home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / new / misc / math / cp / cp.doc < prev    next >
Text File  |  1994-05-01  |  11KB  |  291 lines
  1. /*****************************************************************************/
  2. /*****************************************************************************/
  3.       cP Ver 4.2  by Chris Conger
  4.       April 30, 1994
  5. /*****************************************************************************/
  6. /*****************************************************************************/
  7.  
  8.  Whats New?
  9.  
  10. 4.2)
  11.   cP now stores all its numbers as double precision
  12.   CrossHair feature for Identify Measurements
  13.   Identify/CrossHair option can have significant digits set by menu/CLI/ENV
  14.   Position Locking for CrossHair with spacebar
  15.   Single column data will load with x = line number.
  16.   Old draw break criterion changed to Realtime option (see below)
  17.   Distribution now includes 020/881 version again by request
  18.   Fixes bug where endless loop could occur when clicking grid if no sets were
  19.     ever loaded
  20. 4.1)
  21.   Fixes enforcer hits during Workbench launch (I don't do that very often)
  22. 4.0) 
  23.   Arexx, Printing, Better redraw, and lots of other stuff
  24.  
  25. /*****************************************************************************/
  26. /*****************************************************************************/
  27.  
  28. cP is a DATA PLOTTING PROGRAM capable of plotting TWO DIMENSIONAL DATA in both
  29. LINEAR or LOG space. The program runs from the CLI or from Workbench and
  30. REQUIRES KICKSTART 37 or higher to run. There is no limit to the number of
  31. points that the program can load except the amount of ram on your system.
  32. There is also no limit to the number of sets. cP creates a  PUBLIC SCREEN,
  33. so you can open other applications on its' screen. This version of cP sports
  34. an AREXX interface for almost any function.
  35.  
  36. /*****************************************************************************/
  37.  
  38. EXAMPLE COMMAND:
  39.  
  40.       > CP SAMPLE.#?
  41.  
  42. /*****************************************************************************/
  43.  
  44. cP reads an ENVIRONMENTAL VARIABLE at startup which can be used to change the
  45. default values of the settings. The NAME of the var is CPCONFIG. Any options
  46. given on the command line will override the environmental variable.
  47.  
  48.     EX:
  49.       > setenv cpconfig "ID=32768 FONT helvetica SIZE 9 GRID SETDEF W=1000"
  50.  
  51. /*****************************************************************************/
  52. /*****************************************************************************/
  53.  
  54. The template for BOTH command line and envvar is:
  55.  
  56. FILES=WILD/M,LX=LOGX/S,LY=LOGY/S,GRID/S,SYM/S,ID=DISPLAYID/N/K,FONT/K,FS=SIZE/N/K
  57. LORES/S,HIRES/S,LACE/S,SETDEF/S,W=WIDTH/N/K,H=HEIGHT/N/K,P=POINTS/N/K,T=THIN/N/K
  58. D=DEPTH/N/K,MONO/S,CPANEL/S,NOFN=NOFNBOXES/S,OB=OPENBEHIND/S,MYNAME/K
  59. XLAB/K,YLAB/K,TITLE/K,REALTIME/S,SD=DIGITS/N/K
  60.  
  61. /*****************************************************************************/
  62.  
  63. FILES - This can be multiple args and includes WILDCARD patterns. The files
  64.         must be ASCII NUMBERS DELIMITED BY WHITESPACE OR COMMAS. cP will ignore
  65.         numbers after the first two colums. cP will also ignore text lines so
  66.         that you can place a header in the file. See file sample.asc to see the
  67.        format.
  68.  
  69. /*****************************************************************************/
  70.  
  71. LOGX -  Switch to turn log XAxis on. If any values are less than or = to zero,
  72.         sets back to LINX. ( Can't do log negative ). X HOTKEY.
  73.  
  74. /*****************************************************************************/
  75.  
  76. LOGY -  Switch to turn log YAxis on. If any values are less than or = to zero,
  77.         sets back to LINY.  ( Can't do log negative ). Y HOTKEY.
  78.  
  79. /*****************************************************************************/
  80.  
  81. GRID -  Switch to turn on the grid. G HOTKEY
  82.  
  83. /*****************************************************************************/
  84.  
  85. SYM  -  Draw x SYMBOL AT EACH POINT. Amiga S hotkey.
  86.  
  87. /*****************************************************************************/
  88.  
  89. ID=DISPLAYID - ID number of the TYPE DISPLAY you wish to create.
  90.  
  91.            Default is HIRES LACE.
  92.  
  93.            EXAMPLES:
  94.            ID=4     -> LORES LACE      320*400
  95.            ID=32768 -> HIRES           640*200
  96.            ID=0     -> LORES           320*200
  97.          ID=32804 -> SUPERHIRES LACE 1280*400
  98.  
  99. /*****************************************************************************/
  100.  
  101. FONT - Name of the font to use for the display. The default is topaz.
  102.        cP adds '.font' to the string.
  103.        EX:  FONT helvetica SIZE 12
  104.  
  105. /*****************************************************************************/
  106.  
  107. SIZE - Size of the font. Default 8. No more Max size
  108.  
  109. /*****************************************************************************/
  110.  
  111. LORES - Lores screen
  112. HIRES - Hires screen
  113. LACE  - combine with either LORES or HIRES this function OR's
  114.         the LACE key over DISPLAYID and LORES/HIRES.
  115.  
  116. /*****************************************************************************/
  117.  
  118. SETDEF - Makes the new cP screen the DEFAULT PUBLIC SCREEN.
  119.  
  120. /*****************************************************************************/
  121.  
  122. W=WIDTH -  Set screen width in pixels. cP will open a VIRTUAL autoscroll screen
  123.            if WIDTH is wider than display.
  124.          EX. W=1800
  125.  
  126. H=HEIGHT - Set screen height in pixels. cP will open a VIRTUAL autoscroll
  127.            screen if HEIGHT is taller than display.
  128.          EX. H=800
  129.  
  130. /*****************************************************************************/
  131.  
  132. P=POINTS - Max Points to load in each set
  133.  
  134. /*****************************************************************************/
  135.  
  136. T=THIN   - depopulate set by number
  137.            EX. THIN=3 loads every third point
  138.  
  139. /*****************************************************************************/
  140.  
  141. D=DEPTH - Screen depth in bitplanes.
  142.         DEPTH=1 mono, DEPTH=2 four colors, DEPTH=3 eight colors,
  143.         DEPTH=4 16 colors.  If you have two sets use DEPTH=3 more
  144.         than two use DEPTH=4. One data set looks good either D=1 or D=2
  145.  
  146. MONO  -  black and white display. GREAT FOR BIG VIRTUAL SCREENS. Same as D=1.
  147.  
  148. /*****************************************************************************/
  149.  
  150. CPANEL - toggles CONTROL PANEL on or off. default on. Amiga-C hotkey
  151.  
  152. /*****************************************************************************/
  153.  
  154. NOFN=NOFNBOXES - dont place file name boxes on side of screen
  155.  
  156. /*****************************************************************************/
  157.  
  158. OB=OPENBEHIND - Opens Screen BEHIND ALL OTHER SCREENS
  159.  
  160. /*****************************************************************************/
  161.  
  162. MYNAME  - SETS WINDOW, PUBLIC SCREEN and REXX PORT NAMES to this. OpenScreen
  163.         will fail if name already exists.
  164.  
  165.           EX: MYNAME JoMama
  166.  
  167. /*****************************************************************************/
  168.  
  169. XLAB  -  Label for xaxis
  170. YLAB  -  Label for yaxis
  171. TITLE -  Label at top
  172.  
  173.           EX: XLAB "Pullin NoseHairs"
  174.           
  175. /*****************************************************************************/
  176.  
  177. REALTIME - This switch tells cP that data is increasing. With large data sets,
  178.            the redraw time after a zoom can be improved with this option. cP
  179.            will break from the draw loop for each set if it believes the data
  180.            is offscreen.  If x values are declining at any point in the data
  181.            don't set this option.
  182.  
  183. /*****************************************************************************/
  184.  
  185. SD=DIGITS  Number of significant digits for CrossHair Measurements
  186.  
  187. /*****************************************************************************/
  188. /*****************************************************************************/
  189.  
  190. /*****************************************************************************/
  191.  
  192. HOTKEYS
  193.         X toggles lin / log axis for x values
  194.         Y toggles lin / log axis for y values
  195.         R Redraws screen
  196.         A Add file
  197.         K opens Kill requester
  198.         F Full view
  199.         Z Zoom
  200.         G toggles grid on/off
  201.         H Turns CrossHair on (spacebar locks x in Xhair)
  202.         Q Death
  203.         
  204.         arrow keys page scroll virtual screens    
  205.  
  206. /*****************************************************************************/
  207. /*****************************************************************************/
  208.  
  209. AREXX
  210.  
  211. cP now i