src/tiff/man/tiff2ps.1

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