1PS2FAX(8C) PS2FAX(8C)
2
6 ps2fax - image POSTSCRIPT® for facsimile transmission by HylaFAX
7
9 /var/spool/hylafax/bin/ps2fax [ options ] [ files... ]
10
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 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 Input files containing POSTSCRIPT may be specified on the command line.
25 If none are given, then ps2fax will read from standard input.
26 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 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 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 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 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
49 The following operations are recognized:
50 -1 Write Group 3 1D-encoded data to the output file.
52 -2 Write Group 3 2D-encoded data to the output file.
54 -3 Write Group 4 MMR-encoded data to the output file.
56 -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 -i jobid How the server references the associated Job ID number
61 -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 -o file Write output to the specified file instead of the default
67 ps.fax filename.
68 -w width Set the output page width, in pixels. By default, pages are
70 1728 pixels wide.
71 -l length Set the output page length in millimeters. By default, pages
73 are 297 millimeters long.
74 -r vres Set the vertical resolution, in lines/inch, at which to image
76 the POSTSCRIPT.
77
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 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 The default Ghostscript-based environment is more uncertain; consult
103 the Ghostscript documentation for information on what fonts are avail‐
104 able.
105
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
113 Output from the Display POSTSCRIPT version of this command is encoded
114 according to the Display POSTSCRIPT binary encoding protocol.
115 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 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
126 sendfax(1), faxq(8C), hylafax-server(5F)
127 August 26, 1996 PS2FAX(8C)