home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 2 / FFMCD02.bin / new / misc / sci / cp / readme < prev    next >
Encoding:
Text File  |  1993-12-21  |  5.2 KB  |  158 lines
  1.       cP Ver 3.0  by Chris Conger
  2.  
  3. cP is a data viewing program capable of plotting
  4. two dimensional data in both linear or log space
  5. with or without symbols. The program only runs
  6. from the CLI. It requires Kickstart 37 or higher
  7. to run. There is no limit to the number of points
  8. that the program can load except the amount of ram
  9. on your system. There is also no limit to the
  10. number of sets, however the title boxes on the edge
  11. will scroll off the screen after about ten(use NOFN).
  12. cP does create a public screen, so you can use it for
  13. other applications. Its' name is cP. If there is already
  14. a cP screen in the public screen list cP will append
  15. a number to the screen name ( cp1 ).
  16.  
  17. cP reads an environmental variable at startup
  18. which can be used to change the default values of
  19. the settings. The name of the var is CPCONFIG. Any
  20. options given on the command line will override the
  21. environmental variable.
  22.  
  23.     EX:
  24.       > setenv cpconfig "ID=32768 FONT helvetica SIZE 9 GRID SETDEF W=1000"
  25.  
  26. The template is:
  27.  
  28. FILES/A/M,LX=LOGX/S,LY=LOGY/S,GRID/S,SYM/S,ID=DISPLAYID/N/K,FONT/K,SIZE/N/K
  29.     ,LORES/S,HIRES/S,LACE/S,SETDEF/S,W=WIDTH/N/K,H=HEIGHT/N/K,C=BINARY/F/K,P=POINTS/N/K
  30.     ,T=THIN/N/K,D=DEPTH/N/K,MONO/S,CPANEL/S,NOFN=NOFNBOXES/S
  31.  
  32. FILES - This can be multiple args and includes
  33.        Wildcard patterns. The files must be
  34.        ascii numbers delimited by whitespace
  35.        or commas. cP will ignore numbers after
  36.        the first two colums. cP will also ignore
  37.        text lines so that you can place a header
  38.        in the file. See file sam.dat to see the
  39.        format. Also remember that cP stores its'
  40.        values as 4 byte floats, so don't have any
  41.        values outside of 1e-38 to 1e38.
  42.  
  43. LOGX -  Switch to turn log XAxis on. If any values are LESS
  44.         THAN or = to ZERO, sets back to LINX.
  45.         ( Can't do log negative ).
  46.  
  47. LOGY -  Switch to turn log YAxis on. If any values are LESS
  48.         THAN or = to ZERO, sets back to LINY.
  49.         ( Can't do log negative ).
  50.  
  51. GRID -  Switch to turn on the grid.
  52.  
  53. SYM  -  Draw x symbol at each point.
  54.  
  55. ID=DISPLAYID - ID number of the type display you
  56.         wish to create. Default is HIRES LACE.
  57.         EX:
  58.            ID=4     -> LORES LACE 320x400
  59.            ID=32768 -> HIRES      640x200
  60.            ID=0     -> LORES      320x200
  61.  
  62.         I don't have the includes for 2.1 or 3.0, so
  63.         can't tell you what the others are. cP needs
  64.         16 colors, so SuperHires won't be any good.
  65.         Super72 should be good I think ( I don't know
  66.         the ID number though ).
  67.  
  68. FONT - Name of the font to use for the display. The
  69.        default is topaz. cP adds '.font' to the string.
  70.        EX:
  71.            FONT helvetica SIZE 12
  72.  
  73. SIZE - Size of the font. Default 8. Max size 18.
  74.  
  75. LORES - Lores screen
  76. HIRES - Hires screen
  77. LACE  - combine with either LORES or HIRES this function OR's
  78.         the LACE key over DISPLAYID and LORES/HIRES.
  79.  
  80. SETDEF - Makes the new screen the default public screen.
  81.  
  82. W=WIDTH - Set screen width in pixels. cP will open a virtual
  83.         autoscroll screen if WIDTH is wider than display.
  84.         EX. W=1800
  85.  
  86. H=HEIGHT - Set screen height in pixels. cP will open a virtual
  87.         autoscroll screen if HEIGHT is taller than display.
  88.         EX. H=800
  89.  
  90. C=BINARY - load binary data.  Must be the last arg on the command line
  91.          for more info on the binary format see rhp.c or contact me.
  92.          The format works pretty well but I can't recommend it, except
  93.          for its ability to include lots of data in small files.
  94.  
  95. P=POINTS - Max Points to load in each set
  96.  
  97. T=THIN   - depopulate set by number
  98.            EX. THIN=3 plots every third point
  99.  
  100. D=DEPTH - Screen depth in bitplanes.
  101.         DEPTH=1 mono, DEPTH=2 four colors, DEPTH=3 eight colors,
  102.         DEPTH=4 16 colors.  If you have two sets use DEPTH=3 more
  103.         than two use DEPTH=4. One data set looks good either D=1 or D=2
  104.  
  105. MONO  -  black and white display. Great for big virtual screens.
  106.  
  107. CPANEL - toggles control panel on or off. default on.
  108.  
  109. NOFN=NOFNBOXES - dont place name boxes on side of screen
  110.  
  111.  
  112. EXAMPLE COMMAND:
  113.  
  114.       > cp sam.#? font ZapfChancery size 12 DEPTH=2 ID=32804 SYM LOGX W=1800
  115.  
  116.  
  117. IDENTIFY - cP will write the x and y values cooresponding to mousex and
  118.         mousey when select down. If the mouse is not within three pixels
  119.         when selectup then cP erases the text, otherwise it makes the text
  120.         white.
  121.  
  122. The archive contains both IEEE and 030/68881 compiled
  123. versions. I find about 25% improvement in draw speed for the
  124. 030/881 version on my A3000. Also included is source code
  125. and makefiles for both versions. There arn't many comments
  126. in the source, and I don't really consider them to
  127. be great example code. Anyhow feel free to use any
  128. of the functions in your own programs.
  129.  
  130. The original source for the GUI was created with
  131.  
  132.     GadToolsBox 37.273
  133.            by
  134.      Jan van den Baard
  135.      Jaba Development
  136.  
  137. Much thanks since I'd never have gotten anywhere without
  138. it. The current version of the GUI has been modified
  139. so that GadToolsBox can't edit the source anymore.
  140.  
  141. This code is freely distributable by any means, however
  142. I retain all rights to it.
  143.  
  144. I take no responsibility for any damage which it may
  145. cause to your system, use at your own risk.
  146.  
  147. Comments, Suggestions, Ideas, BUGS contact
  148.  
  149. Chris Conger
  150.  
  151. BIX - cconger
  152.  
  153. NET - congerc@abqa.saic.com
  154.  
  155. c/o SAIC
  156. 2109 AirPark Rd. SE
  157. Albuquerque, NM 87106
  158.