home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 300-399 / ff304.lzh / Gears / gears.doc < prev    next >
Text File  |  1990-01-10  |  4KB  |  122 lines
  1.                              Amiga Gears
  2.                              Veraion 1.1
  3.                             by Joel Swank
  4.                            October 22, 1989
  5.  
  6. SYNOPSIS:
  7.  
  8.     Gears calculates and displays the gears of a multispeed bicycle.
  9. It works for bicycles with 3 to 21 gear combinitations. Gears opens a
  10. custom screen and window that is slightly larger than normal (640x225).
  11. The Main window has gadgets for entering the data about the bicycle and
  12. space for displaying the results.
  13.  
  14. OPERATION:
  15.  
  16.     The gears icon is set up to automaticaly load and display a sample
  17. gearset. To see this, just double click the gears icon. Then you can
  18. enter your own gearset as follows.
  19.  
  20.     First select the number of gears in the front using the Gears/Front
  21. menu. From one to three gears are allowed. Then select the number of
  22. gears in the rear using the Gears/Rear menu. From three to seven gears
  23. are allowed. Next enter the number teeth on each gear in the string
  24. gadgets in the main window. There is a column for the front and a
  25. column for the rear. Select the wheel diameter units by clicking the
  26. in./mm(inches or millimeters) gadget and enter the wheel diameter in
  27. the string gadget. Finally click the CALC gadget. A table will be
  28. displayed in the main window. The first column is the gear combo
  29. ( 48x17 ). Next column is the calculated effective wheel size in the
  30. selected units for this combination. The next 3 columns give the spacing
  31. from the previous 1, 2, and 3 gears in the table. The  table is sorted by
  32. ascending effective wheel size.
  33.  
  34.     The project menu allows valid gearsets to be saved and loaded in an
  35. ASCII file. You will be presented with RJ's file requester to select your
  36. file. You can also get a hardcopy of the table on the PRT: device using
  37. the PRINT menu selection. There is also a help screen that is an
  38. abbreviated version of this file.
  39.     Version 1.1 now has RJ's color window (colors menuitem) to allow
  40. you to change the screen colors. The color palette is saved in the data
  41. file. Files from Version 1 (without colors) can still be read.
  42.  
  43. ARGUMENTS:
  44.  
  45.     Gears allows several parameters to be specified at startup. These
  46. may be specified on the command line when run from a CLI, or in the
  47. TOOLTYPES array of the Gears icon. You can use the Workbench INFO
  48. menu item to edit the TOOLTYPES array.
  49.  
  50. CLI calling format:
  51.  
  52.    >gears [-i] [-m] [-dnn] filename
  53.  
  54. Parameter meaning:
  55.  
  56.    CLI: -i
  57.    WB:  INCHES=
  58.                   Selects the measurement units of the wheel diameter
  59.         to be inches (the default).
  60.  
  61.    CLI: -m
  62.    WB:  MM=
  63.                   Selects the measurement units of the wheel diameter
  64.         to be millimeters.
  65.  
  66.    CLI: -dnn
  67.    WB:  DIAMETER=nn
  68.                   Selects the wheel diameter.
  69.  
  70.    CLI: filename
  71.    WB:  FILE=filename
  72.                   Selects a gears file to be loaded and displayed at
  73.         startup.
  74.  
  75.    The tooltypes keywords must be in caps and all must be followed
  76. by an equal sign (=). The diameter value and units specifications
  77. are ignored if a file is specified.
  78.  
  79.  
  80. LIMITS:
  81.    Front gears: 10 to 80
  82.    Rear gears: 10 to 40
  83.    Diameter: 1 to 1000
  84.  
  85.  
  86. FILE FORMAT:
  87.  
  88.    Gears produces ASCII text files of gearset data. Each file is a
  89. single line of data composed of data elements separated by commas.
  90. All elements are one to five digit integer numbers, except for the
  91. inches/millimeter indicater. Following is the order of the data:
  92.  
  93.     Number of gears on the front
  94.     Number of gears on the rear
  95.     Diameter of the wheel.
  96.     inches/millimeter indicater (i or m)
  97.     Teeth on each of the front gears
  98.     Teeth on each of the rear gears
  99.     The 8 color register values
  100.  
  101. sample file "12spd.grs":
  102.  
  103. 2,6,27,i,54,45,13,15,17,20,26,32,364,2730,546,4048,4040,3840,384,4095
  104.  
  105.  
  106. FORMULA:
  107.  
  108.       The calculations are made with the following formula:
  109.  
  110.       Number of teeth on the front gear  *  Wheel diameter
  111.     -------------------------------------------------------
  112.                Number of teeth on the rear gear
  113.  
  114. COMPILING:
  115.  
  116.      Gears was developed with the Aztec C compiler. A makefile is
  117. included. It includes the file requester and color window from RJ Mical's
  118. Prosuite package. I have precompiled these into library files (not
  119. included). The screen, window, and gadgets were developed with Power
  120. The gadget images were created as DPaint brush files (included).
  121. Windows 2.0. The Power Windows save files are also included (.pw suffix).
  122.