src/tiff/man/tiff2pdf.1

   1 .\"
   2 .\"  Copyright (c) 2003 Ross Finlayson
   3 .\"
   4 .\"  Permission to use, copy, modify, distribute, and sell this software and
   5 .\"  its documentation for any purpose is hereby granted without fee, provided
   6 .\"  that (i) the above copyright notices and this permission notice appear in
   7 .\"  all copies of the software and related documentation, and (ii) the name of
   8 .\"  Ross Finlayson may not be used in any advertising or
   9 .\"  publicity relating to the software without the specific, prior written
  10 .\"  permission of Ross Finlayson.
  11 .\"
  12 .\"  THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND,
  13 .\"  EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
  14 .\"  WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  15 .\"
  16 .\"  IN NO EVENT SHALL ROSS FINLAYSON BE LIABLE FOR
  17 .\"  ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
  18 .\"  OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
  19 .\"  WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF
  20 .\"  LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
  21 .\"  OF THIS SOFTWARE.
  22 .\"
  23 .\" Process this file with
  24 .\" groff -man -Tascii tiff2pdf.1
  25 .\"
  26 .TH TIFF2PDF 1 "April 20, 2006" "libtiff"
  27 .SH NAME
  28 tiff2pdf \- convert a TIFF image to a PDF document
  29 .SH SYNOPSIS
  30 .B tiff2pdf
  31 [
  32 .I options
  33 ]
  34 .I input.tiff
  35 .SH DESCRIPTION
  36 .I tiff2pdf
  37 opens a TIFF image and writes a PDF document to standard output.
  38 .PP
  39 The program converts one TIFF file to one PDF file, including multiple page
  40 TIFF files, tiled TIFF files, black and white. grayscale, and color TIFF
  41 files that contain data of TIFF photometric interpretations of bilevel,
  42 grayscale, RGB, YCbCr, CMYK separation, and ICC L*a*b* as supported by
  43 .I libtiff
  44 and PDF.
  45 .PP
  46 If you have multiple TIFF files to convert into one PDF file then use
  47 .I tiffcp
  48 or other program to concatenate the files into a multiple page TIFF file.
  49 If the input TIFF file is of huge dimensions (greater than 10000 pixels height
  50 or width) convert the input image to a tiled TIFF if it is not already.
  51 .PP
  52 The standard output is standard output.  Set the output file name with the
  53 .BI \-o " output.pdf"
  54 option.
  55 .PP
  56 All black and white files are compressed into a single strip CCITT G4 Fax
  57 compressed PDF, unless tiled, where tiled black and white images are
  58 compressed into tiled CCITT G4 Fax compressed PDF,
  59 .I libtiff
  60 CCITT support is assumed.
  61 .PP
  62 Color and grayscale data can be compressed using either JPEG compression,
  63 ITU-T T.81, or Zip/Deflate LZ77 compression.  Set the compression type using
  64 the
  65 .B \-j
  66 or
  67 .B \-z
  68 options.  JPEG compression support
  69 requires that
  70 .I libtiff
  71 be configured with JPEG support, and Zip/Deflate compression support requires
  72 that
  73 .I libtiff
  74 be configured with Zip support, in tiffconf.h.  Use only one or the other of
  75 .B \-j
  76 and
  77 .B \-z.
  78 .PP
  79 If the input TIFF contains single strip CCITT G4 Fax compressed information,
  80 then that is written to the PDF file without transcoding, unless the options
  81 of no compression and no passthrough are set,
  82 .B \-d
  83 and
  84 .B \-n.
  85 .PP
  86 If the input TIFF contains JPEG or single strip Zip/Deflate compressed
  87 information, and they are configured, then that is written to the PDF file
  88 without transcoding, unless the options of no compression and no passthrough
  89 are set.
  90 .PP
  91 The default page size upon which the TIFF image is placed is determined by
  92 the resolution and extent of the image data.  Default values for the TIFF
  93 image resolution can be set using the
  94 .B \-x
  95 and
  96 .B \-y
  97 options.  The page size can be set using the
  98 .B \-p
  99 option for paper size, or
 100 .B \-w
 101 and
 102 .B \-l
 103 for paper width and length, then each page of the TIFF image is centered on
 104 its page.  The distance unit for default resolution and page width and
 105 length can be set by the
 106 .B \-u
 107 option, the default unit is inch.
 108 .PP
 109 Various items of the output document information can be set with the
 110 .BR \-e ,
 111 .BR \-c ,
 112 .BR \-a ,
 113 .BR \-t ,
 114 .BR \-s ,
 115 and
 116 .B \-k
 117 options.  Setting the argument of the option to "" for these
 118 tags causes the relevant document information field to be not written.  Some
 119 of the document information values otherwise get their information from the
 120 input TIFF image, the software, author, document name, and image description.
 121 .PP
 122 The Portable Document Format (PDF) specification is copyrighted by Adobe
 123 Systems, Incorporated.
 124 .SH OPTIONS
 125 .TP
 126 .BI \-o " output-file"
 127 Set the output to go to file.
 128 .I output-file
 129 .TP
 130 .B \-j
 131 Compress with JPEG (requires
 132 .I libjpeg
 133 configured with
 134 .IR libtiff ).
 135 .TP
 136 .B \-z
 137 Compress with Zip/Deflate (requires
 138 .I zlib
 139 configured with
 140 .IR libtiff ).
 141 .TP
 142 .BI \-q " quality"
 143 Set the compression quality, 1-100 for JPEG.
 144 .TP
 145 .B \-n
 146 Do not allow data to be converted without uncompressing, no compressed
 147 data passthrough.
 148 .TP
 149 .BI \-b
 150 Set PDF ``Interpolate'' user preference.
 151 .TP
 152 .B \-d
 153 Do not compress (decompress).
 154 .TP
 155 .B \-i
 156 Invert colors.
 157 .TP
 158 .BI \-p " paper-size"
 159 Set paper size, e.g.,
 160 .BR letter ,
 161 .BR legal ,
 162 .BR A4 .
 163 .TP
 164 .B \-F
 165 Cause the tiff to fill the PDF page.
 166 .TP
 167 .BR \-u " [" i | m ]
 168 Set distance unit,
 169 .B i
 170 for inch,
 171 .B m
 172 for centimeter.
 173 .TP
 174 .BI \-w " width"
 175 Set width in units.
 176 .TP
 177 .BI \-l " length"
 178 Set length in units.
 179 .TP
 180 .BI \-x " xres"
 181 Set x/width resolution default.
 182 .TP
 183 .BI \-y " yres"
 184 Set y/length resolution default.
 185 .TP
 186 .BR \-r " [" d | o ]
 187 Set
 188 .B d
 189 for resolution default for images without resolution,
 190 .B o
 191 for resolution override for all images.
 192 .TP
 193 .BI \-f
 194 Set PDF ``Fit Window'' user preference.
 195 .TP
 196 .BI \-e " YYYYMMDDHHMMSS"
 197 Set document information date, overrides image or current date/time default,
 198 .I YYYYMMDDHHMMSS.
 199 .TP
 200 .BI \-c " creator"
 201 Set document information creator, overrides image software default.
 202 .TP
 203 .BI \-a " author"
 204 Set document information author, overrides image artist default.
 205 .TP
 206 .BI \-t " title"
 207 Set document information title, overrides image document name default.
 208 .TP
 209 .BI \-s " subject"
 210 Set document information subject, overrides image image description default.
 211 .TP
 212 .BI \-k " keywords"
 213 Set document information keywords.
 214 .TP
 215 .B \-h
 216 List usage reminder to stderr and exit.
 217 .SH EXAMPLES
 218 .TP
 219 The following example would generate the file output.pdf from input.tiff.
 220 .RS
 221 .nf
 222 tiff2pdf \-o output.pdf input.tiff
 223 .fi
 224 .RE
 225 .PP
 226 The following example would generate PDF output from input.tiff and write it
 227 to standard output.
 228 .RS
 229 .nf
 230 tiff2pdf input.tiff
 231 .fi
 232 .RE
 233 .PP
 234 The following example would generate the file output.pdf from input.tiff,
 235 putting the image pages on a letter sized page, compressing the output
 236 with JPEG, with JPEG quality 75, setting the title to ``Document'', and setting
 237 the ``Fit Window'' option.
 238 .RS
 239 .nf
 240 tiff2pdf \-p letter \-j \-q 75 \-t "Document" \-f \-o output.pdf input.tiff
 241 .fi
 242 .RE
 243 .SH BUGS
 244 Please report bugs via the web interface at
 245 .IP
 246 \%http://bugzilla.remotesensing.org/enter_bug.cgi?product=libtiff
 247 .SH "SEE ALSO"
 248 .BR libtiff (3),
 249 .BR tiffcp (1),
 250 .BR tiff2ps (1)
 251 .PP
 252 Libtiff library home page:
 253 .BR http://www.remotesensing.org/libtiff/