home *** CD-ROM | disk | FTP | other *** search
/ Media Share 13 / mediashare_13.zip / mediashare_13 / ZIPPED / GRAFX / PRTGF110.ZIP / PRINTGF.DOC < prev    next >
Text File  |  1994-02-06  |  78KB  |  1,375 lines

  1.  
  2.  
  3.  
  4.                                      PrintGF  1.10
  5.  
  6.                       PrintGF/D - GIF printer for IBM/DOS systems
  7.                       PrintGF/W - GIF printer for Windows systems
  8.  
  9.                       (c) Copyright Ravitz Software Inc. 1993,1994
  10.  
  11.                   AccuSoft IFL image interpreter for DOS - PRINTGF.OVR
  12.                 AccuSoft IFL image interpreter for Windows - PRINTGF.DLL
  13.  
  14.                      (c) Copyright AccuSoft Corporation  1992,1993
  15.  
  16.                         Fargo Primera PR ROM code - PRINTGF.FPR
  17.  
  18.                        (c) Copyright Fargo Electronics, Inc. 1993
  19.  
  20.  
  21.          Ravitz Software Inc.                              BBS/FAX 606-268-0577
  22.          P.O. Box 25068
  23.          Lexington, KY  40524-5068
  24.          USA                                  Compuserve Cary Ravitz [70431,32]
  25.  
  26.  
  27.          ------------------------------ License -------------------------------
  28.  
  29.          PrintGF (including PrintGF/D and PrintGF/W) is provided  as is.  There
  30.          are no warranties expressed or implied.
  31.  
  32.          PrintGF  is  copyrighted  by  Ravitz  Software  Inc.  PRINTGF.OVR  and
  33.          PRINTGF.DLL are  copyrighted by AccuSoft  Corporation.  PRINTGF.FPR is
  34.          copyrighted by  Fargo Electonics, Inc.  You may copy  PrintGF only for
  35.          use under this license agreement.
  36.  
  37.          PrintGF  is distributed as  shareware.  You  may  use  PrintGF without
  38.          charge  on a trial basis to determine its suitability for you.  If you
  39.          continue  to  use it  after  your  evaluation,  you  MUST  purchase  a
  40.          registered  copy  for $34.  The  PrintGF shareware  package  does  not
  41.          include PRINTGF.DLL.
  42.  
  43.          You may  distribute  PrintGF  without  PRINTGF.DLL  as  a stand  alone
  44.          product if  you keep the entire package together, unchanged, including
  45.          this license explanation, and do not charge more than $10. You may not
  46.          distribute PrintGF as part of another product or on the same disk with
  47.          any commercial software.
  48.  
  49.          See License and Registration for more information.                    
  50.  
  51.  
  52.          ------------------------------ Contents ------------------------------
  53.  
  54.          Introduction ....................................................... 3
  55.          License and Registration                                             4
  56.          What Is New ........................................................ 4
  57.          Installation                                                         5
  58.          Operation .......................................................... 5
  59.          Syntax                                                               6
  60.          Overview of Options ................................................ 7
  61.          /1, /2, /3, /4, /5 - Default Options                                 7
  62.          /A - Area Option ................................................... 7
  63.          /B, /C - Brightness, Contrast Options                                8
  64.          /D - Output Destination Option ..................................... 8
  65.          /E - AccuSoft IFL Option                                             9
  66.          /F - Output Format Option .......................................... 9
  67.          /G - GIF File Option                                                11
  68.          /I - Intermediate File Option ..................................... 11
  69.          /J, /K - Printer Code Prefix, Suffix Options                        11
  70.          /L - Page Layout Option ........................................... 12
  71.          /N - Page Number Option                                             12
  72.          /Q - Print Quality Options ........................................ 13
  73.          /X - User Interface Option                                          13
  74.          /Y - Gray Balance Correction Option ............................... 14
  75.          /Z - Gamma Correction Option                                        14
  76.          Menu .............................................................. 15
  77.          Menu Specific Functions                                             15
  78.          Menu Input and Picture Quality Options ............................ 16
  79.          Menu Output Options                                                 16
  80.          Menu Window and Margins ........................................... 16
  81.          Large Paper                                                         17
  82.          Answers ........................................................... 17
  83.          Useful Prefix and Suffix Codes                                      18
  84.          Dithering ......................................................... 19
  85.          Blurring                                                            20
  86.          Gamma Color Correction ............................................ 20
  87.          Color Processing                                                    21
  88.          Output Devices .................................................... 22
  89.          Compatibility and Technical Information                             28
  90.          User Support ...................................................... 28
  91.  
  92.                                                                             p-3
  93.          Introduction ---------------------------------------------------------
  94.  
  95.            PrintGF is a shareware GIF printer for IBM/DOS and Windows  systems.
  96.            It includes a DOS program that can be run from  the command line and
  97.            BAT files or via menu (PrintGF/D) and  an equivalent Windows program
  98.            (PrintGF/W).  It prints GIF  files on  Epson and IBM 9 pin printers,
  99.            Epson, Fujitsu, IBM, NEC, and Toshiba 24 pin  printers, HP LaserJet,
  100.            DeskJet, PaintJet, HI JetPro, IBM ExecJet, LaserPrinter,  Canon LBP,
  101.            BJ, and  BJC printers,  Kodak  Color  4, Fargo  Primera,  PostScript
  102.            printers, Tektronix ColorQuick, and others.  It will also display on
  103.            a CGA, EGA, VGA, VESA SVGA, or HGC.
  104.  
  105.            PrintGF includes an overlay (PRINTGF.OVR) and DLL (PRINTGF.DLL) that
  106.            contain the AccuSoft Image Format  Library image interpreter for DOS
  107.            and Windows. These let PrintGF read a number of image formats beyond
  108.            GIF, including BMP, JPEG, PCX, TARGA, and TIFF.  These files are not
  109.            needed for  reading GIF images.  PRINTGF.DLL is not included in  the
  110.            shareware version of PrintGF.
  111.  
  112.            PrintGF transforms the bit map size and resolution to match the user
  113.            specified size and the native resolution of  the output  device.  It
  114.            outputs 240 level dithered gray on black/white devices and 240 level
  115.            per  plane dithered color on three plane (CMY  or RGB) color devices
  116.            (giving  13  million  colors).  The  dither  pattern  size and error
  117.            diffusion filter can be set to trade speed verses print quality.
  118.  
  119.            The  user  options include  picture  area,  print area  and margins,
  120.            processing  resolution,  brightness  and contrast,  gamma  and  gray
  121.            balance color correction, printer type, output destination, etc.
  122.  
  123.            GIF  stands  for Graphics Interchange Format.  It is  a widely  used
  124.            format for storing bit mapped images.  The images are defined with a
  125.            palette of  up  to  256 colors each defined at 256 levels per plane.
  126.            GIF  files  are compressed  via  LZW  compression  and  may  contain
  127.            multiple images so they are an efficient way of handling images.
  128.  
  129.            The  Graphics  Interchange Format  (c) is the  Copyright property of
  130.            CompuServe  Incorporated.  GIF  (sm)  is a  Service Mark property of
  131.            CompuServe Incorporated. For further information, please contact:
  132.  
  133.              CompuServe Incorporated
  134.              Graphics Technology Department
  135.              5000 Arlington Center Blvd
  136.              Columbus, OH  43220
  137.              USA
  138.  
  139.            This program is produced by a member of the Association of Shareware
  140.            Professionals (ASP).  ASP wants to  make  sure  that  the  shareware
  141.            principle  works   for  you.   If  you   are  unable  to  resolve  a
  142.            shareware-related  problem  with  an ASP  member  by  contacting the
  143.            member directly, ASP may be able to help. The ASP Ombudsman can help
  144.            you resolve a  dispute or problem  with an  ASP member, but does not
  145.            provide technical support for members' products. Please write to the
  146.            ASP  Ombudsman at  545  Grover Road,  Muskegon, MI 49442  or send  a
  147.            CompuServe message via CompuServe Mail to ASP Ombudsman 70007,3536. 
  148.  
  149.                                                                             p-4
  150.          License and Registration ---------------------------------------------
  151.  
  152.            PrintGF (including PrintGF/D and PrintGF/W) is provided as is. There
  153.            are no warranties expressed or implied.
  154.  
  155.            PrintGF is  copyrighted  by  Ravitz  Software  Inc.  PRINTGF.OVR and
  156.            PRINTGF.DLL are copyrighted by AccuSoft Corporation.  PRINTGF.FPR is
  157.            copyrighted by Fargo Electonics, Inc.  You may copy PrintGF only for
  158.            use under this license agreement.
  159.  
  160.            PrintGF  is distributed as shareware.  You  may use  PrintGF without
  161.            charge on a trial basis to determine its suitability for you. If you
  162.            continue  to  use  it  after  your  evaluation, you MUST purchase  a
  163.            registered copy  for $34.  The  PrintGF shareware  package  does not
  164.            include PRINTGF.DLL.  Registration covers use by a single person (on
  165.            multiple computers) or installation  on  a  single computer (may  be
  166.            used by a group of people).  There is no cost to  use  a  later 1.**
  167.            version after registering any 1.** version.
  168.  
  169.            You may  distribute PrintGF  without PRINTGF.DLL  as  a  stand alone
  170.            product  if  you  keep  the  entire  package   together,  unchanged,
  171.            including this license explanation, and do not charge more than $10.
  172.            You  may not distribute PrintGF as part of another product or on the
  173.            same disk with any commercial software.
  174.  
  175.            To  purchase a registered copy of PrintGF,  send your name, address,
  176.            and $34 check to:
  177.  
  178.              Ravitz Software Inc.
  179.              P.O. Box 25068
  180.              Lexington, KY  40524-5068
  181.              USA
  182.  
  183.            You  will be  sent a current disk - specify  3.5 or  5.25 inch disk.
  184.            PRINTGF.DLL is included on this disk.  If  you previously registered
  185.            PrintGF, you may send $10 to get a current disk.
  186.  
  187.            For users outside the USA it is preferred that the check be drawn on
  188.            a  bank in the US, Canada, England,  France, or  Switzerland, and be
  189.            payable in  US Dollars.  If  the check is  drawn on a  bank from any
  190.            other  country,  please  make it  payable in  the currency  of  that
  191.            country with the amount calculated at the current exchange rate.
  192.  
  193.          What Is New ----------------------------------------------------------
  194.  
  195.            Version 1.10 replaces  PrintGF  and  PGFMenu  with  PrintGF/D,  adds
  196.            PrintGF/W,   adds  online  help  (F1),  supports  PostScript,  Fargo
  197.            Primera, direct parallel port drive  (/DP1,  etc.),  picture  aspect
  198.            ratio is  maintainted unless  stretch  is  specified,  landscape  is
  199.            specified with the /A option.
  200.  
  201.            Version 1.08 enhances PGFMENU with new mouse and  color control  and
  202.            sorted directory lists. PRINTGF.OVR is a general image interpreter.
  203.  
  204.            The latest version of PrintGF is available from the support bulletin
  205.            board at  606-268-0577 (1200..14400, N,8,1, 24 hours/day, XMODEM, 1K
  206.            XMODEM, or ZMODEM download), packed in ZIP format.                  
  207.  
  208.                                                                             p-5
  209.          Installation ---------------------------------------------------------
  210.  
  211.            Copy the files PRINTGFD.EXE, PRINTGFW.EXE, PRINTGF.OVR, PRINTGF.DLL,
  212.            PRINTGF.FPR, and PRINTGF.DOC to your working disk or directory.  All
  213.            of  these files should be in the same directory  and it is preferred
  214.            that the directory be in your DOS PATH.  PRINTGF.OVR and PRINTGF.DLL
  215.            are needed  only for non GIF images.  PRINTGF.FPR is needed only for
  216.            Fargo  Primera  Photo-Realistic prints.  In  addition,  the README.*
  217.            files (quick information) are included  in the  package and  must be
  218.            included if you distribute PrintGF as shareware.
  219.  
  220.            To install  PrintGF/W  as  an icon in the  Windows  Program Manager,
  221.            select File, then  New, then program  item  to bring  up the Program
  222.            Item  Properties menu.  Enter the item name - PrintGF/W, the command
  223.            line - \path\PRINTGFW, and the working directory - wherever you keep
  224.            your  GIF  files.  You can choose from three icons designed for two,
  225.            sixteen, and 32K color setups.
  226.  
  227.          Operation ------------------------------------------------------------
  228.  
  229.            When working with flat GIF files (most of them), printed in portrait
  230.            orientation,  PrintGF  reads  a  GIF file and prints simultaneously.
  231.            Interlaced GIF files, landscape prints, Primera  output, and  images
  232.            read by the AccuSoft IFL  image interpreter require PrintGF  to read
  233.            the entire  file into XMS  memory and then  print  it, so there is a
  234.            delay between startup and printing.
  235.  
  236.            Esc  stops PrintGF at the next good break point, leaving the printer
  237.            ready for new data. Ctrl-B stops PrintGF as quickly as possible. You
  238.            generally need to do a printer reset after a Ctrl-B.
  239.  
  240.            When  you display a plot, press Enter or Esc to  return to  the  DOS
  241.            text screen, any of the four cursor movement keys  to  scroll across
  242.            the  plot, PgDn to magnify, PgUp  to reduce, or  S  to cycle between
  243.            full, half (the default), quarter, and eighth page scrolling.
  244.  
  245.            Print  quality  and print  speed are  predominantly affected by  the
  246.            output format (/F) and quality option (/Q). Color and gray level are
  247.            predominantly affected by the brightness (/B), contrast (/C),  gamma
  248.            correction (/Z), and gray balance  (/Y).  Look  at these options  to
  249.            correct any such problems.
  250.  
  251.            PrintGF works within a printer's current margins  and starts at  the
  252.            current  vertical print  position.  If  you decline  the  form  feed
  253.            suboption  of the  /L option then PrintGF leaves the  printer at the
  254.            start of the  line directly below the plot.
  255.  
  256.            PrintGF will not automatically change a printer's operating mode. On
  257.            multimode  printers, the  right  operating  mode must be  set before
  258.            running PrintGF or with the prefix code (/J) option.                
  259.  
  260.                                                                             p-6
  261.          Syntax ---------------------------------------------------------------
  262.  
  263.            PrintGF can  be run  from  the command  line (DOS  or Windows) using
  264.            various options to tell it what to do. And it can be started with no
  265.            options  to  bring  up  a  menu  system.   The   menu  options  have
  266.            corresponding command line options, so the two forms of options will
  267.            be described together.  The menu options are noted by  the menu name
  268.            in  quotes followed by  the  menu  choice  in  quotes,  for  example
  269.            "page/area" "GIF page number:".
  270.  
  271.            From the command line, the calling syntax is:
  272.  
  273.              PRINTGF  giffile /option1 /option2 ...
  274.              PRINTGFW giffile /option1 /option2 ...
  275.  
  276.            Spaces  between  parameters  are not required.  The GIF file may  be
  277.            specified with the  /G option if  it is  inconvenient to make it the
  278.            first parameter.
  279.  
  280.            If a given option is entered more than once,  only the last entry is
  281.            used.  And if  an  option  is invalid (but  not  incorrect),  it  is
  282.            ignored.
  283.  
  284.            When run  from the  command  line,  PrintGF uses  the  current  menu
  285.            options as the default,  so if you have  the menu set up as desired,
  286.            you can run PRINTGFW giffile from the command line  and  avoid going
  287.            through the menu to select the giffile.
  288.  
  289.            Below, [ and ] enclose optional suboptions and  | separates mutually
  290.            exclusive suboptions. The options and suboptions may be in any order
  291.            except  that  multiple  numeric suboptions are ordered  and  numeric
  292.            suboptions must follow character suboptions where the characters may
  293.            be digits.  "c" refers to a suboption character, "w",  "x", "y", and
  294.            "z"  to  suboption numbers,  "i", "j", "k",  and  "l"  to  suboption
  295.            integers, "b" to  a suboption byte,  and "f" to a DOS file or device
  296.            name.
  297.  
  298.            For  numbers (w,  x, y, z),  a decimal point  is allowed but is  not
  299.            required, and scientific notation is not allowed. "-" is allowed but
  300.            not "+". For integer input (i, j, k, l), only base ten integers from
  301.            -32768 to 32767 are allowed. "+" is not allowed.  A byte (b) must be
  302.            a base ten integer from  0  to 255 or a hexadecimal  number prefixed
  303.            with $ from  $00  to $FF.  Further  range checking is  done for most
  304.            options  to  flag  unreasonable  input.  If  an  option has multiple
  305.            numeric suboptions, these may be separated with commas or blanks.   
  306.  
  307.                                                                             p-7
  308.          Overview of Options --------------------------------------------------
  309.  
  310.            PrintGF's options fall into four categories.  The first is input and
  311.            output choices.  The input  is chosen with /G, the GIF file, /N, the
  312.            page number, and /A, the area of the GIF file to be printed.  Output
  313.            options  are  /F,  the output format  (printer  model), and /D,  the
  314.            destination port, device, or file.
  315.  
  316.            The  second category is the page  layout.  /L  controls the size and
  317.            location of the print window and the option to not send a form feed.
  318.  
  319.            The third category defines how the image is processed. /B and /C set
  320.            the brightness  and contrast.  /Q sets  the dither type and and blur
  321.            level.  /Y sets the gray balance and /Z sets gamma color correction.
  322.            /E specifies the image interpreter.
  323.  
  324.            /X sets all of the user interface options and /1, /2, /3, /4, and /5
  325.            choose one of the menu setups as the command line default.
  326.  
  327.          /1, /2, /3, /4, /5 - Default Options ---------------------------------
  328.  
  329.            These command line options  select  a configuration from the menu to
  330.            be  used as the default.  This option must match the first character
  331.            of the title of one of the five menu configurations.
  332.  
  333.          /A - Area Option -----------------------------------------------------
  334.  
  335.            /A[L][M][S]i,j,k[,l] - area to be printed - default /A50,50,100
  336.  
  337.            "page/area" "picture area:"
  338.            "page/area" "landscape: "
  339.            "page/area" "mirror: "
  340.            "page/area" "stretch to fit window: "
  341.  
  342.            /A defines the area of the GIF file that is to be printed and offers
  343.            several options  to  modify  the  printed  image.  This  can be  any
  344.            rectangular  area, defined by the center point of the rectangle, its
  345.            width, and  optionally  its  height.  The center point is set as the
  346.            percent  distance from the left and top of the picture to the center
  347.            of  the area  (0..100).  The width  is set  as  a  percentage of the
  348.            picture width, from 1 to 100.  The height may be set as a percentage
  349.            of the picture  height (1..100) or  defaulted to the same percentage
  350.            as the width.  The  center point will be adjusted to insure that the
  351.            entire width and height are on the picture.
  352.  
  353.            The L  suboption specifies landscape  orientation.  M says to mirror
  354.            the image.  S says to stretch the picture to fill the  print window.
  355.            This can distort the aspect ratio, which may be desirable if PrintGF
  356.            has  misinterpreted the true aspect ratio.  This often  happens when
  357.            there  is no information in the bit map that lets  PrintGF determine
  358.            the correct value. S is ineffective if you have set the print window
  359.            height to 0.
  360.  
  361.            /A50,50,100     the default, prints the entire picture
  362.            /A25,25,50      prints the upper left hand quarter of the picture
  363.            /A25,75,50      prints the lower left hand quarter of the picture
  364.            /A25,90,20      is adjusted to 25,80,20 so the area fits            
  365.  
  366.                                                                             p-8
  367.          /B, /C - Brightness, Contrast Options --------------------------------
  368.  
  369.            /Bi[,j[,k]] - brightness - default /B50
  370.            /Ci[,j[,k]] - contrast   - default /C50
  371.  
  372.            "print quality" "brightness:"
  373.            "print quality" "contrast:"
  374.  
  375.            PrintGF modifies each GIF  color  based on  the  /B and /C  options.
  376.            These  numbers can  be  specified overall  or  for each  color plane
  377.            (RGB). They are applied before any conversion to black/white.
  378.  
  379.            The brightness  number  specifies  the output level (%) at  an input
  380.            level  of  50%.  50  is  the default  and it  leaves  the brightness
  381.            unchanged.
  382.  
  383.            The contrast number specifies  the difference  in  output  level  at
  384.            input level 100% verses input level 50%.  50 is  the  default and it
  385.            leaves the contrast unchanged.
  386.  
  387.            Output  levels clip at 0% and 100%.  If the brightness plus contrast
  388.            total  100 or less then you will not clip any colors at the top.  If
  389.            the brightness  minus the contrast  is 0 or  above then you will not
  390.            clip any colors at the bottom.
  391.  
  392.          /D - Output Destination Option ---------------------------------------
  393.  
  394.            /D[+]f - destination - default /D1
  395.  
  396.            "destination"
  397.  
  398.            The D option specifies the output printer port, device, or file. The
  399.            + suboption causes files to be appended rather than overwritten  (it
  400.            has no effect on device output). 1, 2, and 3 select the BIOS printer
  401.            routines.  P1, P2, and P3 select direct parallel port drive. X1, X2,
  402.            X3, and X4 select xon/xoff controlled serial port drive. H1, H2, H3,
  403.            and H4 select hardware controlled serial  port drive.  You  can also
  404.            use  the DOS  devices LPT1, COM1,  etc.  /D  is ignored for  display
  405.            output.
  406.  
  407.            For PrintGF/W, specify W to send data to the Windows print manager.
  408.  
  409.            P1, P2, and P3 are generally the fastest way to drive a printer.
  410.  
  411.            PrintGF cannot set up the serial ports.  This is usually done in the
  412.            AUTOEXEC.BAT with MODE (probably MODE COM1:9600,N,8,1,P).
  413.  
  414.            /D2           sends output to the second parallel port via BIOS
  415.            /DLPT3        sends output to the DOS device LPT3
  416.            /D+TEMP.PRN   appends output to file TEMP.PRN                       
  417.  
  418.                                                                             p-9
  419.          /E - AccuSoft IFL Option ---------------------------------------------
  420.  
  421.            /E - read bit map via AccuSoft IFL image interpreter
  422.  
  423.            "interpreter"
  424.  
  425.            If  you add the /E option  to the PrintGF command line, it reads the
  426.            GIF file via the AccuSoft Image Format Library interpreter contained
  427.            in  PRINTGF.OVR (DOS)  or  PRINTGF.DLL  (Windows,  registered copies
  428.            only).  This interpreter  reads  a  number  of  different file types
  429.            including BMP, GIF,  JPEG,  PCX, TARGA, and TIFF.  These  images are
  430.            loaded  directly into XMS  memory before  any processing,  so XMS is
  431.            required  for any use of this interpreter.  24  bit  images  require
  432.            three bytes per pixel for the entire original image.  For a 1024x768
  433.            image this is 2.25 Meg.
  434.  
  435.          /F - Output Format Option --------------------------------------------
  436.  
  437.            /Fc[-|+|*|^][%][!|¡][~|`][x,y] - output format - default /FN~
  438.  
  439.            "output format"
  440.            "print quality" "CMY (3) or CMYK (4) color: "
  441.            "print quality" "Primera heat (1..96): "
  442.  
  443.            The F  option specifies  the  output format.  -,  +,  *,  and  ^ are
  444.            resolution modifiers, ! and ¡ select compression levels, ~ turns off
  445.            color  processing, and  ` switches  to  or  from  four  plane  color
  446.            processing.  % uses equivalent Windows modes instead of full  screen
  447.            displays. These suboptions are allowed even if they have no effect.
  448.  
  449.            For PCX and PostScript (/FZ, /FS) you can append the resolution. For
  450.            the Primera (/F8) you can append the heat setting (1..96).
  451.  
  452.            Each printer driver has a default level of  data compression, chosen
  453.            to give maximum compatibility among the different  printers that the
  454.            driver supports.  Many  drivers have  an optional enhanced  level of
  455.            compression, chosen with  !.  This  will be incompatible  with  some
  456.            printers.  And  some drivers let you turn all compression off with ¡
  457.            (ASCII 173).  This is rarely of any use.  Where these suboptions are
  458.            effective, they are marked in the table below.
  459.  
  460.            Drivers  marked below with  ~  can handle color.  Using ~ suppresses
  461.            color processing, substituting black for all colors except white.  `
  462.            switches between 3 and 4 plane color (see Color Processing).
  463.  
  464.            /F1            IBM 9 pin .................................... 120x72
  465.            /F2            IBM Quietwriter 2                             240x240
  466.            /F3            IBM Quietwriter 3 ........................... 240x240
  467.            /F4-       !¡  IBM LaserPrinter (PPDS mode)                  150x150
  468.            /F4        !¡  IBM LaserPrinter (PPDS mode) ................ 300x300
  469.            /F4+       !¡  IBM LaserPrinter (PPDS mode)                  600x600
  470.            /F5        ! ~ IBM 24 pin alternate 1 ...................... 180x180
  471.            /F6        !   IBM Proprinter X24                            180x182
  472.            /F7-        ¡  Canon BJ IBM mode, IBM ExecJet .............. 180x180
  473.            /F7         ¡  Canon BJ IBM mode, IBM ExecJet                360x360
  474.  
  475.                                                                       continued
  476.  
  477.                                                                            p-10
  478.            /F8[i]       ~ Fargo Primera, heat i ....................... 203x203
  479.            /F8+[i]      ~ Fargo Primera Photo-Realistic, heat i         203x203
  480.            /F9        ! ~ NEC 24 pin .................................. 180x180
  481.            /F#-        ¡  JRL J bubblejet Epson mode                    180x180
  482.            /F#         ¡  JRL J bubblejet Epson mode .................. 360x360
  483.            /F&-         ~ Canon BJ/BJC native mode                      180x180
  484.            /F&          ~ Canon BJ/BJC native mode .................... 360x360
  485.            /F@-         ~ Canon BJC CaPSL mode                          180x180
  486.            /F@          ~ Canon BJC CaPSL mode ........................ 360x360
  487.            /FA-       ! ~ HP DeskJet 500C, Mannesmann Tally MT92C       150x150
  488.            /FA        ! ~ HP DeskJet 500C, Mannesmann Tally MT92C ..... 300x300
  489.            /FB-        ¡~ Canon BJ/BJC Epson mode                       180x180
  490.            /FB         ¡~ Canon BJ/BJC Epson mode ..................... 360x360
  491.            /FC            CGA display                                     80x33
  492.            /FD-       !¡  Canon LBP (ISO/CaPSL mode) .................. 150x150
  493.            /FD        !¡  Canon LBP (ISO/CaPSL mode)                    300x300
  494.            /FD+       !¡  Canon LBP (ISO/CaPSL mode) .................. 600x600
  495.            /FE          ~ 128K EGA color display                          80x58
  496.            /FF        ! ~ Fujitsu 24 pin .............................. 180x180
  497.            /FG         ¡  PDP Protracer (IBM mode)                      360x360
  498.            /FH            Hercules graphics card display ................ 90x58
  499.            /FI-           HP LaserJet 3, DeskJet                        150x150
  500.            /FI            HP LaserJet 3, DeskJet ...................... 300x300
  501.            /FI+           HP LaserJet 4                                 600x600
  502.            /FJ-           Canon BJ BJ130 mode ......................... 180x180
  503.            /FJ            Canon BJ BJ130 mode                           360x360
  504.            /FK          ~ Kodak Diconix Color 4 ....................... 192x192
  505.            /FL-       !¡  HP LaserJet                                   150x150
  506.            /FL        !¡  HP LaserJet ................................. 300x300
  507.            /FM            128K EGA monochrome display                     80x58
  508.            /FN          ~ Epson 9 pin .................................  120x72
  509.            /FO        ! ~ Toshiba 24 pin                                180x180
  510.            /FP        ! ~ HP PaintJet ................................. 180x180
  511.            /FQ            HP QuietJet (PCL mode)                        192x192
  512.            /FR          ~ Tektronix ColorQuick ........................ 216x216
  513.            /FS-[i[,j]]  ~ PostScript 1 bit/plane                72x72, ixi, ixj
  514.            /FS[i[,j]]   ~ PostScript 8 bits/plane ............ native, ixi, ixj
  515.            /FT        ! ~ Epson 24 pin                                  180x180
  516.            /FU-         ~ 320x200 256+ color VGA or VESA SVGA display ... 40x33
  517.            /FU          ~ 640x480 256+ color VESA SVGA display            80x80
  518.            /FU+         ~ 800x600 256+ color VESA SVGA display ........ 100x100
  519.            /FU*         ~ 1024x768 256+ color VESA SVGA display         128x128
  520.            /FU^         ~ 1280x1024 256+ color VESA SVGA display ...... 160x170
  521.            /FV          ~ 640x480 VGA display                             80x80
  522.            /FV+         ~ 800x600 VESA SVGA display ................... 100x100
  523.            /FV*         ~ 1024x768 VESA SVGA display                    128x128
  524.            /FV^         ~ 1280x1024 VESA SVGA display ................. 160x170
  525.            /FW          ~ Epson 9 pin alternate                          120x72
  526.            /FX        ! ~ IBM 24 pin alternate 2 ...................... 180x180
  527.            /FZ[i[,j]]   ~ ZSoft PCX                           100x100, ixi, ixj
  528.  
  529.                                                                            p-11
  530.          /G - GIF File Option -------------------------------------------------
  531.  
  532.            /Gf - GIF file - no default
  533.  
  534.            "gif file"
  535.  
  536.            The GIF file may be specified as the first parameter with no prefix,
  537.            or it may be specified anywhere in the option list with /G.
  538.  
  539.            When  the  GIF  file  name is SHADE4  to  SHADE256  (with no path or
  540.            extension), PrintGF generates data internally  giving  a color scale
  541.            with 4  to 256  steps.  This is  useful for setting  the gamma color
  542.            correction and gray balance correction.
  543.  
  544.          /I - Intermediate File Option ----------------------------------------
  545.  
  546.            /I[f] intermediate output file - default /I
  547.  
  548.            "other output" "intermediate file:"
  549.  
  550.            /I  lets you specify an intermediate file for  data  output.  During
  551.            processing all print  data is sent to this file.  Then the  file  is
  552.            copied to the destination.  This is  only effective for destinations
  553.            1..3,  H1..H4,  P1..P3,  and  X1..X4  (direct drive devices).  It is
  554.            useful when the device requires continuous, fast data flow.
  555.  
  556.          /J, /K - Printer Code Prefix, Suffix Options -------------------------
  557.  
  558.            /J[b,b,..] - printer code prefix - default /J
  559.            /K[b,b,..] - printer code suffix - default /K
  560.  
  561.            "other output" "prefix codes: "
  562.            "other output" "suffix codes: "
  563.  
  564.            /J lets you send codes to the printer before PrintGF's usual data is
  565.            sent and /K  lets you send codes after PrintGF's usual data is sent.
  566.            This lets you set up and reset the  printer for special  situations.
  567.  
  568.            The codes  are  specified  with  byte  values  (0..255  or  $0..$FF)
  569.            separated with  blanks  or commas.  All  options are  limited  to 80
  570.            characters, so long sequences must be handled outside of PrintGF.
  571.  
  572.            /J27,69  does a printer reset on HP-PCL printers                    
  573.  
  574.                                                                            p-12
  575.          /L - Page Layout Option ----------------------------------------------
  576.  
  577.            /L[N][x[,y[,x,y]]] - page layout - default /L8,6,0,0
  578.  
  579.            "window/margins"
  580.            "other output" "form feed:"
  581.  
  582.            The L option defines the page layout.
  583.  
  584.            N turns form feeds off. It is ignored for PCX and display output.
  585.  
  586.            The first  optional x and y are the print window width and height in
  587.            inches, which is the output image size. If the height is 0 or is not
  588.            included, it is set to give the correct aspect ratio for the image.
  589.  
  590.            The second optional x and y are the left  and top margins,  measured
  591.            from the printer's left margin and current vertical position to  the
  592.            print  window.  Margins  are  measured  from  the  bottom  left  for
  593.            PostScript. Margins are ignored for PCX output.
  594.  
  595.            THE PRINT WINDOW PLUS THE MARGINS MUST FIT WITHIN THE PRINTABLE AREA
  596.            OF THE PRINTER.
  597.  
  598.            /L8,4,0,1  print window 8x4, margins 0,1
  599.  
  600.          /N - Page Number Option ----------------------------------------------
  601.  
  602.            /Ni - page number - default /N1
  603.  
  604.            "page/area" "page number:"
  605.  
  606.            The /N option specifies the GIF page number to print.
  607.  
  608.            /N3  prints page 3                                                  
  609.  
  610.                                                                            p-13
  611.          /Q - Print Quality Options -------------------------------------------
  612.  
  613.            /Q[1|2|4|8][F|P|R|S|X][B|D|N] - print quality - default /Q1RN
  614.  
  615.            "print quality" "dither pattern (1|2|4|8): "
  616.            "print quality" "error diffusion (F|P|R|S|X):"
  617.            "print quality" "blur level (0|1|2):"
  618.  
  619.            The 1, 2, 4, and  8 suboptions specify the dither pattern cell size.
  620.            With 1 each output dot is treated  as one dot internally  with shade
  621.            levels 0 or 1. With 2, 4, and 8 output dots are grouped in 2x2, 4x4,
  622.            and 8x8 cells with shade levels 0..4, 0..16, and 0..64.  Larger cell
  623.            sizes   are   faster  and  smaller  cell  sizes  gives  better  edge
  624.            definition. The default is 1.
  625.  
  626.            For the 256+ color VGA modes  (/FU), the Primera in  Photo-Realistic
  627.            mode (/F8+), and PostScript 8/24 bit mode  (/FS+) the output devices
  628.            are multi-level and the dither pattern cell size is always 1.
  629.  
  630.            Regardless  of the  dither  pattern,  the  output shade  levels  are
  631.            dithered to 0..240 (or  0..192, 0..170  for some drivers) via  error
  632.            diffusion.   Four  error   diffusion  filters  are  available.   The
  633.            Floyd-Steinberg  filter is  selected with  suboption  F.  The Stucki
  634.            filter  is selected  with S.  A special  filter,  labeled Ravitz, is
  635.            selected with R (the default). And the Ravitz filter with 50% random
  636.            noise added into the weights is selected with P (Perturbed).
  637.  
  638.            You can turn off error diffusion dithering, leaving only the pattern
  639.            dither, with the X suboption. This might be useful with the 8x8 This
  640.            might be useful with the 8x8 dither pattern.
  641.  
  642.            If too much digitization detail shows in the output picture, you can
  643.            reduce it  with the  Blur or Double blur  suboptions.  These options
  644.            increase the processing time and the required memory.  You  can also
  645.            reduce detail by increasing the dither pattern  cell size.  This  is
  646.            faster but may not give the same picture quality.
  647.  
  648.            See Dithering for more information on PrintGF's dithering options.
  649.  
  650.          /X - User Interface Option -------------------------------------------
  651.  
  652.            /X[P][S] - interface options - default /X
  653.  
  654.            "other output" "pause to load paper:"
  655.  
  656.            The X option sets various interface options. P causes a pause before
  657.            each printed page. S suppresses extra information messages.
  658.  
  659.            /XS  gives only the most important messages                         
  660.  
  661.                                                                            p-14
  662.          /Y - Gray Balance Correction Option ----------------------------------
  663.  
  664.            /Y[H|R][x,y,z] - gray balance - default /Y1,1,1
  665.  
  666.            "print quality" "gray balance (c,m,y):"
  667.            "print quality" "gray balance type (H|R):"
  668.  
  669.            /Y lets you do gray balancing to compensate for printers  that use a
  670.            cyan, magenta, yellow ink mix to produce an non-neutral  black.  The
  671.            three  numbers represent the  fraction of cyan, magenta, and  yellow
  672.            ink to use to  get  a  neutral black.  H  specifies  HP's  suggested
  673.            compensation  for  the  HP   DeskJet   500C  printer.   R  specifies
  674.            compensation on the black component of each color, without regard to
  675.            the total non-black range.
  676.  
  677.            /YR1,1,1    is the default and does no gray balancing
  678.            /YH.67,1,1  is HP's recommended value for the HP DeskJet 500C
  679.  
  680.          /Z - Gamma Correction Option -----------------------------------------
  681.  
  682.            /Zw[,x,y[,z]] - gamma correction - default /Z.5 or /Z1
  683.  
  684.            "print quality" "gamma correction (r,g,b):"
  685.  
  686.            This  option  specifies the use of the gamma  shade  level  transfer
  687.            function that corrects  for typical printer nonlinearity.  The value
  688.            may be specified for overall red,  green, and blue (one number), for
  689.            independent red, green, and blue (three numbers) or  for independent
  690.            cyan,  magenta,  yellow, and black  (four  numbers).  A value of 1.0
  691.            gives  a  linear  response.  Values from 0.1  to  1.0  increase  the
  692.            brightness  of the output.  The default is 0.5 for most printers and
  693.            1.0 for displays. The default for the Primera is 1.0
  694.  
  695.            See Gamma Color Correction for more information.                    
  696.  
  697.                                                                            p-15
  698.          Menu -----------------------------------------------------------------
  699.  
  700.            PrintGF/D  and PrintGF/W include a menu interface to let  you select
  701.            options, choose  a list  of GIF files, and  print.  Run  PRINTGLD or
  702.            PRINTGLW with no command line parameters to bring up the menu.
  703.  
  704.            The main menu is displayed at the top of the screen, and  the bottom
  705.            of the screen is used differently for each main menu item.  The main
  706.            menu  is  divided by column into four groups, described  below.  The
  707.            functions of the PrintGF options are described in detail above.
  708.  
  709.            When the  cursor is on  a  main menu item, the current value  of the
  710.            option is displayed below the main menu.  To change the value, press
  711.            Enter (or left mouse button).  The options are  modified with cursor
  712.            movement and typing numbers/names.  The Enter key returns you to the
  713.            main  menu  with the new option values.  Esc (or right mouse button)
  714.            returns you to the main menu with the option values unchanged.
  715.  
  716.            The PrintGF documentation (this file)  can be viewed by  pressing F1
  717.            from any menu that displays F1 on its key line.
  718.  
  719.            If  one of the first two letters of a main menu item is capitalized,
  720.            that item may be accessed immediately by pressing the letter.
  721.  
  722.            When a cursor bar has a notch, the value in the notch may be edited.
  723.  
  724.          Menu Specific Functions ----------------------------------------------
  725.  
  726.            The  first  column  of  main  menu  options  is  dedicated  to  menu
  727.            functions.  These include running PrintGF, switching to an alternate
  728.            configuration, exit, saving the current configurations, and set menu
  729.            options.
  730.  
  731.            The  "Alt  configuration" item rotates between five  configurations.
  732.            The current configuration name is on line 2.
  733.  
  734.            The "save configurations" item  saves the  current configurations by
  735.            writing them to the  EXE file.  The GIF file list is not saved.  You
  736.            can create multiple EXE files with different names and each can have
  737.            its own configurations.
  738.  
  739.            The  "menu options" item lets you set the configuration name, screen
  740.            colors, up to five initial plotfile masks, and  the name of  the BAT
  741.            file created by the "create BAT" option. Screen colors are specified
  742.            with the mnemonics listed here:
  743.  
  744.              k black    r red             k+ gray            r+ bright red
  745.              b blue     m magenta         b+ bright blue     m+ bright magenta
  746.              g green    y yellow/brown    g+ bright green    y+ bright yellow
  747.              c cyan     w white           c+ bright cyan     w+ bright white
  748.  
  749.            For PrintGF/W you can also use - and * as color modifiers. These are
  750.            only  effective with 15, 16, or  24  bit  color setups.  To use  the
  751.            default Windows colors with PrintGF/W, blank out the desired line of
  752.            colors.                                                             
  753.  
  754.                                                                            p-16
  755.          Menu Input and Picture Quality Options -------------------------------
  756.  
  757.            Column  two of the main menu lets  you choose the GIF files to print
  758.            (the  /G option  in  PrintGF), the  GIF page number (/N) and picture
  759.            area  (/A),  and  the  picture quality  (/F`  -  CMY  or CMYK  color
  760.            processing, /B - brightness, /C- contrast, /Q -  quality, /Z - gamma
  761.            color  correction,  /Y -  gray  balance  correction),  and the image
  762.            interpreter (/E).
  763.  
  764.            You may enter up to 99 GIF files in the "gif file" main menu option.
  765.            To choose from  a list  of files, enter a mask name  and press Enter
  766.            (the cursor must be on the mask).  The menu will then display a list
  767.            of corresponding files. Select any number of the files by moving the
  768.            cursor to the  desired file and  pressing Space (or the middle mouse
  769.            button). If no files have been selected, then pressing Enter selects
  770.            the file under the cursor.  The selected files are added to the file
  771.            list at  or  below  the cursor.  Files that  would overflow the 99th
  772.            position on the plotfile list are dropped.
  773.  
  774.            When you "Run PrintGF", PrintGF is run for each file on the GIF file
  775.            list.  Masks  are  ignored.  For any GIF files that PrintGF does not
  776.            successfully process, an arrow is inserted in front of  the GIF file
  777.            name.  You can view the results from the "gif file" main menu  item.
  778.            The  arrow  is not  considered part  of the file name, so you do not
  779.            need to remove it to retry PrintGF.
  780.  
  781.  
  782.          Menu Output Options --------------------------------------------------
  783.  
  784.            The  third column of options specifies  the output destination (/D),
  785.            output format (/F),  and other output options (/L suboption F - form
  786.            feed, /X  suboption P - pause to load paper, /J prefix codes, and /K
  787.            suffix codes.
  788.  
  789.            In the  output format menu, printers that support color have a color
  790.            option ("clr:"  on the menu).  This  lets  you specify a black/white
  791.            output.  Output formats that do not support color  do  not have this
  792.            option and always convert to black/ white.
  793.  
  794.          Menu Window and Margins ----------------------------------------------
  795.  
  796.            The   fourth   column   of   main   menu   options   includes   just
  797.            "window/margins",  which  lets you  specify the print  area  and its
  798.            position on the paper.                                              
  799.  
  800.                                                                            p-17
  801.          Large Paper ----------------------------------------------------------
  802.  
  803.            PrintGF can handle printing on paper  larger than  the usual 8.5x11,
  804.            but this takes some extra work. First you need to increase PrintGF's
  805.            print window  to cover the large  paper.  This is  done with the  /L
  806.            option.  The print  window  plus  the margins  must  fit  within the
  807.            printer's printable area.
  808.  
  809.            And then you must make  sure that your printer recognizes the larger
  810.            paper height.  For  continuous  forms paper  this  is  best  done by
  811.            setting skip perforation to off,  either by  printer switch or  with
  812.            PrintGF prefix codes.  For Canon, Epson, Fujitsu, IBM, and NEC  line
  813.            printers (dot  matrix,  ink jet, thermal) use  /J27  79,  or "modify
  814.            output" "prefix codes: 27 79".
  815.  
  816.            For  cut  sheet  paper,  on Canon  (except BJ  native  mode), Epson,
  817.            Fujitsu, IBM, and  NEC line printers use /J27 67 0 n, where n is the
  818.            page length in inches.  For the PDP ProTracer use /J27 67 n, where n
  819.            is the page length in lines, at six lines per inch.
  820.  
  821.            And for some printers you need to increase the right margin. For the
  822.            Canon BJC  in  Epson  mode  use  /J27 81 114.  For the HI V50/100 in
  823.            printer mode use /J27 91 88 2 0 1 255.
  824.  
  825.            For page  printers, legal size  paper  may  be specified  with these
  826.            printer code prefixes: HP-PCL  printers  /J27 38 108 51 65  (/K27 38
  827.            108 50 65 to  reset to letter), Canon  LBP  /J27 91  51 50 59 59 112
  828.            (/K27 91 51 48  59 59 112 to reset), IBM LaserPrinter /J27 91 70 5 0
  829.            3 1 2 1 (/J27 91 70 5 0 3 1 1 1 to reset).
  830.  
  831.            To  get  a 10x16  print window on  11x17 paper with  a Canon, Epson,
  832.            Fujitsu,  IBM, or NEC line printer, use these options: /L10 16 0 .25
  833.            /J27 67 0 17.  You  will probably need to adjust the margins (0 .25)
  834.            for best centering.
  835.  
  836.            The maximum  width  of the  print window  on  most  narrow  carriage
  837.            printers is 8.  The maximum print window width on most wide carriage
  838.            printers is 13.6.  The horizontal margin should be  set  to 0 to get
  839.            this width.
  840.  
  841.          Answers --------------------------------------------------------------
  842.  
  843.            For the Canon BJC-800 in Epson mode, the right margin  defaults to 8
  844.            inches. Use /J27 64 27 81 114 to set it to 11.4 inches.
  845.  
  846.            For the  Canon BJ-330 and most wide  carriage printers,  the maximum
  847.            print window  width is 13.57  inches.  This is a printer  limitation
  848.            that you cannot get around.
  849.  
  850.            If your  printer ejects  the paper before the plot is  finished, you
  851.            probably  need to specify a paper length prefix code.  For most line
  852.            printers use /J27 67 0 n where n is the page length in inches.      
  853.  
  854.                                                                            p-18
  855.          Useful Prefix and Suffix Codes ---------------------------------------
  856.  
  857.            Below,  n  represents any number 0..255, nA represents any number in
  858.            ASCII format (1 becomes 49, 2 becomes 50, 43 becomes 52 51, etc.).
  859.  
  860.            Canon,      Reset                    27 64
  861.            Epson,      N inch paper             27 67 0 n
  862.            Fujitsu,    17 inch paper            27 67 0 17
  863.            IBM, NEC    Right margin n columns   27 81 n       (not for IBM)
  864.            dot matrix, Skip perforation off     27 79
  865.            inkjet      Unidirectional printing  27 85 1
  866.  
  867.            HP PCL,     Reset                 27 69
  868.            DeskJet,    Portrait mode         27 38 108 48 79
  869.            LaserJet,   Top margin 0          27 38 108 48 69
  870.            PaintJet    Skip perforation off  27 38 108 48 76
  871.                        11 inch paper         27 38 108 50 65
  872.                        14 inch paper         27 38 108 51 65
  873.                        11x17 inch paper      27 38 108 54 65
  874.                        Manual feed           27 38 108 50 72
  875.                        N copies              27 38 108 nA 88  (page printers)
  876.  
  877.            HP DJ500C   High quality, slow    27 42 111 49 81
  878.                        No ink depletion      27 42 111 49 68
  879.  
  880.            HP PJXL300  Low quality, fast     27 42 111 45 49 81
  881.  
  882.            HP QJ       HP-PCL mode           27 37 65
  883.                        DIP switch mode       27 37 64
  884.  
  885.            IBM LP      11 inch paper, tray 1, n copies  27 91 70 5 0 3 1 1 n
  886.                        14 inch paper, tray 1, n copies  27 91 70 5 0 3 1 2 n
  887.                        14 inch paper, manual, n copies  27 91 70 5 0 1 1 2 n
  888.                        N copies                         27 91 70 5 0 0 0 0 0 n
  889.  
  890.            Can BJ nat  Page length, right margin x 10   27 40 103 3 0 n 1 n
  891.  
  892.            Can CaPSL   Reset                  27 99
  893.                        11 inch paper          27 91 51 48 59 59 112
  894.                        14 inch paper          27 91 51 50 59 59 112
  895.                        Manual feed            27 91 49 113
  896.                        Automatic feed         27 91 48 113
  897.                        Full page memory mode  27 59 27 91 50 38 122
  898.                        N copies               27 91 nA 118
  899.                        Cursor to top of page  27 91 48 100
  900.                        Diablo mode            27 58
  901.                        ISO mode               27 59
  902.  
  903.            PostScript  N copies      nA 32 88 67
  904.                        Paper tray n  nA 32 88 80
  905.  
  906.            ProTracer   N line paper  27 67 n
  907.  
  908.            HI V50/100  Max margins   27,91,88,2,0,1,255                        
  909.  
  910.                                                                            p-19
  911.          Dithering ------------------------------------------------------------
  912.  
  913.            Dithering is the  process  of  reducing  the  0..255 shade per plane
  914.            color the input bit map  to  the  0..1 shade  per plane color of the
  915.            output.  There is  no exact way to do this - edge or color defintion
  916.            will  be lost and artifacts of the dithering process will be visible
  917.            in  the  output.  Because of this, PrintGF offers  a  wide range  of
  918.            dithering options, specified by the /Q option.
  919.  
  920.            PrintGF starts the  dithering process using  a pattern  dither.  The
  921.            output dots  are divided  into groups and each  group  is set from a
  922.            pattern  that gives various levels of color.  The pattern can be 8x8
  923.            dots giving  0..64 shades per  plane (chosen with the 8  suboption),
  924.            4x4 dots giving 0..16 shades (4),  2x2  giving 0..4 shades  (4), and
  925.            1x1 giving shades 0 and 1 (1, the default).
  926.  
  927.            Only  the 8x8 dither  pattern  is  sufficient by  itself to  produce
  928.            acceptable color output, so each of the pattern dithers is  enhanced
  929.            by error diffusion  dithering  (see  Bit-Mapped  Graphics  by  Steve
  930.            Rimmer)  that extends the color levels to 240 levels per plane.  The
  931.            error  diffusion  can be  done  via the  Floyd-Steinberg  filter  (F
  932.            suboption), the  Stucki filter (S), a special  filter labeled Ravitz
  933.            (R - the default), or the Ravitz filter with 50% random perturbation
  934.            of  the weights (suboption P) (as  suggested  by  Robert Ulichney in
  935.            Digital Halftoning), or it can be turned off (X).  The Ravitz filter
  936.            diffuses  error only  to immediate neighbors,  like Floyd-Steinberg,
  937.            but has directional properties close to Stucki's.
  938.  
  939.              Ravitz    x 6      Floyd-Steinberg    x 7      Stucki      x 8 4
  940.                      3 6 1                       3 5 1              2 4 8 4 2
  941.                                                                     1 2 4 2 1
  942.  
  943.            There are some exceptions to the above. 256+ color display modes are
  944.            treated as  0..5,  0..30,  or  0..240 level  color  or  0..30  level
  945.            monochrome  devices  and the pattern dither is not  done.  The Fargo
  946.            Pimera in Photo-Realistic mode and PostScript  in 8/24 bit mode  are
  947.            multi-level  devices  so no  pattern  dither  is done.  And the  8x8
  948.            pattern dither is extended via error  diffusion to 192 levels rather
  949.            than 240.
  950.  
  951.            The 8x8 pattern  dither gives the best color,  the fewest unexpected
  952.            dithering  artifacts  (the pattern  is  always  visible  but is  not
  953.            obtrusive), the fastest processing, and  the worst  edge  defintion.
  954.            This is likely to be the best choice for high resolution devices.
  955.  
  956.            The  1x1  pattern dither  gives  the best edge  definition  and  the
  957.            slowest processing. The error diffusion does all of the dithering in
  958.            this case so the choice of filter is important. The order of fastest
  959.            to slowest filters is F-S, Ravitz, Stucki, and Perturbed.  The order
  960.            of fewest to most visual artifacts is the reverse.  The  1x1 pattern
  961.            is  generally the  best choice for  low  resolution devices and  for
  962.            pictures that require sharp edges such as text and line drawings.
  963.  
  964.            The 2x2 and 4x4  patterns  are  in the middle  of  the 1x1  and  8x8
  965.            patterns on  all of  the attributes and should be tried to determine
  966.            their usefulness.                                                   
  967.  
  968.                                                                            p-20
  969.          Blurring -------------------------------------------------------------
  970.  
  971.            When the  output size  of a bitmap  is significantly larger than the
  972.            input, the rectangular nature of the input dots may become apparent.
  973.            This can be reduced  by  reducing  the processing resolution,  which
  974.            effectively  reduces  the size  of  the  output  bitmap.  If  it  is
  975.            desirable to stay  with a higher  processing resolution then you can
  976.            use blurring to reduce the effect.
  977.  
  978.            PrintGF has two blur filters, chosen with the B and D suboptions  of
  979.            /Q.  The blurring acts on the output bit map, not the input. B blurs
  980.            to 8 neighbors and D blurs to 20 neighbors. This process is slow.
  981.  
  982.              B  121     D   111
  983.                 242        12221
  984.                 121        12421
  985.                            12221
  986.                             111
  987.  
  988.          Gamma Color Correction -----------------------------------------------
  989.  
  990.            Printer's typically overprint the  area  of  a  dot,  for  example a
  991.            nominal 1/300  inch square  dot might be printed  as a 1.2/300  inch
  992.            diameter circle, giving an additional area of 13%. So dithered shade
  993.            levels  composed of single dots will  be 13% too dark.  Shade levels
  994.            composed of multiple  connected dots will also be  too  dark, but by
  995.            less than 13%. Solid white and solid black will exact.
  996.  
  997.            The  gamma  function is a general correction for this behavior.  The
  998.            function is g(x,gamma)=255*((x/255)^gamma) for 0..255 level additive
  999.            color.  For  gamma above 1  the function describes  an  overprinting
  1000.            situation.  Using 1/gamma exactly  reverses  the  function, so if  a
  1001.            printer's gamma is 1.5 then it is corrected by using 1/1.5 = .67.
  1002.  
  1003.            The preferred gamma correction  will  be different for the different
  1004.            dither pattern  sizes.  The  8x8 pattern  will likely need much less
  1005.            gamma correction that the 1x1 pattern.
  1006.  
  1007.            When specifying gamma  independently for cyan,  magenta, yellow, and
  1008.            black PrintGF uses g(x,gamma)=255-255*(((255-x)/255)^gamma). This is
  1009.            so that cyan, magenta, yellow  correction is the same as red, green,
  1010.            blue  correction  if black  gamma is  1 (/Z.6,.7,.8  is the same  as
  1011.            /Z.6,.7,.8,1)
  1012.  
  1013.            When the GIF  file  name  is SHADE4  to SHADE256  (with  no  path or
  1014.            extension), PrintGF generates  data internally  giving a color scale
  1015.            with 4 to 256 steps.  Set up the gamma correction to make this scale
  1016.            look best.
  1017.  
  1018.            The shade scale is also useful for setting up gray balance.         
  1019.  
  1020.                                                                            p-21
  1021.          Color Processing -----------------------------------------------------
  1022.  
  1023.            Color graphics devices use a variety of color technologies.  PrintGF
  1024.            supports these basic types.
  1025.  
  1026.            CMY  or  cyan/magenta/yellow  is  used  by  inkjet  and  dot  matrix
  1027.            printers.  This uses three color planes and gives eight pure colors.
  1028.            Even when black ink is available, using CMY processing may give more
  1029.            consistent  colors than CMYK.  Good gray balance values are critical
  1030.            with CMY color.
  1031.  
  1032.            CMYK  or cyan/magenta/yellow/black is used by inkjet  and dot matrix
  1033.            printers.  This  uses four color planes and gives eight pure colors.
  1034.            Using black ink  instead of a  cyan/magenta/yellow  mix gives a more
  1035.            neutral and sometimes darker black color.
  1036.  
  1037.            RGB or red/green/blue is used by displays  and  bit maps.  This uses
  1038.            three color planes and gives eight pure colors.
  1039.  
  1040.            RGBI  or red/green/blue/intensity is used by  displays and bit maps.
  1041.            This  uses four color  planes to give fifteen pure  colors.  PrintGF
  1042.            uses  only eight  or these fifteen  colors - dark black  and intense
  1043.            red, green, blue, etc.
  1044.  
  1045.            CMY and RGBI are used by default.  CMYK and RGB can be selected with
  1046.            the ` suboption of /F.                                              
  1047.  
  1048.                                                                            p-22
  1049.          Output Devices -------------------------------------------------------
  1050.  
  1051.            Canon BJ and BJC Printers ------------------------------------------
  1052.  
  1053.              PrintGF has five basic drivers for Canon BJ and BJC printers.  /F7
  1054.              is  the  IBM  mode  driver.   It  works  with  the  BJ130e,   BJ5,
  1055.              BJ10/10e/10ex, BJ20, BJ200/230, and BJ300/330.
  1056.  
  1057.              /FJ is the BJ130 mode driver.  It works with all Canon BJ printers
  1058.              in IBM or native mode. The printer is set to 10 pitch text.
  1059.  
  1060.              /FB is the Epson mode driver.  It  works  with the  BJ200/230  and
  1061.              BJC800/820. Color is supported. For the BJC800/820 the prefix code
  1062.              27 81 114 sets the print width to 11.4 inches.
  1063.  
  1064.              /F& is the native  mode driver.  It works  with  the BJ200/230 and
  1065.              BJC800/820 in any mode.  Color is supported. Epson/IBM mode prefix
  1066.              codes are not compatible and are not needed.
  1067.  
  1068.              /F@ is the CaPSL mode driver for the BJC880. Color is supported.
  1069.  
  1070.              Some  of these printers have  an image density option (DIP  switch
  1071.              and/or  front panel switch).  Low density  eliminates every second
  1072.              dot. To get the full 360 dpi resolution, use high density.
  1073.  
  1074.            Canon LBP Printers -------------------------------------------------
  1075.  
  1076.              /FD works with any Canon LBP 4 and 8 printers that do not have the
  1077.              SX or 30 suffix.  If the printer is in Diablo mode, it is switched
  1078.              to ISO  mode.  At 300 dpi it takes up to one meg of printer memory
  1079.              to print a full page of graphics.
  1080.  
  1081.              The ! suboption switches to CaPSL 4 data compression. /FD+! is the
  1082.              best driver for the LBP 8 Mk4 at 600 dpi.
  1083.  
  1084.              You might need to set up the printer with /J27 59 27 91 50 38 122.
  1085.              To switch back to Diablo mode on completion, use /K27 58.
  1086.  
  1087.              Any Canon  LBP printer with  the SX or  30  suffix  is  an  HP-PCL
  1088.              printer and should use the /FI drivers.                           
  1089.  
  1090.                                                                            p-23
  1091.            Display ------------------------------------------------------------
  1092.  
  1093.              When you display a plot, the cursor keys scroll the plot, S cycles
  1094.              between  full,  half  (the  default),  quarter,  and  eighth  page
  1095.              scrolling, PgDn and  PgUp  magnify and reduce by 1.4, and Enter or
  1096.              Esc returns to DOS.
  1097.  
  1098.              Regardless of the size of your monitor, PrintGF acts as if it were
  1099.              8 inches wide.
  1100.  
  1101.              /FC drives a CGA, but does not give color.
  1102.  
  1103.              The EGA drivers, /FE and /FM, require a 128K or 256K EGA. /FC will
  1104.              work with a 64K EGA.  /FM is for an EGA  card with a digital (TTL)
  1105.              monochrome monitor.
  1106.  
  1107.              /FH supports the Hercules monochrome graphics card.
  1108.  
  1109.              /FV works with any VGA card. For MCGAs use /FV~.
  1110.  
  1111.              /FV+  uses VESA  SVGA 800x600 16  color mode.  /FV* uses VESA SVGA
  1112.              1024x768 16 color mode.
  1113.  
  1114.              The  /FU  drivers use 256 or  greater  color modes  to  give 0..5,
  1115.              0..30, or 0..240 level per plane color or 0..30  level monochrome.
  1116.              The processing  resolution  option  is ignored  for these drivers.
  1117.              /FU-  drives any VGA at 320x200.  /FU, /FU+,  /FU*,  and  /FU^ use
  1118.              640x480, 800x600, 1024x768, and 1280x1024 VESA SVGA modes.  All of
  1119.              these drivers first look for a 24 bit (8r,8g,8b) color mode,  then
  1120.              a 15 or 16 bit (5r,5g,5b or 5r,6g,5b)  color  mode, and then an  8
  1121.              bit (256 color palette) color mode,  using the best  mode  that it
  1122.              finds at the specified resolution.
  1123.  
  1124.              Display output cannot be redirected to a file.
  1125.  
  1126.            Epson, IBM 9 Pin Printers ------------------------------------------
  1127.  
  1128.              /FN, /FW, and /F1 cover a wide range of Epson/IBM compatible 9 pin
  1129.              dot  matrix printers.  You need a cyan/magenta/yellow/black ribbon
  1130.              to get color prints. /FW sets line feeds to 1/6 inch.
  1131.  
  1132.            Epson, Fujitsu, NEC, Toshiba 24 Pin Printers -----------------------
  1133.  
  1134.              /FT  covers  all  Epson LQ printers and  many  compatible printers
  1135.              (Panasonic in LQ mode and others).  /FF works with  Fujitsu 24 pin
  1136.              printers in Fujitsu mode.  /F9 works with NEC 24 pin printers. /FO
  1137.              works  with Toshiba 24  pin printers.  /FO  resets the  line  feed
  1138.              distance to 1/6 inch on completion.
  1139.  
  1140.              For all of these  drivers,  you need  a  cyan/magenta/yellow/black
  1141.              ribbon to get color prints.                                       
  1142.  
  1143.                                                                            p-24
  1144.            Fargo Primera ------------------------------------------------------
  1145.  
  1146.              /F8  includes five drivers for the Primera.  /F8 is the CMY driver
  1147.              for standard CMY and CMYK ribbons. /F8` is the CMYK driver for the
  1148.              standard CMYK ribbon. /F8~ is for standard black ribbons.  /F8+ is
  1149.              for  Photo-Realistic CMY  ribbons.  /F8+~  is for  Photo-Realistic
  1150.              black ribbons. XMS memory is required for Primera output.
  1151.  
  1152.              The Primera  heat  level  (1..96)  may be appended  to the  output
  1153.              format option. The default is 20.
  1154.  
  1155.              The Primera requires fast data  flow  and can cause long  waits in
  1156.              the data flow at times. Because of this it is important to use the
  1157.              direct printer port (/DP1, ..)  or BIOS printer destinations (/D1,
  1158.              ..) rather than the LPT destinations (/DLPT1, ..).
  1159.  
  1160.              Depending on your computer and the ribbon type, PrintGF may not be
  1161.              able to send data to the printer  as fast as it needs it.  In this
  1162.              case the printer will still  function  but there  will be indexing
  1163.              errors  or  horizontal  bands in the  print.  To fix  this use the
  1164.              intermediate  file option (/I).  This will send all  output to  an
  1165.              intermediate file and then copy the file to the printer.
  1166.  
  1167.              For  the Primera in  Photo-Realistic mode,  the  Fargo recommended
  1168.              color correction is done after any user specified color correction
  1169.              (brightness, gamma, etc.).
  1170.  
  1171.            Fax/Modems ---------------------------------------------------------
  1172.  
  1173.              PrintGF will not create data for direct use  by fax/modem devices.
  1174.              Most fax software  will read PCX files and  PrintGF  can  generate
  1175.              such files.
  1176.  
  1177.              Use /FZ~200,196 or "ZSoft PCX b/w h,v dpi: 200,196" to  generate a
  1178.              PCX at 200x196 dpi which is the native fax high resolution. 200,98
  1179.              matches the fax standard resolution,  but  this is not recommended
  1180.              for graphics.
  1181.  
  1182.            HI JetPro V50/100 --------------------------------------------------
  1183.  
  1184.              In printer mode the HI V50/100 acts as a Canon BJ IBM mode printer
  1185.              (/F7).  The  maximum  print width is 15.25 and you need the prefix
  1186.              code 27,91,88,2,0,1,255 to get beyond 13.6 inches.
  1187.  
  1188.            HP DeskJet, HP PaintJet XL300, Mannesmann Tally MT92C --------------
  1189.  
  1190.              /FI works with any black/white DeskJet in portrait mode.
  1191.  
  1192.              /FA drives the  DeskJet 500C, PaintJet XL300, MT92C, and any color
  1193.              300 dpi HP-PCL printer that supports data transfer mode 2.
  1194.  
  1195.              /FA  has three modes and covers different  levels of 300 dpi color
  1196.              HP-PCL printers.  /FA uses RGB color  and  works with the  DeskJet
  1197.              500C and Mannesmann  Tally MT92C.  /FA!  uses  CMY color which can
  1198.              speed printing  in some  cases.  This works with the DeskJet 500C,
  1199.              DeskJet 550C, and PaintJet XL300.  /FA!` uses  CMYK  color to give
  1200.              give better blacks on the DeskJet 550C.                           
  1201.  
  1202.                                                                            p-25
  1203.            HP LaserJet --------------------------------------------------------
  1204.  
  1205.              /FL works with any LaserJet compatible printer. /FL! works with LJ
  1206.              2 (PCL 4) printers.  /FI works with LJ 3 (PCL 5) printers. /FI+ is
  1207.              a 600 dpi driver for the LaserJet 4.
  1208.  
  1209.              All  of these drivers work in portrait mode, which may be set with
  1210.              /J 27 38 108 48 79 or you can reset the printer with /J 27 69.
  1211.  
  1212.              LaserJets with under one meg of memory may not be able to handle a
  1213.              full page of graphics. /FL!  uses less printer memory than /FI, so
  1214.              it may be preferred on LaserJet 3s with limited memory.
  1215.  
  1216.            HP PaintJet --------------------------------------------------------
  1217.  
  1218.              /FP drives 180 dpi PaintJet printers.  The compression mode driver
  1219.              (/FP!)  uses  data  transfer  mode 2 (instead of 1) and works only
  1220.              with a PaintJet XL.
  1221.  
  1222.              /FA! (the DeskJet 500C CMY driver) works with the PaintJet XL300.
  1223.  
  1224.            HP QuietJet --------------------------------------------------------
  1225.  
  1226.              /FQ works with QuietJets in HP-PCL mode.
  1227.  
  1228.            IBM Inkjets --ExecJet 4072, ExecJet II 4076, Color Jetprinter 4079 -
  1229.  
  1230.              These are three completely different printers. The ExecJet 4072 is
  1231.              Canon BJ330 compatible. Put the printer in IBM mode and use /F7.
  1232.  
  1233.              The ExecJet II 4076 is a DeskJet compatible printer and should  be
  1234.              used  with  /FI.
  1235.  
  1236.              The 4079 is basically a PostScript printer  and  you can  drive it
  1237.              with  /FS.  However you can get  faster printing by using it as  a
  1238.              raster printer.  Newer versions of the printer can be set to ASCII
  1239.              text mode  and driven with /F& (Canon  BJ native).  Older printers
  1240.              can be turned on with the  two leftmost  buttons  held down  until
  1241.              startup is complete and then put in ASCII dump mode to use /F&.
  1242.  
  1243.            IBM LaserPrinter 4019, 4029, 4037, 4039 ----------------------------
  1244.  
  1245.              /F4  drives  any LaserPrinter 4019, 4029, or 4037 in PPDS (native)
  1246.              mode.  /FL will work for HP LaserJet mode.  At 300 dpi it takes up
  1247.              to one meg of printer memory to print a full page of graphics.
  1248.  
  1249.              The !  suboption or "modify output" "compression mode: Y" switches
  1250.              to 4029 data compression.  /F4+!  works with the 4029 with 600 dpi
  1251.              PPDS upgrade.
  1252.  
  1253.              All 4039s  are HP-PCL printers and should  be driven  with /FI  or
  1254.              /FI+. These printers do not support PPDS mode (/F4).              
  1255.  
  1256.                                                                            p-26
  1257.            IBM 24 Pin Printers ------------------------------------------------
  1258.  
  1259.              PrintGF has three drivers  for Proprinter X24 compatible printers.
  1260.              Use  native  mode, not AGM.  /F6 is for all IBM X24s and  the 24P.
  1261.              These  printers  do 1/144 inch indexing and using  them at 180 dpi
  1262.              gives horizontal  white streaks  every 2/3 inch.  The  /F6 drivers
  1263.              compensate  for this by indexing 19/144  per line, giving 182 dpi.
  1264.              To work properly the  printer must start on  a 1/72 boundary so it
  1265.              is best to keep line feeds at a multiple of 1/72 (1/6, 1/8, 1/9).
  1266.  
  1267.              /F5 is referred to as X24 alternate 1 and is for printers that are
  1268.              X24 compatible  except for  1/180 inch indexing.  This is the case
  1269.              with  most X24 compatible printers, including the IBM  Quickwriter
  1270.              and IBM 2390 and 2391. /F5* works only with printers that do 1/360
  1271.              indexing, including the 2390 and 2391 but not the Quickwriter.
  1272.  
  1273.              /FX  is referred to  as X24  alternate 2  and is  the same  as /F5
  1274.              except for the  vertical units command.  /FX  works with Panasonic
  1275.              printers in X24 mode.
  1276.  
  1277.            IBM Quietwriter 2 and 3 --------------------------------------------
  1278.  
  1279.              /F2  and /F3 drive the Quietwriter 2 and 3.  Line feeds are set to
  1280.              1/6 inch on completion.
  1281.  
  1282.            JRL J bubblejet ----------------------------------------------------
  1283.  
  1284.              /F# drives the JRL J bubblejet in Epson LQ mode.
  1285.  
  1286.            Kodak Diconix Color 4 ----------------------------------------------
  1287.  
  1288.              /FK drives the Color 4.
  1289.  
  1290.            Pacific Data Products ProTracer ------------------------------------
  1291.  
  1292.              /FG drives the ProTracer (base model) in IBM Proprinter mode.  The
  1293.              maximum print window width is 15.
  1294.  
  1295.            PostScript Printers ------------------------------------------------
  1296.  
  1297.              /FS  sends  8  bit  black/white  or  24  bit  color  data.  Unless
  1298.              overridden, the output resolution matches the GIF file.  This lets
  1299.              the PostScript device handle all of the dithering.
  1300.  
  1301.              /FS- drives  PostScript printers  with 1 bit  black/white or 3 bit
  1302.              color.  It  is important to match the  resolution of the driver to
  1303.              the  resolution of the printer for good  results.  Some PostScript
  1304.              printers cannot handle this data.
  1305.  
  1306.              The  vertical  margin  is  from  the   bottom  of  the  page  with
  1307.              PostScript.
  1308.  
  1309.            Tektronix ColorQuick -----------------------------------------------
  1310.  
  1311.              /FR drives the ColorQuick.                                        
  1312.  
  1313.                                                                            p-27
  1314.            ZSoft PCX Bit Map --------------------------------------------------
  1315.  
  1316.              Use /FZ or /FZ~ to output an eight or two color ZSoft PCX bit map.
  1317.              The  horizontal and vertical dots/inch may be appended to override
  1318.              the default 100x100, for example /FZ80,90. PCX should generally be
  1319.              directed to a file with the /D option.
  1320.  
  1321.              Since  most  fax  software  can take PCX  files as input, this  is
  1322.              useful  for  faxing  images.  Use  /FZ~200,196 to  match  the  fax
  1323.              resolution.                                                       
  1324.  
  1325.                                                                            p-28
  1326.          Compatibility and Technical Information ------------------------------
  1327.  
  1328.            PrintGF will  run  on any IBM compatible system  with MS-DOS 3.0  or
  1329.            above. MS-DOS 3.3 or later is recommended. It requires up to 256K of
  1330.            free memory. XMS memory, available from HIMEM, QEMM, 386MAX or other
  1331.            memory  managers, is  required for  interlaced  GIF files, landscape
  1332.            mode printing, AccuSoft IFL use, and printing to the Fargo Primera.
  1333.  
  1334.            PrintGF/W is  an MS Windows  3.1 program.  It  uses  its own printer
  1335.            drivers, not Windows printer drivers.
  1336.  
  1337.            These programs should not be compressed by any EXE file compressors,
  1338.            as they rewrite the EXE when saving configurations.
  1339.  
  1340.            PrintGF was written by Cary Ravitz and compiled with Borland's Turbo
  1341.            Pascal 7.0. PRINTGF.OVR is compiled with Borland's Turbo C++ 3.0 and
  1342.            contains  AccuSoft's  Image  Format  Library  4.0  low  level  image
  1343.            interpreter.   PRINTGF.DLL  is  AccuSofts's  IFL  4.0  Windows  DLL.
  1344.            PRINTGF.FPR is Fargo's Primera Photo-Realistic ROM code.
  1345.  
  1346.          User Support ---------------------------------------------------------
  1347.  
  1348.            Correspondence  about  this  program  may be  sent  via the  support
  1349.            bulletin board, fax, Compuserve, or mail.
  1350.  
  1351.            BBS:        606-268-0577  1200..14400,N,8,1  24 hours/day
  1352.  
  1353.              To ask a question, prepare an ASCII text file with  the details of
  1354.              your question.  Then call the bulletin board and choose the upload
  1355.              question  option.  XMODEM,  1K XMODEM,  or  ZMODEM  file  transfer
  1356.              protocol is required for this.  Your question will be  assigned  a
  1357.              number (such as 1015) - remember this number. An answer file (with
  1358.              the assigned number)  will be posted, usually within  24 hours  on
  1359.              weekdays.  To  get  an answer, call the bulletin board, choose the
  1360.              download option, then the answer option, and then enter the answer
  1361.              number.
  1362.  
  1363.            Compuserve: Cary Ravitz [70431,32]
  1364.  
  1365.            Fax:        606-268-0577
  1366.  
  1367.              If  your fax machine does not send the fax calling signal, the BBS
  1368.              will  answer and  hang  up (about  30  seconds), then the  call is
  1369.              routed to the fax.  Faxes from outside the USA may be answered via
  1370.              letter.
  1371.  
  1372.            Mail:       Ravitz Software Inc.
  1373.                        P.O. Box 25068
  1374.                        Lexington, KY  40524-5068
  1375.                        USA