Top |
Functions
GdkDisplay * | gdk_monitor_get_display () |
void | gdk_monitor_get_geometry () |
int | gdk_monitor_get_width_mm () |
int | gdk_monitor_get_height_mm () |
const char * | gdk_monitor_get_manufacturer () |
const char * | gdk_monitor_get_model () |
const char * | gdk_monitor_get_connector () |
int | gdk_monitor_get_scale_factor () |
int | gdk_monitor_get_refresh_rate () |
GdkSubpixelLayout | gdk_monitor_get_subpixel_layout () |
gboolean | gdk_monitor_is_valid () |
Properties
char * | connector | Read |
GdkDisplay * | display | Read / Write / Construct Only |
GdkRectangle * | geometry | Read |
int | height-mm | Read |
char * | manufacturer | Read |
char * | model | Read |
int | refresh-rate | Read |
int | scale-factor | Read |
GdkSubpixelLayout | subpixel-layout | Read |
gboolean | valid | Read |
int | width-mm | Read |
Description
GdkMonitor objects represent the individual outputs that are
associated with a GdkDisplay. GdkDisplay keeps a GListModel to enumerate
and monitor monitors with gdk_display_get_monitors()
.
You can use gdk_display_get_monitor_at_surface()
to find a particular monitor.
Functions
gdk_monitor_get_display ()
GdkDisplay *
gdk_monitor_get_display (GdkMonitor *monitor
);
Gets the display that this monitor belongs to.
gdk_monitor_get_geometry ()
void gdk_monitor_get_geometry (GdkMonitor *monitor
,GdkRectangle *geometry
);
Retrieves the size and position of an individual monitor within the
display coordinate space. The returned geometry is in ”application pixels”,
not in ”device pixels” (see gdk_monitor_get_scale_factor()
).
gdk_monitor_get_width_mm ()
int
gdk_monitor_get_width_mm (GdkMonitor *monitor
);
Gets the width in millimeters of the monitor.
gdk_monitor_get_height_mm ()
int
gdk_monitor_get_height_mm (GdkMonitor *monitor
);
Gets the height in millimeters of the monitor.
gdk_monitor_get_manufacturer ()
const char *
gdk_monitor_get_manufacturer (GdkMonitor *monitor
);
Gets the name or PNP ID of the monitor's manufacturer, if available.
Note that this value might also vary depending on actual display backend.
PNP ID registry is located at https://uefi.org/pnp_id_list
gdk_monitor_get_model ()
const char *
gdk_monitor_get_model (GdkMonitor *monitor
);
Gets the string identifying the monitor model, if available.
gdk_monitor_get_connector ()
const char *
gdk_monitor_get_connector (GdkMonitor *monitor
);
Gets the name of the monitor's connector, if available.
gdk_monitor_get_scale_factor ()
int
gdk_monitor_get_scale_factor (GdkMonitor *monitor
);
Gets the internal scale factor that maps from monitor coordinates to the actual device pixels. On traditional systems this is 1, but on very high density outputs this can be a higher value (often 2).
This can be used if you want to create pixel based data for a
particular monitor, but most of the time you’re drawing to a surface
where it is better to use gdk_surface_get_scale_factor()
instead.
gdk_monitor_get_refresh_rate ()
int
gdk_monitor_get_refresh_rate (GdkMonitor *monitor
);
Gets the refresh rate of the monitor, if available.
The value is in milli-Hertz, so a refresh rate of 60Hz is returned as 60000.
gdk_monitor_get_subpixel_layout ()
GdkSubpixelLayout
gdk_monitor_get_subpixel_layout (GdkMonitor *monitor
);
Gets information about the layout of red, green and blue primaries for each pixel in this monitor, if available.
gdk_monitor_is_valid ()
gboolean
gdk_monitor_is_valid (GdkMonitor *monitor
);
Returns TRUE
if the monitor
object corresponds to a
physical monitor. The monitor
becomes invalid when the
physical monitor is unplugged or removed.
Types and Values
GdkMonitor
typedef struct _GdkMonitor GdkMonitor;
The GdkMonitor struct contains only private fields and should not be accessed directly.
enum GdkSubpixelLayout
This enumeration describes how the red, green and blue components of physical pixels on an output device are laid out.
Property Details
The “connector”
property
“connector” char *
The connector name.
Owner: GdkMonitor
Flags: Read
Default value: NULL
The “display”
property
“display” GdkDisplay *
The display of the monitor.
Owner: GdkMonitor
Flags: Read / Write / Construct Only
The “geometry”
property
“geometry” GdkRectangle *
The geometry of the monitor.
Owner: GdkMonitor
Flags: Read
The “height-mm”
property
“height-mm” int
The height of the monitor, in millimeters.
Owner: GdkMonitor
Flags: Read
Allowed values: >= 0
Default value: 0
The “manufacturer”
property
“manufacturer” char *
The manufacturer name.
Owner: GdkMonitor
Flags: Read
Default value: NULL
The “model”
property
“model” char *
The model name.
Owner: GdkMonitor
Flags: Read
Default value: NULL
The “refresh-rate”
property
“refresh-rate” int
The refresh rate, in millihertz.
Owner: GdkMonitor
Flags: Read
Allowed values: >= 0
Default value: 0
The “scale-factor”
property
“scale-factor” int
The scale factor.
Owner: GdkMonitor
Flags: Read
Allowed values: >= 0
Default value: 1
The “subpixel-layout”
property
“subpixel-layout” GdkSubpixelLayout
The subpixel layout.
Owner: GdkMonitor
Flags: Read
Default value: GDK_SUBPIXEL_LAYOUT_UNKNOWN
The “valid”
property
“valid” gboolean
Whether the monitor is still valid.
Owner: GdkMonitor
Flags: Read
Default value: TRUE
Signal Details
The “invalidate”
signal
void user_function (GdkMonitor *monitor, gpointer user_data)
The ::invalidate signal gets emitted when the output represented
by monitor
gets disconnected.
Parameters
monitor |
the object on which this signal was emitted |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First