| DIR: /usr/share/doc/libtiff-devel/html/man /usr/share/doc/libtiff-devel/html/man/ |
| Current File : /usr/share/doc/libtiff-devel/html/man/tiff2ps.1.html |
<!-- Creator : groff version 1.22.4 -->
<!-- CreationDate: Sun Nov 2 19:00:00 2025 -->
<!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; vertical-align: top }
pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
table { margin-top: 0; margin-bottom: 0; vertical-align: top }
h1 { text-align: center }
</style>
<title>TIFF2PS</title>
</head>
<body>
<h1 align="center">TIFF2PS</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>
<h2>NAME
<a name="NAME"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">tiff2ps −
convert a <small>TIFF</small> image to PostScript™</p>
<h2>SYNOPSIS
<a name="SYNOPSIS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>tiff2ps</b>
[ <i>options</i> ] <i>input.tif ...</i></p>
<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><i>tiff2ps</i>
reads <small>TIFF</small> images and writes PostScript or
Encapsulated PostScript (EPS) on the standard output. By
default, <i>tiff2ps</i> writes Encapsulated PostScript for
the first image in the specified <small>TIFF</small> image
file.</p>
<p style="margin-left:11%; margin-top: 1em">By default,
<i>tiff2ps</i> will generate PostScript that fills a printed
area specified by the <small>TIFF</small> tags in the input
file. If the file does not contain <i>XResolution</i> or
<i>YResolution</i> tags, then the printed area is set
according to the image dimensions. The <b>−w</b> and
<b>−h</b> options (see below) can be used to set the
dimensions of the printed area in inches; overriding any
relevant <small>TIFF</small> tags.</p>
<p style="margin-left:11%; margin-top: 1em">The PostScript
generated for <small>RGB,</small> palette, and
<small>CMYK</small> images uses the <i>colorimage</i>
operator. The PostScript generated for greyscale and bilevel
images uses the <i>image</i> operator. When the
<i>colorimage</i> operator is used, PostScript code to
emulate this operator on older PostScript printers is also
generated. Note that this emulation code can be very
slow.</p>
<p style="margin-left:11%; margin-top: 1em">Color images
with associated alpha data are composited over a white
background.</p>
<h2>OPTIONS
<a name="OPTIONS"></a>
</h2>
<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"><b>−1</b></p></td>
<td width="8%"></td>
<td width="78%">
<p style="margin-top: 1em">Generate PostScript Level 1 (the
default).</p> </td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p><b>−2</b></p></td>
<td width="8%"></td>
<td width="78%">
<p>Generate PostScript Level 2.</p></td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p><b>−3</b></p></td>
<td width="8%"></td>
<td width="78%">
<p>Generate PostScript Level 3. It basically allows one to
use the /flateDecode filter for ZIP compressed TIFF
images.</p> </td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p><b>−8</b></p></td>
<td width="8%"></td>
<td width="78%">
<p>Disable use of ASCII85 encoding with PostScript Level
2/3.</p> </td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p><b>−a</b></p></td>
<td width="8%"></td>
<td width="78%">
<p>Generate output for all IFDs (pages) in the input
file.</p> </td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p><b>−b</b></p></td>
<td width="8%"></td>
<td width="78%">
<p>Specify the bottom margin for the output (in inches).
This does not affect the height of the printed image.</p></td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p><b>−c</b></p></td>
<td width="8%"></td>
<td width="78%">
<p>Center the image in the output. This option only shows
an effect if both the <b>−w</b> and the
<b>−h</b> option are given.</p></td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p><b>−C</b></p></td>
<td width="8%"></td>
<td width="78%">
<p>Specify the document creator name.</p></td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p><b>−d</b></p></td>
<td width="8%"></td>
<td width="78%">
<p>Set the initial <small>TIFF</small> directory to the
specified directory number. (NB: Directories are numbered
starting at zero.) This option is useful for selecting
individual pages in a multi-page (e.g. facsimile) file.</p></td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p><b>−D</b></p></td>
<td width="8%"></td>
<td width="78%">
<p>Enable duplex printing (two pages per sheet of
paper).</p> </td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p><b>−e</b></p></td>
<td width="8%"></td>
<td width="78%">
<p>Force the generation of Encapsulated PostScript (implies
<b>−z</b>).</p> </td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p><b>−h</b></p></td>
<td width="8%"></td>
<td width="78%">
<p>Specify the vertical size of the printed area (in
inches).</p> </td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p><b>−H</b></p></td>
<td width="8%"></td>
<td width="78%">
<p>Specify the maximum height of image (in inches). Images
with larger sizes will be split in several pages. Option
<b>−L</b> may be used for specifying size of split
images overlapping. <b>−i</b> Enable/disable pixel
interpolation. This option requires a single numeric value:
zero to disable pixel interpolation and non-zero to enable.
The default is enabled.</p></td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p><b>−L</b></p></td>
<td width="8%"></td>
<td width="78%">
<p>Specify the size of overlapping for split images (in
inches). Used in conjunction with <b>−H</b> and
<b>−W</b> options.</p></td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p><b>−l</b></p></td>
<td width="8%"></td>
<td width="78%">
<p>Specify the left margin for the output (in inches). This
does not affect the width of the printed image.</p></td></tr>
</table>
<p style="margin-left:11%;"><b>−M</b> <i>size</i></p>
<p style="margin-left:22%;">Set maximum memory allocation
size (in MiB). The default is 256MiB. Set to 0 to disable
the limit.</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><b>−m</b></p></td>
<td width="2%"></td>
<td width="78%">
<p>Where possible render using the <i>imagemask</i>
PostScript operator instead of the <i>image</i> operator.
When this option is specified <i>tiff2ps</i> will use
<i>imagemask</i> for rendering 1 bit deep images. If this
option is not specified or if the image depth is greater
than 1 then the <i>image</i> operator is used.</p></td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="9%">
<p><b>−o</b></p></td>
<td width="2%"></td>
<td width="78%">
<p>Set the initial <small>TIFF</small> directory to the
<small>IFD</small> at the specified file offset. This option
is useful for selecting thumbnail images and the like which
are hidden using the <i>SubIFD</i> tag.</p></td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="9%">
<p><b>−O</b></p></td>
<td width="2%"></td>
<td width="78%">
<p>Write PostScript to specified file instead of standard
output.</p> </td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="9%">
<p><b>−p</b></p></td>
<td width="2%"></td>
<td width="78%">
<p>Force the generation of (non-Encapsulated)
PostScript.</p> </td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="9%">
<p><b>−P L|P</b></p></td>
<td width="2%"></td>
<td width="78%">
<p>Set optional PageOrientation DSC comment to Landscape or
Portrait.</p> </td></tr>
</table>
<p style="margin-left:11%;"><b>−r
90|180|270|auto</b></p>
<p style="margin-left:22%;">Rotate image by 90, 180, 270
degrees or auto. Auto picks the best fit for the image on
the specified paper size (eg portrait or landscape) if -h or
-w is specified. Rotation is in degrees counterclockwise.
Auto rotates 90 degrees ccw to produce landscape.</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><b>−s</b></p></td>
<td width="8%"></td>
<td width="78%">
<p>Generate output for a single IFD (page) in the input
file.</p> </td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p><b>−t</b></p></td>
<td width="8%"></td>
<td width="78%">
<p>Specify the document title string.</p></td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p><b>−T</b></p></td>
<td width="8%"></td>
<td width="78%">
<p>Print pages for top edge binding.</p></td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p><b>−w</b></p></td>
<td width="8%"></td>
<td width="78%">
<p>Specify the horizontal size of the printed area (in
inches).</p> </td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p><b>−W</b></p></td>
<td width="8%"></td>
<td width="78%">
<p>Specify the maximum width of image (in inches). Images
with larger sizes will be split in several pages. Options
<b>−L</b> and <b>−W</b> are mutually
exclusive.</p> </td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p><b>−x</b></p></td>
<td width="8%"></td>
<td width="78%">
<p>Override resolution units specified in the TIFF as
centimeters.</p> </td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p><b>−y</b></p></td>
<td width="8%"></td>
<td width="78%">
<p>Override resolution units specified in the TIFF as
inches.</p> </td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p><b>−z</b></p></td>
<td width="8%"></td>
<td width="78%">
<p>When generating PostScript Level 2, data is scaled so
that it does not image into the <i>deadzone</i> on a page
(the outer margin that the printing device is unable to
mark). This option suppresses this behavior. When PostScript
Level 1 is generated, data is imaged to the entire printed
page and this option has no affect.</p></td></tr>
</table>
<h2>EXAMPLES
<a name="EXAMPLES"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">The following
generates PostScript Level 2 for all pages of a
facsimile:</p>
<p style="margin-left:22%;">tiff2ps −a2 fax.tif |
lpr</p>
<p style="margin-left:11%;">Note also that if you have
version 2.6.1 or newer of Ghostscript then you can
efficiently preview facsimile generated with the above
command.</p>
<p style="margin-left:11%; margin-top: 1em">To generate
Encapsulated PostScript for a the image at directory 2 of an
image use:</p>
<p style="margin-left:22%;">tiff2ps −d 1 foo.tif</p>
<p style="margin-left:11%;">(Notice that directories are
numbered starting at zero.)</p>
<p style="margin-left:11%; margin-top: 1em">If you have a
long image, it may be split in several pages:</p>
<p style="margin-left:22%;">tiff2ps −h11 −w8.5
−H14 −L.5 foo.tif > foo.ps</p>
<p style="margin-left:11%;">The page size is set to 8.5x11
by <b>−w</b> and <b>−h</b> options. We will
accept a small amount of vertical compression, so
<b>−H</b> set to 14. Any pages between 11 and 14
inches will be fit onto one page. Pages longer than 14
inches are cut off at 11 and continued on the next page. The
<b>−L.5</b> option says to repeat a half inch on the
next page (to improve readability).</p>
<h2>BUGS
<a name="BUGS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">Because
PostScript does not support the notion of a colormap, 8-bit
palette images produce 24-bit PostScript images. This
conversion results in output that is six times bigger than
the original image and which takes a long time to send to a
printer over a serial line. Matters are even worse for 4-,
2-, and 1-bit palette images.</p>
<p style="margin-left:11%; margin-top: 1em">Does not handle
tiled images when generating PostScript Level I output.</p>
<h2>SEE ALSO
<a name="SEE ALSO"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>pal2rgb</b>(1),
<b>tiffinfo</b>(1), <b>tiffcp</b>(1), <b>tiffgt</b>(1),
<b>tiffmedian</b>(1), <b>tiff2bw</b>(1), <b>tiffsv</b>(1),
<b>libtiff</b>(3)</p>
<p style="margin-left:11%; margin-top: 1em">Libtiff library
home page: <b>http://www.simplesystems.org/libtiff/</b></p>
<hr>
</body>
</html>
|