home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 376.lha / DGplot_v0.08 / DGplot.doc < prev    next >
Text File  |  1990-04-01  |  16KB  |  392 lines
  1.                           DGplot Version 0.08                          
  2.                    By John (the Amiga Kid) Robertson                   
  3.  
  4. BEFORE RUNNING DGplot you MUST put the following file in your
  5. current S: directory...
  6.  
  7.       FastLib
  8.  
  9. You MUST put the following file in your current LIBS: directory...
  10.  
  11.       arp.library
  12.  
  13. If you do not, DGPlot will not run!  I have provided a script,
  14. "Install_DGPlot", which will do this for you.
  15.  
  16. DGplot is copyright (c) 1990 by John Dillard Robertson, 28 Pinckney St.
  17. #4, Greenville, SC  29601,  (803) 271-1459 (voice), but may be freely
  18. distributed as long as no profit is made from its distribution or sale
  19. without my written permission.  This program is 'FreeWare'.
  20.  
  21. Included Support files:
  22.  
  23.    PrtDef (directory)       ... printer driver files
  24.  
  25.    arp.library              ... AmigaDOS Replacement Project library
  26.  
  27.    DGplot                   ... DGplot program executable file
  28.  
  29.    DGplot.doc               ... Documentation for DGplot (you are
  30.                                 looking at it)
  31.  
  32.    FastLib                  ... Fbasic support library required to run
  33.                                 programs compiled with the Fbasic compiler.
  34.  
  35.    NULL                     ... An empty file for PIPE: reads
  36.  
  37.    Plans-configuration      ... HPGL configuration file for "Plans"
  38.                                 shareware CAD program.
  39.  
  40.    RaceCar.D                ... Sample HPGL file.  "D" size drawing.
  41.  
  42.    SuperPlot.HP7550         ... Sample HPGL file.  "HP7550" size
  43.                                 drawing.
  44.  
  45.  
  46.                ------ What in the heck is DGplot? ------               
  47.  
  48. DGplot, or "darn good plot" is a program which turns your Amiga
  49. computer and parallel port dot matrix printer into an extremely high
  50. resolution Hewlett-Packard ® pen plotter.  This makes your printer a
  51. suitable (and economical) hard copy device for computer aided design
  52. programs, some spreadsheet programs, and data graphing programs.  You
  53. will probably be amazed when you see the resolution that your dot
  54. matrix printer really has.  DGplot output in FINAL quality will look
  55. much better than a screen dump.
  56.  
  57. DGplot reads (and understands) a useful subset of HPGL commands.  HPGL
  58. is an acronym for "Hewlett Packard Graphics Language", which is a
  59. language used to tell a pen plotter how to draw a picture.  HPGL files
  60. are ASCII files, so you can type them to the CLI window if you are
  61. curious.  HPGL has become a pseudo-standard plotter language in the
  62. computer industry, and is supported by all CAD programs.  DGplot has
  63. been tested with:
  64.  
  65.         - `Plans' shareware CAD program
  66.            (you must have the proper "plans-configuration" file which
  67.            is supplied with this program)                    
  68.  
  69.         - `X-CAD designer' commercial CAD program                
  70.  
  71.         - `SuperPlot' data graphing program (on this disk)         
  72.  
  73. DGplot should work fine with Aegis Draw (and all variants), IntroCad,
  74. and most other CAD programs.
  75.  
  76.                  ------ How do I set up DGplot? ------                 
  77.  
  78. Required Files:
  79.  
  80.  directory      file
  81. ----------   ----------
  82.       C:     DGplot
  83.  
  84.    LIBS:     arp.library
  85.  
  86.       S:     FastLib
  87.              DGprinter    (one of the included printer drivers renamed)
  88.  
  89. DGplot is designed to support just about any dot matrix printer on the
  90. market.  To accomplish this, DGplot must have a special printer driver
  91. file in your S: directory, named "DGprinter".
  92.  
  93. The DGplot printer driver is NOT the same as a preferences printer
  94. driver, so don't intermix them. 
  95.  
  96. DGplot printer drivers are compatible with most IntroCad ® printer
  97. drivers. If you look in the PrtDef directory you will find the names of
  98. many printers.  After you select the appropriate one, copy it to the S:
  99. directory, and rename it "DGprinter".  If you need to try several
  100. printer drivers, you can specify the printer driver on the command line
  101. (See Power Users section).
  102.  
  103. Copy the program file, "DGplot", into your C: directory, or somewhere
  104. in your assigned search path.  You must also copy the file "FastLib"
  105. into your S: directory, and the "arp.library" into your LIBS:
  106. directory.  If you are booting off of "Ultra_Bench", both files will
  107. already be there.
  108.  
  109. Please note:  Nothing you can set in Preferences will have any effect
  110. on DGplot.
  111.  
  112.                   ------ How do I use DGplot? ------                   
  113.  
  114. To use DGplot, simply type:
  115.  
  116.       DGplot HPGLfilename
  117.  
  118. into a CLI window where `HPGLfilename' is the name of an HPGL file. 
  119. You will be prompted with the following:
  120.  
  121.         Select a drawing size
  122.  
  123.  A       (8 x 10.5)      1000 units/inch
  124.  B       (10.5 x 16.5)   1000 units/inch
  125.  C       (16.25 x 21.25) 1000 units/inch
  126.  D       (21 x 33)       1000 units/inch
  127.  E       (33 x 43)       1000 units/inch
  128.  HP7475  (7.8 x 10.1)    1021 units/inch
  129.  HP7550  (7.7 x 10)      1016 units/inch
  130.  USER    Specify (? x ?) 1000 units/inch
  131.             (ESC) (CR) to abort
  132. ?
  133.  
  134. Reply with "A","B","C"..., or hit the ESC key and then RETURN to abort.
  135. DGplot will not alter the scaling of your drawing in any way, so make
  136. sure you choose the appropriate size for the drawing you would like to
  137. plot.  If you choose the "USER" selection you will be prompted for the
  138. desired width and height of the drawing.  A 1/2" border is assumed. 
  139. after making a valid choice, you will be prompted next with something
  140. like this:
  141.  
  142.  
  143.         Specify drawing quality
  144.  
  145.  QUICK
  146.  DRAFT
  147.  FINAL
  148.             (ESC) (CR) to abort
  149. ?
  150.  
  151. Reply by typing in one of the choices (upper or lower case doesn't
  152. matter).  If you have trouble, view the printer driver, which is an
  153. ASCII file.
  154.  
  155. If DGplot finds the selected entry in the printer driver, and the HPGL
  156. file is where you said that it was, you should see DGplot counting the
  157. kilobytes read from the file.  DGplot is now reading the file and
  158. building the internal vector lists.  If you wish to abort the file
  159. read, just activate the CLI window that DGplot is running from, and
  160. press CTRL-C simultaneously.
  161.  
  162. After DGplot finishes reading the HPGL file it will begin printing
  163. immediately.  You will see a status line printed which tell you how
  164. many strips and how many rows to go.  1 row = 1 printer head height,
  165. and 1 strip is one 8" wide portion of the drawing.  If you wish to
  166. abort the printing, just activate the CLI window that DGplot is running
  167. from, and press CTRL-C simultaneously.
  168.  
  169. If DGplot appears to be doing nothing, check to see that your printer
  170. is turned on, and "ON LINE".  If the drawing size you selected is 8" or
  171. more in its shortest dimension (including the border), the printer will
  172. print out several strips with alignment marks.  The strips should be
  173. separated and joined along the sides, with the alignment marks on top
  174. of each other.
  175.  
  176.            Strip #1                       Strip #2
  177.  ______________________________ ______________________________
  178.  |                            | |                            |
  179.  |       alignment mark---> + | | + <--- alignment mark      |
  180.  |                            | |                            |
  181.  |                            | |                            |
  182.  |                            | |                            |
  183.  |                            | |                            |
  184.  |                            | |                            |
  185.  |                            | |                            |
  186.  |                            | |                            |
  187.  |                            | |                            |
  188.  |............................| |............................|
  189.  |                            | |                            |
  190.  |                            | |                            |
  191.  |                            | |                            |
  192.  |                            | |                            |
  193.  |                            | |                            |
  194.  |                            | |                            |
  195.  |                            | |                            |
  196.  |                            | |                            |
  197.  |                            | |                            |
  198.  |                          + | | +                          |
  199.  |____________________________| |____________________________|
  200.  |   Tear here and join to    |               ^
  201.  | +        strip #1          |               |
  202.  |                            |               |
  203.  |                            |               |
  204.  |                            |               |
  205.  |                            |               |
  206.  |                            |               |
  207.  |                            |               |
  208.  |                            |<---------------
  209.  |                            |
  210.  |............................|
  211.  |                            |
  212.  |                            |
  213.  |                            |
  214.  |                            |
  215.  |                            |
  216.  |                            |
  217.  |                            |
  218.  |                            |
  219.  |                            |
  220.  | +                          |
  221.  |____________________________|
  222.  
  223. Since dot matrix printers can't print all of the way to the left edge
  224. of the paper, you will have to trim about 1/8" off of the left side of
  225. all strips after first.  DGplot gives you 1/4" of overlap between
  226. strips.  The best way to join the strips is to lay them on a large flat
  227. surface properly aligned, place a straight edge on the junction, and
  228. cut with a razor knife.  This will give an exact edge with no overlap
  229. necessary.
  230.  
  231.                        ------ Power Users ------                       
  232.  
  233. For all you power users out there, DGplot accepts any number of HPGL
  234. filenames on the command line, or any ARP wildcard pattern (The GADS
  235. command line parser is used).  You may also specify the size, width,
  236. height, print quality, and printer driver on the command line.  If you
  237. specify a size other than "USER", the width and height arguments will
  238. be ignored.  If you omit a necessary specification, you will be
  239. prompted for it.  Here is a fully specified example:
  240.  
  241.   DGplot t:*.plt -S user -W 10.0 -H 7.49 -Q draft -P PrtDrv/Epson-FX   
  242.  
  243.                                   or                                   
  244.  
  245.   DGplot t:*.plt -S hp7550 -Q draft -P PrtDrv/Epson-FX   
  246.  
  247. where * is a wildcard character.  If you use the command line options
  248. to specify size and print quality, DGplot can be run from script files.
  249.  
  250.  
  251.               ------ Reading from the PIPE: device ------              
  252.  
  253. HPGL files can be very large, and have little value in themselves. 
  254. This makes them a good candidate for the PIPE: device.  The PIPE:
  255. device was distributed on WorkBench 1.3, and on Ultra_Bench.  The PIPE:
  256. device is a 4K buffer that appears to a program as a file.  Using the
  257. PIPE: will eliminate the need to save the HPGL file to disk, and it
  258. will speed up the whole process of printing output.
  259.  
  260. To use the PIPE: with DGplot you must open a CLI window and make sure
  261. that the PIPE: is mounted by typing:
  262.  
  263.                               mount PIPE:                              
  264.  
  265. This will mount the PIPE: device if it has not already been mounted. 
  266. Now you should invoke DGplot with a valid PIPE: for the HPGLfilename. 
  267. For example:
  268.  
  269.               DGplot PIPE:A -S user -W 30 -H 20 -Q final               
  270.  
  271. The "PIPE:A" specification may be any string up to 30 characters as
  272. long as it starts out with "PIPE:".  After you hit RETURN, DGplot
  273. should report that it is reading PIPE:A, and should not be counting up.
  274. At this point, DGplot is waiting for some program to write to "PIPE:A".
  275.  
  276. Now go to your CAD program, or any program that outputs HPGL and plot
  277. your drawing by selecting the HPGL plotter option, and save output to
  278. "PIPE:A".  Now, if you flip back to the WorkBench screen, you should
  279. see the CLI window with DGplot running in it counting up the Kbytes
  280. read.
  281.  
  282. When your CAD program indicates that it has finished saving the HPGL
  283. plot file, DGplot may or may not start printing.  If it does not, it is
  284. still waiting for an `end of file' condition from the PIPE:.  To supply
  285. this I have included a file named "NULL", which is empty.  Open a
  286. second CLI window (it is important that it is not the same CLI window
  287. as DGplot is running from), and type:
  288.  
  289.                           type null to PIPE:A                          
  290.  
  291. This will send the `end of file' signal to DGplot, and it should start
  292. printing immediately.
  293.  
  294.  
  295.                         ------ Reference ------                        
  296.  
  297. HPGL commands currently supported with DGplot are:
  298.  
  299. AA - the Arc Absolute instruction
  300. CI - the Circle instruction
  301. DF - the Default instruction
  302. IN - the Initialize instruction
  303. PA - the Plot Absolute instruction
  304. PD - the Pen Down instruction
  305. PR - the Plot Relative instruction
  306. PU - the Pen Up instruction
  307. RO - the Rotate Coordinate System instruction
  308. LT - the Line Type instruction
  309.  
  310. All commands that are in an HPGL file and are not supported by DGplot
  311. will simply be ignored.  Since I am interested in making DGplot useful
  312. to as many people as possible, I will add support for commands that you
  313. request.
  314.  
  315.                        ------ Intentions ------                        
  316.  
  317. I do not wish to support all HPGL commands, since the size of the code
  318. and memory requirements would be very large.  DGplot and all vector
  319. lists currently take up about 120K of memory, depending on the size of
  320. the input file.  This makes it feasible to run DGplot while you are
  321. still running your CAD program.
  322.  
  323.                     ------ What's the Catch? ------                    
  324.  
  325. If you find a bug, I would appreciate it if you would tell me about it.
  326. It is very helpful if you can provide the HPGL file that made DGplot
  327. barf.  My address and phone number are:
  328.  
  329.                            John D. Robertson                           
  330.                           28 Pinckney St. #4                           
  331.                          Greenville, SC  29601                         
  332.                             (803) 271-1459                             
  333.  
  334.                         Compuserve ID   71620,1325
  335.                         People Link ID  OBS747
  336.  
  337. Any donations will be gleefully accepted, and donaters will recieve a
  338. reply in the mail.  Donations will provide incentive for future public
  339. domain programs.
  340.  
  341.  
  342.  
  343.                       ------ Future Plans ------                       
  344.  
  345. Thanks in part to my faithful alpha testers, I plan to do the
  346. following:
  347.  
  348. - Support a command which is not in the Hewlett Packard Graphics
  349.   Language, but would be useful for making printed circuit boards.  The
  350.   command will be "LW", for Line Width, and will have one argument. 
  351.   The argument will specify the line width in thousandths of an inch. 
  352.   To use this feature you simply assign the LW command instead of the
  353.   SP command in your plotter setup file for your CAD program.  This
  354.   will make each color of line on the screen represent a different
  355.   width of line on the hard copy.  (Thanks Jerry!)
  356.  
  357. - Support color (I need to get at least one request for this).
  358.  
  359. All suggestions will be appreciated and considered.
  360.  
  361. Thank you and enjoy DGplot!
  362.  
  363.                       ------ Release Notes ------                      
  364.  
  365.                         Version 0.03  (1/28/90)                        
  366.  
  367. Initial release.  Does not support HPGL "LT" command, so can't do line
  368. types.  Only accepts one HPGL file on the command line.
  369.  
  370.                         Version 0.06 (2/25/90)                         
  371.  
  372. Now supports "LT" command.  Supports ARP command line options with
  373. unlimited filenames, wild cards, and complete drawing specification
  374. from key words.  Requires the presence of the "arp.library" in the
  375. "LIBS:" directory.  Added "USER" drawing size where the user specifies
  376. the width and height of the drawing.  User may now break (ctrl-C) at
  377. any time during reading phase or printing phase.
  378.  
  379.                         Version 0.07 (3/3/90)                         
  380.  
  381. DGplot now prints out the available print quality entries from the
  382. printer driver that has been specified, so you can see all available
  383. choices.  If you incompletely specify either the size or print quality
  384. by using fewer characters than shown, DGplot will look for the first
  385. character for character match for what you have specified.  (Thanks
  386. Bernie!)
  387.  
  388.                          Version 0.08 (3/6/90)                         
  389.  
  390. Fixed bug that would not allow you to specify the drawing size from the
  391. command line.
  392.