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
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>Armada Backlight Controller</title>
</head>
<body>
<h1><img src="logo.png" align="left">Armada Backlight Controller</h1>
<p>
The Armada Backlight Controller is a program for controlling the
brightness of the LCD backlight on
<a href="http://www.compaq.com">Compaq</a>
<a href="http://www.compaq.com/products/notebooks/">Armada laptops</a>
under Linux.
It has been tested on an Armada M700 running
<a href="http://www.redhat.com">Red Hat Linux 7.2</a>.
It is based on code by
<a href="http://www.acher.org">George Acher</a>, which was written for
the M300 and has been used on the E500. This package should also
work on those machines, although that has not been tested by Nat Pryce,
who put this modified package together.
</p>
<p> The package is divided into two parts:</p>
<ol>
<li>A <a href="#CLI">command-line program</a> that is installed with
privileges that allow it to control the backlight hardware
(aka an "suid" program).</li>
<li>A <a href="#GNOMEApplet">GNOME panel applet</a> that provides a
convenient GUI to the command-line program.</li>
</ol>
<p>
An alternative way of using the command-line program is to configure
your X window manager to run it in response to key sequences such
as Alt-F10 to make the screen brighter and Alt-Shift-F10 to make the
screen dimmer. (The F10 key has a brightness icon on it, which makes
it appropriate for this function.)
</p>
<h2>License</h2>
<p>
This program is free software; you can redistribute it and/or modify
it under the terms of the
<a href="http://www.fsf.org/licenses/gpl.html">GNU General Public License</a>
as published by the Free Software Foundation; either version 2 of
the License, or (at your option) any later version.
</p>
<p>
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
<a href="http://www.fsf.org/licenses/gpl.html">GNU General Public License</a>
for more details.
</p>
<!--
<h2>Download</h2>
<p>Armada Backlight is available in source code form as a GZipped TAR file.
The latest version is 1.1.
</p>
<ul>
<li><a href="armada-backlight-1.1.tar.gz">Version 1.1</a>.
<li><a href="armada-backlight-1.0.tar.gz">Version 1.0</a>.
</ul>
<h2>Installation</h2>
<p>
The following process will install the armada-backlight and
armada-backlight-applet programs in the directory used for
GNOME binaries.
</p>
<ol>
<li>Extract the archive. This will create a directory named
"armada-backlight"</li>
<li>Cd to the "armada-backlight/src" directory.</li>
<li>Type "make install"
</ol>
-->
<h2 id="GNOMEApplet">GNOME Panel Applet</h2>
<p>
The Armada Backlight Controller applet is installed into the Utility
category of the GNOME Applets menu.
</p>
<p>
<img src="menu.png">
</p>
<p>
When added to the panel, the applet presents a scrollbar that can be
used to interactively control the brightness of the backlight and also
shows the current level numerically. The icon identifies the applet
in the panel and can be used to access the applet menu using the
right mouse button.
</p>
<p>
<img src="applet.png">
</p>
<h2 id="CLI">Command Line Controller</h2>
<p>Usage:</p>
<p><code>armada-backlight [+|-|<var>value</var>|--help]</code></p>
<p>Options:</p>
<table>
<tr>
<td>None</td>
<td>Prints the current brightness level to stdout.</td>
</tr>
<tr>
<td><code>+</code></td>
<td>Increases the brightness of the backlight.</td>
</tr>
<tr>
<td><code>-</code></td>
<td>Decreases the brightness of the backlight.</td>
</tr>
<tr>
<td><var>value</var></td>
<td>Sets the brightness of the backlight.
<var>Value</var> must be between 0 and 8, inclusive.</td>
</tr>
<tr>
<td><code>--help</code></td>
<td>Prints usage information to stderr.</td>
</tr>
</table>
<hr>
<!-- Created: Fri Apr 26 12:29:00 BST 2002 -->
<!-- hhmts start -->
Last modified: Fri May 24 12:24:57 BST 2002
<!-- hhmts end -->
</body>
</html>
|