<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
]>
<refentry id="GdkMonitor">
<refmeta>
<refentrytitle role="top_of_page" id="GdkMonitor.top_of_page">GdkMonitor</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GDK4 Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GdkMonitor</refname>
<refpurpose>Object representing an output</refpurpose>
</refnamediv>

<refsect1 id="GdkMonitor.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_proto_type" colwidth="150px"/>
<colspec colname="functions_proto_name"/>
<tbody>
<row><entry role="function_type"><link linkend="GdkDisplay"><returnvalue>GdkDisplay</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-monitor-get-display">gdk_monitor_get_display</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-monitor-get-geometry">gdk_monitor_get_geometry</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="int"><returnvalue>int</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-monitor-get-width-mm">gdk_monitor_get_width_mm</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="int"><returnvalue>int</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-monitor-get-height-mm">gdk_monitor_get_height_mm</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-monitor-get-manufacturer">gdk_monitor_get_manufacturer</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-monitor-get-model">gdk_monitor_get_model</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gdk-monitor-get-connector">gdk_monitor_get_connector</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="int"><returnvalue>int</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-monitor-get-scale-factor">gdk_monitor_get_scale_factor</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="int"><returnvalue>int</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-monitor-get-refresh-rate">gdk_monitor_get_refresh_rate</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GdkSubpixelLayout"><returnvalue>GdkSubpixelLayout</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-monitor-get-subpixel-layout">gdk_monitor_get_subpixel_layout</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gdk-monitor-is-valid">gdk_monitor_is_valid</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GdkMonitor.properties" role="properties">
<title role="properties.title">Properties</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="properties_type" colwidth="150px"/>
<colspec colname="properties_name" colwidth="300px"/>
<colspec colname="properties_flags" colwidth="200px"/>
<tbody>
<row><entry role="property_type"><link linkend="char"><type>char</type></link>&#160;*</entry><entry role="property_name"><link linkend="GdkMonitor--connector">connector</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="GdkDisplay"><type>GdkDisplay</type></link>&#160;*</entry><entry role="property_name"><link linkend="GdkMonitor--display">display</link></entry><entry role="property_flags">Read / Write / Construct&#160;Only</entry></row>
<row><entry role="property_type"><link linkend="GdkRectangle"><type>GdkRectangle</type></link>&#160;*</entry><entry role="property_name"><link linkend="GdkMonitor--geometry">geometry</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="int"><type>int</type></link></entry><entry role="property_name"><link linkend="GdkMonitor--height-mm">height-mm</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="char"><type>char</type></link>&#160;*</entry><entry role="property_name"><link linkend="GdkMonitor--manufacturer">manufacturer</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="char"><type>char</type></link>&#160;*</entry><entry role="property_name"><link linkend="GdkMonitor--model">model</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="int"><type>int</type></link></entry><entry role="property_name"><link linkend="GdkMonitor--refresh-rate">refresh-rate</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="int"><type>int</type></link></entry><entry role="property_name"><link linkend="GdkMonitor--scale-factor">scale-factor</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="GdkSubpixelLayout"><type>GdkSubpixelLayout</type></link></entry><entry role="property_name"><link linkend="GdkMonitor--subpixel-layout">subpixel-layout</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GdkMonitor--valid">valid</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="int"><type>int</type></link></entry><entry role="property_name"><link linkend="GdkMonitor--width-mm">width-mm</link></entry><entry role="property_flags">Read</entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GdkMonitor.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="signal_proto_type" colwidth="150px"/>
<colspec colname="signal_proto_name" colwidth="300px"/>
<colspec colname="signal_proto_flags" colwidth="200px"/>
<tbody>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GdkMonitor-invalidate">invalidate</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GdkMonitor.other" role="other_proto">
<title role="other_proto.title">Types and Values</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="other_proto_type" colwidth="150px"/>
<colspec colname="other_proto_name"/>
<tbody>
<row><entry role="datatype_keyword"></entry><entry role="function_name"><link linkend="GdkMonitor-struct">GdkMonitor</link></entry></row>
<row><entry role="datatype_keyword">enum</entry><entry role="function_name"><link linkend="GdkSubpixelLayout">GdkSubpixelLayout</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GdkMonitor.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<screen>    <link linkend="GObject">GObject</link>
    <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> GdkMonitor
</screen>
</refsect1>

<refsect1 id="GdkMonitor.includes"><title>Includes</title><synopsis>#include &lt;gdk/gdk.h&gt;
</synopsis></refsect1>

