src/tiff/man/fax2ps.1

   1 .\"     $Id: fax2ps.1,v 1.4 2006-04-20 12:17:19 dron Exp $
   2 .\"
   3 .\" Copyright (c) 1991-1997 Sam Leffler
   4 .\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
   5 .\"
   6 .\" Permission to use, copy, modify, distribute, and sell this software and
   7 .\" its documentation for any purpose is hereby granted without fee, provided
   8 .\" that (i) the above copyright notices and this permission notice appear in
   9 .\" all copies of the software and related documentation, and (ii) the names of
  10 .\" Sam Leffler and Silicon Graphics may not be used in any advertising or
  11 .\" publicity relating to the software without the specific, prior written
  12 .\" permission of Sam Leffler and Silicon Graphics.
  13 .\"
  14 .\" THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND,
  15 .\" EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
  16 .\" WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  17 .\"
  18 .\" IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
  19 .\" ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
  20 .\" OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
  21 .\" WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF
  22 .\" LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
  23 .\" OF THIS SOFTWARE.
  24 .\"
  25 .ds Ps PostScript
  26 .if n .po 0
  27 .TH FAX2PS 1 "November 2, 2005" "libtiff"
  28 .SH NAME
  29 fax2ps \- convert a
  30 .SM TIFF
  31 facsimile to compressed \*(Ps\(tm
  32 .SH SYNOPSIS
  33 .B fax2ps
  34 [
  35 .I options
  36 ] [
  37 .I file ...\&
  38 ]
  39 .SH DESCRIPTION
  40 .I fax2ps
  41 reads one or more
  42 .SM TIFF
  43 facsimile image files and prints a compressed form of
  44 \*(Ps on the standard output that is suitable for printing.
  45 .PP
  46 By default, each page is scaled to reflect the
  47 image dimensions and resolutions stored in the file.
  48 The
  49 .B \-x
  50 and
  51 .B \-y
  52 options can be used to specify the horizontal and vertical
  53 image resolutions (lines/inch), respectively.
  54 If the
  55 .B \-S
  56 option is specified, each page is scaled to fill an output page.
  57 The default output page is 8.5 by 11 inches.
  58 Alternate page dimensions can be specified in inches with the
  59 .B \-W
  60 and
  61 .B \-H
  62 options.
  63 .PP
  64 By default
  65 .I fax2ps
  66 generates \*(Ps for all pages in the file.
  67 The
  68 .B \-p
  69 option can be used to select one or more pages from
  70 a multi-page document.
  71 .PP
  72 .I fax2ps
  73 generates a compressed form of \*(Ps that is
  74 optimized for sending pages of text to a \*(Ps
  75 printer attached to a host through a low-speed link (such
  76 as a serial line).
  77 Each output page is filled with white and then only
  78 the black areas are drawn.
  79 The \*(Ps specification of the black drawing operations
  80 is optimized by using a special font that encodes the
  81 move-draw operations required to fill
  82 the black regions on the page.
  83 This compression scheme typically results in a substantially
  84 reduced \*(Ps description, relative to the straightforward
  85 imaging of the page with a \*(Ps
  86 .I image
  87 operator.
  88 This algorithm can, however, be ineffective
  89 for continuous-tone and white-on-black images.
  90 For these images, it sometimes is more efficient to send
  91 the raster bitmap image directly; see
  92 .BR tiff2ps (1).
  93 .SH OPTIONS
  94 .TP 10
  95 .BI \-p " number"
  96 Print only the indicated page.
  97 Multiple pages may be printed by specifying
  98 this option more than once.
  99 .TP 10
 100 .BI \-x " resolution"
 101 Use
 102 .I resolution
 103 as the horizontal resolution, in dots/inch, of the image data.
 104 By default this value is taken from the file.
 105 .TP 10
 106 .BI \-y " resolution"
 107 Use
 108 .I resolution
 109 as the vertical resolution, in lines/inch, of the image data.
 110 By default this value is taken from the file.
 111 .TP 10
 112 .B \-S
 113 Scale each page of image data to fill the output page dimensions.
 114 By default images are presented according to the dimension
 115 information recorded in the
 116 .SM TIFF
 117 file.
 118 .TP 10
 119 .BI \-W " width"
 120 Use
 121 .I width
 122 as the width, in inches, of the output page.
 123 .TP 10
 124 .BI \-H " height"
 125 Use
 126 .I height
 127 as the height, in inches, of the output page.
 128 .SH DIAGNOSTICS
 129 Some messages about malformed
 130 .SM TIFF
 131 images come from the
 132 .SM TIFF
 133 library.
 134 .PP
 135 Various messages about badly formatted facsimile images
 136 may be generated due to transmission errors in received
 137 facsimile.
 138 .I fax2ps
 139 attempts to recover from such data errors by resynchronizing
 140 decoding at the end of the current scanline.
 141 This can result in long horizontal black lines in the resultant
 142 \*(Ps image.
 143 .SH NOTES
 144 If the destination printer supports \*(Ps Level II then
 145 it is always faster to just send the encoded bitmap generated
 146 by the
 147 .BR tiff2ps (1)
 148 program.
 149 .SH BUGS
 150 .I fax2ps
 151 should probably figure out when it is doing a poor
 152 job of compressing the output and just generate
 153 \*(Ps to image the bitmap raster instead.
 154 .SH "SEE ALSO"
 155 .BR tiff2ps (1),
 156 .BR libtiff (3)
 157 .PP
 158 Libtiff library home page:
 159 .BR http://www.remotesensing.org/libtiff/