xfw_monitor_get_identifier ()

const char *
xfw_monitor_get_identifier (XfwMonitor *monitor);

Retrieves an opaque identifier for this monitor. The identifier can usually be relied upon to uniquely identify this monitor (even if you have multiple identical monitors of the same make and model), assuming the monitor's hardware is set up properly.

This identifier should also be stable across application and machine restarts.

If the monitor's hardware is not set up properly, the identifier may not be unique. Unfortunately, this library cannot determine when this is the case.

Since: 4.19.4

xfw_monitor_get_description ()

const char *
xfw_monitor_get_description (XfwMonitor *monitor);

Returns a human-readable description of this monitor, suitable for displaying in a user interface.

Since: 4.19.4

xfw_monitor_get_connector ()

const char *
xfw_monitor_get_connector (XfwMonitor *monitor);

Returns the name of the physical connector this monitor is connected to.

This might be a string such as "eDP-1", "DP-3", or "HDMI-2". Note that in environments where the monitor is "virtual", a synthetic connector name may be returned.

Since: 4.19.4

xfw_monitor_get_make ()

const char *
xfw_monitor_get_make (XfwMonitor *monitor);

Returns the monitor's manufacturer's name, if available.

Since: 4.19.4

xfw_monitor_get_model ()

const char *
xfw_monitor_get_model (XfwMonitor *monitor);

Returns the monitor's product model name, if available.

Since: 4.19.4

xfw_monitor_get_serial ()

const char *
xfw_monitor_get_serial (XfwMonitor *monitor);

Returns the monitor's serial number, if available. Note that some manufacturers do not program their monitor's hardware with unique serial numbers.

Since: 4.19.4

xfw_monitor_get_refresh ()

guint
xfw_monitor_get_refresh (XfwMonitor *monitor);

Returns the monitor's current refresh rate, in millihertz.

Since: 4.19.4

xfw_monitor_get_scale ()

guint
xfw_monitor_get_scale (XfwMonitor *monitor);

Returns the monitor's scaling factor, as an integer.

Since: 4.19.4

xfw_monitor_get_fractional_scale ()

gdouble
xfw_monitor_get_fractional_scale (XfwMonitor *monitor);

Returns the monitor's scaling factor.

Since: 4.19.4

xfw_monitor_get_physical_geometry ()

void
xfw_monitor_get_physical_geometry (XfwMonitor *monitor,
                                   GdkRectangle *physical_geometry);

Retrieves the position and size of the monitor in physical device pixels.

Since: 4.19.4

xfw_monitor_get_logical_geometry ()

void
xfw_monitor_get_logical_geometry (XfwMonitor *monitor,
                                  GdkRectangle *logical_geometry);

Retrieves the position and size of the monitor in logical application pixels, which are affected by the monitor's fractional scale factor.

Since: 4.19.4

xfw_monitor_get_workarea ()

void
xfw_monitor_get_workarea (XfwMonitor *monitor,
                          GdkRectangle *workarea);

Retrieves the workarea for monitor , which may exclude regions of the screen for windows such as panels or docks.

The returned geometry is in logical application pixels, which are affected by the monitor's integer scale factor. The origin is set to the top-left corner of the monitor.

Since: 4.19.4

xfw_monitor_get_physical_size ()

void
xfw_monitor_get_physical_size (XfwMonitor *monitor,
                               guint *width_mm,
                               guint *height_mm);

Retrieves the physical width and height of the monitor in millimeters.

Since: 4.19.4

xfw_monitor_get_subpixel ()

XfwMonitorSubpixel
xfw_monitor_get_subpixel (XfwMonitor *monitor);

Returns the subpixel ordering of monitor .

Since: 4.19.4

xfw_monitor_get_transform ()

XfwMonitorTransform
xfw_monitor_get_transform (XfwMonitor *monitor);

Returns the rotation and reflection transform set on monitor .

Since: 4.19.4

xfw_monitor_is_primary ()

gboolean
xfw_monitor_is_primary (XfwMonitor *monitor);

