File: usage.xml

package info (click to toggle)
ddccontrol 1.0.3-1
  • links: PTS, VCS
  • area: main
  • in suites: sid, trixie
  • size: 1,092 kB
  • sloc: ansic: 6,696; xml: 1,841; makefile: 155; sh: 116; sed: 16
file content (133 lines) | stat: -rw-r--r-- 5,047 bytes parent folder | download
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+&gt;=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)
&gt; Color settings
   &gt; Brightness and Contrast
      <emphasis>&gt; id=brightness, name=Brightness, address=0x10, delay=-1ms, type=0
        supported, value=55, maximum=100</emphasis>
      &gt; id=contrast, name=Contrast, address=0x12, delay=-1ms, type=0
        supported, value=60, maximum=100
      &gt; id=magicbright, name=Magic Bright Mode, address=0xdc, delay=-1ms, type=2
        Possible values:
         &gt; id=text - name=Text, value=1
         &gt; id=internet - name=Internet, value=2
         &gt; id=entertain - name=Entertain, value=3
         &gt; id=custom - name=Custom, value=4
        supported, value=4, maximum=4
&gt; Others
   &gt; Restore defaults
      &gt; id=defaults, name=Restore Factory Defaults, address=0x4, delay=-1ms, type=1
        Possible values:
         &gt; id=default - name=Restore Factory Defaults, value=1
        supported, value=0, maximum=1
      &gt; id=defaultluma, name=Restore Brightness and Contrast, address=0x5, delay=-1ms, type=1
        Possible values:
         &gt; id=default - name=Restore Brightness and Contrast, value=1
        supported, value=0, maximum=1
      &gt; id=settings, name=Settings, address=0xb0, delay=-1ms, type=1
        Possible values:
         &gt; id=store - name=Save Current Settings, value=1
         &gt; id=restorefactory - name=Restore Factory Settings, value=2
        supported, value=0, maximum=2
   &gt; Input settings
      &gt; id=inputsource, name=Input Source Select, address=0x60, delay=-1ms, type=2
        Possible values:
         &gt; id=analog - name=Analog, value=1
         &gt; id=digital - name=Digital, value=3
        supported, value=3, maximum=3
   &gt; Power control
      &gt; id=dpms, name=DPMS Control, address=0xd6, delay=-1ms, type=2
        Possible values:
         &gt; id=on - name=On, value=1
         &gt; 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">
      &gt; 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>