<<< PRINTFAX.EXE Documentation >>>

    Quick Link II Fax  has  a  flexible   fax   printing   program   called
    PRINTFAX.EXE.   It utilizes printer files with a .QLP extension.  These
    printer files define how the  PRINTFAX  program  should  print  to  the
    target printer.   Shipped on the QL II Fax  distribution  diskette  are
    three printer files.

	   9PIN.QLP will print on most 9 pin printers
	   24PIN.QLP is used for printing to 24 pin printers
	   LASER.QLP for printing to HP LaserJet printers

    This document will help the user who needs to modify  an  existing  QLP
    file to work with their  printer,  or  create  a  new  QLP  file.   The
    PRINTFAX program is used  from  within  the  QL II Fax  application  by
    pulling down the File Menu Bar and selecting the  Print  Fax  function.
    To choose which type of printer you are using, pull down the Setup Menu
    and choose Hardware Setup.  Now Press the Type Button.   A Dialog  will
    appear with a list of all the  printers  supported  by  the  above  QLP
    files.  By picking a printer in the list,  you  are  telling  QL II Fax
    which printer file PRINTFAX should use.

    To add support for an additional printer, you should copy the QLP  file
    which is closest to your printer and name it something else.   Use  the
    following command from the DOS command line:

	   COPY 9PIN.QLP MYPRINT.QLP

    Now using the Edit Old File under the Edit Menu Bar, you will edit  the
    new QLP file to work for your printer.  Once you QLP  file  is  on  the
    screen, you will notice that it  is  a  text  file  with  some  special
    commands in it.  The first few lines of the text  file  lists  all  the
    printers that the QLP file will support.   Since we  are  modifying  an
    existing QLP file, delete all the name in quotes, and add the  name  of
    your printer on the first line  of  the  text  file.   It  should  look
    something like this:

	   "My Printer XYZ-100"
	   ; This line is a comment.  The entire line will be ignored
	   INIT=<ESC>3<24><CR><LF>
	   .
	   .
	   .

    Now you will need to modify each of the printer commands to  work  with
    your printer.  Each printer command can have a  maximum  of  100  char-
    acters in it.  The commands with an * next to them  are  mandatory  and
    must be in the QLP file for it to print.   Here is a  compete  list  of
    printer commands:

	   INIT            String given to printer at the start of a print job
	   START_PAGE      Command given at the beginning of each fax page
	   END_PAGE        Given at the end of each fax page
	   EXIT            Command given to printer at the end of the job

	   These three printer commands are use only when  printing  in  draft
	   mode.   The quality is selected in  Hardware  Setup,  next  to  the
	   printer list.
	  *LOW_RES_DPI     Gives resolution of printer, size of a page
	   LOW_RES_SET     Command given to printer after the INIT to set
				    low res printing.
	  *LOW_RES_PRINT   Command to print graphics in low res.

	   These three printer commands are for normal printing only.
	  *NORM_RES_DPI    Gives resolution of printer, size of a page
	   NORM_RES_SET    Command given to printer after the INIT to set
				    normal res printing.
	  *NORM_RES_PRINT  Command to print graphics in normal res.

	   These three printer commands are for high res printing only.
	  *HI_RES_DPI      Gives resolution of printer, size of a page
	   HI_RES_SET      Command given to printer after the INIT to set
				    high res printing.
	  *HI_RES_PRINT    Command to print graphics in hi res.

    To set one of these printer commands in the QLP file, type its name  on
    the left most margin, type an equals sign, then type the  ASCII  values
    to be sent to the printer.  Non-printable ASCII  values  (values  below
    32)  need to be in the following format:

	   <NUL>   0       <BS>    8           <DLE>   16          <CAN>   24
	   <SOH>   1       <HT>    9           <DC1>   17          <EM>    25
	   <STX>   2       <LF>    10          <DC2>   18          <SUB>   26
	   <ETX>   3       <VT>    11          <DC3>   19          <ESC>   27
	   <EOT>   4       <FF>    12          <DC4>   20          <FS>    28
	   <ENQ>   5       <CR>    13          <NAK>   21          <GS>    29
	   <ACK>   6       <SO>    14          <SYN>   22          <RS>    30
	   <BEL>   7       <SI>    15          <ETB>   23          <US>    31

    An example of setting the EXIT printer command would be:

	   EXIT=<ESC>E

    This command will make PRINTFAX to send an ASCII 27, then an ASCII  69.
    This is the command to reset a LaserJet.

    There are four other special commands that you will see in  QLP  files.
    These commands are used  for  the  LOW_RES_PRINT,  NORM_RES_PRINT,  and
    HI_RES_PRINT printer commands.  They are:

	   <N1>    9pin and 24 pin graphics command
	   <N2>    9pin and 24 pin graphics command
	   <N3>    Selects width of graphics printing for the LaserJet
	   <DATA>  Replaced by the actual stream of graphics fax data being
			 sent to the printer (used by all printers)

    For example, the command to print  120 dpi printing on a 9 pin is:

	   NORM_RES_PRINT=<ESC>L<N1><N2><DATA><CR><LF>

    The <N1> and the <N2> commands will be  replaced  by  number  which to-
    gether represents the width of the  data  to  be  sent  by  the  <DATA>
    command.  For further documentation of  <N1>  and  <N2>  refer  to  you
    printer manual.

    There is a special format for the LOW_RES_DPI, NORM_RES_DPI, HI_RES_DPI
    commands.  The format is:

	   NORM_RES_DPI=H1xV1:H2xV2:V3

	   H1 = printer horizontal dots per inch
	   V1 = printer vertical dots per inch
	   H2 = width of page in dots
	   V2 = length of page in dots (0 = continuous)
	   V3 = width of print head in dots

	   example for LaserJet:  NORM_RES_DPI=150x150:1200x1540:1
	   example for 9pin:      NORM_RES_DPI=120x72:960x0:8

    To find out how your printer prints graphics,  refer  to  your  printer
    manual.  Because of the wide variety of printers on the  market,  Smith
    Micro Software, Inc.  does  not  guarantee  that  PRINTFAX  has  enough
    flexibility to be able to print to every printer,  but  in  testing  it
    did print to most.

    There are two undocumented features of PRINTFAX.

    The Reset Feature will initialize an LPT port.

	   PRINTFAX /R             will reset a printer on LPT1
	   PRINTFAX /R /L2         will reset a printer on LPT2

    The Test Feature will query the printer status register.

	   PRINTFAX /T             will test a printer on LPT1
	   PRINTFAX /T /L2         will test a printer on LPT2

