Screens¶

Nativella\Screen describes the displays connected to the machine, and where the mouse cursor is.

$display = $screen->primary();

$window->setSize(
    $display->workArea->width * 0.6,
    $display->workArea->height * 0.8,
);
$window->center();

Method
`all(): list<Display>`	Every display.
`primary(): ?Display`	The primary display, null when the system names none. That is the case under Wayland, among others, where `Display::$primary` is always false too.
`cursorPosition(): Point`	Where the mouse cursor is.

Display¶

Nativella\Screen\Display:

Property	Type
`name`	`?string`	The name the system gives the display.
`primary`	`bool`
`bounds`	`Rectangle`	The whole display.
`workArea`	`Rectangle`	The display without the taskbar, the dock or the menu bar, which is where windows go.
`scaleFactor`	`float`	Physical pixels per logical pixel: 2.0 on a typical high-density display.

Nativella\Screen\Rectangle has x, y, width and height, in logical pixels, like CSS pixels and window sizes. Displays share one desktop, and a display's position is where it sits on it.

Cursor¶

cursorPosition() returns a Nativella\Screen\Point, with x and y in physical pixels, from the top left corner of the desktop, which is the primary display's corner on Windows and macOS, and the leftmost display's on X11. Divide by the display's scaleFactor to compare it with window positions, which are logical.