<HTML
><HEAD
><TITLE
>Odometer Applet</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.54"></HEAD
><BODY
CLASS="ARTICLE"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="ARTICLE"
><DIV
CLASS="TITLEPAGE"
><H1
CLASS="TITLE"
><A
NAME="AEN2"
>Odometer Applet</A
></H1
><P
CLASS="COPYRIGHT"
><A
HREF="ln7.html"
>Copyright</A
> &copy; 2000 by <SPAN
CLASS="HOLDER"
>Arjan Scherpenisse</SPAN
></P
><HR
WIDTH="75%"
ALIGN="CENTER"
COLOR="#000000"
SIZE="1"></DIV
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="index.html#ODOMETER"
>Odometer Applet</A
></DT
></DL
></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="ODOMETER"
>Odometer Applet</A
></H1
><P
>    The GNOME panel <TT
CLASS="APPLICATION"
>Odometer</TT
> applet, shown in <A
HREF="index.html#ODOMETER-APPLET-FIG"
>Figure 1</A
> is an applet which tracks and measures the
     movements of your mouse pointer across the desktop. It is part of the
     gnome-applets package. To add this
      applet to a <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>, 
      right-click on the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> and choose
      <B
CLASS="GUIMENU"
>Panel</B
>-&gt;<B
CLASS="GUISUBMENU"
>Add to panel</B
>-&gt;<B
CLASS="GUISUBMENU"
>Applet</B
>-&gt;<B
CLASS="GUISUBMENU"
>Amusements</B
>-&gt;<B
CLASS="GUIMENUITEM"
>Odometer</B
>.
  </P
><DIV
CLASS="FIGURE"
><A
NAME="ODOMETER-APPLET-FIG"
></A
><P
><IMG
SRC="odometer_applet.png"></P
><P
><B
>Figure 1. Odometer Applet</B
></P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="ODOMETER-USAGE"
>Usage</A
></H2
><P
>      Once it is present, you don't need to do anything to the odometer.
      It just sits quietly in your panel and keeps track of all your mouse movements.
      In addition, moving the mouse pointer over the odometer produces
      a <TT
CLASS="GUILABEL"
><B
>tooltip</B
></TT
> telling you whether the distance 
      is expressed in metric units (centimeters, meters, kilometers)
      of in feet (inches, feet, miles).
      The upper value indicates your total trip distance,
      and the lower value is the partial trip distance, that 
      can be resetted at will.
    </P
><P
>      Right-clicking on the applet brings up a menu containing the
      following items:
      <P
></P
><UL
><LI
><P
>	    <B
CLASS="GUIMENUITEM"
>Reset</B
> &#8212;
	    This resets the odometer applet to zero again.
	  </P
></LI
><LI
><P
>	    <B
CLASS="GUIMENUITEM"
>Properties&#8230;</B
> &#8212;
	    opens the <A
HREF="index.html#ODOMETER-PREFS"
>	      <TT
CLASS="GUILABEL"
><B
>Properties</B
></TT
></A
> dialog.
	  </P
></LI
><LI
><P
>	    <B
CLASS="GUIMENUITEM"
>Help</B
> &#8212;
	    displays this document.
	  </P
></LI
><LI
><P
>	    <B
CLASS="GUIMENUITEM"
>About&#8230;</B
> &#8212;
	    shows basic information about <TT
CLASS="APPLICATION"
>odometer
	      Applet</TT
>, including the applet's version and the
	    author's name.
	  </P
></LI
></UL
>
    </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="ODOMETER-PREFS"
>Customization</A
></H2
><P
>      You can customize <TT
CLASS="APPLICATION"
>odometer</TT
>
      applet by right-clicking on it and choosing
      <B
CLASS="GUIMENUITEM"
>Properties&#8230;</B
>. This will open the
      <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog(shown in <A
HREF="index.html#ODOMETER-SETTINGS-FIG"
>Figure 2</A
>), which allows you to
	change various settings.
    </P
><P
>      The <SPAN
CLASS="INTERFACE"
>properties dialog box</SPAN
> (which calls
      itself "Odometer setting" rather than properties) is divided into
      two sections, one for general options, and one for themes.
      
      <P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>General</DT
><DD
><DIV
CLASS="FIGURE"
><A
NAME="ODOMETER-SETTINGS-FIG"
></A
><P
><IMG
SRC="odometer_settings.png"></P
><P
><B
>Figure 2. Properties dialog (general preferences tab)</B
></P
></DIV
><P
>	      The <TT
CLASS="GUILABEL"
><B
>general preferences tab</B
></TT
>, shown in <A
HREF="index.html#ODOMETER-SETTINGS-FIG"
>Figure 2</A
>, has four options:
	    </P
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>Use metric</DT
><DD
><P
>		    If the <B
CLASS="GUIBUTTON"
>use metric checkbox</B
> is checked,
                    mouse pointer distance travelled is shown in meters 
                    (centimeters, meters, and kilometers) . If it
                    is not checked, the distance travelled is shown in feet
                    (inches, feet and miles). By
		    moving the pointer over the odometer you can produce a 
		    <TT
CLASS="GUILABEL"
><B
>tooltip</B
></TT
> which shows you whether it is
		    currently displaying meters or feet.
		  </P