<refsect1 id="GdkMonitor.description" role="desc">
<title role="desc.title">Description</title>
<para>GdkMonitor objects represent the individual outputs that are
associated with a <link linkend="GdkDisplay"><type>GdkDisplay</type></link>. GdkDisplay keeps a <link linkend="GListModel"><type>GListModel</type></link> to enumerate
and monitor monitors with <link linkend="gdk-display-get-monitors"><function>gdk_display_get_monitors()</function></link>.  
You can use <link linkend="gdk-display-get-monitor-at-surface"><function>gdk_display_get_monitor_at_surface()</function></link> to find a particular monitor.</para>

</refsect1>
<refsect1 id="GdkMonitor.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="gdk-monitor-get-display" role="function">
<title>gdk_monitor_get_display&#160;()</title>
<indexterm zone="gdk-monitor-get-display"><primary>gdk_monitor_get_display</primary></indexterm>
<programlisting language="C"><link linkend="GdkDisplay"><returnvalue>GdkDisplay</returnvalue></link>&#160;*
gdk_monitor_get_display (<parameter><link linkend="GdkMonitor"><type>GdkMonitor</type></link> *monitor</parameter>);</programlisting>
<para>Gets the display that this monitor belongs to.</para>
<refsect3 id="gdk-monitor-get-display.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>monitor</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkMonitor"><type>GdkMonitor</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-monitor-get-display.returns" role="returns">
<title>Returns</title>
<para>the display. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-monitor-get-geometry" role="function">
<title>gdk_monitor_get_geometry&#160;()</title>
<indexterm zone="gdk-monitor-get-geometry"><primary>gdk_monitor_get_geometry</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gdk_monitor_get_geometry (<parameter><link linkend="GdkMonitor"><type>GdkMonitor</type></link> *monitor</parameter>,
                          <parameter><link linkend="GdkRectangle"><type>GdkRectangle</type></link> *geometry</parameter>);</programlisting>
