src/tiff/man/tiff2pdf.1

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