1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133
|
<chapter id="usage">
<title>Usage</title>
<sect1>
<title>GTK+ GUI</title>
<para>If GTK+>=2.4 is installed on your computer, the configure process will
detect it, and build the GTK+ application.</para>
<para>The GTK+ GUI is designed to be user-friendly, so it should be easy to
use it. To launch this GUI, simply type:</para>
<screen format="linespecific">
# gddccontrol
</screen>
</sect1>
<sect1>
<title>Command line tool</title>
<para>The command line tool is useful for debugging purpose, and to create
automatic scripts.</para>
<note>
<para>We won't present everything you can do with ddccontrol, if you want more
information, type:</para>
<screen format="linespecific">
# ddccontrol -h
</screen>
</note>
<sect2>
<title>Usage example</title>
<para>This example explains how to list all available controls and then
change the brightness parameter.</para>
<sect3>
<title>List available controls</title>
<para>To list available controls, type:</para>
<screen format="linespecific">
# ddccontrol -p
</screen>
<para>This probes for available monitors, then takes the first probed monitor
and lists controls supported by it. This should give you an output like this
(this example uses a Samsung Syncmaster 173P and a nVidia GeForce FX 5700):
</para>
<screen format="linespecific">
ddccontrol version 0.1
Copyright 2004 Oleg I. Vdovikin (oleg-at-cs.msu.su)
Copyright 2004 Nicolas Boichat (nicolas-at-boichat.ch)
This program comes with ABSOLUTELY NO WARRANTY.
You may redistribute copies of this program under the terms of the GNU General Public License.
Device : pci:01:00.0-0
Error while reading write message answer: Bad message
Reading EDID 0x50 failed.
Device : pci:01:00.0-1
Device : pci:01:00.0-2
Detected monitors :
- Device : pci:01:00.0-1
DDC/CI supported : Yes
Monitor Name : Samsung SyncMaster 173P (DVI)
Input type : Digital
(Automatically selected)
- Device : pci:01:00.0-2
DDC/CI supported : Yes
Monitor Name : NEC Multisync 2080UX+
Input type : Analog
Reading EDID and initializing DDC/CI at bus pci:01:00.0-1...
Device : pci:01:00.0-1
EDID readings:
Plug and Play ID: SAM00E2 [Samsung SyncMaster 173P (DVI)]
Input type: Digital
= Samsung SyncMaster 173P (DVI)
> Color settings
> Brightness and Contrast
<emphasis>> id=brightness, name=Brightness, address=0x10, delay=-1ms, type=0
supported, value=55, maximum=100</emphasis>
> id=contrast, name=Contrast, address=0x12, delay=-1ms, type=0
supported, value=60, maximum=100
> id=magicbright, name=Magic Bright Mode, address=0xdc, delay=-1ms, type=2
Possible values:
> id=text - name=Text, value=1
> id=internet - name=Internet, value=2
> id=entertain - name=Entertain, value=3
> id=custom - name=Custom, value=4
supported, value=4, maximum=4
> Others
> Restore defaults
> id=defaults, name=Restore Factory Defaults, address=0x4, delay=-1ms, type=1
Possible values:
> id=default - name=Restore Factory Defaults, value=1
supported, value=0, maximum=1
> id=defaultluma, name=Restore Brightness and Contrast, address=0x5, delay=-1ms, type=1
Possible values:
> id=default - name=Restore Brightness and Contrast, value=1
supported, value=0, maximum=1
> id=settings, name=Settings, address=0xb0, delay=-1ms, type=1
Possible values:
> id=store - name=Save Current Settings, value=1
> id=restorefactory - name=Restore Factory Settings, value=2
supported, value=0, maximum=2
> Input settings
> id=inputsource, name=Input Source Select, address=0x60, delay=-1ms, type=2
Possible values:
> id=analog - name=Analog, value=1
> id=digital - name=Digital, value=3
supported, value=3, maximum=3
> Power control
> id=dpms, name=DPMS Control, address=0xd6, delay=-1ms, type=2
Possible values:
> id=on - name=On, value=1
> id=standby - name=Standby, value=4
supported, value=1, maximum=4
</screen>
</sect3>
<sect3>
<title>Change the brightness</title>
<para>The lines concerning brightness in the available controls list are:</para>
<screen format="linespecific">
> id=brightness, name=Brightness, <emphasis>address=0x10</emphasis>, delay=-1ms, type=0
supported, <emphasis>value=55</emphasis>, <emphasis>maximum=100</emphasis>
</screen>
<para>The important elements are address (here:
<computeroutput>0x10</computeroutput>), current value
(<computeroutput>55</computeroutput>) and maximum value
(<computeroutput>100</computeroutput>).</para>
<para>To change the brightness value to 70/100, type:</para>
<screen format="linespecific">
ddccontrol -p -r <userinput>0x10</userinput> -w <userinput>70</userinput>
</screen>
The last lines of the output should be:
<screen format="linespecific">
Writing 0x10, 0x46(70)...
Control 0x10: +/70/100 [Brightness]
</screen>
</sect3>
</sect2>
</sect1>
</chapter>
|