<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="gnome-desktop-gnome-rr-screen">
<refmeta>
<refentrytitle role="top_of_page" id="gnome-desktop-gnome-rr-screen.top_of_page">gnome-rr-screen</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GNOME-DESKTOP Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>gnome-rr-screen</refname>
<refpurpose></refpurpose>
</refnamediv>

<refsynopsisdiv id="gnome-desktop-gnome-rr-screen.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>
#include &lt;libgnomeui/gnome-rr.h&gt;

typedef             <link linkend="GnomeRRScreen">GnomeRRScreen</link>;
<link linkend="void">void</link>                (<link linkend="GnomeRRScreenChanged">*GnomeRRScreenChanged</link>)             (<link linkend="GnomeRRScreen">GnomeRRScreen</link> *screen,
                                                         <link linkend="gpointer">gpointer</link> data);
<link linkend="GnomeRRScreen">GnomeRRScreen</link> *     <link linkend="gnome-rr-screen-new">gnome_rr_screen_new</link>                 (<link linkend="GdkScreen">GdkScreen</link> *screen,
                                                         <link linkend="GnomeRRScreenChanged">GnomeRRScreenChanged</link> callback,
                                                         <link linkend="gpointer">gpointer</link> data,
                                                         <link linkend="GError">GError</link> **error);
<link linkend="void">void</link>                <link linkend="gnome-rr-screen-destroy">gnome_rr_screen_destroy</link>             (<link linkend="GnomeRRScreen">GnomeRRScreen</link> *screen);
<link linkend="gboolean">gboolean</link>            <link linkend="gnome-rr-screen-refresh">gnome_rr_screen_refresh</link>             (<link linkend="GnomeRRScreen">GnomeRRScreen</link> *screen,
                                                         <link linkend="GError">GError</link> **error);
<link linkend="GnomeRROutput">GnomeRROutput</link> **    <link linkend="gnome-rr-screen-list-outputs">gnome_rr_screen_list_outputs</link>        (<link linkend="GnomeRRScreen">GnomeRRScreen</link> *screen);
<link linkend="GnomeRRCrtc">GnomeRRCrtc</link> **      <link linkend="gnome-rr-screen-list-crtcs">gnome_rr_screen_list_crtcs</link>          (<link linkend="GnomeRRScreen">GnomeRRScreen</link> *screen);
<link linkend="GnomeRRMode">GnomeRRMode</link> **      <link linkend="gnome-rr-screen-list-modes">gnome_rr_screen_list_modes</link>          (<link linkend="GnomeRRScreen">GnomeRRScreen</link> *screen);
<link linkend="GnomeRRMode">GnomeRRMode</link> **      <link linkend="gnome-rr-screen-list-clone-modes">gnome_rr_screen_list_clone_modes</link>    (<link linkend="GnomeRRScreen">GnomeRRScreen</link> *screen);
<link linkend="void">void</link>                <link linkend="gnome-rr-screen-set-size">gnome_rr_screen_set_size</link>            (<link linkend="GnomeRRScreen">GnomeRRScreen</link> *screen,
                                                         <link linkend="int">int</link> width,
                                                         <link linkend="int">int</link> height,
                                                         <link linkend="int">int</link> mm_width,
                                                         <link linkend="int">int</link> mm_height);
<link linkend="GnomeRROutput">GnomeRROutput</link> *     <link linkend="gnome-rr-screen-get-output-by-id">gnome_rr_screen_get_output_by_id</link>    (<link linkend="GnomeRRScreen">GnomeRRScreen</link> *screen,
                                                         <link linkend="guint32">guint32</link> id);
<link linkend="GnomeRROutput">GnomeRROutput</link> *     <link linkend="gnome-rr-screen-get-output-by-name">gnome_rr_screen_get_output_by_name</link>  (<link linkend="GnomeRRScreen">GnomeRRScreen</link> *screen,
                                                         const <link linkend="char">char</link> *name);
<link linkend="GnomeRRCrtc">GnomeRRCrtc</link> *       <link linkend="gnome-rr-screen-get-crtc-by-id">gnome_rr_screen_get_crtc_by_id</link>      (<link linkend="GnomeRRScreen">GnomeRRScreen</link> *screen,
                                                         <link linkend="guint32">guint32</link> id);
