.\"	$Id$
.\"
.\" HylaFAX Facsimile Software
.\"
.\" Copyright (c) 1990-1996 Sam Leffler
.\" Copyright (c) 1991-1996 Silicon Graphics, Inc.
.\" HylaFAX is a trademark of Silicon Graphics
.\" 
.\" Permission to use, copy, modify, distribute, and sell this software and 
.\" its documentation for any purpose is hereby granted without fee, provided
.\" that (i) the above copyright notices and this permission notice appear in
.\" all copies of the software and related documentation, and (ii) the names of
.\" Sam Leffler and Silicon Graphics may not be used in any advertising or
.\" publicity relating to the software without the specific, prior written
.\" permission of Sam Leffler and Silicon Graphics.
.\" 
.\" THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, 
.\" EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY 
.\" WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  
.\" 
.\" IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
.\" ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
.\" OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
.\" WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF 
.\" LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE 
.\" OF THIS SOFTWARE.
.\"
.if n .po 0
.ds Fx \fIHyla\s-1FAX\s+1\fP
.ds Ps P\s-2OST\s+2S\s-2CRIPT\s+2
.TH PS2FAX 8 "August 26, 1996"
.SH NAME
ps2fax \- image \*(Ps\(rg for facsimile transmission by \*(Fx
.SH SYNOPSIS
.B /var/spool/hylafax/bin/ps2fax
[
.I options
] [
.IR files ...
]
.SH DESCRIPTION
.I ps2fax
takes \*(Ps input and generates a
.SM TIFF
Class F image file suitable for facsimile transmission.
It is usually invoked by the \*(Fx scheduler process,
.IR faxq (8).
On Silicon Graphics'
.SM IRIX
systems,
this application is based on Adobe's Display \*(Ps software.
On other machines \*(Ps imaging is typically done using the
freely available
.I Ghostscript
software.
.PP
.I ps2fax
is actually a link (symbolic or otherwise) to the script
appropriate for the \*(Ps imaging tool.
The link is setup when the
.IR faxsetup (8)
script is run to configure a \*(Fx server machine for use.
.PP
Input files containing \*(Ps may be specified on the
command line.
If none are given, then
.I ps2fax
will read from standard input.
.PP
By default,
.I 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.
.PP
If no filename is given, 
.I ps2fax
writes its output to a file named
.BR ps.fax ;
the
.B \-o
option can be used to specify an alternate filename.
.PP
By default, output is compressed using the standard
Group 3 1D-encoding scheme, with
.SM EOL
codes padded to byte boundaries.
If the
.B \-2
option is specified, output is encoded with the optional
Group 3 2D-encoding scheme (\c
.SM EOL
codes are still padded to byte boundaries).
.PP
This script can modify outgoing facsimile, such as watermarking,
To do this create a shell script
.B etc/FaxModify
in the spooling area that alters the document.
.PP
Note that
.B bin/ps2fax
is usually just a link to a shell script that invokes the
appropriate \*(Ps
.SM RIP
to do the work.
.SH OPTIONS
The following operations are recognized:
.TP 10
.B \-1
Write Group 3 1D-encoded data to the output file.
.TP 10
.B \-2
Write Group 3 2D-encoded data to the output file.
.TP 10
.B \-3
Write Group 4 MMR-encoded data to the output file.
.TP 10
.BI \-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.
.TP 10
.BI \-o " file"
Write output to the specified
.I file
instead of the default
.B ps.fax
filename.
.TP 10
.BI \-w " width"
Set the output page
.IR width ,
in pixels.
By default, pages are 1728 pixels wide.
.TP 10
.BI \-l " length"
Set the output page
.IR length
in millimeters.
By default, pages are 297 millimeters long.
.TP
.BI \-r " vres"
Set the vertical resolution,
in lines/inch, at which to image the \*(Ps.
.SH "RUNTIME ENVIRONMENT"
Before user-supplied \*(Ps is passed
to the \*(Ps 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.
.PP
The default Display \*(Ps-based execution
environment includes support for the following fonts:
.sp .5
.ta \w'AvantGarde-DemiOblique    'u +\w'Helvetica-Narrow-BoldOblique    'u
.nf
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
.fi
.sp .5
Note that this is the same set of fonts supported by the
.SM DPS
extension to the X server.
.PP
The default Ghostscript-based environment is more uncertain;
consult the Ghostscript documentation for information on
what fonts are available.
.SH FILES
.ta \w'/var/spool/hylafax/etc/dpsprinter.ps    'u
.nf
/var/spool/hylafax/etc/dpsprinter.ps	\*(Ps code read at startup for \s-1DPS\s+1
/usr/lib/DPS/default.dps_vm	startup VM file for \s-1DPS\s+1
/usr/lib/DPS/outline	Type 1 fonts for \s-1DPS\s+1
/usr/lib/DPS/prebuilt	prebuilt versions of fonts for \s-1DPS\s+1
.fi
.SH BUGS
Output from the Display \*(Ps version of this command
is encoded according to the Display \*(Ps binary encoding
protocol.
.PP
No prebuilt bitmap fonts are currently available for the
.SM DPS\c
-based imager;
this would greatly improve legibility at low resolutions,
as the rendering of outline fonts at 98 lpi is particularly
poor.
.PP
Both
.SM DPS-
and
Ghostscript-based versions of this program fail to exit with
non-zero status when an invalid \*(Ps document is processed;
this makes it problematic for the \*(Fx queue manager to
determine when a problem arises when preparing a job for
transmission.
.SH "SEE ALSO"
.IR sendfax (1),
.IR faxq (8),
.IR hylafax-server(5)