home *** CD-ROM | disk | FTP | other *** search
/ Phoenix CD 2.0 / Phoenix_CD.cdr / 24b / lazer12.zip / OKIPIE11.ZIP / OKIPIE.DOC next >
Text File  |  1988-10-31  |  7KB  |  197 lines
  1.                             OKIPIE
  2.  
  3.                           Version 1.1
  4.  
  5.  
  6. Changes for version 1.1  (01/88-10/88)
  7.         
  8.     Fixed some centering problems.
  9.     Added proper width tables for LASERLINE fonts.
  10.     Changed from .MAP to .PCX bitmap format (saves space).  Works
  11.     with LAZER version 1.2.
  12.     Added LAZER command.
  13.     Included in LAZER12 Archive
  14.  
  15. If you find this program of value, relax.  I don't want your money.
  16. However, if you are in an extremely generous mood, and have a spare 80386
  17. machine or MacIntosh lying around, here's my address:
  18.  
  19.     James Bumgardner
  20.     711 E. Cypress, Apt. A
  21.     Burbank, CA  91501
  22.     818-846-7781 (PLINK BUM)
  23.  
  24.  
  25. Contents of this library:
  26.  
  27.     OKIPIE.EXE        Pie Graph Maker
  28.     OKIPIE.DOC        This File
  29.     PSAMPLE.DAT        A Sample Pie Graph Source File
  30.     OKIPIE.TXT        Pie Graph Header File
  31.  
  32. OKIPIE produces hi-resolution (300 dpi) pie graphs.  It works with the
  33. program LAZER.EXE which can be found in LAZER.ARC.
  34.  
  35. The pie graphs are circular (1024 X 1024), with an optional 3-D shadow
  36. effect and exploded slices.  You can have up to 2 centered titles, and
  37. data-titles all around the graph.  Unlike LOTUS, the data-titles are
  38. properly centered outside of each slice.
  39.  
  40. OKIPIE translates an easy to read SOURCE file into two new files, a
  41. .PCX graphics file, and a new text file which contains the text
  42. and typesetting instructions.
  43.  
  44. All the text and numbers on the graphs use regular laser printer
  45. fonts, rather than raster graphics.  This speeds up graph generation,
  46. and allows you to use your own font library.  This program works with
  47. either OKIDATA LASERLINE resident fonts, or with download fonts.  If
  48. you've got an 18 pt and 10 pt resident font, you can modify it to work
  49. with those as well by changing OKIPIE.TXT. 
  50.  
  51. LAZER
  52. -----
  53. The program LAZER (not included here, but available on this BBS) is an
  54. interpreter which reads the typesetting files.  It translates the
  55. typesetting commands into HP LaserJet+ commands, as well as
  56. downloading fonts and bitmaps to the printer. 
  57.  
  58. The advantages of using LAZER, as opposed to having OKIPIE send its
  59. commands directly to the printer, are twofold.  First, if there is a
  60. problem with the output, such as a spelling error, you can correct the
  61. text without having to generate the bitmap over again.  In the same vein,
  62. you can also make minor cosmetic changes pretty easily.  Secondly, this
  63. method makes the printer driver more independent, permitting the
  64. creation of Typesetting programs for other printers. 
  65.  
  66. LAZER.EXE is a pretty useful program in it's own right, apart from
  67. being used to print graphs.  I use it to design business forms and as
  68. a poor man's page-setter.  However if you just want to print graphs,
  69. you don't need to know anything about it.  If you're curious, the
  70. documentation for LAZER is in the file LAZER.DOC. 
  71.  
  72. USAGE
  73. -----
  74.   OKIPIE uses this syntax:
  75.  
  76.     OKIPIE sourcefile [outfile] [-m mapfile]
  77.  
  78. For Example:
  79.  
  80.     OKIPIE cheese.dat
  81.     OKIPIE cheese.dat special.gra
  82.     OKIPIE cheese.dat -m cheese.pcx
  83.  
  84. While constructing the graph, OKIPIE wil print "Slice X" for each
  85. slice of the pie.  This is to let you know that your computer hasn't
  86. died.  It takes about a minute to draw a reasonably complex graph at 300 dpi.
  87.  
  88. When finished drawing, OKIPIE will quickly output the bitmap and exit.
  89. Use LAZER to print the graph:
  90.  
  91.     LAZER cheese.gra        (Output to LPT1)
  92.     LAZER cheese.gra LPT2        (Output to LPT2)
  93.     LAZER cheese.gra outfile    (Output to a very large file)
  94.  
  95. LAZER will take up to 5 minutes to print the graph (usually 2 or 3),
  96. depending on how many fonts you're downloading, and the speed of your
  97. printer.
  98.  
  99. The outfile name is optional and defaults to *.GRA.  It's just
  100. a regular text file with the typesetting instructions for LAZER.
  101. Try TYPEing or LISTing the .GRA file to see what it looks like.
  102.  
  103. The bitmap name is optional and defaults to PIE.PCX.  The bitmaps are
  104. approx 30K and will eventually consume all your disk-space if you don't
  105. purge them from time to time, this is why OKIPIE normally erases the old
  106. map.  The .PCX file can be read by PC Paintbrush and a few other graphics
  107. programs.
  108.  
  109.  
  110. PIE SOURCE FILES
  111. ----------------
  112. Here is a sample Pie Source File:
  113.  
  114. ; (comment) this is the start of the file
  115. ;
  116. FONT 0 \fonts\emerald
  117. TITLE    Distribution of Lucky Charms
  118. SUBTITLE September, 1987
  119. SHADOW
  120. ;
  121. 123 Yellow Moons
  122. 102 Green Clovers
  123. 75 Blue Diamonds
  124. 23 Pink Hearts
  125. ; end of file
  126.  
  127. Not much to it really.  All lines that start with a number are considered data.
  128. You may follow each number with text to be printed next to the slice.
  129.  
  130. All lines that start with a word are commands.  You may abbreviate all
  131. commands down to 2 letters.
  132.  
  133. COMMAND            MEANING
  134. -------            -------
  135.  
  136. TITLE string        This is the title of the graph.
  137.  
  138. STITLE string or
  139. SUBTITLE string        This is the sub-title of the graph.
  140.  
  141. EXPLODE [n,...]        This tells OKIPIE to explode one or more slices.
  142.             Slice numbers start with 0.  OKIPIE defaults to
  143.             exploding the first slice.
  144.  
  145. SHADOW [dots]        This makes OKIPIE use a 3-D Shadow effect.
  146.             You may use a number to indicate shadow thickness,
  147.             which defaults to 20 dots.  There is no hidden-line
  148.             algorithm, so shadows on the upper-left quadrant
  149.             may collide with other slices.  To avoid this, don't
  150.             explode slices in that quadrant.  Also, thick shadows
  151.             at the bottom of the circle will be clipped.
  152.  
  153. THICKNESS n        This sets the pen width, which defaults to 4 dots
  154.             on either side of the line.
  155.  
  156. SORT            This sorts the slices from largest to smallest,
  157.             typical Pie Chart format.  The Explode Command
  158.             refers to post-sorted slices.
  159.  
  160. INSIDE            Center the text INSIDE the slices.  This is only
  161.             effective with big slices and small text.
  162.  
  163. PERCENTS        Includes percentages with the text of each slice.
  164.             Example: Blue Moons (15%)
  165.  
  166. NUMBERS            Includes numbers with the text of each slice.
  167.             Example: Blue Moons (560)
  168.  
  169. Both PERCENTS and NUMBERS:     Blue Moons (560 - 15%)
  170.  
  171.  
  172. FONT # fontname        This causes OKIDATA to use a width table from
  173.             a download font, allowing it to properly center the
  174.             letters.  The Typesetting File will contain a command
  175.             to download this font.
  176.  
  177.             FONT 0 is for the title.
  178.             FONT 1 is for the subtitle
  179.             FONT 2 is for the slice text.
  180.  
  181.             If you omit these commands, OKIPIE will use the
  182.             resident fonts on the Okidata Laserline Printer.
  183.             I obtained the width tables for these fonts by
  184.             looking at the Word Perfect printer drivers.
  185.  
  186.  
  187.             FONT 0 Defaults to Helvetica Bold 18
  188.             FONT 1 Defaults to Times Roman 10
  189.             FONT 2 Defaults to Times Roman 10 Italic
  190.  
  191. LAZER commands
  192.             This command will insert LAZER commands into the
  193.             .GRA file.
  194.  
  195.  
  196. ** End of Documentation **
  197.