<para>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 <link linkend="gdk-monitor-get-scale-factor"><function>gdk_monitor_get_scale_factor()</function></link>).</para>
<refsect3 id="gdk-monitor-get-geometry.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>monitor</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkMonitor"><type>GdkMonitor</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>geometry</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkRectangle"><type>GdkRectangle</type></link> to be filled with the monitor geometry. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>out</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gdk-monitor-get-width-mm" role="function">
<title>gdk_monitor_get_width_mm&#160;()</title>
<indexterm zone="gdk-monitor-get-width-mm"><primary>gdk_monitor_get_width_mm</primary></indexterm>
<programlisting language="C"><link linkend="int"><returnvalue>int</returnvalue></link>
gdk_monitor_get_width_mm (<parameter><link linkend="GdkMonitor"><type>GdkMonitor</type></link> *monitor</parameter>);</programlisting>
<para>Gets the width in millimeters of the monitor.</para>
<refsect3 id="gdk-monitor-get-width-mm.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>monitor</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkMonitor"><type>GdkMonitor</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-monitor-get-width-mm.returns" role="returns">
<title>Returns</title>
<para> the physical width of the monitor</para>
</refsect3></refsect2>
<refsect2 id="gdk-monitor-get-height-mm" role="function">
<title>gdk_monitor_get_height_mm&#160;()</title>
<indexterm zone="gdk-monitor-get-height-mm"><primary>gdk_monitor_get_height_mm</primary></indexterm>
<programlisting language="C"><link linkend="int"><returnvalue>int</returnvalue></link>
gdk_monitor_get_height_mm (<parameter><link linkend="GdkMonitor"><type>GdkMonitor</type></link> *monitor</parameter>);</programlisting>
<para>Gets the height in millimeters of the monitor.</para>
<refsect3 id="gdk-monitor-get-height-mm.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>monitor</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkMonitor"><type>GdkMonitor</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-monitor-get-height-mm.returns" role="returns">
<title>Returns</title>
<para> the physical height of the monitor</para>
</refsect3></refsect2>
<refsect2 id="gdk-monitor-get-manufacturer" role="function">
<title>gdk_monitor_get_manufacturer&#160;()</title>
<indexterm zone="gdk-monitor-get-manufacturer"><primary>gdk_monitor_get_manufacturer</primary></indexterm>
<programlisting language="C">const <link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
gdk_monitor_get_manufacturer (<parameter><link linkend="GdkMonitor"><type>GdkMonitor</type></link> *monitor</parameter>);</programlisting>
<para>Gets the name or PNP ID of the monitor's manufacturer, if available.</para>
<para>Note that this value might also vary depending on actual
display backend.</para>
<para>PNP ID registry is located at https://uefi.org/pnp_id_list</para>
<refsect3 id="gdk-monitor-get-manufacturer.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>monitor</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkMonitor"><type>GdkMonitor</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-monitor-get-manufacturer.returns" role="returns">
<title>Returns</title>
<para>the name of the manufacturer, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-monitor-get-model" role="function">
<title>gdk_monitor_get_model&#160;()</title>
<indexterm zone="gdk-monitor-get-model"><primary>gdk_monitor_get_model</primary></indexterm>
<programlisting language="C">const <link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
gdk_monitor_get_model (<parameter><link linkend="GdkMonitor"><type>GdkMonitor</type></link> *monitor</parameter>);</programlisting>
<para>Gets the string identifying the monitor model, if available.</para>
<refsect3 id="gdk-monitor-get-model.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>monitor</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkMonitor"><type>GdkMonitor</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-monitor-get-model.returns" role="returns">
<title>Returns</title>
<para>the monitor model, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-monitor-get-connector" role="function">
<title>gdk_monitor_get_connector&#160;()</title>
<indexterm zone="gdk-monitor-get-connector"><primary>gdk_monitor_get_connector</primary></indexterm>
<programlisting language="C">const <link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
gdk_monitor_get_connector (<parameter><link linkend="GdkMonitor"><type>GdkMonitor</type></link> *monitor</parameter>);</programlisting>
<para>Gets the name of the monitor's connector, if available.</para>
<refsect3 id="gdk-monitor-get-connector.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>monitor</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkMonitor"><type>GdkMonitor</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-monitor-get-connector.returns" role="returns">
<title>Returns</title>
<para>the name of the connector. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gdk-monitor-get-scale-factor" role="function">
<title>gdk_monitor_get_scale_factor&#160;()</title>
<indexterm zone="gdk-monitor-get-scale-factor"><primary>gdk_monitor_get_scale_factor</primary></indexterm>
<programlisting language="C"><link linkend="int"><returnvalue>int</returnvalue></link>
gdk_monitor_get_scale_factor (<parameter><link linkend="GdkMonitor"><type>GdkMonitor</type></link> *monitor</parameter>);</programlisting>
<para>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).</para>
<para>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 <link linkend="gdk-surface-get-scale-factor"><function>gdk_surface_get_scale_factor()</function></link> instead.</para>
<refsect3 id="gdk-monitor-get-scale-factor.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>monitor</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkMonitor"><type>GdkMonitor</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-monitor-get-scale-factor.returns" role="returns">
<title>Returns</title>
<para> the scale factor</para>
</refsect3></refsect2>
<refsect2 id="gdk-monitor-get-refresh-rate" role="function">
<title>gdk_monitor_get_refresh_rate&#160;()</title>
<indexterm zone="gdk-monitor-get-refresh-rate"><primary>gdk_monitor_get_refresh_rate</primary></indexterm>
<programlisting language="C"><link linkend="int"><returnvalue>int</returnvalue></link>
gdk_monitor_get_refresh_rate (<parameter><link linkend="GdkMonitor"><type>GdkMonitor</type></link> *monitor</parameter>);</programlisting>
<para>Gets the refresh rate of the monitor, if available.</para>
<para>The value is in milli-Hertz, so a refresh rate of 60Hz
is returned as 60000.</para>
<refsect3 id="gdk-monitor-get-refresh-rate.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>monitor</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkMonitor"><type>GdkMonitor</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-monitor-get-refresh-rate.returns" role="returns">
<title>Returns</title>
<para> the refresh rate in milli-Hertz, or 0</para>
</refsect3></refsect2>
<refsect2 id="gdk-monitor-get-subpixel-layout" role="function">
<title>gdk_monitor_get_subpixel_layout&#160;()</title>
<indexterm zone="gdk-monitor-get-subpixel-layout"><primary>gdk_monitor_get_subpixel_layout</primary></indexterm>
<programlisting language="C"><link linkend="GdkSubpixelLayout"><returnvalue>GdkSubpixelLayout</returnvalue></link>
gdk_monitor_get_subpixel_layout (<parameter><link linkend="GdkMonitor"><type>GdkMonitor</type></link> *monitor</parameter>);</programlisting>
<para>Gets information about the layout of red, green and blue
primaries for each pixel in this monitor, if available.</para>
<refsect3 id="gdk-monitor-get-subpixel-layout.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>monitor</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkMonitor"><type>GdkMonitor</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-monitor-get-subpixel-layout.returns" role="returns">
<title>Returns</title>
<para> the subpixel layout</para>
</refsect3></refsect2>
<refsect2 id="gdk-monitor-is-valid" role="function">
<title>gdk_monitor_is_valid&#160;()</title>
<indexterm zone="gdk-monitor-is-valid"><primary>gdk_monitor_is_valid</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gdk_monitor_is_valid (<parameter><link linkend="GdkMonitor"><type>GdkMonitor</type></link> *monitor</parameter>);</programlisting>
<para>Returns <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the <parameter>monitor</parameter>
 object corresponds to a
