src/tiff/man/tiff2ps.1

   1 .\"
   2 .\" Copyright (c) 1988-1997 Sam Leffler
   3 .\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
   4 .\"
   5 .\" Permission to use, copy, modify, distribute, and sell this software and
   6 .\" its documentation for any purpose is hereby granted without fee, provided
   7 .\" that (i) the above copyright notices and this permission notice appear in
   8 .\" all copies of the software and related documentation, and (ii) the names of
   9 .\" Sam Leffler and Silicon Graphics may not be used in any advertising or
  10 .\" publicity relating to the software without the specific, prior written
  11 .\" permission of Sam Leffler and Silicon Graphics.
  12 .\"
  13 .\" THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND,
  14 .\" EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
  15 .\" WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  16 .\"
  17 .\" IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
  18 .\" ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
  19 .\" OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
  20 .\" WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF
  21 .\" LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
  22 .\" OF THIS SOFTWARE.
  23 .\"
  24 .ds Ps PostScript
  25 .if n .po 0
  26 .TH TIFF2PS 1 "November 2, 2005" "libtiff"
  27 .SH NAME
  28 tiff2ps \- convert a
  29 .SM TIFF
  30 image to \*(Ps\*(Tm
  31 .SH SYNOPSIS
  32 .B tiff2ps
  33 [
  34 .I options
  35 ]
  36 .I "input.tif ..."
  37 .SH DESCRIPTION
  38 .I tiff2ps
  39 reads
  40 .SM TIFF
  41 images and writes \*(Ps or Encapsulated \*(Ps (EPS)
  42 on the standard output.
  43 By default,
  44 .I tiff2ps
  45 writes Encapsulated \*(Ps for the first image in the specified
  46 .SM TIFF
  47 image file.
  48 .PP
  49 By default,
  50 .I tiff2ps
  51 will generate \*(Ps that fills a printed area specified
  52 by the
  53 .SM TIFF
  54 tags in the input file.
  55 If the file does not contain
  56 .I XResolution
  57 or
  58 .I YResolution
  59 tags, then the printed area is set according to the image dimensions.
  60 The
  61 .B \-w
  62 and
  63 .B \-h
  64 options (see below)
  65 can be used to set the dimensions of the printed area in inches;
  66 overriding any relevant
  67 .SM TIFF
  68 tags.
  69 .PP
  70 The \*(Ps generated for
  71 .SM RGB,
  72 palette, and
  73 .SM CMYK
  74 images uses the
  75 .I colorimage
  76 operator.
  77 The \*(Ps generated for
  78 greyscale and bilevel images
  79 uses the
  80 .I image
  81 operator.
  82 When the
  83 .I colorimage
  84 operator is used, \*(Ps code to emulate this operator
  85 on older \*(Ps printers is also generated.
  86 Note that this emulation code can be very slow.
  87 .PP
  88 Color images with associated alpha data are composited over
  89 a white background.
  90 .SH OPTIONS
  91 .TP
  92 .B \-1
  93 Generate \*(Ps Level 1 (the default).
  94 .TP
  95 .B \-2
  96 Generate \*(Ps Level 2.
  97 .TP
  98 .B \-3
  99 Generate \*(Ps Level 3. It basically allows one to use the /flateDecode
 100 filter for ZIP compressed TIFF images.
 101 .TP
 102 .B \-a
 103 Generate output for all IFDs (pages) in the input file.
 104 .TP
 105 .B \-b
 106 Specify the bottom margin for the output (in inches). This does not affect
 107 the height of the printed image.
 108 .TP
 109 .B \-c
 110 Center the image in the output. This option only shows an effect if both
 111 the
 112 .B \-w
 113 and the
 114 .B \-h
 115 option are given.
 116 .TP
 117 .B \-d
 118 Set the initial
 119 .SM TIFF
 120 directory to the specified directory number.
 121 (NB: Directories are numbered starting at zero.)
 122 This option is useful for selecting individual pages in a
 123 multi-page (e.g. facsimile) file.
 124 .TP
 125 .B \-e
 126 Force the generation of Encapsulated \*(Ps (implies
 127 .BR \-z ).
 128 .TP
 129 .B \-h
 130 Specify the vertical size of the printed area (in inches).
 131 .TP
 132 .B \-H
 133 Specify the maximum height of image (in inches). Images with larger sizes will
 134 be split in several pages. Option
 135 .B \-L
 136 may be used for specifying size of split images overlapping.
 137 .TP
 138 .B \-W
 139 Specify the maximum width of image (in inches). Images with larger sizes will
 140 be split in several pages. Options
 141 .B \-L
 142 and
 143 .B \-W
 144 are mutually exclusive.
 145 .B \-i
 146 Enable/disable pixel interpolation.  This option requires a
 147 single numeric value: zero to disable pixel interpolation and
 148 non-zero to enable.  The default is enabled.
 149 .TP
 150 .B \-L
 151 Specify the size of overlapping for split images (in inches). Used in
 152 conjunction with
 153 .B \-H
 154 option and
 155 .B \-W
 156 option.
 157 .TP
 158 .B \-l
 159 Specify the left margin for the output (in inches). This does not affect
 160 the width of the printed image.
 161 .TP
 162 .B \-m
 163 Where possible render using the
 164 .I imagemask
 165 \*(Ps operator instead of the
 166 .I image
 167 operator.  When this option is specified
 168 .I tiff2ps
 169 will use
 170 .I imagemask
 171 for rendering 1 bit deep images.  If this option is not specified
 172 or if the image depth is greater than 1 then the
 173 .I image
 174 operator is used.
 175 .TP
 176 .B \-o
 177 Set the initial
 178 .SM TIFF
 179 directory to the
 180 .SM IFD
 181 at the specified file offset.
 182 This option is useful for selecting thumbnail images and the
 183 like which are hidden using the
 184 .I SubIFD
 185 tag.
 186 .TP
 187 .B \-p
 188 Force the generation of (non-Encapsulated) \*(Ps.
 189 .TP
 190 .B \-r 90|180|270|auto
 191 Rotate image by 90, 180, 270 degrees or auto.  Auto picks the best
 192 fit for the image on the specified paper size (eg portrait
 193 or landscape) if -h or -w is specified. Rotation is in degrees
 194 counterclockwise. Auto rotates 90 degrees ccw to produce landscape.
 195 .TP
 196 .B \-s
 197 Generate output for a single IFD (page) in the input file.
 198 .TP
 199 .B \-w
 200 Specify the horizontal size of the printed area (in inches).
 201 .TP
 202 .B \-x
 203 Override resolution units specified in the TIFF as centimeters.
 204 .TP
 205 .B \-y
 206 Override resolution units specified in the TIFF as inches.
 207 .TP
 208 .B \-z
 209 When generating \*(Ps Level 2, data is scaled so that it does not
 210 image into the
 211 .I deadzone
 212 on a page (the outer margin that the printing device is unable to mark).
 213 This option suppresses this behavior.
 214 When \*(Ps Level 1 is generated, data is imaged to the entire printed
 215 page and this option has no affect.
 216 .SH EXAMPLES
 217 The following generates \*(Ps Level 2 for all pages of a facsimile:
 218 .RS
 219 .nf
 220 tiff2ps \-a2 fax.tif | lpr
 221 .fi
 222 .RE
 223 Note also that if you have version 2.6.1 or newer of Ghostscript then you
 224 can efficiently preview facsimile generated with the above command.
 225 .PP
 226 To generate Encapsulated \*(Ps for a the image at directory 2
 227 of an image use:
 228 .RS
 229 .nf
 230 tiff2ps \-d 1 foo.tif
 231 .fi
 232 .RE
 233 (Notice that directories are numbered starting at zero.)
 234 .PP
 235 If you have a long image, it may be split in several pages:
 236 .RS
 237 .nf
 238 tiff2ps \-h11 \-w8.5 \-H14 \-L.5 foo.tif > foo.ps
 239 .fi
 240 .RE
 241 The page size is set to 8.5x11 by
 242 .B \-w
 243 and
 244 .B \-h
 245 options. We will accept a small amount of vertical compression, so
 246 .B \-H
 247 set to 14. Any pages between 11 and 14 inches will be fit onto one page.
 248 Pages longer than 14 inches are cut off at 11 and continued on the next
 249 page. The
 250 .B \-L.5
 251 option says to repeat a half inch on the next page (to improve readability).
 252 .SH BUGS
 253 Because \*(Ps does not support the notion of a colormap,
 254 8-bit palette images produce 24-bit \*(Ps images.
 255 This conversion results in output that is six times
 256 bigger than the original image and which takes a long time
 257 to send to a printer over a serial line.
 258 Matters are even worse for 4-, 2-, and 1-bit palette images.
 259 .PP
 260 Does not handle tiled images when generating \*(Ps Level I output.
 261 .SH "SEE ALSO"
 262 .BR pal2rgb (1),
 263 .BR tiffinfo (1),
 264 .BR tiffcp (1),
 265 .BR tiffgt (1),
 266 .BR tiffmedian (1),
 267 .BR tiff2bw (1),
 268 .BR tiffsv (1),
 269 .BR libtiff (3)
 270 .PP
 271 Libtiff library home page:
 272 .BR http://www.remotesensing.org/libtiff/