c3402403ea
be used if build directory is not the same as source directory.
* man/{TIFFGetField.3tiff, man/TIFFSetField.3tiff}: Documented
TIFFTAG_PHOTOSHOP, TIFFTAG_RICHTIFFIPTC, and TIFFTAG_XMLPACKET,
and re-sorted tag names in alphabetical order.
423 lines
12 KiB
HTML
423 lines
12 KiB
HTML
<!-- Creator : groff version 1.19.2 -->
|
|
<!-- CreationDate: Mon Jan 2 17:41:55 2006 -->
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
|
|
"http://www.w3.org/TR/html4/loose.dtd">
|
|
<html>
|
|
<head>
|
|
<meta name="generator" content="groff -Thtml, see www.gnu.org">
|
|
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
|
|
<meta name="Content-Style" content="text/css">
|
|
<style type="text/css">
|
|
p { margin-top: 0; margin-bottom: 0; }
|
|
pre { margin-top: 0; margin-bottom: 0; }
|
|
table { margin-top: 0; margin-bottom: 0; }
|
|
</style>
|
|
<title>TIFF2PDF</title>
|
|
|
|
</head>
|
|
<body>
|
|
|
|
<h1 align=center>TIFF2PDF</h1>
|
|
|
|
<a href="#NAME">NAME</a><br>
|
|
<a href="#SYNOPSIS">SYNOPSIS</a><br>
|
|
<a href="#DESCRIPTION">DESCRIPTION</a><br>
|
|
<a href="#OPTIONS">OPTIONS</a><br>
|
|
<a href="#EXAMPLES">EXAMPLES</a><br>
|
|
<a href="#BUGS">BUGS</a><br>
|
|
<a href="#SEE ALSO">SEE ALSO</a><br>
|
|
|
|
<hr>
|
|
|
|
|
|
<a name="NAME"></a>
|
|
<h2>NAME</h2>
|
|
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">tiff2pdf -
|
|
convert a TIFF image to a PDF document</p>
|
|
|
|
<a name="SYNOPSIS"></a>
|
|
<h2>SYNOPSIS</h2>
|
|
|
|
|
|
<p style="margin-left:11%; margin-top: 1em"><b>tiff2pdf
|
|
[</b> <i>options</i> <b>]</b> <i>input.tiff</i></p>
|
|
|
|
<a name="DESCRIPTION"></a>
|
|
<h2>DESCRIPTION</h2>
|
|
|
|
|
|
|
|
<p style="margin-left:11%; margin-top: 1em"><b>tiff2pdf</b>
|
|
opens a TIFF image and writes a PDF document to standard
|
|
output.</p>
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">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
|
|
<i>libtiff</i> and PDF.</p>
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">If you have
|
|
multiple TIFF files to convert into one PDF file then use
|
|
<i>tiffcp</i> 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.</p>
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">The standard
|
|
output is standard output. Set the output file name with the
|
|
<b>-o</b><i>output.pdf</i> option.</p>
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">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, <i>libtiff</i> CCITT support is assumed.</p>
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">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 <b>−j</b> or
|
|
<b>−z</b> options. JPEG compression support requires
|
|
that <i>libtiff</i> be configured with JPEG support, and
|
|
Zip/Deflate compression support requires that <i>libtiff</i>
|
|
be configured with Zip support, in tiffconf.h. Use only one
|
|
or the other of <b>−j</b> and <b>−z.</b></p>
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">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, <b>−d</b> and
|
|
<b>−n.</b></p>
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">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.</p>
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">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
|
|
<b>−x</b> and <b>−y</b> options. The page size
|
|
can be set using the <b>−p</b> option for paper size,
|
|
or <b>−w</b> and <b>−l</b> 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 <b>−u</b> option,
|
|
the default unit is inch.</p>
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">Various items
|
|
of the output document information can be set with the
|
|
<b>−e, −c, −a, −t, −s,</b> and
|
|
<b>−k</b> options. 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.</p>
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">The Portable
|
|
Document Format (PDF) specification is copyrighted by Adobe
|
|
Systems, Incorporated.</p>
|
|
|
|
<a name="OPTIONS"></a>
|
|
<h2>OPTIONS</h2>
|
|
|
|
|
|
|
|
<p style="margin-left:11%; margin-top: 1em"><b>−o</b><i>output-file</i></p>
|
|
|
|
<p style="margin-left:22%;">Set the output to go to file
|
|
<i>output-file</i></p>
|
|
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−j</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Compress with JPEG
|
|
(requires libjpeg configured with libtiff).</p></td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−z</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Compress with
|
|
Zip/Deflate (requires zlib configured with libtiff).</p></td>
|
|
</table>
|
|
|
|
|
|
<p style="margin-left:11%;"><b>−q</b><i>quality</i></p>
|
|
|
|
<p style="margin-left:22%;">Set the compression quality,
|
|
1-100 for JPEG.</p>
|
|
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−n</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Do not allow data
|
|
to be converted without uncompressing, no compressed data
|
|
passthrough.</p> </td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−b</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Set PDF
|
|
"Interpolate" user preference.</p></td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−d</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Do not compress
|
|
(decompress).</p> </td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−i</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Invert colors.</p></td>
|
|
</table>
|
|
|
|
|
|
<p style="margin-left:11%;"><b>−p</b><i>paper-size</i></p>
|
|
|
|
<p style="margin-left:22%;">Set paper size, eg
|
|
"letter", "legal", "A4".</p>
|
|
|
|
|
|
<p style="margin-left:11%;"><b>−u</b><i>[i|m]</i></p>
|
|
|
|
<p style="margin-left:22%;">Set distance unit, <i>i</i> for
|
|
inch, <i>m</i> for centimeter.</p>
|
|
|
|
|
|
<p style="margin-left:11%;"><b>−w</b><i>width</i></p>
|
|
|
|
<p style="margin-left:22%;">Set width in units.</p>
|
|
|
|
|
|
<p style="margin-left:11%;"><b>−l</b><i>length</i></p>
|
|
|
|
<p style="margin-left:22%;">Set length in units.</p>
|
|
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="9%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−x</b><i>xres</i></p> </td>
|
|
<td width="2%"></td>
|
|
<td width="49%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Set x/width
|
|
resolution default.</p></td>
|
|
<td width="29%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="9%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−y</b><i>yres</i></p> </td>
|
|
<td width="2%"></td>
|
|
<td width="49%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Set y/length
|
|
resolution default.</p></td>
|
|
<td width="29%">
|
|
</td>
|
|
</table>
|
|
|
|
|
|
<p style="margin-left:11%;"><b>−r</b><i>[d|o]</i></p>
|
|
|
|
<p style="margin-left:22%;">Set <i>d</i> for resolution
|
|
default for images without resolution, <i>o for resolution
|
|
override for all images.</i></p>
|
|
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−f</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="56%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Set PDF "Fit
|
|
Window" user preference.</p></td>
|
|
<td width="22%">
|
|
</td>
|
|
</table>
|
|
|
|
|
|
<p style="margin-left:11%;"><b>−e</b><i>YYYYMMDDHHMMSS</i></p>
|
|
|
|
<p style="margin-left:22%;">Set document information date,
|
|
overrides image or current date/time default,
|
|
<i>YYYYMMDDHHMMSS.</i></p>
|
|
|
|
|
|
<p style="margin-left:11%;"><b>−c</b><i>creator</i></p>
|
|
|
|
<p style="margin-left:22%;">Set document information
|
|
creator, overrides image software default.</p>
|
|
|
|
|
|
<p style="margin-left:11%;"><b>−a</b><i>author</i></p>
|
|
|
|
<p style="margin-left:22%;">Set document information
|
|
author, overrides image artist default</p>
|
|
|
|
|
|
<p style="margin-left:11%;"><b>−t</b><i>title</i></p>
|
|
|
|
<p style="margin-left:22%;">Set document information title,
|
|
overrides image document name default</p>
|
|
|
|
|
|
<p style="margin-left:11%;"><b>−s</b><i>subject</i></p>
|
|
|
|
<p style="margin-left:22%;">Set document information
|
|
subject, overrides image image description default</p>
|
|
|
|
|
|
<p style="margin-left:11%;"><b>−k</b><i>keywords</i></p>
|
|
|
|
<p style="margin-left:22%;">Set document information
|
|
keywords.</p>
|
|
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−h</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="60%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">List usage reminder
|
|
to stderr and exit.</p></td>
|
|
<td width="18%">
|
|
</td>
|
|
</table>
|
|
|
|
<a name="EXAMPLES"></a>
|
|
<h2>EXAMPLES</h2>
|
|
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">The following
|
|
example would generate the file output.pdf from <br>
|
|
input.tiff.</p>
|
|
|
|
<p style="margin-left:22%; margin-top: 1em">tiff2pdf -o
|
|
output.pdf input.tiff</p>
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">The following
|
|
example would generate PDF output from input.tiff and write
|
|
it to standard output.</p>
|
|
|
|
<p style="margin-left:22%; margin-top: 1em">tiff2pdf
|
|
input.tiff</p>
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">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.</p>
|
|
|
|
<p style="margin-left:22%; margin-top: 1em">tiff2pdf -p
|
|
letter -j -q 75 -t "Document" -f -o output.pdf
|
|
input.tiff</p>
|
|
|
|
<a name="BUGS"></a>
|
|
<h2>BUGS</h2>
|
|
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">Please report
|
|
bugs via the web interface at</p>
|
|
|
|
|
|
<p style="margin-left:22%; margin-top: 1em">http://bugzilla.remotesensing.org/enter_bug.cgi?product=libtiff</p>
|
|
|
|
<a name="SEE ALSO"></a>
|
|
<h2>SEE ALSO</h2>
|
|
|
|
|
|
|
|
<p style="margin-left:11%; margin-top: 1em"><b>libtiff</b>(3)<b>,
|
|
tiffcp</b>(1)<b>, tiff2ps</b>(1)</p>
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">Libtiff library
|
|
home page: <b>http://www.remotesensing.org/libtiff/</b></p>
|
|
<hr>
|
|
</body>
|
|
</html>
|