Usage

Watch the icons to tell the state of any of the keyboard leds.

Right-clicking on the applet brings up a menu containing the following items:

• Properties... — opens the Properties dialog.

• Help — displays this document.

• About... — shows basic information about Keyboard Led Applet, including the applet's version and the author's name.

Customization

You can customize Keyboard Led applet by right-clicking on it and choosing Properties.... This will open the Properties dialogs General tab (shown in Figure 3), which allows you to change the geometry of the applet.

The properties in the General tab are:

• Use default settings? -- if this is checked, the applets default settings (as set on compile time) will be used.

• Minimum width -- if this is checked, you will be allowed to set a minimum width for a single icon regardless of the panel size. (Note: the width may or may not be correlated to the panel size.) If not set, the width will be dicated by the panel size (equal to panel size on vertical panels, and by reversed aspect ratio from width on horizontal panels).

• Maximum width -- if this is checked, you will be allowed to set a maximum width for a single icon regardless of the panel size. (Note: the height may or may not be correlated to the panel size.) If not set, the height will be dicated by the panel size (by aspect ratio from width on vertical panels, and equal to panel size on horizontal panels).

• Aspect ratio -- Relationship between width and height.

• Optimize space-usage -- if this is checked the applet will try to stack the icon(s) in the opposite orientation of the panel to minimize space-usage. Success is based on panel size, maximum width & height, aspect ratio, and number of icons to display.

• Display Num-, Caps- or Scroll Lock -- if one of these is checked, the corresponding led-icon will show on the applet. Note: the applet requires at least one of the three led-icons to be displayed.

The Properties dialogs Images tab (shown in Figure 4), allows you to change the images on the icons of the applet.

Disable default settings on the General tab, and you will be allowed to set an image for each of the three led-icons in either on or off state.

After you have made all the changes you want, click on OK to apply the changes and close the Properties dialog. To apply the changes without closing the Properties dialog, click on Apply. To cancel the changes and return to previous values, click the Close button.

Known Bugs and Limitations

This applet has no known bugs. Do you know of any? :-)

Authors

Keyboard Led was written by Ørjan Nygaard Austvold (<austvold@acm.org>). Please send any comments, suggestions, and bug reports to the GNOME bug tracking database. (Instructions for submitting bug reports can be found on-line. If you are using GNOME 1.1 or later, you can also use Bug Report Tool (bug-buddy), available in the Utilities submenu of Main Menu, for submitting bug reports.

This manual was written by Ørjan Nygaard Austvold (<austvold@acm.org>). Please send all comments and suggestions regarding this manual to the GNOME Documentation Project by sending an email to <docs@gnome.org>. You can also submit comments online by using the GNOME Documentation Status Table.

License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

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 GNU General Public License for more details.

A copy of the GNU General Public License is included as an appendix to the GNOME Users Guide. You may also obtain a copy of the GNU General Public License from the Free Software Foundation by visiting their Web site or by writing to

     Free Software Foundation, Inc.
     59 Temple Place - Suite 330
     Boston, MA 02111-1307
     USA