1PS2FAX(8C)                                                          PS2FAX(8C)
2
3
4

NAME

6       ps2fax - image POSTSCRIPT® for facsimile transmission by HylaFAX
7

SYNOPSIS

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

DESCRIPTION

12       ps2fax  takes  POSTSCRIPT input and generates a TIFF Class F image file
13       suitable for facsimile transmission.  It  is  usually  invoked  by  the
14       HylaFAX  scheduler  process,  faxq(8C).  On Silicon Graphics' IRIX sys‐
15       tems, this application is based on Adobe's Display POSTSCRIPT software.
16       On other machines POSTSCRIPT imaging is typically done using the freely
17       available Ghostscript software.
18
19       ps2fax is actually a link (symbolic or otherwise) to the script  appro‐
20       priate  for  the  POSTSCRIPT  imaging tool.  The link is setup when the
21       faxsetup(8C) script is run to configure a HylaFAX  server  machine  for
22       use.
23
24       Input files containing POSTSCRIPT may be specified on the command line.
25       If none are given, then ps2fax will read from standard input.
26
27       By default, ps2fax will generate a 98 line/inch output  document  whose
28       page width is 1728 pixels and page length is 297 mm (a standard A4 page
29       at low resolution).  Horizontal resolution is always 204 dpi.   Command
30       line  options  may  be used to select alternate vertical resolution and
31       page dimensions.
32
33       If no filename is given, ps2fax writes  its  output  to  a  file  named
34       ps.fax; the -o option can be used to specify an alternate filename.
35
36       By default, output is compressed using the standard Group 3 1D-encoding
37       scheme, with EOL codes padded to byte boundaries.  If the -2 option  is
38       specified,  output  is  encoded  with  the optional Group 3 2D-encoding
39       scheme (EOL codes are still padded to byte boundaries).
40
41       This script can modify outgoing facsimile, such as watermarking, To  do
42       this  create  a  shell  script  etc/FaxModify in the spooling area that
43       alters the document.
44
45       Note that bin/ps2fax is usually just a link  to  a  shell  script  that
46       invokes the appropriate POSTSCRIPT RIP to do the work.
47

OPTIONS

49       The following operations are recognized:
50
51       -1        Write Group 3 1D-encoded data to the output file.
52
53       -2        Write Group 3 2D-encoded data to the output file.
54
55       -3        Write Group 4 MMR-encoded data to the output file.
56
57       -color    Write  color data to an output file (possibly a separate file
58                 if Group 3 or Group 4 data is also being output).
59
60       -i jobid  How the server references the associated Job ID number
61
62       -m pages  Set the maximum number of pages that  are  permitted  in  the
63                 output file.  If more pages are present in the input document
64                 then abort processing.
65
66       -o file   Write output to the specified file  instead  of  the  default
67                 ps.fax filename.
68
69       -w width  Set  the output page width, in pixels.  By default, pages are
70                 1728 pixels wide.
71
72       -l length Set the output page length in millimeters.  By default, pages
73                 are 297 millimeters long.
74
75       -r vres   Set the vertical resolution, in lines/inch, at which to image
76                 the POSTSCRIPT.
77

RUNTIME ENVIRONMENT

79       Before user-supplied POSTSCRIPT is  passed  to  the  POSTSCRIPT  inter‐
80       preter, a limited number of operators are defined.  These operators are
81       operators commonly found in a LaserWriter printer and (sometimes)  gen‐
82       erated by Macintosh-based applications.
83
84       The  default  Display  POSTSCRIPT-based  execution environment includes
85       support for the following fonts:
86       AvantGarde-Book           Helvetica-Bold                  Palatino-BoldItalic
87       AvantGarde-BookOblique    Helvetica-BoldOblique           Palatino-Italic
88       AvantGarde-Demi           Helvetica-Narrow                Palatino-Roman
89       AvantGarde-DemiOblique    Helvetica-Narrow-Bold           StoneSerif
90       Bookman-Demi              Helvetica-Narrow-BoldOblique    Symbol
91       Bookman-DemiItalic        Helvetica-Narrow-Oblique        Tekton
92       Bookman-Light             Helvetica-Oblique               Times-Bold
93       Bookman-LightItalic       Lithos-Bold                     Times-BoldItalic
94       Courier                   NewCenturySchlbk-Bold           Times-Italic
95       Courier-Bold              NewCenturySchlbk-BoldItalic     Times-Roman
96       Courier-BoldOblique       NewCenturySchlbk-Italic         ZapfChancery-MediumItalic
97       Courier-Oblique           NewCenturySchlbk-Roman          ZapfDingbats
98       Helvetica                 Palatino-Bold
99       Note that this is the same set of fonts supported by the DPS  extension
100       to the X server.
101
102       The  default  Ghostscript-based  environment is more uncertain; consult
103       the Ghostscript documentation for information on what fonts are  avail‐
104       able.
105

FILES

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

BUGS

113       Output  from  the Display POSTSCRIPT version of this command is encoded
114       according to the Display POSTSCRIPT binary encoding protocol.
115
116       No prebuilt bitmap fonts are  currently  available  for  the  DPS-based
117       imager;  this  would  greatly improve legibility at low resolutions, as
118       the rendering of outline fonts at 98 lpi is particularly poor.
119
120       Both DPS- and Ghostscript-based versions of this program fail  to  exit
121       with  non-zero status when an invalid POSTSCRIPT document is processed;
122       this makes it problematic for the HylaFAX queue  manager  to  determine
123       when a problem arises when preparing a job for transmission.
124

SEE ALSO

126       sendfax(1), faxq(8C), hylafax-server(5F)
127
128
129
130                                August 26, 1996                     PS2FAX(8C)
Impressum