Copyright (c) 1991-1997 Sam Leffler
Copyright (c) 1991-1997 Silicon Graphics, Inc.
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.
By default, each page is scaled to reflect the image dimensions and resolutions stored in the file. The -x and -y options can be used to specify the horizontal and vertical image resolutions (lines/inch), respectively. If the -S option is specified, each page is scaled to fill an output page. The default output page is 8.5 by 11 inches. Alternate page dimensions can be specified in inches with the -W and -H options.
By default fax2ps generates \*(Ps for all pages in the file. The -p option can be used to select one or more pages from a multi-page document.
fax2ps generates a compressed form of \*(Ps that is optimized for sending pages of text to a \*(Ps printer attached to a host through a low-speed link (such as a serial line). Each output page is filled with white and then only the black areas are drawn. The \*(Ps specification of the black drawing operations is optimized by using a special font that encodes the move-draw operations required to fill the black regions on the page. This compression scheme typically results in a substantially reduced \*(Ps description, relative to the straightforward imaging of the page with a \*(Ps image operator. This algorithm can, however, be ineffective for continuous-tone and white-on-black images. For these images, it sometimes is more efficient to send the raster bitmap image directly; see tiff2ps (1).
10 -p " number" Print only the indicated page. Multiple pages may be printed by specifying this option more than once.
10 -x " resolution" Use resolution as the horizontal resolution, in dots/inch, of the image data. By default this value is taken from the file.
10 -y " resolution" Use resolution as the vertical resolution, in lines/inch, of the image data. By default this value is taken from the file.
10 -S Scale each page of image data to fill the output page dimensions. By default images are presented according to the dimension information recorded in the TIFF file.
10 -W " width" Use width as the width, in inches, of the output page.
10 -H " height" Use height as the height, in inches, of the output page.
Various messages about badly formatted facsimile images may be generated due to transmission errors in received facsimile. fax2ps attempts to recover from such data errors by resynchronizing decoding at the end of the current scanline. This can result in long horizontal black lines in the resultant \*(Ps image.