home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / TCOMM / PRINTGL.ZIP / PRINTGL.DOC next >
Encoding:
Text File  |  1990-02-10  |  39.6 KB  |  769 lines

  1.                                                             
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                              PRINTGL 1.00 REFERENCE
  22.  
  23.                              (C) Copyright Cary Ravitz 1990
  24.  
  25.  
  26.                              Cary Ravitz
  27.                              P. O. Box 25068
  28.                              Lexington, KY  40524-5068
  29.                                                                              
  30.  
  31.                                                                             g-1
  32.          CONTENTS
  33.  
  34.            INTRODUCTION ..................................................... 2
  35.            LICENSE AND REGISTRATION                                           2
  36.            INSTALLATION ..................................................... 3
  37.            OPERATION                                                          3
  38.            SYNTAX ........................................................... 4
  39.            /A - LOCATION OPTION                                               5
  40.            /C - PEN COLOR OPTION ............................................ 5
  41.            /D - OUTPUT DESTINATION OPTION                                     5
  42.            /F - OUTPUT FORMAT OPTION ........................................ 6
  43.            /I - SCALING POINT LOCATION OPTION                                 6
  44.            /L - PAGE LAYOUT OPTION .......................................... 7
  45.            /M - MAGNIFICATION OPTION                                          7
  46.            /N - PAGE NUMBER OPTION .......................................... 8
  47.            /O - ORIGIN AND ORIENTATION OPTION                                 8
  48.            /P - PLOTFILE OPTION ............................................. 8
  49.            /S - PEN SHADING OPTION                                            8
  50.            /T - TEMPORARY FILE OPTION ....................................... 8
  51.            /W - PEN WIDTH OPTION                                              9
  52.            /Y - Y/D SWITCH SETTING OPTION ................................... 9
  53.            /Z - CHORD ANGLE OPTION                                            9
  54.            EPSON 9 PIN PRINTERS ............................................ 10
  55.            EPSON 24 PIN PRINTERS                                             10
  56.            HP LASERJET ..................................................... 10
  57.            HP PAINTJET                                                       10
  58.            IBM LASERPRINTER ................................................ 11
  59.            IBM PROPRINTER                                                    11
  60.            IBM PROPRINTER X24 COMPATIBLE PRINTERS, IBM QUICKWRITER ......... 11
  61.            IBM PROPRINTER X24                                                11
  62.            IBM QUIETWRITER 2 AND 3 ......................................... 11
  63.            CGA DISPLAY                                                       12
  64.            EGA DISPLAY ..................................................... 12
  65.            HERCULES DISPLAY                                                  12
  66.            MCGA DISPLAY .................................................... 12
  67.            VGA DISPLAY                                                       12
  68.            BIT MAPS ........................................................ 12
  69.            PLOTFILE SPECIFICS                                                13
  70.            LINE TYPE PATTERNS .............................................. 14
  71.            COMPATIBILITY AND TECHINCAL INFORMATION                           15
  72.            WHAT TO DO IF YOU HAVE PROBLEMS ................................. 15
  73.                                                                              
  74.  
  75.                                                                             g-2
  76.          INTRODUCTION
  77.  
  78.            PrintGL prints an HP-GL (Hewlett-Packard Graphics Language) plotfile
  79.            on a matrix printer. HP-GL is HP's pen plotter control language that
  80.            is widely  supported by graphics programs including AutoCAD, GenCAD,
  81.            MathCAD, SAS, MICROCADAM, Schema, and many more.  PrintGL has native
  82.            mode drivers for Epson compatible 9  and 24 pin dot matrix printers,
  83.            HP   LaserJet,  DeskJet,  and  PaintJet,  and   IBM  9  and  24  pin
  84.            Proprinters, Quietwriter 2 and  3, and  LaserPrinter.  It will  also
  85.            display plots with  a CGA, EGA, VGA, enhanced VGA, or HGC and output
  86.            a bit map.
  87.  
  88.            Even if  your graphics program  supports your printer,  you may find
  89.            that  PrintGL  gives  better print quality.  PrintGL  uses  the best
  90.            graphics  modes available for each printer that it supports.  If you
  91.            need  printed graphics output from personal software, you can output
  92.            HP-GL and use  PrintGL to  do the  printing.  This  gives  immediate
  93.            support to a wide range of printers.
  94.  
  95.            PrintGL interprets all of the HP 7470 command set that is applicable
  96.            to plotfiles.  None  of  the  digitize,  output,  or  device control
  97.            commands (except plotter on and off) are supported as these are only
  98.            used with direct control of a plotter. And the error mask command is
  99.            not supported.  In addition to the HP 7470 commands, PrintGL handles
  100.            paper feed commands and eight pens (instead of two).
  101.  
  102.            If  you are interested in  using PrintGL  as a printer  driver  in a
  103.            commercial program, contact me. I can prepare a special version with
  104.            a  program  interface, alternate  vector  language input,  alternate
  105.            font, or support for additional printers.
  106.  
  107.          LICENSE AND REGISTRATION
  108.  
  109.            You may use PrintGL without charge on a trial basis to determine its
  110.            suitability for  you.  If  you  continue to  use PrintGL  after your
  111.            evaluation a $25 registration is requested.
  112.  
  113.            PrintGL is  provided as is.  There  are no warranties  expressed  or
  114.            implied.
  115.  
  116.            You may distribute PrintGL if you keep  the entire package together,
  117.            unchanged,  including this  license explanation, and  do  not charge
  118.            more than a small handling fee ($10).
  119.  
  120.            To  register your copy of PrintGL,  send your name, address, and $25
  121.            check to:
  122.  
  123.              Cary Ravitz
  124.              P. O. Box 25068
  125.              Lexington, KY  40524-5068
  126.  
  127.            You will  not  receive  a  new copy of  PrintGL.  The bulletin board
  128.            distribution package is the complete, full function program.
  129.                                                                              
  130.  
  131.                                                                             g-3
  132.          INSTALLATION
  133.  
  134.            The PrintGL package consists of these files:
  135.  
  136.              PRINTGL.EXE  program
  137.              PRINTGL.DOC  documentation
  138.              SAMPLE.PLT   sample plotfile
  139.  
  140.            To  install PrintGL copy the distribution files to your working disk
  141.            or directory.
  142.  
  143.            PRINTGL.EXE is a stand alone executable  file.  There  are no  extra
  144.            printer driver files or overlays.
  145.  
  146.            PRINTGL.DOC is this manual.  You can print it with "COPY PRINTGL.DOC
  147.            PRN" (16 pages).
  148.  
  149.            SAMPLE.PLT is a sample plotfile to help you try out PrintGL.
  150.  
  151.          OPERATION
  152.  
  153.            PrintGL reads a plotfile, does arc and character to line conversion,
  154.            stores  the data in a coordinate list,  and if needed, puts the list
  155.            on disk.  It then reorients the  data and determines the plot  size.
  156.            Next the data is resized and relocated.  Finally the coordinate list
  157.            is rasterized  and printed  in swaths.  You are likely  to  see  the
  158.            printer print  a swath and stop while PrintGL is processing the next
  159.            swath.
  160.  
  161.            When you display a plot, press Esc to return to the DOS text screen.
  162.            Ctrl-Break  stops  PrintGL at the next break  point.  Ctrl-Break  is
  163.            ignored when PrintGL is waiting for user input.
  164.  
  165.            If  your  plotfile  contains  any  IW  (input window)  commands then
  166.            PrintGL does any automatic centering and sizing (as specified by the
  167.            /A  and /F options) assuming that you want to see the entire window,
  168.            even if there is no data in the window.
  169.  
  170.            PrintGL  works within a printer's current  margins and starts at the
  171.            current print position.  If you decline  the form  feed suboption of
  172.            the  /L option then PrintGL  leaves the printer at the  start of the
  173.            line directly below the plot.  All printing is done in printer lines
  174.            that  cover the full width of the printhead.  This is noted  in  the
  175.            screen output so  that you can determine exactly how much  space the
  176.            plot takes. For example, if you specify a 3 inch high plot (with the
  177.            /L option) with a 24 pin  printer,  PrintGL notes "23  lines  24/180
  178.            inch/line", so the actual height of the plot is 3.067 inches.
  179.  
  180.            Internally PrintGL uses two byte coordinates on a 1016 dots per inch
  181.            grid. This allows for plots with coordinates of over 30 inches - far
  182.            larger than an HP7470 can handle.  However  if you are using PrintGL
  183.            to emulate a large plotter, you may overflow the internal coordinate
  184.            system.  This  condition  is not checked, and it will cause  garbage
  185.            output.  You can change the internal resolution to 508 dots per inch
  186.            (giving 60  inch maximum  plot sizes) by  editing PRINTGL.EXE with a
  187.            binary editor -  search for the  string "indpi"  and change the next
  188.            two bytes from hex F803 to hex FC01.
  189.                                                                              
  190.  
  191.                                                                             g-4
  192.          SYNTAX
  193.  
  194.            The calling syntax of PrintGL is:
  195.  
  196.              PRINTGL plotfile /option1 /option2 ...
  197.  
  198.            The  plotfile  may  be  specified  with  the  /P  option  if  it  is
  199.            inconvenient to make it the first parameter.
  200.  
  201.            If a given option is entered more  than once, only the last entry is
  202.            used.  And if  an  option  is invalid  (but  not  incorrect),  it is
  203.            ignored.  This  lets  you set  up a  batch  file with your preferred
  204.            options  but override them as desired.  For example,  create PHP.BAT
  205.            with the line:
  206.  
  207.              PRINTGL /FL /M1 /P %1 %2 %3 %4 %5 %6 %7 %8 %9
  208.  
  209.            Then  PHP can be called just  like PRINTGL  but  it  defaults to  HP
  210.            LaserJet format with magnification 1.
  211.  
  212.            '-' may be used instead of '/' to prefix the options.  If you do not
  213.            enter  any parameters  or if  any  parameter  is  incorrect, PrintGL
  214.            displays its help screen.
  215.  
  216.            Below [ and ] enclose optional suboptions  and │  separates mutually
  217.            exclusive suboptions. The options and suboptions may be in any order
  218.            except that multiple numeric suboptions are ordered. "c" refers to a
  219.            suboption  character,  "x"  and  "y"  to  suboption  floating  point
  220.            numbers, "i" and "j" to suboption integers, and "f" to a DOS file or
  221.            device name.  For integer input, floating point numbers are accepted
  222.            and  rounded  to  an  integer.  If an  option has  multiple  numeric
  223.            suboptions, these may be separated with commas or blanks.
  224.  
  225.            ********************************************************************
  226.  
  227.            It  is very important to choose the right output format (/F option).
  228.            It is likely  that  the  default  output  format will  work on  your
  229.            printer, but it is equally likely  that it  will not produce optimal
  230.            results.  Please look carefully at the entire list of output formats
  231.            before  choosing one, and do not assume that because a  format works
  232.            that it is the best one to use.
  233.  
  234.            ********************************************************************
  235.                                                                              
  236.  
  237.                                                                             g-5
  238.          /A - LOCATION OPTION
  239.  
  240.            /A[O][x,y] - location - default /A
  241.  
  242.            The A option determines  the  location of the plot  in  the  printer
  243.            window, by specifying a point on the plot that is to be aligned with
  244.            a point in the printer window. The point on the plot is normally its
  245.            center,  but  you can specify  a point with x,y  in  inches from the
  246.            plot's  origin.  The  point  in  the printer window is  normally the
  247.            center, but O says to make it the origin.  The  default /A  puts the
  248.            center of the plot at the center of the printer window.
  249.  
  250.            When PrintGL is  finding the center of a plot, the  entire rectangle
  251.            defined  by any IW command  is included  in the overall  size of the
  252.            plot.
  253.  
  254.          /C - PEN COLOR OPTION
  255.  
  256.            /Cc.. - color - default /CL
  257.  
  258.            The C  option specifies  the color of each  of the eight  pens.  The
  259.            colors are  B  for blue, C for cyan, G for green, L for black, M for
  260.            magenta, R for red, and Y for yellow.  Unspecified pens use the last
  261.            specified color  (/CRGB is the  same as /CRGBBBBBB).  If  the output
  262.            format does not allow color then this option is ignored.
  263.  
  264.            The following output formats handle colors:
  265.  
  266.              /FB  bit map
  267.              /FE  EGA
  268.              /FN  Epson 9 pin
  269.              /FP  HP PaintJet
  270.              /FT  Epson 24 pin
  271.              /FV  VGA
  272.              /FW  alternate VGA
  273.  
  274.            Color  may  be  emulated on  black only  printers  with shading  (/S
  275.            option).
  276.  
  277.          /D - OUTPUT DESTINATION OPTION
  278.  
  279.            /Df - destination - default /D1
  280.  
  281.            The D option specifies the output printer port, device, or file.  1,
  282.            2, or  3 causes PrintGL  to use the BIOS printer routines, bypassing
  283.            DOS.  This is  normally faster than specifying the DOS device (LPT1,
  284.            LPT2, LPT3), but  it  may  cause  problems with  print  spoolers  or
  285.            multitasking systems.
  286.  
  287.            Display output  can only go to the screen and causes this  option to
  288.            be ignored.
  289.                                                                              
  290.  
  291.                                                                             g-6
  292.          /F - OUTPUT FORMAT OPTION
  293.  
  294.            /Fc[+│-│*│i,j] - output format - default /FG
  295.  
  296.            The F option specifies which output  format to use.  The  format  is
  297.            chosen with a device character and  a resolution modifier (-, +, *).
  298.            *, +, and - are allowed even where they have no affect. For bit maps
  299.            you can choose a specific  resolution in dots per inch.  Resolutions
  300.            here are given in horizontal x vertical dots/inch.
  301.  
  302.            To return to DOS from a displayed plot, press Esc.
  303.  
  304.            /F1     IBM Proprinter ..................................... 120x72
  305.            /F1+    IBM Proprinter (2 pass)                              120x144
  306.            /F2     IBM Quietwriter 2 .................................. 240x240
  307.            /F3     IBM Quietwriter 3                                    240x240
  308.            /F4-    IBM LaserPrinter ................................... 150x150
  309.            /F4     IBM LaserPrinter                                     300x300
  310.            /F5     IBM Proprinter X24 compatible printers ............. 180x180
  311.            /F5+    IBM Proprinter X24 compatible printers (2 pass)      360x180
  312.            /F6     IBM Proprinter X24 ................................. 180x182
  313.            /F6+    IBM Proprinter X24 (2 pass)                          360x182
  314.            /FB     bit map ............................................ 100x100
  315.            /FBi,j  bit map                                                ixj
  316.            /FC     CGA display ......................................... 62x25
  317.            /FE     128K EGA color display                                62x45
  318.            /FH     Hercules graphics card display ...................... 70x45
  319.            /FL-    HP LaserJet compatible printers                      150x150
  320.            /FL     HP LaserJet compatible printers .................... 300x300
  321.            /FM     128K EGA monochrome display                           62x45
  322.            /FN     Epson 9 pin compatible printers .................... 120x72
  323.            /FN+    Epson 9 pin compatible printers (3 pass)             120x216
  324.            /FN*    Epson 9 pin compatible printers (6 pass) ........... 240x216
  325.            /FP     HP PaintJet                                          180x180
  326.            /FT     Epson 24 pin compatible printers ................... 180x180
  327.            /FT+    Epson 24 pin compatible printers (2 pass)            360x180
  328.            /FT*    Epson 24 pin compatible printers (4 pass) .......... 360x360
  329.            /FV     VGA display                                           62x62
  330.            /FV+    enhanced VGA display 720x540 mode ................... 70x70
  331.            /FV*    enhanced VGA display 800x600 mode                     78x78
  332.            /FW     VGA display ......................................... 62x62
  333.            /FW+    alternate enhanced VGA display 800x600 mode           78x78
  334.  
  335.          /I - SCALING POINT LOCATION OPTION
  336.  
  337.            /IA│R│W[N] - IP point location - default /IA
  338.  
  339.            The I  option sets the  initial scaling points (P1, P2 - the scaling
  340.            points may  be  set  in  the HP-GL  file  with the  IP  command).  A
  341.            (absolute) sets the points to 250,279 and 10250,7479 (the same as an
  342.            HP 7470). R fits P1 and P2 to the plot window with at least .25 inch
  343.            margins and an x/y ratio of 10/7.2 (the same ratio as the  HP 7470).
  344.            W fits P1 and P2 to the plot window with a .25 inch margin.  N makes
  345.            the margin 0 for R or W and is ignored with A.
  346.                                                                              
  347.  
  348.                                                                             g-7
  349.          /L - PAGE LAYOUT OPTION
  350.  
  351.            /L[B][F][R][x,y[,x,y]] - page layout - default depends on printer
  352.  
  353.            The L option defines the page layout.
  354.  
  355.            B boxes the plot at the hard clip limits using pen 8. This generally
  356.            increases the amount of data  sent to a printer, but not bit maps or
  357.            displays.
  358.  
  359.            F  causes a form feed after the plot.  This  is ignored for bit maps
  360.            and display output.
  361.  
  362.            R causes reverse  video (black on white)  on one color display plots
  363.            and bit maps and is otherwise ignored.
  364.  
  365.            The first optional x and  y are the  plot width and height in inches
  366.            rounded to .01.  These define the hard clip limits. These values are
  367.            not checked against your printer's capabilities.  If  you specify  a
  368.            page  layout larger than the  output  device can handle, the results
  369.            are unknown.  You may need to reset your  printer's margins, maximum
  370.            line length, or page length to get large plots.  The size needed for
  371.            a given width and height exceeds x and y by 8 pels to allow for line
  372.            widths.
  373.  
  374.            The  second optional x and y are the left and top margins,  measured
  375.            from the printer's left and top margins to the hard clip limits. The
  376.            left margin  is rounded to .01 inch.  The top margin is rounded to a
  377.            1/6  inch  and  line  feeds  (assumed to  be 1/6 inch)  are  used to
  378.            position the paper.  The margins  are subject to printer  resolution
  379.            and  efficiency considerations,  and may not be  exact.  Margins are
  380.            ignored for display output and bit maps.
  381.  
  382.            Each printer has a default page layout. The default width and height
  383.            are  7.53x10.14  for  printers  and  bit  maps  and  10.14x7.53  for
  384.            displays.  The  margins  are  printer  specific  to  compensate  for
  385.            different default  margins.  In  evaluating  user  options,  PrintGL
  386.            processes each option and when finished reprocesses the default page
  387.            layout  for  the  last chosen printer and then  reprocesses the last
  388.            user /L option.  This  procedure gives good default  values so  that
  389.            your /L option can change the  letter or  size  suboptions and still
  390.            have good margins.
  391.  
  392.          /M - MAGNIFICATION OPTION
  393.  
  394.            /M[F]x - magnification - default /MF.9
  395.  
  396.            The M option specifies the magnification.  F  fits the  plot to  the
  397.            printer window size.  The default is  /MF.9 which makes the plot 90%
  398.            of the largest size that will fit in the printer window.
  399.                                                                              
  400.  
  401.                                                                             g-8
  402.          /N - PAGE NUMBER OPTION
  403.  
  404.            /N[i] - page number - default /N
  405.  
  406.            Ni says to print only page i of the plotfile.  If you do not specify
  407.            i then all pages in the plot will be printed (this is the default).
  408.  
  409.          /O - ORIGIN AND ORIENTATION OPTION
  410.  
  411.            /O1│2│3│4[L] - origin, orientation - default /O1 or /O2
  412.  
  413.            The O options sets the printer's origin and orientation.  The origin
  414.            is  one of four corners numbered  1..4 for upper  left, lower  left,
  415.            lower  right,  and upper  right.  The  L suboption  specifies a left
  416.            handed coordinate  system (this should never be  needed).  1  is the
  417.            default  origin for  printers and  matches the  plotter's coordinate
  418.            system.  2 is the default origin for displays which also matches the
  419.            plotter's coordinates due to the reversed width/height ratio.
  420.  
  421.          /P - PLOTFILE OPTION
  422.  
  423.            /Pf - plotfile - no default
  424.  
  425.            The  plotfile  may  be specified  as the first parameter without any
  426.            prefix, or  it may be specified anywhere in the option list with the
  427.            /P prefix.
  428.  
  429.          /S - PEN SHADING OPTION
  430.  
  431.            /Sc.. - pen shading patterns - default /S0
  432.  
  433.            This option assigns a shading pattern to each pen.  Unspecified pens
  434.            use the last specified shade.  The  shade values are 0..7.  0 is the
  435.            default  solid line.  1..4 are 1 dot patterns (75%, 50%, 25%, 12.5%)
  436.            and  need  line widths of at least three to give good looking lines.
  437.            5..7 are 2x2 dot patterns (75%, 50%, 25%) and need line widths of at
  438.            least five  to give good looking lines.  Some printers may wash  out
  439.            shading because they  have a dot size  that is large relative to the
  440.            dot spacing.  This is especially  true with dot  matrix printers  in
  441.            multipass modes.
  442.  
  443.            1         2         3        4         5         6         7
  444.            █▀█▀█▀█▀  ▀▄▀▄▀▄▀▄  ▀ ▀ ▀ ▀  ▀   ▀     ████████  ██  ██    ██  ██
  445.            █▀█▀█▀█▀  ▀▄▀▄▀▄▀▄  ▀ ▀ ▀ ▀    ▀   ▀   ██  ██      ██  ██
  446.            █▀█▀█▀█▀  ▀▄▀▄▀▄▀▄  ▀ ▀ ▀ ▀  ▀   ▀     ████████  ██  ██    ██  ██
  447.            █▀█▀█▀█▀  ▀▄▀▄▀▄▀▄  ▀ ▀ ▀ ▀    ▀   ▀   ██  ██      ██  ██
  448.  
  449.          /T - TEMPORARY FILE OPTION
  450.  
  451.            /Tf - temporary file - default /TPRINTGL.TMP
  452.  
  453.            PrintGL uses a temporary file when it does not have enough memory to
  454.            handle a  plotfile.  It does  not use extended or expanded memory so
  455.            you can best utilize this memory by  putting the temporary file on a
  456.            RAM disk  in  the  extra  memory.  If you have 640K and average size
  457.            plotfiles then  it is likely that PrintGL will never use a temporary
  458.            file.
  459.                                                                              
  460.  
  461.                                                                             g-9
  462.          /W - PEN WIDTH OPTION
  463.  
  464.            /Wc.. - pen widths - default /WA
  465.  
  466.            The W option assigns a line width to each pen (1..8). Each width may
  467.            be  1..8 pels or A..H for the default  width of the  selected output
  468.            format plus 0..7 (maximum 8).  Unassigned pens use the last assigned
  469.            width.
  470.  
  471.            The default line  width  is 1 for all output formats except  240 and
  472.            300 dpi printers which have a default line width of 2.
  473.  
  474.          /Y - Y/D SWITCH SETTING OPTION
  475.  
  476.            /YD│Y - Y/D switch setting - default /YD
  477.  
  478.            The Y option sets the plotter's rear panel Y/D switch to D  or Y.  Y
  479.            starts with the plotter off and responds to esc.(, esc.Y, esc.), and
  480.            esc.Z  commands.  D  starts with  the plotter  on and  ignores these
  481.            commands.
  482.  
  483.          /Z - CHORD ANGLE OPTION
  484.  
  485.            /Zi,j - default and minimum chord angle - default /Z15,5
  486.  
  487.            The HP 7470 defaults  to a  chord  angle of  5  and has  no minimum.
  488.            Because  PrintGL stores each  chord  in a  circle  in  its  internal
  489.            database, this can be  very  time consuming.  And because of the low
  490.            resolution   of  printers  it  does   not  produce  a  corresponding
  491.            improvement in print quality. The Z option specifies the default and
  492.            minimum  chord angles.  The default is /Z15,5.  For better emulation
  493.            use /Z5,0.
  494.                                                                              
  495.  
  496.                                                                            g-10
  497.          EPSON 9 PIN PRINTERS
  498.  
  499.            /FN covers a wide range  of  9  pin dot matrix printers.  You need a
  500.            cyan/magenta/yellow ribbon  to  get  color  prints.  /FN+ uses 1/216
  501.            indexing and /FN* uses 1/216 indexing and 1/240 graphics.
  502.  
  503.            The IBM  9  pin  Proprinters do not do  1/216  indexing and  do  not
  504.            correctly handle 1/240  graphics commands.  /FP  is a special driver
  505.            for Proprinters.
  506.  
  507.          EPSON 24 PIN PRINTERS
  508.  
  509.            /FT covers the entire line of Epson LQ printers and  many compatible
  510.            printers  (NEC,  Panasonic,  etc.).  You need  a cyan/magenta/yellow
  511.            ribbon to get color prints. /FT+ uses 1/360 graphics mode. /FT* uses
  512.            1/360 graphics mode and 1/360 indexing and resets the printer's line
  513.            feed distance to 1/6 inch on completion.
  514.  
  515.            These  drivers will not  work with IBM  Proprinter X24s in alternate
  516.            graphics mode because they use the absolute tab command.
  517.  
  518.          HP LASERJET
  519.  
  520.            /FL works with any LaserJet or DeskJet.
  521.  
  522.            This driver assumes that your printer is in portrait mode.
  523.  
  524.            At  300 dpi (the default), if you have just 512K  in a LaserJet then
  525.            your  plot can  cover about  half  the area of  the  page.  1.5M  is
  526.            sufficient for  a  full page of graphics.  At  150  dpi (/FL-)  512K
  527.            handles  a full  page.  (All  DeskJets  can  handle a full  page  of
  528.            graphics at 300 dpi.)
  529.  
  530.            /FL- defaults to a page  height of 10.11 inch instead of 10.14 inch,
  531.            so that plots fit on a page without changing margins.
  532.  
  533.          HP PAINTJET
  534.  
  535.            /FP should work with  any 180  dpi HP-PCL  printer, including the HP
  536.            Rugged Writer, but this has not been tested.
  537.                                                                              
  538.  
  539.                                                                            g-11
  540.          IBM LASERPRINTER
  541.  
  542.            /F6 drives the  LaserPrinter  in  native mode.  /FL will work if the
  543.            LaserPrinter is in HP LaserJet mode.
  544.  
  545.            At 300 dpi (the default), if you have just 512K in your LaserPrinter
  546.            then your plot can cover about half of the page.  1.5M is sufficient
  547.            for a full page of graphics.  At 150 dpi (/F6-) 512K  handles a full
  548.            page.
  549.  
  550.          IBM PROPRINTER
  551.  
  552.            The /FP driver  is  for all 9 pin  Proprinters.  The high resolution
  553.            driver (/FP+) uses  1/144  inch indexing  and it does  not work with
  554.            Epson 9 pin compatible printers that have 1/216 inch indexing.
  555.  
  556.            There  is no  /FP*  resolution,  which  would  be  240x144,  because
  557.            Proprinters do not handle 1/240 graphics correctly.
  558.  
  559.          IBM PROPRINTER X24
  560.  
  561.            The /F5 driver covers all Proprinter  X24s.  These printers  can use
  562.            the X24 compatible driver (/F4), but because they do 1/144 indexing,
  563.            the print will have horizontal white streaks every 2/3 inch. The /F5
  564.            drivers  compensate  for  the  indexing  by  defining  the  vertical
  565.            resolution as 182 dots per inch  and  indexing 19/144 inch per line.
  566.            To work properly the printer  must be  on a  1/144 boundary when the
  567.            graphics are printed.  If you keep the line feed distance a multiple
  568.            of 1/144 (1/6, 1/8, 1/9) then this will always be the case.
  569.  
  570.            Proprinter X24 and  XL24  are very  slow with  graphics, making many
  571.            passes per line.  This limitation cannot be  overcome  with software
  572.            (to the best of my knowledge).  The X24E and XL24E are significantly
  573.            faster, and are much preferred to the original X24s.
  574.  
  575.          IBM PROPRINTER X24 COMPATIBLE PRINTERS, IBM QUICKWRITER
  576.  
  577.            The IBM Quickwriter is  a  Proprinter X24 compatible printer  except
  578.            that  it does 1/180 indexing.  This is  probably the  case with most
  579.            Proprinter X24 compatible printers. /F4 is the correct driver to use
  580.            for  such  printers.   /F5  (the  Proprinter  X24   driver)  is  not
  581.            recommended.
  582.  
  583.          IBM QUIETWRITER 2 AND 3
  584.  
  585.            The Quietwriter  drivers reset the  line  feed distance to 1/6  inch
  586.            upon completion.
  587.                                                                              
  588.  
  589.                                                                            g-12
  590.          CGA DISPLAY
  591.  
  592.            The  CGA  driver (/FC)  does not give  color.  The  CGA card has  no
  593.            graphics mode that supports the 7 colors used by PrintGL.
  594.  
  595.          EGA DISPLAY
  596.  
  597.            The EGA drivers (/FE, /FM) require a 128K or 256K EGA. If you have a
  598.            64K EGA, the CGA (/FC) driver will work.
  599.  
  600.            /FM is for an EGA card with  a digital monochrome  monitor attached.
  601.            If  your display  adaptor supports  Hercules  modes, /FH  will  give
  602.            better resolution.
  603.  
  604.          HERCULES DISPLAY
  605.  
  606.            /FH supports the  Hercules  monochrome graphics card.  There  is  no
  607.            support for the Hercules InColor card.
  608.  
  609.          MCGA DISPLAY
  610.  
  611.            /FV will work with an MCGA if you do not use color.
  612.  
  613.          VGA DISPLAY
  614.  
  615.            The  /FV+  output  format requires a VGA card that  supports 720x540
  616.            mode.  The  /FV* output  format  requires a  VGA card  and multisync
  617.            monitor  that  support  800x600 mode.  You may need to run a special
  618.            driver that is supplied  with  the card to get these modes.  PrintGL
  619.            sets up the screen by  setting BIOS display modes hex 63 and hex 64.
  620.            Your VGA card must use these modes to work with /FV+ and /FV*.
  621.  
  622.            /FW+ is the  same as /FV* except that it uses BIOS display  mode hex
  623.            58 to set 800x600 mode.  This works with Paradise enhanced VGA cards
  624.            with multisync monitors. /FW is identical to /FV.
  625.  
  626.          BIT MAPS
  627.  
  628.            Color bit maps are two pels per byte.  Each  pel nibble  = 1*blue  +
  629.            2*green + 4*red +  8*intensity.  The  intensity is 0 for black and 1
  630.            otherwise.  The  background is  15  - white,  which  is  not  a user
  631.            selectable color.
  632.  
  633.            /CL  (default) bit  maps are 8  pels/byte with 1 meaning black and 0
  634.            background.  This may  be  reversed  with  the R suboption of the /L
  635.            option.
  636.  
  637.            The  map size is the size specified  by the L  option plus 8 pels in
  638.            each direction to give room for line widths of up to 8 pels.
  639.                                                                              
  640.  
  641.                                                                            g-13
  642.          PLOTFILE SPECIFICS
  643.  
  644.            In reading a plotfile, PrintGL ignores carriage returns, line feeds,
  645.            and nulls  except where  they may be valid characters (LB,  SM,  DT,
  646.            esc.), and ASCII EOF (dec 26) is interpreted as an end of file mark.
  647.  
  648.            PrintGL's HP-GL specification is taken  from the HP 7470 programming
  649.            manual.  PrintGL supports  this  HP-GL  subset  except for  digitize
  650.            commands, output commands,  the error mask command, and most  device
  651.            control commands  (plotter  on  and  off  are supported).  Supported
  652.            commands  are listed  here.  Commands  that  are  not supported  are
  653.            ignored.
  654.  
  655.            Two extensions are  also supported.  Form feed  commands are allowed
  656.            and 8 pens are allowed instead of 2.  To take advantage of the this,
  657.            it may be useful to use a 7475 (6 pens) or 7550 (eight pens and form
  658.            feeds) driver to create your plotfile.
  659.  
  660.            AA x,y,aa[,ca]                     arc absolute
  661.            AF                                 new page (extension)
  662.            AR x,y,aa[,ca]                     arc relative
  663.            CA [0/1/2/3/4]                     designate alternate character set
  664.            CI r[,ca]                          circle
  665.            CP [sp,ln]                         character plot
  666.            CS [0/1/2/3/4]                     designate standard character set
  667.            DF                                 set default values
  668.            DI [run,rise]                      absolute direction
  669.            DR [run,rise]                      relative direction
  670.            DTt                                define label terminator
  671.            IN                                 initialize
  672.            IP [p1x,p1y[,p2x,p2y]]             input p1 and p2
  673.            IW xll,yll,xur,yur                 input window
  674.            LB...text...t                      label
  675.            LT [pn,pl]                         designate line type and length
  676.            PA [x,y] [,x,y] ...                plot absolute
  677.            PD [x,y] [,x,y] ...                pen down
  678.            PG [i]                             new page (extension)
  679.            PR [x,y] [,x,y] ...                plot relative
  680.            PU [x,y] [,x,y] ...                pen up
  681.            SA                                 select alternate character set
  682.            SC xmin,xmax,ymin,ymax             scale
  683.            SI [width,height]                  absolute character size
  684.            SL [tan a]                         character slant
  685.            SM[c]                              symbol mode
  686.            SP [0/1/2/3/4/5/6/7/8]             select pen (2..8 extension)
  687.            SR [width,height]                  relative character size
  688.            SS                                 select standard character set
  689.            TL [[tp],tn]                       tick length
  690.            UC [[pc,]dx,dy] [[,pc],dx,dy] ...  user defined character
  691.            XT                                 x-axis tick
  692.            YT                                 y-axis tick
  693.            esc.(                              plotter on (only with /YY)
  694.            esc.Y                              plotter on (only with /YY)
  695.            esc.)                              plotter off (only with /YY)
  696.            esc.Z                              plotter off (only with /YY)
  697.                                                                              
  698.  
  699.                                                                            g-14
  700.          LINE TYPE PATTERNS
  701.  
  702.            Below are PrintGL's line type patterns.  They  are close to, but not
  703.            identical to HP's.  Line type patterns are dynamically limited  to a
  704.            minimum length of 20 pels.
  705.  
  706.            0        at endpoints only
  707.            1        ─         ─         ─         ─
  708.            2        ─────     ─────     ─────     ─────
  709.            3        ────────  ────────  ────────  ────────
  710.            4        ─────── ─ ─────── ─ ─────── ─ ─────── ─
  711.            5        ────── ── ────── ── ────── ── ────── ──
  712.            6        ───── ─ ─ ───── ─ ─ ───── ─ ─ ───── ─ ─
  713.            default  ────────────────────────────────────────
  714.  
  715.            Note  that line type  is  specified in an HP-GL plotfile with the LT
  716.            command - it is not a property of the pen that is being used to draw
  717.            the  line.  You  cannot specify  that  a  certain pen  should  use a
  718.            specific line type.  (Color, shading, and  width  are pen properties
  719.            and can be assigned to pens.)
  720.                                                                              
  721.  
  722.                                                                            g-15
  723.          COMPATIBILITY AND TECHNICAL INFORMATION
  724.  
  725.            PrintGL will run on any IBM compatible MS-DOS computer. It will work
  726.            in  a  region  as small as 80K but  may need  more memory  for  high
  727.            resolution  or wide prints.  104K should suffice for the worst  case
  728.            black/white prints  -  13.2 inches wide, 360x360 dpi.  Color  output
  729.            requires  an additional  32K  or  more  for high  resolution /  wide
  730.            prints. 184K is needed for the worst case.  A larger region may make
  731.            things go  faster by allowing larger buffers and averting the use of
  732.            a spill file.
  733.  
  734.            By default PrintGL uses the BIOS printer interrupt to send data to a
  735.            printer.  If  a  file or device is specified for output then DOS 2.0
  736.            file handling is  used instead.  PrintGL uses  DOS 2.0 file handling
  737.            for all  disk input and output.  Screen messages are done  with DOS,
  738.            graphics screen modes  (except Hercules) are set up  with  BIOS, and
  739.            graphics  screen updates are done by writing directly to the display
  740.            buffer. Keyboard handling is done via BIOS.
  741.  
  742.            PrintGL takes the BIOS break interrupt (hex 1B) and the DOS critical
  743.            error interrupt (hex 24) in addition to those  taken  by  the  Turbo
  744.            Pascal 5.5 startup code.
  745.  
  746.            PrintGL was compiled with Borland's Turbo Pascal 5.5.
  747.  
  748.          WHAT TO DO IF YOU HAVE PROBLEMS
  749.  
  750.            If  you  have problems with PrintGL or questions about it, there are
  751.            two  ways  to get  in  touch with me.  First is  my support bulletin
  752.            board.  Prepare a file  with the details  of your problem.  Call the
  753.            bulletin board at 606-268-0577  (1200/2400,N,8,1  24 hours/day)  and
  754.            upload  your file.  It will be assigned a question number - remember
  755.            this number.  I will  prepare  an  answer file, hopefully  within 48
  756.            hours. Call the bulletin board and download the corresponding answer
  757.            file to get your answer. All question and answer files are public.
  758.  
  759.            You  can  also mail questions  on disk  to  me (360K, 720K, or 1.44M
  760.            diskettes  only - I  cannot  read  1.2M  diskettes).  Please include
  761.            return postage. Send the diskette to:
  762.  
  763.              Cary Ravitz
  764.              P. O. Box 25068
  765.              Lexington, KY  40524-5068
  766.  
  767.            I must have specific details. Do not assume that I know what you are
  768.            trying to do.
  769.