<link linkend="void">void</link>                <link linkend="gnome-rr-screen-get-ranges">gnome_rr_screen_get_ranges</link>          (<link linkend="GnomeRRScreen">GnomeRRScreen</link> *screen,
                                                         <link linkend="int">int</link> *min_width,
                                                         <link linkend="int">int</link> *max_width,
                                                         <link linkend="int">int</link> *min_height,
                                                         <link linkend="int">int</link> *max_height);
</synopsis>
</refsynopsisdiv>

<refsect1 id="gnome-desktop-gnome-rr-screen.description" role="desc">
<title role="desc.title">Description</title>
<para>
</para>
</refsect1>
<refsect1 id="gnome-desktop-gnome-rr-screen.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GnomeRRScreen" role="typedef">
<title>GnomeRRScreen</title>
<indexterm zone="GnomeRRScreen"><primary>GnomeRRScreen</primary></indexterm>
<programlisting>typedef struct GnomeRRScreen GnomeRRScreen;
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GnomeRRScreenChanged" role="function">
<title>GnomeRRScreenChanged ()</title>
<indexterm zone="GnomeRRScreenChanged"><primary>GnomeRRScreenChanged</primary></indexterm>
<programlisting><link linkend="void">void</link>                (*GnomeRRScreenChanged)             (<link linkend="GnomeRRScreen">GnomeRRScreen</link> *screen,
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>screen</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-rr-screen-new" role="function">
<title>gnome_rr_screen_new ()</title>
<indexterm zone="gnome-rr-screen-new"><primary>gnome_rr_screen_new</primary></indexterm>
<programlisting><link linkend="GnomeRRScreen">GnomeRRScreen</link> *     gnome_rr_screen_new                 (<link linkend="GdkScreen">GdkScreen</link> *screen,
                                                         <link linkend="GnomeRRScreenChanged">GnomeRRScreenChanged</link> callback,
                                                         <link linkend="gpointer">gpointer</link> data,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>screen</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-rr-screen-destroy" role="function">
<title>gnome_rr_screen_destroy ()</title>
<indexterm zone="gnome-rr-screen-destroy"><primary>gnome_rr_screen_destroy</primary></indexterm>
<programlisting><link linkend="void">void</link>                gnome_rr_screen_destroy             (<link linkend="GnomeRRScreen">GnomeRRScreen</link> *screen);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>screen</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-rr-screen-refresh" role="function">
<title>gnome_rr_screen_refresh ()</title>
<indexterm zone="gnome-rr-screen-refresh"><primary>gnome_rr_screen_refresh</primary></indexterm>
<programlisting><link linkend="gboolean">gboolean</link>            gnome_rr_screen_refresh             (<link linkend="GnomeRRScreen">GnomeRRScreen</link> *screen,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
Refreshes the screen configuration, and calls the screen's callback if it
exists and if the screen's configuration changed.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>screen</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GnomeRRScreen"><type>GnomeRRScreen</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara> location to store error, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> TRUE if the screen's configuration changed; otherwise, the
function returns FALSE and a NULL error if the configuration didn't change,
or FALSE and a non-NULL error if there was an error while refreshing the
configuration.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-rr-screen-list-outputs" role="function">
<title>gnome_rr_screen_list_outputs ()</title>
<indexterm zone="gnome-rr-screen-list-outputs"><primary>gnome_rr_screen_list_outputs</primary></indexterm>
<programlisting><link linkend="GnomeRROutput">GnomeRROutput</link> **    gnome_rr_screen_list_outputs        (<link linkend="GnomeRRScreen">GnomeRRScreen</link> *screen);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>screen</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-rr-screen-list-crtcs" role="function">
<title>gnome_rr_screen_list_crtcs ()</title>
<indexterm zone="gnome-rr-screen-list-crtcs"><primary>gnome_rr_screen_list_crtcs</primary></indexterm>
<programlisting><link linkend="GnomeRRCrtc">GnomeRRCrtc</link> **      gnome_rr_screen_list_crtcs          (<link linkend="GnomeRRScreen">GnomeRRScreen</link> *screen);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>screen</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-rr-screen-list-modes" role="function">
<title>gnome_rr_screen_list_modes ()</title>
<indexterm zone="gnome-rr-screen-list-modes"><primary>gnome_rr_screen_list_modes</primary></indexterm>
<programlisting><link linkend="GnomeRRMode">GnomeRRMode</link> **      gnome_rr_screen_list_modes          (<link linkend="GnomeRRScreen">GnomeRRScreen</link> *screen);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>screen</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-rr-screen-list-clone-modes" role="function">
<title>gnome_rr_screen_list_clone_modes ()</title>
<indexterm zone="gnome-rr-screen-list-clone-modes"><primary>gnome_rr_screen_list_clone_modes</primary></indexterm>
<programlisting><link linkend="GnomeRRMode">GnomeRRMode</link> **      gnome_rr_screen_list_clone_modes    (<link linkend="GnomeRRScreen">GnomeRRScreen</link> *screen);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>screen</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-rr-screen-set-size" role="function">
<title>gnome_rr_screen_set_size ()</title>
<indexterm zone="gnome-rr-screen-set-size"><primary>gnome_rr_screen_set_size</primary></indexterm>
<programlisting><link linkend="void">void</link>                gnome_rr_screen_set_size            (<link linkend="GnomeRRScreen">GnomeRRScreen</link> *screen,
                                                         <link linkend="int">int</link> width,
                                                         <link linkend="int">int</link> height,
                                                         <link linkend="int">int</link> mm_width,
                                                         <link linkend="int">int</link> mm_height);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>screen</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>width</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>height</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>mm_width</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>mm_height</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-rr-screen-get-output-by-id" role="function">
<title>gnome_rr_screen_get_output_by_id ()</title>
<indexterm zone="gnome-rr-screen-get-output-by-id"><primary>gnome_rr_screen_get_output_by_id</primary></indexterm>
<programlisting><link linkend="GnomeRROutput">GnomeRROutput</link> *     gnome_rr_screen_get_output_by_id    (<link linkend="GnomeRRScreen">GnomeRRScreen</link> *screen,
                                                         <link linkend="guint32">guint32</link> id);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>screen</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>id</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-rr-screen-get-output-by-name" role="function">
<title>gnome_rr_screen_get_output_by_name ()</title>
<indexterm zone="gnome-rr-screen-get-output-by-name"><primary>gnome_rr_screen_get_output_by_name</primary></indexterm>
<programlisting><link linkend="GnomeRROutput">GnomeRROutput</link> *     gnome_rr_screen_get_output_by_name  (<link linkend="GnomeRRScreen">GnomeRRScreen</link> *screen,
                                                         const <link linkend="char">char</link> *name);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>screen</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>name</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-rr-screen-get-crtc-by-id" role="function">
<title>gnome_rr_screen_get_crtc_by_id ()</title>
<indexterm zone="gnome-rr-screen-get-crtc-by-id"><primary>gnome_rr_screen_get_crtc_by_id</primary></indexterm>
<programlisting><link linkend="GnomeRRCrtc">GnomeRRCrtc</link> *       gnome_rr_screen_get_crtc_by_id      (<link linkend="GnomeRRScreen">GnomeRRScreen</link> *screen,
                                                         <link linkend="guint32">guint32</link> id);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>screen</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>id</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-rr-screen-get-ranges" role="function">
<title>gnome_rr_screen_get_ranges ()</title>
<indexterm zone="gnome-rr-screen-get-ranges"><primary>gnome_rr_screen_get_ranges</primary></indexterm>
<programlisting><link linkend="void">void</link>                gnome_rr_screen_get_ranges          (<link linkend="GnomeRRScreen">GnomeRRScreen</link> *screen,
                                                         <link linkend="int">int</link> *min_width,
                                                         <link linkend="int">int</link> *max_width,
                                                         <link linkend="int">int</link> *min_height,
                                                         <link linkend="int">int</link> *max_height);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>screen</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>min_width</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>max_width</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>min_height</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>max_height</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>

</refentry>
