summaryrefslogtreecommitdiff
path: root/src/org.freedesktop.UPower.KbdBacklight.xml
blob: 3ccc211359a0ba87b16421b9a6101c7c3d5868d4 (plain)
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
<!DOCTYPE node PUBLIC
"-//freedesktop//DTD D-BUS Object Introspection 1.0//EN"
"http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd" [
  <!ENTITY ERROR_GENERAL "org.freedesktop.UPower.GeneralError">
]>
<node name="/" xmlns:doc="http://www.freedesktop.org/dbus/1.0/doc.dtd">
  <interface name="org.freedesktop.UPower.KbdBacklight">
    <doc:doc>
      <doc:description>
        <doc:para>
          org.freedesktop.UPower.KbdBacklight is a DBus interface implimented
          by UPower.
	  It allows the keyboard backlight (if present) to be controlled.
        </doc:para>
      </doc:description>
    </doc:doc>

    <!-- ************************************************************ -->
    <method name="GetMaxBrightness">
      <arg name="value" direction="out" type="i">
        <doc:doc>
          <doc:summary>
            The maximum value of the keyboard backlight brightness.
          </doc:summary>
        </doc:doc>
      </arg>
      <doc:doc>
        <doc:description>
          <doc:para>
            Get the maximum brightness level for the keyboard backlight.
          </doc:para>
        </doc:description>
        <doc:errors>
          <doc:error name="&ERROR_GENERAL;">if an error occured while getting the maximum brightness</doc:error>
        </doc:errors>
      </doc:doc>
    </method>

    <!-- ************************************************************ -->
    <method name="GetBrightness">
      <arg name="value" direction="out" type="i">
        <doc:doc>
          <doc:summary>
            The current value of the keyboard backlight brightness.
          </doc:summary>
        </doc:doc>
      </arg>
      <doc:doc>
        <doc:description>
          <doc:para>
            Get the brightness level of the keyboard backlight.
          </doc:para>
        </doc:description>
        <doc:errors>
          <doc:error name="&ERROR_GENERAL;">if an error occured while getting the brightness</doc:error>
        </doc:errors>
      </doc:doc>
    </method>

    <!-- ************************************************************ -->
    <method name="SetBrightness">
      <arg name="value" direction="in" type="i">
        <doc:doc>
          <doc:summary>
            The value to set the KbdBacklight brightness.
          </doc:summary>
        </doc:doc>
      </arg>
      <doc:doc>
        <doc:description>
          <doc:para>
            Set the brightness level of the keyboard backlight.
          </doc:para>
        </doc:description>
        <doc:errors>
          <doc:error name="&ERROR_GENERAL;">if an error occured while setting the brightness</doc:error>
        </doc:errors>
      </doc:doc>
    </method>

    <!-- ************************************************************ -->
    <signal name="BrightnessChanged">
      <arg name="value" direction="out" type="i">
        <doc:doc>
          <doc:summary>
            The new brightness value of the keyboard backlight.
          </doc:summary>
        </doc:doc>
      </arg>
      <doc:doc>
        <doc:description>
          <doc:para>
	    The keyboard backlight brightness level has changed.
          </doc:para>
        </doc:description>
      </doc:doc>
    </signal>

  </interface>

</node>