All Manuals > CAPI User Guide and Reference Manual > 21 CAPI Reference Entries

screen-internal-geometries Function

Summary

Returns the internal geometries of all the monitors of a screen.

Package

capi

Signature

screen-internal-geometries screen => internal-geometries

Arguments
screen
A CAPI screen.
Values
internal-geometries
A list of screen rectangles.
Description

The function screen-internal-geometries returns the internal geometries of all the "monitors" of screen. A "monitor" typically corresponds to a physical monitor, but can be anything that the underlying GUI system considers a monitor.

The internal geometry of a monitor is a rectangle which excludes "system areas" like taskbars and global menu bars and so on. Examples of these include the Windows taskbar, the macOS menu bar, and the macOS Dock. See screen-internal-geometry for information about displaying CAPI windows in system areas.

Each internal geometry is represented as a screen rectangle. A screen rectangle is a list of four numbers: x and y being the coordinates as offsets from the top-left of the primary monitor, and width and height.

The first screen rectangle in internal-geometries corresponds to the usable area of the primary monitor.

Notes

On GTK+ when using a desktop with separate workspaces, the workspaces may be considered as separate "monitors". When there are multiple real monitors, the values may be incorrect. You can use screen-monitor-geometries to check the number of monitors, and to check the full size of the monitors.

See also

pane-screen-internal-geometry
virtual-screen-geometry
screen-internal-geometry
screen-monitor-geometries
3.13 Screens
4.3 Support for multiple monitors
11.6 Querying and modifying interface geometry


CAPI User Guide and Reference Manual (Unix version) - 01 Dec 2021 19:32:42