physical monitor. The <parameter>monitor</parameter>
 becomes invalid when the
physical monitor is unplugged or removed.</para>
<refsect3 id="gdk-monitor-is-valid.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>monitor</para></entry>
<entry role="parameter_description"><para>a <link linkend="GdkMonitor"><type>GdkMonitor</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gdk-monitor-is-valid.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the object corresponds to a physical monitor</para>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GdkMonitor.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="GdkMonitor-struct" role="struct">
<title>GdkMonitor</title>
<indexterm zone="GdkMonitor-struct"><primary>GdkMonitor</primary></indexterm>
<programlisting language="C">typedef struct _GdkMonitor GdkMonitor;</programlisting>
<para>The GdkMonitor struct contains only private fields and should not
be accessed directly.</para>
</refsect2>
<refsect2 id="GdkSubpixelLayout" role="enum">
<title>enum GdkSubpixelLayout</title>
<indexterm zone="GdkSubpixelLayout"><primary>GdkSubpixelLayout</primary></indexterm>
<para>This enumeration describes how the red, green and blue components
of physical pixels on an output device are laid out.</para>
<refsect3 id="GdkSubpixelLayout.members" role="enum_members">
<title>Members</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="enum_members_name" colwidth="300px"/>
<colspec colname="enum_members_description"/>
<colspec colname="enum_members_annotations" colwidth="200px"/>
<tbody>
<row role="constant"><entry role="enum_member_name"><para id="GDK-SUBPIXEL-LAYOUT-UNKNOWN:CAPS">GDK_SUBPIXEL_LAYOUT_UNKNOWN</para></entry>
<entry role="enum_member_description"><para>The layout is not known</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GDK-SUBPIXEL-LAYOUT-NONE:CAPS">GDK_SUBPIXEL_LAYOUT_NONE</para></entry>
<entry role="enum_member_description"><para>Not organized in this way</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GDK-SUBPIXEL-LAYOUT-HORIZONTAL-RGB:CAPS">GDK_SUBPIXEL_LAYOUT_HORIZONTAL_RGB</para></entry>
<entry role="enum_member_description"><para>The layout is horizontal, the order is RGB</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GDK-SUBPIXEL-LAYOUT-HORIZONTAL-BGR:CAPS">GDK_SUBPIXEL_LAYOUT_HORIZONTAL_BGR</para></entry>
<entry role="enum_member_description"><para>The layout is horizontal, the order is BGR</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GDK-SUBPIXEL-LAYOUT-VERTICAL-RGB:CAPS">GDK_SUBPIXEL_LAYOUT_VERTICAL_RGB</para></entry>
<entry role="enum_member_description"><para>The layout is vertical, the order is RGB</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GDK-SUBPIXEL-LAYOUT-VERTICAL-BGR:CAPS">GDK_SUBPIXEL_LAYOUT_VERTICAL_BGR</para></entry>
<entry role="enum_member_description"><para>The layout is vertical, the order is BGR</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GdkMonitor.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GdkMonitor--connector" role="property"><title>The <literal>“connector”</literal> property</title>
<indexterm zone="GdkMonitor--connector"><primary>GdkMonitor:connector</primary></indexterm>
<programlisting>  “connector”                <link linkend="char"><type>char</type></link>&#160;*</programlisting>
<para>The connector name.</para><para>Owner: GdkMonitor</para>
<para>Flags: Read</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GdkMonitor--display" role="property"><title>The <literal>“display”</literal> property</title>
<indexterm zone="GdkMonitor--display"><primary>GdkMonitor:display</primary></indexterm>
<programlisting>  “display”                  <link linkend="GdkDisplay"><type>GdkDisplay</type></link>&#160;*</programlisting>
<para>The display of the monitor.</para><para>Owner: GdkMonitor</para>
<para>Flags: Read / Write / Construct&#160;Only</para>
</refsect2>
<refsect2 id="GdkMonitor--geometry" role="property"><title>The <literal>“geometry”</literal> property</title>
<indexterm zone="GdkMonitor--geometry"><primary>GdkMonitor:geometry</primary></indexterm>
<programlisting>  “geometry”                 <link linkend="GdkRectangle"><type>GdkRectangle</type></link>&#160;*</programlisting>
<para>The geometry of the monitor.</para><para>Owner: GdkMonitor</para>
<para>Flags: Read</para>
</refsect2>
<refsect2 id="GdkMonitor--height-mm" role="property"><title>The <literal>“height-mm”</literal> property</title>
<indexterm zone="GdkMonitor--height-mm"><primary>GdkMonitor:height-mm</primary></indexterm>
<programlisting>  “height-mm”                <link linkend="int"><type>int</type></link></programlisting>
<para>The height of the monitor, in millimeters.</para><para>Owner: GdkMonitor</para>
<para>Flags: Read</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GdkMonitor--manufacturer" role="property"><title>The <literal>“manufacturer”</literal> property</title>
<indexterm zone="GdkMonitor--manufacturer"><primary>GdkMonitor:manufacturer</primary></indexterm>
<programlisting>  “manufacturer”             <link linkend="char"><type>char</type></link>&#160;*</programlisting>
<para>The manufacturer name.</para><para>Owner: GdkMonitor</para>
<para>Flags: Read</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GdkMonitor--model" role="property"><title>The <literal>“model”</literal> property</title>
<indexterm zone="GdkMonitor--model"><primary>GdkMonitor:model</primary></indexterm>
<programlisting>  “model”                    <link linkend="char"><type>char</type></link>&#160;*</programlisting>
<para>The model name.</para><para>Owner: GdkMonitor</para>
<para>Flags: Read</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GdkMonitor--refresh-rate" role="property"><title>The <literal>“refresh-rate”</literal> property</title>
<indexterm zone="GdkMonitor--refresh-rate"><primary>GdkMonitor:refresh-rate</primary></indexterm>
<programlisting>  “refresh-rate”             <link linkend="int"><type>int</type></link></programlisting>
<para>The refresh rate, in millihertz.</para><para>Owner: GdkMonitor</para>
<para>Flags: Read</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GdkMonitor--scale-factor" role="property"><title>The <literal>“scale-factor”</literal> property</title>
<indexterm zone="GdkMonitor--scale-factor"><primary>GdkMonitor:scale-factor</primary></indexterm>
<programlisting>  “scale-factor”             <link linkend="int"><type>int</type></link></programlisting>
<para>The scale factor.</para><para>Owner: GdkMonitor</para>
<para>Flags: Read</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 1</para>
</refsect2>
<refsect2 id="GdkMonitor--subpixel-layout" role="property"><title>The <literal>“subpixel-layout”</literal> property</title>
<indexterm zone="GdkMonitor--subpixel-layout"><primary>GdkMonitor:subpixel-layout</primary></indexterm>
<programlisting>  “subpixel-layout”          <link linkend="GdkSubpixelLayout"><type>GdkSubpixelLayout</type></link></programlisting>
<para>The subpixel layout.</para><para>Owner: GdkMonitor</para>
<para>Flags: Read</para>
<para>Default value: GDK_SUBPIXEL_LAYOUT_UNKNOWN</para>
</refsect2>
<refsect2 id="GdkMonitor--valid" role="property"><title>The <literal>“valid”</literal> property</title>
<indexterm zone="GdkMonitor--valid"><primary>GdkMonitor:valid</primary></indexterm>
<programlisting>  “valid”                    <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether the monitor is still valid.</para><para>Owner: GdkMonitor</para>
<para>Flags: Read</para>
<para>Default value: TRUE</para>
</refsect2>
<refsect2 id="GdkMonitor--width-mm" role="property"><title>The <literal>“width-mm”</literal> property</title>
<indexterm zone="GdkMonitor--width-mm"><primary>GdkMonitor:width-mm</primary></indexterm>
<programlisting>  “width-mm”                 <link linkend="int"><type>int</type></link></programlisting>
<para>The width of the monitor, in millimeters.</para><para>Owner: GdkMonitor</para>
<para>Flags: Read</para>
<para>Allowed values: &gt;= 0</para>
<para>Default value: 0</para>
</refsect2>

</refsect1>
<refsect1 id="GdkMonitor.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GdkMonitor-invalidate" role="signal"><title>The <literal>“invalidate”</literal> signal</title>
<indexterm zone="GdkMonitor-invalidate"><primary>GdkMonitor::invalidate</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GdkMonitor"><type>GdkMonitor</type></link> *monitor,
               <link linkend="gpointer"><type>gpointer</type></link>    user_data)</programlisting>
<para>The ::invalidate signal gets emitted when the output represented
by <parameter>monitor</parameter>
 gets disconnected.</para>
<refsect3 id="GdkMonitor-invalidate.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>monitor</para></entry>
<entry role="parameter_description"><para>the object on which this signal was emitted</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></para>
</refsect2>
</refsect1>

</refentry>
