Multi-Head Environments

Sawfish has special functions to support environments with multiple monitors displaying a single logical screen (as provided by Xinerama).

find-head x y

Function

Return a ID for the display head that point (x, y) is in. The return value is an integer; the default head has ID zero. Returns nil if it cannot determine the head from x and y.

head-count

Function

Return the number of display heads on the machine.

head-dimensions id

Function

Return the cons cell (width . height) of the dimensions of the display head indicated by id. Id must be a non-negative integer. Without Xinerama support, id must be zero and the function returns the screen size.

head-offset id

Function

Return the cons cell (x . y) of the dimensions of the display head indicated by id. Id must be a non-negative integer. Without Xinerama support, id must be zero and the function returns (0 . 0).

pointer-head

Function

Return the ID of the head containing the mouse pointer.

current-head &optional window

Function

Return the ID of the head containing the window with input focus. If window is supplied and a window, return the head containing that window. If window is supplied and nil, return (pointer-head).

current-head-dimensions &optional window

Function

Return a cons-cell defining the size in pixels of the current head (that containing the window window, or the pointer if window is false). Returns the screen dimensions if no such head can be identified.

current-head-offset &optional window

Function

Return a cons-cell defining the origin of the current head (that containing the window window, or the pointer if window is false). Returns '(0 . 0) if no such head can be identified.