Returns whether or not monitor has been designated as the primary monitor.

Since: 4.19.4

xfw_monitor_get_gdk_monitor ()

GdkMonitor *
xfw_monitor_get_gdk_monitor (XfwMonitor *monitor);

Returns the GdkMonitor that corresponds to monitor .

Since: 4.19.4

XfwMonitor

typedef struct _XfwMonitor XfwMonitor;

enum XfwMonitorSubpixel

Describes how the color components of the physical pixels are laid out on a monitor.

Since: 4.19.4

enum XfwMonitorTransform

Describes the rotation and reflection applied to a monitor.

Since: 4.19.4

The “connector” property

  “connector”                char *

Physical/virtual connector name.

Owner: XfwMonitor

Flags: Read

Default value: NULL

Since: 4.19.4

The “description” property

  “description”              char *

Human-readable description.

Owner: XfwMonitor

Flags: Read

Default value: NULL

Since: 4.19.4

The “fractional-scale” property

  “fractional-scale”         double

UI fractional scaling factor.

Owner: XfwMonitor

Flags: Read

Allowed values: >= 1

Default value: 1

Since: 4.19.4

The “gdk-monitor” property

  “gdk-monitor”              GdkMonitor *

The GdkMonitor corresponding to this monitor.

Since 4.19.4

Owner: XfwMonitor

Flags: Read

The “height-mm” property

  “height-mm”                guint

Physical height of the monitor in millimeters.

Owner: XfwMonitor

Flags: Read

Default value: 0

Since: 4.19.4

The “identifier” property

  “identifier”               char *

Opaque, hopefully-unique monitor identifier.

Owner: XfwMonitor

Flags: Read

Default value: NULL

Since: 4.19.4

The “is-primary” property

  “is-primary”               gboolean

Whether or not this monitor is the primary monitor.

Owner: XfwMonitor

Flags: Read

Default value: FALSE

Since: 4.19.4

The “logical-geometry” property

  “logical-geometry”         GdkRectangle *

Coordinates and size of the monitor in scaled logical pixels.

Owner: XfwMonitor

Flags: Read

Since: 4.19.4

The “make” property

  “make”                     char *

Manufacturer name.

Owner: XfwMonitor

Flags: Read

Default value: NULL

Since: 4.19.4

The “model” property

  “model”                    char *

Product model name.

Owner: XfwMonitor

Flags: Read

Default value: NULL

Since: 4.19.4

The “physical-geometry” property

  “physical-geometry”        GdkRectangle *

Coordinates and size of the monitor in physical device pixels.

Owner: XfwMonitor

Flags: Read

Since: 4.19.4

The “refresh” property

  “refresh”                  guint

Current refresh rate, in millihertz.

Owner: XfwMonitor

Flags: Read

Default value: 60000

Since: 4.19.4

The “scale” property

  “scale”                    guint

UI scaling factor.

Owner: XfwMonitor

Flags: Read

Allowed values: >= 1

Default value: 1

Since: 4.19.4

The “serial” property

  “serial”                   char *

Product serial number.

Owner: XfwMonitor

Flags: Read

Default value: NULL

Since: 4.19.4

The “subpixel” property

  “subpixel”                 XfwMonitorSubpixel

Hardware subpixel layout.

Owner: XfwMonitor

Flags: Read

Default value: XFW_MONITOR_SUBPIXEL_UNKNOWN

Since: 4.19.4

The “transform” property

  “transform”                XfwMonitorTransform

Rotation and reflection of the monitor's contents.

Owner: XfwMonitor

Flags: Read

Default value: XFW_MONITOR_TRANSFORM_NORMAL

The “width-mm” property

  “width-mm”                 guint

Physical width of the monitor in millimeters.

Owner: XfwMonitor

Flags: Read

Default value: 0

Since: 4.19.4

The “workarea” property

  “workarea”                 GdkRectangle *

Monitor workarea in scaled logical pixels.

Owner: XfwMonitor

Flags: Read