180 lines
6.5 KiB
Groff
180 lines
6.5 KiB
Groff
.\" $Id: tiff2pdf.1,v 1.1 2003-11-26 15:04:51 rossf Exp $
|
|
.\"
|
|
.\" Copyright (c) 2003 Ross Finlayson
|
|
.\"
|
|
.\" Permission to use, copy, modify, distribute, and sell this software and
|
|
.\" its documentation for any purpose is hereby granted without fee, provided
|
|
.\" that (i) the above copyright notices and this permission notice appear in
|
|
.\" all copies of the software and related documentation, and (ii) the name of
|
|
.\" Ross Finlayson may not be used in any advertising or
|
|
.\" publicity relating to the software without the specific, prior written
|
|
.\" permission of Ross Finlayson.
|
|
.\"
|
|
.\" THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND,
|
|
.\" EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
|
|
.\" WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
|
|
.\"
|
|
.\" IN NO EVENT SHALL ROSS FINLAYSON BE LIABLE FOR
|
|
.\" ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
|
|
.\" OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
|
|
.\" WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF
|
|
.\" LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
|
|
.\" OF THIS SOFTWARE.
|
|
.\"
|
|
.\" Process this file with
|
|
.\" groff -man -Tascii tiff2pdf.1
|
|
.\"
|
|
.TH TIFF2PDF 1 "NOVEMBER 2003" "tiff2pdf"
|
|
.SH NAME
|
|
tiff2pdf - convert a TIFF image to a PDF document
|
|
.SH SYNOPSIS
|
|
.B tiff2pdf [
|
|
.I options
|
|
.B ]
|
|
.I input.tiff
|
|
.SH DESCRIPTION
|
|
.B tiff2pdf
|
|
opens a TIFF image and writes a PDF document to standard output.
|
|
.PP
|
|
The program converts one TIFF file to one PDF file, including multiple page
|
|
TIFF files, tiled TIFF files, black and white. grayscale, and color TIFF
|
|
files that contain data of TIFF photometric interpretations of bilevel,
|
|
grayscale, RGB, YCbCr, CMYK separation, and ICC L*a*b* as supported by
|
|
.B libtiff
|
|
and PDF.
|
|
.PP
|
|
If you have multiple TIFF files to convert into one PDF file then use
|
|
.B tiffcp
|
|
or other program to concatenate the files into a multiple page TIFF file.
|
|
If the input TIFF file is of huge dimensions (greater than 10000 pixels height
|
|
or width) convert the input image to a tiled TIFF if it is not already.
|
|
.PP
|
|
The standard output is standard output. Set the output file name with the
|
|
"-o output.pdf" option.
|
|
.PP
|
|
All black and white files are compressed into a single strip CCITT G4 Fax
|
|
compressed PDF, unless tiled, where tiled black and white images are
|
|
compressed into tiled CCITT G4 Fax compressed PDF,
|
|
.B libtiff
|
|
CCITT support is assumed.
|
|
.PP
|
|
Color and grayscale data can be compressed using either JPEG compression,
|
|
ITU-T T.81, or Zip/Deflate LZ77 compression. Set
|
|
the compression type using the -j or -z options. JPEG compression support
|
|
requires that
|
|
.B libtiff
|
|
be configured with JPEG support, and Zip/Deflate
|
|
compression support requires that
|
|
.B libtiff
|
|
be configured with Zip support,
|
|
in tiffconf.h. Use only one or the other of -j and -z.
|
|
.PP
|
|
If the input TIFF contains single strip CCITT G4 Fax compressed information,
|
|
then that is written to the PDF file without transcoding, unless the options
|
|
of no compression and no passthrough are set, -d and -n.
|
|
.PP
|
|
If the input TIFF contains JPEG or single strip Zip/Deflate compressed
|
|
information, and they are configured, then that is written to the PDF file
|
|
without transcoding, unless the options of no compression and no passthrough
|
|
are set.
|
|
.PP
|
|
The default page size upon which the TIFF image is placed is determined by
|
|
the resolution and extent of the image data. Default values for the TIFF
|
|
image resolution can be set using the -x and -y options. The page size can
|
|
be set using the -p option for paper size, or -w and -l for paper width and
|
|
length, then each page of the TIFF image is centered on its page. The
|
|
distance unit for default resolution and page width and length can be set
|
|
by the -u option, the default unit is inch.
|
|
.PP
|
|
Various items of the output document information can be set with the -e, -c,
|
|
-a, -t, -s, and -k tags. Setting the argument of the option to "" for these
|
|
tags causes the relevant document information field to be not written. Some
|
|
of the document information values otherwise get their information from the
|
|
input TIFF image, the software, author, document name, and image description.
|
|
.PP
|
|
The Portable Document Format (PDF) specification is copyrighted by Adobe
|
|
Systems, Incorporated.
|
|
.SH OPTIONS
|
|
.IP "-o output-file"
|
|
Set the output to go to file
|
|
.B output-file
|
|
.IP -j
|
|
Compress with JPEG (requires libjpeg configured with libtiff)
|
|
.IP -z
|
|
Compress with Zip/Deflate (requires zlib configured with libtiff)
|
|
.IP "-q quality"
|
|
Set the compression quality, 1-100 for JPEG.
|
|
.IP -n
|
|
Do not allow data to be converted without uncompressing, no compressed data passthrough.
|
|
.IP -d
|
|
Do not compress (decompress).
|
|
.IP -i
|
|
Invert colors.
|
|
.IP "-p paper-size"
|
|
Set paper size, eg "letter", "legal", "A4".
|
|
.IP "-u [i|m]"
|
|
Set distance unit, 'i' for inch, 'm' for centimeter.
|
|
.IP "-w width"
|
|
Set width in units.
|
|
.IP "-l length"
|
|
Set length in units.
|
|
.IP "-x xres"
|
|
Set x/width resolution default.
|
|
.IP "-y yres"
|
|
Set y/length resolution default.
|
|
.IP "-r [d|o]"
|
|
Set 'd' for resolution default for images without resolution, 'o' for resolution override for
|
|
all images.
|
|
.IP -f
|
|
Set PDF "Fit Window" user preference
|
|
.IP "-e YYYYMMDDHHMMSS"
|
|
Set document information date, overrides image or current date/time default, YYYYMMDDHHMMSS.
|
|
.IP "-c creator"
|
|
Set document information creator, overrides image software default.
|
|
.IP "-a author"
|
|
Set document information author, overrides image artist default
|
|
.IP "-t title"
|
|
Set document information title, overrides image document name default
|
|
.IP "-s subject"
|
|
Set document information subject, overrides image image description default
|
|
.IP "-k keywords"
|
|
Set document information keywords.
|
|
.IP -h
|
|
List usage reminder to stderr and exit.
|
|
.SH EXAMPLES
|
|
The following example would generate the file output.pdf from input.tiff.
|
|
.PP
|
|
.RS
|
|
.NF
|
|
tiff2pdf -o output.pdf input.tiff
|
|
.FI
|
|
.RE
|
|
.PP
|
|
The following example would generate PDF output from input.tiff and write it
|
|
to standard output.
|
|
.PP
|
|
.RS
|
|
.NF
|
|
tiff2pdf input.tiff
|
|
.FI
|
|
.RE
|
|
.PP
|
|
The following example would generate the file output.pdf from input.tiff,
|
|
putting the image pages on a letter sized page, compressing the output
|
|
with JPEG, with JPEG quality 75, setting the title to "Document", and setting
|
|
the "Fit Window" option.
|
|
.PP
|
|
.RS
|
|
.NF
|
|
tiff2pdf -p letter -j -q 75 -t "Document" -f -o output.pdf input.tiff
|
|
.FI
|
|
.RE
|
|
.SH BUGS
|
|
Please report bugs via the web interface at
|
|
http://bugzilla.remotesensing.org/enter_bug.cgi?product=libtiff.
|
|
.
|
|
.SH "SEE ALSO"
|
|
.BR libtiff (3) ,
|
|
.BR tiffcp (1) ,
|
|
.BR tiff2ps (1)
|