></DD
><DT
>auto_reset</DT
><DD
><P
>		    If the <B
CLASS="GUIBUTTON"
>auto_reset checkbox</B
> is checked,
                    the odometer numbers return to zero each time it's
                    started or each time the session is started. This allows
                    you to display your daily mouse trip distance if you
                    used to restart you gnome session every morning.
		  </P
></DD
><DT
>enabled</DT
><DD
><P
>		    If the <B
CLASS="GUIBUTTON"
>enabled checkbox</B
> is checked, then
		    the odometer will keep counting how far you have moved your
		    pointer. If not, it will return the numbers to zero until you
		    re-enable it.
		  </P
></DD
><DT
>digits number</DT
><DD
><P
>		    The <B
CLASS="GUIBUTTON"
>digits number field</B
> determines how
		    many digits the odometer will display. The default is four, and
		    the range is from 1 to 10.
		  </P
></DD
></DL
></DIV
></DD
><DT
>Theme</DT
><DD
><DIV
CLASS="FIGURE"
><A
NAME="ODOMETER-THEMES-FIG"
></A
><P
><IMG
SRC="odometer_themes.png"></P
><P
><B
>Figure 3. Properties dialog (theme preferences tab)</B
></P
></DIV
><P
>	      The <TT
CLASS="GUILABEL"
><B
>theme preferences tab</B
></TT
>, shown in <A
HREF="index.html#ODOMETER-THEMES-FIG"
>Figure 3</A
>, has a variety of
	      themes you can choose from. They are found by default in 
	      <TT
CLASS="FILENAME"
>$PREFIX/odometer/</TT
>.
	    </P
></DD
></DL
></DIV
>
    </P
><P
> 
      After you have made all the changes you want, click on
      <B
CLASS="GUIBUTTON"
>OK</B
> to apply the changes and close the
      <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog. To cancel the changes
      and return to previous values, click the
      <B
CLASS="GUIBUTTON"
>Close</B
> button.
    </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="BUGS"
>Known Bugs and Limitations</A
></H2
><P
>      This applet has no known bugs.
    </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AUTHORS"
>Authors</A
></H2
><P
>      The <TT
CLASS="APPLICATION"
>odometer applet</TT
> was written by
      Fabrice Bellet (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:Fabrice.Bellet@creatis.insa-lyon.fr"
>Fabrice.Bellet@creatis.insa-lyon.fr</A
>&#62;</TT
>),
      and based on the <TT
CLASS="APPLICATION"
>Mouspedometa</TT
> for KDE by
      Armen Nakashian, which in turn was based on the
      Motif-based <TT
CLASS="APPLICATION"
>Xodometer</TT
> by Mark H. Granoff.
      Please send all comments,
      suggestions, and bug 
      reports to the <A
HREF="http://bugs.gnome.org"
TARGET="_top"
>GNOME
      bug tracking database</A
>. (Instructions for submitting bug
      reports can be found <A
HREF="http://bugs.gnome.org/Reporting.html"
TARGET="_top"
>      on-line</A
>.) If you are using
      GNOME 1.1 or later, you can also use <TT
CLASS="APPLICATION"
>Bug Report
      Tool</TT
> (<B
CLASS="COMMAND"
>bug-buddy</B
>), available in the
      <B
CLASS="GUISUBMENU"
>Utilities</B
> submenu of <B
CLASS="GUIMENU"
>Main
      Menu</B
>, for submitting bug reports.
    </P
><P
>      This manual was written by Arjan Scherpenisse
      (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:acscherp@wins.uva.nl"
>acscherp@wins.uva.nl</A
>&#62;</TT
>). Please send all comments and
      suggestions regarding this manual to the <A
HREF="http://www.gnome.org/gdp"
TARGET="_top"
>GNOME Documentation Project</A
> 
      by sending an email to <TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:docs@gnome.org"
>docs@gnome.org</A
>&#62;</TT
>. You can also
      submit comments online by using the <A
HREF="http://www.gnome.org/gdp/doctable/"
TARGET="_top"
>GNOME Documentation Status
	Table</A
>.
    </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="LICENSE"
>License</A
></H2
><P
>      This program is free software; you can redistribute it and/or
      modify it under the terms of the <I
CLASS="CITETITLE"
>GNU General Public
	License</I
> 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
      <I
CLASS="CITETITLE"
>GNU General Public License</I
> for more details.
    </P
><P
>      A copy of the <I
CLASS="CITETITLE"
>GNU General Public License</I
> is
      included as an appendix to the <I
CLASS="CITETITLE"
>GNOME Users
	Guide</I
>.  You may also obtain a copy of the
      <I
CLASS="CITETITLE"
>GNU General Public License</I
> from the Free
      Software Foundation by visiting <A
HREF="http://www.fsf.org"
TARGET="_top"
>their Web site</A
> or by writing to
      <P
CLASS="ADDRESS"
>	Free&nbsp;Software&nbsp;Foundation,&nbsp;Inc.<br>
	<SPAN
CLASS="STREET"
>59 Temple Place</SPAN
>&nbsp;-&nbsp;Suite&nbsp;330<br>
	<SPAN
CLASS="CITY"
>Boston</SPAN
>,&nbsp;<SPAN
CLASS="STATE"
>MA</SPAN
>&nbsp;<SPAN
CLASS="POSTCODE"
>02111-1307</SPAN
><br>
	<SPAN
CLASS="COUNTRY"
>USA</SPAN
><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</P
>
    </P
></DIV
></DIV
></DIV
></BODY
></HTML
>