forked from Mirrors/freeswitch
e6e5fde3b0
git-svn-id: http://svn.freeswitch.org/svn/freeswitch/trunk@13134 d0543943-73ff-0310-b7d9-9358b9ac24b2
537 lines
13 KiB
HTML
537 lines
13 KiB
HTML
<!-- Creator : groff version 1.18.1 -->
|
|
<!-- CreationDate: Mon Mar 13 18:03:13 2006 -->
|
|
<html>
|
|
<head>
|
|
<meta name="generator" content="groff -Thtml, see www.gnu.org">
|
|
<meta name="Content-Style" content="text/css">
|
|
<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="#BUGS">BUGS</a><br>
|
|
<a href="#SEE ALSO">SEE ALSO</a><br>
|
|
|
|
<hr>
|
|
<a name="NAME"></a>
|
|
<h2>NAME</h2>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="91%">
|
|
<p>tiff2ps − convert a <small>TIFF</small> image to
|
|
™</p>
|
|
</td>
|
|
</table>
|
|
<a name="SYNOPSIS"></a>
|
|
<h2>SYNOPSIS</h2>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="91%">
|
|
<p><b>tiff2ps</b> [ <i>options</i> ] <i>input.tif
|
|
...</i></p>
|
|
</td>
|
|
</table>
|
|
<a name="DESCRIPTION"></a>
|
|
<h2>DESCRIPTION</h2>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="91%">
|
|
<p><i>tiff2ps</i> reads <small>TIFF</small> images and
|
|
writes or Encapsulated (EPS) on the standard output. By
|
|
default, <i>tiff2ps</i> writes Encapsulated for the first
|
|
image in the specified <small>TIFF</small> image file.</p>
|
|
<!-- INDENTATION -->
|
|
<p>By default, <i>tiff2ps</i> will generate 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>
|
|
<!-- INDENTATION -->
|
|
<p>The generated for <small>RGB,</small> palette, and
|
|
<small>CMYK</small> images uses the <i>colorimage</i>
|
|
operator. The generated for greyscale and bilevel images
|
|
uses the <i>image</i> operator. When the <i>colorimage</i>
|
|
operator is used, code to emulate this operator on older
|
|
printers is also generated. Note that this emulation code
|
|
can be very slow.</p>
|
|
<!-- INDENTATION -->
|
|
<p>Color images with associated alpha data are composited
|
|
over a white background.</p>
|
|
</td>
|
|
</table>
|
|
<a name="OPTIONS"></a>
|
|
<h2>OPTIONS</h2>
|
|
<!-- TABS -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="5" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="3%">
|
|
|
|
<p><b>−1</b></p>
|
|
</td>
|
|
<td width="5%"></td>
|
|
<td width="80%">
|
|
|
|
<p>Generate Level 1 (the default).</p>
|
|
</td>
|
|
<td width="0%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="3%">
|
|
|
|
<p><b>−2</b></p>
|
|
</td>
|
|
<td width="5%"></td>
|
|
<td width="80%">
|
|
|
|
<p>Generate Level 2.</p>
|
|
</td>
|
|
<td width="0%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="3%">
|
|
|
|
<p><b>−3</b></p>
|
|
</td>
|
|
<td width="5%"></td>
|
|
<td width="80%">
|
|
|
|
<p>Generate Level 3. It basically allows one to use the
|
|
/flateDecode filter for ZIP compressed TIFF images.</p>
|
|
</td>
|
|
<td width="0%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="3%">
|
|
|
|
<p><b>−a</b></p>
|
|
</td>
|
|
<td width="5%"></td>
|
|
<td width="80%">
|
|
|
|
<p>Generate output for all IFDs (pages) in the input
|
|
file.</p>
|
|
</td>
|
|
<td width="0%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="3%">
|
|
|
|
<p><b>−b</b></p>
|
|
</td>
|
|
<td width="5%"></td>
|
|
<td width="80%">
|
|
|
|
<p>Specify the bottom margin for the output (in inches).
|
|
This does not affect the height of the printed image.</p>
|
|
</td>
|
|
<td width="0%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="3%">
|
|
|
|
<p><b>−c</b></p>
|
|
</td>
|
|
<td width="5%"></td>
|
|
<td width="80%">
|
|
|
|
<p>Center the image in the output. This option only shows
|
|
an effect if both the -w and the -h option are given.</p>
|
|
</td>
|
|
<td width="0%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="3%">
|
|
|
|
<p><b>−d</b></p>
|
|
</td>
|
|
<td width="5%"></td>
|
|
<td width="80%">
|
|
|
|
<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>
|
|
<td width="0%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="3%">
|
|
|
|
<p><b>−e</b></p>
|
|
</td>
|
|
<td width="5%"></td>
|
|
<td width="80%">
|
|
|
|
<p>Force the generation of Encapsulated (implies -z).</p>
|
|
</td>
|
|
<td width="0%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="3%">
|
|
|
|
<p><b>−h</b></p>
|
|
</td>
|
|
<td width="5%"></td>
|
|
<td width="80%">
|
|
|
|
<p>Specify the vertical size of the printed area (in
|
|
inches).</p>
|
|
</td>
|
|
<td width="0%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="3%">
|
|
|
|
<p><b>−H</b></p>
|
|
</td>
|
|
<td width="5%"></td>
|
|
<td width="80%">
|
|
|
|
<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.</p>
|
|
</td>
|
|
<td width="0%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="3%">
|
|
|
|
<p><b>−i</b></p>
|
|
</td>
|
|
<td width="5%"></td>
|
|
<td width="80%">
|
|
|
|
<p>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>
|
|
<td width="0%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="3%">
|
|
|
|
<p><b>−L</b></p>
|
|
</td>
|
|
<td width="5%"></td>
|
|
<td width="80%">
|
|
|
|
<p>Specify the size of overlapping for split images (in
|
|
inches). Used in conjunction with <b>−H</b>
|
|
option.</p>
|
|
</td>
|
|
<td width="0%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="3%">
|
|
|
|
<p><b>−l</b></p>
|
|
</td>
|
|
<td width="5%"></td>
|
|
<td width="80%">
|
|
|
|
<p>Specify the left margin for the output (in inches). This
|
|
does not affect the width of the printed image.</p>
|
|
</td>
|
|
<td width="0%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="3%">
|
|
|
|
<p><b>−m</b></p>
|
|
</td>
|
|
<td width="5%"></td>
|
|
<td width="80%">
|
|
|
|
<p>Where possible render using the <b>imagemask</b>
|
|
operator instead of the image operator. When this option is
|
|
specified <i>tiff2ps</i> will use <b>imagemask</b> for
|
|
rendering 1 bit deep images. If this option is not specified
|
|
or if the image depth is greater than 1 then the image
|
|
operator is used.</p>
|
|
</td>
|
|
<td width="0%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="3%">
|
|
|
|
<p><b>−o</b></p>
|
|
</td>
|
|
<td width="5%"></td>
|
|
<td width="80%">
|
|
|
|
<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 SubIFD tag.</p>
|
|
</td>
|
|
<td width="0%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="3%">
|
|
|
|
<p><b>−p</b></p>
|
|
</td>
|
|
<td width="5%"></td>
|
|
<td width="80%">
|
|
|
|
<p>Force the generation of (non-Encapsulated) .</p>
|
|
</td>
|
|
<td width="0%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="3%">
|
|
|
|
<p><b>−r</b></p>
|
|
</td>
|
|
<td width="5%"></td>
|
|
<td width="80%">
|
|
|
|
<p>Rotate image by 180 degrees.</p>
|
|
</td>
|
|
<td width="0%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="3%">
|
|
|
|
<p><b>−s</b></p>
|
|
</td>
|
|
<td width="5%"></td>
|
|
<td width="80%">
|
|
|
|
<p>Generate output for a single IFD (page) in the input
|
|
file.</p>
|
|
</td>
|
|
<td width="0%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="3%">
|
|
|
|
<p><b>−w</b></p>
|
|
</td>
|
|
<td width="5%"></td>
|
|
<td width="80%">
|
|
|
|
<p>Specify the horizontal size of the printed area (in
|
|
inches).</p>
|
|
</td>
|
|
<td width="0%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="3%">
|
|
|
|
<p><b>−x</b></p>
|
|
</td>
|
|
<td width="5%"></td>
|
|
<td width="80%">
|
|
|
|
<p>Override resolution units specified in the TIFF as
|
|
centimeters.</p>
|
|
</td>
|
|
<td width="0%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="3%">
|
|
|
|
<p><b>−y</b></p>
|
|
</td>
|
|
<td width="5%"></td>
|
|
<td width="80%">
|
|
|
|
<p>Override resolution units specified in the TIFF as
|
|
inches.</p>
|
|
</td>
|
|
<td width="0%">
|
|
</td>
|
|
<tr valign="top" align="left">
|
|
<td width="10%"></td>
|
|
<td width="3%">
|
|
|
|
<p><b>−z</b></p>
|
|
</td>
|
|
<td width="5%"></td>
|
|
<td width="80%">
|
|
|
|
<p>When generating 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 Level 1 is generated,
|
|
data is imaged to the entire printed page and this option
|
|
has no affect.</p>
|
|
</td>
|
|
<td width="0%">
|
|
</td>
|
|
</table>
|
|
<a name="EXAMPLES"></a>
|
|
<h2>EXAMPLES</h2>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="91%">
|
|
<p>The following generates Level 2 for all pages of a
|
|
facsimile:</p></td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="17%"></td>
|
|
<td width="82%">
|
|
<pre>tiff2ps -a2 fax.tif | lpr
|
|
</pre>
|
|
</td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="91%">
|
|
<p>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>
|
|
<!-- INDENTATION -->
|
|
<p>To generate Encapsulated for a the image at directory 2
|
|
of an image use:</p></td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="17%"></td>
|
|
<td width="82%">
|
|
<pre>tiff2ps -d 1 foo.tif
|
|
</pre>
|
|
</td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="91%">
|
|
<p>(notice that directories are numbered starting at
|
|
zero.)</p>
|
|
<!-- INDENTATION -->
|
|
<p>If you have a long image, it may be split in several
|
|
pages:</p></td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="17%"></td>
|
|
<td width="82%">
|
|
<pre>tiff2ps -h11 -w8.5 -H14 -L.5 foo.tif > foo.ps
|
|
</pre>
|
|
</td>
|
|
</table>
|
|
<!-- INDENTATION -->
|
|
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="91%">
|
|
<p>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>
|
|
</td>
|
|
</table>
|
|
<a name="BUGS"></a>
|
|
<h2>BUGS</h2>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="91%">
|
|
<p>Because does not support the notion of a colormap, 8-bit
|
|
palette images produce 24-bit 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>
|
|
</td>
|
|
</table>
|
|
<a name="BUGS"></a>
|
|
<h2>BUGS</h2>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="91%">
|
|
<p>Does not handle tiled images when generating PS Level I
|
|
output.</p>
|
|
</td>
|
|
</table>
|
|
<a name="SEE ALSO"></a>
|
|
<h2>SEE ALSO</h2>
|
|
<!-- INDENTATION -->
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cols="2" cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="8%"></td>
|
|
<td width="91%">
|
|
<p><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>
|
|
<!-- INDENTATION -->
|
|
<p>Libtiff library home page:
|
|
<b>http://www.remotesensing.org/libtiff/</b></p>
|
|
</td>
|
|
</table>
|
|
<hr>
|
|
</body>
|
|
</html>
|