NAME

       ps2fax - image POSTSCRIPT® for facsimile transmission by HylaFAX

SYNOPSIS

       /var/spool/hylafax/bin/ps2fax [ options ] [ files...  ]

DESCRIPTION

       ps2fax  takes  POSTSCRIPT  input  and  generates  a  TIFF  Class F image file suitable for
       facsimile transmission.  It is usually invoked by the HylaFAX scheduler process,  faxq(8).
       On Silicon Graphics' IRIX systems, this application is based on Adobe's Display POSTSCRIPT
       software.  On other machines  POSTSCRIPT  imaging  is  typically  done  using  the  freely
       available Ghostscript software.

       ps2fax  is  actually  a  link  (symbolic  or  otherwise) to the script appropriate for the
       POSTSCRIPT imaging tool.  The link  is  setup  when  the  faxsetup(8)  script  is  run  to
       configure a HylaFAX server machine for use.

       Input  files  containing  POSTSCRIPT  may  be  specified on the command line.  If none are
       given, then ps2fax will read from standard input.

       By default, ps2fax will generate a 98 line/inch output document whose page width  is  1728
       pixels  and  page  length  is  297  mm (a standard A4 page at low resolution).  Horizontal
       resolution is always 204 dpi.  Command line  options  may  be  used  to  select  alternate
       vertical resolution and page dimensions.

       If  no  filename  is given, ps2fax writes its output to a file named ps.fax; the -o option
       can be used to specify an alternate filename.

       By default, output is compressed using the standard Group 3 1D-encoding scheme,  with  EOL
       codes  padded  to  byte boundaries.  If the -2 option is specified, output is encoded with
       the optional Group 3 2D-encoding scheme (EOL codes are still padded to byte boundaries).

       This script can modify outgoing facsimile, such as watermarking, To do this create a shell
       script etc/FaxModify in the spooling area that alters the document.

       Note that bin/ps2fax is usually just a link to a shell script that invokes the appropriate
       POSTSCRIPT RIP to do the work.

OPTIONS

       The following operations are recognized:

       -1        Write Group 3 1D-encoded data to the output file.

       -2        Write Group 3 2D-encoded data to the output file.

       -3        Write Group 4 MMR-encoded data to the output file.

       -m pages  Set the maximum number of pages that are permitted in the output file.  If  more
                 pages are present in the input document then abort processing.

       -o file   Write output to the specified file instead of the default ps.fax filename.

       -w width  Set the output page width, in pixels.  By default, pages are 1728 pixels wide.

       -l length Set  the  output  page  length  in  millimeters.   By  default,  pages  are  297
                 millimeters long.

       -r vres   Set the vertical resolution, in lines/inch, at which to image the POSTSCRIPT.

RUNTIME ENVIRONMENT

       Before user-supplied POSTSCRIPT is passed to the POSTSCRIPT interpreter, a limited  number
       of  operators  are defined.  These operators are operators commonly found in a LaserWriter
       printer and (sometimes) generated by Macintosh-based applications.

       The default Display  POSTSCRIPT-based  execution  environment  includes  support  for  the
       following fonts:
       AvantGarde-Book           Helvetica-Bold                  Palatino-BoldItalic
       AvantGarde-BookOblique    Helvetica-BoldOblique           Palatino-Italic
       AvantGarde-Demi           Helvetica-Narrow                Palatino-Roman
       AvantGarde-DemiOblique    Helvetica-Narrow-Bold           StoneSerif
       Bookman-Demi              Helvetica-Narrow-BoldOblique    Symbol
       Bookman-DemiItalic        Helvetica-Narrow-Oblique        Tekton
       Bookman-Light             Helvetica-Oblique               Times-Bold
       Bookman-LightItalic       Lithos-Bold                     Times-BoldItalic
       Courier                   NewCenturySchlbk-Bold           Times-Italic
       Courier-Bold              NewCenturySchlbk-BoldItalic     Times-Roman
       Courier-BoldOblique       NewCenturySchlbk-Italic         ZapfChancery-MediumItalic
       Courier-Oblique           NewCenturySchlbk-Roman          ZapfDingbats
       Helvetica                 Palatino-Bold
       Note that this is the same set of fonts supported by the DPS extension to the X server.

       The  default  Ghostscript-based  environment  is  more  uncertain; consult the Ghostscript
       documentation for information on what fonts are available.

FILES

       /var/spool/hylafax/etc/dpsprinter.ps    POSTSCRIPT code read at startup for DPS
       /usr/lib/DPS/default.dps_vm             startup VM file for DPS
       /usr/lib/DPS/outline                    Type 1 fonts for DPS
       /usr/lib/DPS/prebuilt                   prebuilt versions of fonts for DPS

BUGS

       Output from the Display POSTSCRIPT version of this command is  encoded  according  to  the
       Display POSTSCRIPT binary encoding protocol.

       No  prebuilt  bitmap  fonts  are  currently available for the DPS-based imager; this would
       greatly improve legibility at low resolutions, as the rendering of outline fonts at 98 lpi
       is particularly poor.

       Both DPS- and Ghostscript-based versions of this program fail to exit with non-zero status
       when an invalid POSTSCRIPT document is  processed;  this  makes  it  problematic  for  the
       HylaFAX  queue  manager  to  determine  when  a  problem  arises  when preparing a job for
       transmission.

SEE ALSO

       sendfax(1), faxq(8), hylafax-server(5)

                                         August 26, 1996                                PS2FAX(8)