home *** CD-ROM | disk | FTP | other *** search
/ PC World 2000 February / PCWorld_2000-02_cd.bin / live / usr / X11R6 / lib / X11 / xodomm.a < prev   
Text File  |  1998-02-17  |  8KB  |  201 lines
  1. !<arch>
  2. xodo.mm/        820946896   0     100   100600  7506      `
  3.  
  4. xodometer
  5.  
  6.     Track the total distance your pointing device and cursor
  7.     travel.  The distance can be displayed in various units.
  8.  
  9.     xodometer displays total distance and "trip" distance
  10.     since the application started (or since you clicked on
  11.     a trip reset button).
  12.  
  13.     xodometer requires certain information to ensure
  14.     accurate distance tracking.  Refer to the following
  15.     sections to learn about calibrating xodometer, and to
  16.     view a list of tested configurations.
  17.  
  18.     xodometer is typically started from the .xinitrc file.
  19.     Use the left button for selections.  Use the middle
  20.     button to reset both trip odometers simultaneously.
  21.  
  22.     Every xodometer command line parameter can have an
  23.     application resource in the xrdb database or .Xdefaults
  24.     file.  A resource follows this convention:
  25.  
  26.       xodo.parameter_name : parameter_value
  27.  
  28.     Therefore to specify xodometer's default font the
  29.     following resource entry could be specified:
  30.  
  31.       xodo.fontname : Rom8
  32.  
  33.     For further help try xodo -full_help.
  34.  
  35.     Examples:
  36.  
  37.       xodo -bd red -bg wheat1 -fg blue -g -0-0
  38.  
  39.       xodo -fn rom6 -o cursor -dwm 300 -dhm 234 
  40.  
  41.  
  42.     CALIBRATION
  43.  
  44.     xodometer requires the display dimensions in both pixels
  45.     and millimeters in order to correctly compute distances.
  46.     Look for this information in the appropriate hardware 
  47.     reference manual for your display.  If you cannot find
  48.     this information it's still easy to determine.  For the
  49.     display dimensions in pixels simply run xodometer, jam
  50.     the cursor in the bottom-right corner and note the X/Y
  51.     coordinates displayed at the bottom of the window - add
  52.     one to get the actual pixel count.  For the display
  53.     dimensions in millimeters just grab a tape measure and
  54.     measure your screen - if inches multiply by 25.4 and if
  55.     centimeters multiply by 10.  Select "About" and    verify
  56.     that xodometer is calibrated properly by using a ruler
  57.     to measure the calibration scale.  The default values
  58.     for these dimensions are suitable for an IBM RS/6000
  59.     machine with a 6091 19" color monitor.  Refer to the
  60.     next section for values of other tested    configurations.
  61.  
  62.     Assuming that the display dimension data is correct the
  63.     cursor distance can be accurately tracked.  The actual
  64.     distance that your pointing device, typically a mouse,
  65.     travels is INFERRED by accleration information provided
  66.     by the X server and pointer scaling information that
  67.     you must provide.  The default scale factor is 3.4,
  68.     meaning that the cursor travels 3.4 times as far as the
  69.     pointing device moves. This value is appropriate for an
  70.     IBM RS/6000 machine with a 6091 19" color monitor.
  71.     Refer to the next section for values of other tested
  72.     configurations.
  73.  
  74.     If you cannot find the correct scale factor for your
  75.     mouse then you must determine it by measuring.  It is
  76.     rather easy to do this:  first enter "xset m 1 1" to
  77.     set the X threshold and    acceleration to 1, then enter
  78.     "xodo -psf 1.0" to set xodometer's pointer scale factor
  79.     also to 1.  Once xodo is running pull-down the Units
  80.     menu and select "inches".  Then, using a ruler, place
  81.     the pointing device against one edge, click the second
  82.     button to reset the trip odometers, and then trace a
  83.     known distance, say, one inch.  The distance recorded
  84.     by the pointer's trip odometer is the proper scaling
  85.     factor.  Repeat the measurement several times for
  86.     accuracy.
  87.  
  88.     At the bottom of the xodometer window is a status line
  89.     that displays the current distance Units and the X/Y
  90.     cordinates of the cursor.  In the "About" window the
  91.     pointer    Scale factor, and the X Threshold and
  92.     Acceleration are displayed.
  93.  
  94.     All the calibration information you supply is either
  95.     passed on the command line, stored in environment
  96.     variables, or placed in your .Xdefaults file.  The
  97.     applicable environment variables are:
  98.     
  99.       D_XODO_DWM    display_width_millimeters
  100.       D_XODO_DHM    display_height_millimeters
  101.       D_XODO_DWP    display_width_pixels
  102.       D_XODO_DHP    display_height_pixels
  103.       D_XODO_PSF    pointer_scale_factor
  104.  
  105.  
  106.         TESTED CONFIGURATIONS    
  107.  
  108.     For each machine, Operating System/window manager and
  109.     display configuration, a sample xodometer command line
  110.     is given:
  111.  
  112.     - Pentium-100, Linux 1.2.13/fvmw, 15" color
  113.       xodo -dwm 286 -dhm 203 -dwp 1024 -dhp 768  -psf 3.0
  114.  
  115.     - IBM RS/6000, AIX 3.2.3/mwm, 16" color
  116.       xodo -dwm 300 -dhm 234 -dwp 1280 -dhp 1024 -psf 3.0
  117.  
  118.     - IBM RS/6000, AIX 3.2.3/mwm, 19" color
  119.       xodo -dwm 350 -dhm 274 -dwp 1280 -dhp 1024 -psf 3.4
  120.  
  121.     - IBM RS/6000, AIX 3.2.3/mwm, 23" color
  122.       xodo -dwm 430 -dhm 340 -dwp 1280 -dhp 1024 -psf 4.0
  123.  
  124.     - Sun SPARC 1+, SunOS 4.1.1/twm, 17" monochrome
  125.       xodo -dwm 292 -dhm 232 -dwp 1152 -dhp  900 -psf 2.0      
  126.  
  127.     - Sun SPARC 1+, SunOS 4.1.1/twm, 19" color
  128.       xodo -dwm 358 -dhm 274 -dwp 1152 -dhp  900 -psf 4.0      
  129. .display
  130.     The X display name; default is the DISPLAY variable.
  131. .display_width_millimeters
  132.     The width in millimeters of the X display.  The default
  133.     is 350 mm (an IBM 6091 19" color monitor).
  134. .display_height_millimeters
  135.     The height in millimeters of the X display.  The default
  136.     is 274 mm (an IBM 6091 19" color monitor).
  137. .display_width_pixels
  138.     The width of the X display in pixels.  The default
  139.     is 1280 pixels (an IBM 6091 19" color monitor).
  140. .display_height_pixels
  141.     The height of the X display in pixels.  The default
  142.     is 1024 pixels (an IBM 6091 19" color monitor).
  143. .pointer_scale_factor
  144.     The scale factor to convert pointer movement to cursor
  145.     movement.  A scale factor of 2.0 means that for every D
  146.     units of distance the pointing device moves, the cursor
  147.     moves 2 * D units.  The default is 3.4, suitable for an
  148.     IBM 6091 19" color monitor.
  149. .border
  150.     xodometer's border color.
  151. .background
  152.     xodometer's background color.
  153. .foreground
  154.     xodometer's foreground color.
  155. .fontname
  156.     xodometer's odometer font.  An extremely small font
  157.     is "rom6" while a rather large font is "helvr30".
  158. .fontname2
  159.     xodometer's button font.  In general you should NOT
  160.     change this font since the action buttons do not
  161.     change size.  Another suitable font is "Rom8", but
  162.     that is not available on all X servers.
  163. .geometry
  164.     Specifies the X geometry in the standard notation.
  165.     The width and height are not normally specified since
  166.     xodometer calculates them based on the fontname.  If
  167.     an "offset" value is positive it is measured from the
  168.     top or left edge of the display, and if negative it is
  169.     measured from the bottom or right edge of the screen.
  170.     So, to start xodometer in the bottom-right corner a
  171.     geometry string of "-0-0" would be specified.
  172. .iconic
  173.     If specified xodometer starts up already iconified.
  174. .microsecond_interval_time
  175.     The number of microseconds between odometer updates.  The
  176.     default value of 100,000 means that the pointer position
  177.     is sampled 10 times per second, which seems to provide
  178.     accurate distance measurements without consuming
  179.     excessive amounts of your machine's resources.
  180. .odometer
  181.     A keyword that specifies whether to display both
  182.     odometers, or just one of them, and if just one,
  183.     which one.
  184. .odometer_file
  185.     The path name of the file to record total mouse distance
  186.     (in millimeters) and other application information.  This
  187.     file is read during xodometer startup to initialize the
  188.     distance totals and establish the distance units.  When
  189.     you "Quit" xodometer the updated distance/unit data is
  190.     written to this file.
  191. .odometer_autosave_time
  192.     Specifies the time interval in minutes between odometer
  193.     file updates.  This is just for good luck, as xodometer
  194.     updates the odometer file when these event are received:
  195.  
  196.       - control/c
  197.       - window close
  198.       - window manager exit
  199. .title
  200.     The xodometer window title line.
  201.