src/tiff/man/fax2ps.1

   1 .\"     $Id: fax2ps.1,v 1.3 2005/11/02 11:07: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 .if n .po 0
  26 .TH FAX2PS 1 "November 2, 2005" "libtiff"
  27 .SH NAME
  28 fax2ps \- convert a
  29 .SM TIFF
  30 facsimile to compressed \*(Ps\(tm
  31 .SH SYNOPSIS
  32 .B fax2ps
  33 [
  34 .I options
  35 ] [
  36 .IR file ...
  37 ]
  38 .SH DESCRIPTION
  39 .I fax2ps
  40 reads one or more
  41 .SM TIFF
  42 facsimile image files and prints a compressed form of
  43 \*(Ps on the standard output that is suitable for printing.
  44 .PP
  45 By default, each page is scaled to reflect the
  46 image dimensions and resolutions stored in the file.
  47 The
  48 .B \-x
  49 and
  50 .B \-y
  51 options can be used to specify the horizontal and vertical
  52 image resolutions (lines/inch), respectively.
  53 If the
  54 .B \-S
  55 option is specified, each page is scaled to fill an output page.
  56 The default output page is 8.5 by 11 inches.
  57 Alternate page dimensions can be specified in inches with the
  58 .B \-W
  59 and
  60 .B \-H
  61 options.
  62 .PP
  63 By default
  64 .I fax2ps
  65 generates \*(Ps for all pages in the file.
  66 The
  67 .B \-p
  68 option can be used to select one or more pages from
  69 a multi-page document.
  70 .PP
  71 .I fax2ps
  72 generates a compressed form of \*(Ps that is
  73 optimized for sending pages of text to a \*(Ps
  74 printer attached to a host through a low-speed link (such
  75 as a serial line).
  76 Each output page is filled with white and then only
  77 the black areas are drawn.
  78 The \*(Ps specification of the black drawing operations
  79 is optimized by using a special font that encodes the
  80 move-draw operations required to fill
  81 the black regions on the page.
  82 This compression scheme typically results in a substantially
  83 reduced \*(Ps description, relative to the straightforward
  84 imaging of the page with a \*(Ps
  85 .I image
  86 operator.
  87 This algorithm can, however, be ineffective
  88 for continuous-tone and white-on-black images.
  89 For these images, it sometimes is more efficient to send
  90 the raster bitmap image directly; see
  91 .IR tiff2ps (1).
  92 .SH OPTIONS
  93 .TP 10
  94 .BI \-p " number"
  95 Print only the indicated page.
  96 Multiple pages may be printed by specifying
  97 this option more than once.
  98 .TP 10
  99 .BI \-x " resolution"
 100 Use
 101 .I resolution
 102 as the horizontal resolution, in dots/inch, of the image data.
 103 By default this value is taken from the file.
 104 .TP 10
 105 .BI \-y " resolution"
 106 Use
 107 .I resolution
 108 as the vertical resolution, in lines/inch, of the image data.
 109 By default this value is taken from the file.
 110 .TP 10
 111 .B \-S
 112 Scale each page of image data to fill the output page dimensions.
 113 By default images are presented according to the dimension
 114 information recorded in the
 115 .SM TIFF
 116 file.
 117 .TP 10
 118 .BI \-W " width"
 119 Use
 120 .I width
 121 as the width, in inches, of the output page.
 122 .TP 10
 123 .BI \-H " height"
 124 Use
 125 .I height
 126 as the height, in inches, of the output page.
 127 .SH DIAGNOSTICS
 128 Some messages about malformed
 129 .SM TIFF
 130 images come from the
 131 .SM TIFF
 132 library.
 133 .PP
 134 Various messages about badly formatted facsimile images
 135 may be generated due to transmission errors in received
 136 facsimile.
 137 .I fax2ps
 138 attempts to recover from such data errors by resynchronizing
 139 decoding at the end of the current scanline.
 140 This can result in long horizontal black lines in the resultant
 141 \*(Ps image.
 142 .SH NOTES
 143 If the destination printer supports \*(Ps Level II then
 144 it is always faster to just send the encoded bitmap generated
 145 by the
 146 .BR tiff2ps (1)
 147 program.
 148 .SH BUGS
 149 .I fax2ps
 150 should probably figure out when it is doing a poor
 151 job of compressing the output and just generate
 152 \*(Ps to image the bitmap raster instead.
 153 .SH "SEE ALSO"
 154 .BR tiff2ps (1),
 155 .BR libtiff (3)
 156 .PP
 157 Libtiff library home page:
 158 .BR http://www.remotesensing.org/libtiff/