src/tiff/man/tiff2ps.1

   1 .\" $Id: tiff2ps.1,v 1.8 2005/11/02 11:07:19 dron 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 .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 -w and the -h option are given.
 112 .TP
 113 .B \-d
 114 Set the initial
 115 .SM TIFF
 116 directory to the specified directory number.
 117 (NB: directories are numbered starting at zero.)
 118 This option is useful for selecting individual pages in a
 119 multi-page (e.g. facsimile) file.
 120 .TP
 121 .B \-e
 122 Force the generation of Encapsulated \*(Ps (implies -z).
 123 .TP
 124 .B \-h
 125 Specify the vertical size of the printed area (in inches).
 126 .TP
 127 .B \-H
 128 Specify the maximum height of image (in inches). Images with larger sizes will
 129 be split in several pages. Option
 130 .B \-L
 131 may be used for specifying size of split images overlapping.
 132 .TP
 133 .B \-i
 134 Enable/disable pixel interpolation.  This option requires a
 135 single numeric value: zero to disable pixel interpolation and
 136 non-zero to enable.  The default is enabled.
 137 .TP
 138 .B \-L
 139 Specify the size of overlapping for split images (in inches). Used in
 140 conjunction with
 141 .B \-H
 142 option.
 143 .TP
 144 .B \-l
 145 Specify the left margin for the output (in inches). This does not affect
 146 the width of the printed image.
 147 .TP
 148 .B \-m
 149 Where possible render using the
 150 .B imagemask
 151 \*(Ps operator instead of the image operator.  When this option is specified
 152 .I tiff2ps
 153 will use
 154 .B imagemask
 155 for rendering 1 bit deep images.  If this option is not specified
 156 or if the image depth is greater than 1 then the image operator
 157 is used.
 158 .TP
 159 .B \-o
 160 Set the initial
 161 .SM TIFF
 162 directory to the
 163 .SM IFD
 164 at the specified file offset.
 165 This option is useful for selecting thumbnail images and the
 166 like which are hidden using the SubIFD tag.
 167 .TP
 168 .B \-p
 169 Force the generation of (non-Encapsulated) \*(Ps.
 170 .TP
 171 .B \-r
 172 Rotate image by 180 degrees.
 173 .TP
 174 .B \-s
 175 Generate output for a single IFD (page) in the input file.
 176 .TP
 177 .B \-w
 178 Specify the horizontal size of the printed area (in inches).
 179 .TP
 180 .B \-x
 181 Override resolution units specified in the TIFF as centimeters.
 182 .TP
 183 .B \-y
 184 Override resolution units specified in the TIFF as inches.
 185 .TP
 186 .B \-z
 187 When generating \*(Ps Level 2, data is scaled so that it does not
 188 image into the
 189 .I deadzone
 190 on a page (the outer margin that the printing device is unable to mark).
 191 This option suppresses this behavior.
 192 When \*(Ps Level 1 is generated, data is imaged to the entire printed
 193 page and this option has no affect.
 194 .SH EXAMPLES
 195 The following generates \*(Ps Level 2 for all pages of a facsimile:
 196 .RS
 197 .nf
 198 tiff2ps -a2 fax.tif | lpr
 199 .fi
 200 .RE
 201 Note also that if you have version 2.6.1 or newer of Ghostscript then you
 202 can efficiently preview facsimile generated with the above command.
 203 .PP
 204 To generate Encapsulated \*(Ps for a the image at directory 2
 205 of an image use:
 206 .RS
 207 .nf
 208 tiff2ps -d 1 foo.tif
 209 .fi
 210 .RE
 211 (notice that directories are numbered starting at zero.)
 212 .PP
 213 If you have a long image, it may be split in several pages:
 214 .RS
 215 .nf
 216 tiff2ps -h11 -w8.5 -H14 -L.5 foo.tif > foo.ps
 217 .fi
 218 .RE
 219 The page size is set to 8.5x11 by
 220 .B \-w
 221 and
 222 .B \-h
 223 options. We will accept a small amount of vertical compression, so
 224 .B \-H
 225 set to 14. Any pages between 11 and 14 inches will be fit onto one page.
 226 Pages longer than 14 inches are cut off at 11 and continued on the next
 227 page. The
 228 .B \-L.5
 229 option says to repeat a half inch on the next page (to improve readability).
 230 .SH BUGS
 231 Because \*(Ps does not support the notion of a colormap,
 232 8-bit palette images produce 24-bit \*(Ps images.
 233 This conversion results in output that is six times
 234 bigger than the original image and which takes a long time
 235 to send to a printer over a serial line.
 236 Matters are even worse for 4-, 2-, and 1-bit palette images.
 237 .SH BUGS
 238 Does not handle tiled images when generating PS Level I output.
 239 .SH "SEE ALSO"
 240 .BR pal2rgb (1),
 241 .BR tiffinfo (1),
 242 .BR tiffcp (1),
 243 .BR tiffgt (1),
 244 .BR tiffmedian (1),
 245 .BR tiff2bw (1),
 246 .BR tiffsv (1),
 247 .BR libtiff (3)
 248 .PP
 249 Libtiff library home page:
 250 .BR http://www.remotesensing.org/libtiff/