diff options
Diffstat (limited to 'src/3rdparty/libtiff/html/man/tiff2ps.1.html')
| -rw-r--r-- | src/3rdparty/libtiff/html/man/tiff2ps.1.html | 536 |
1 files changed, 536 insertions, 0 deletions
diff --git a/src/3rdparty/libtiff/html/man/tiff2ps.1.html b/src/3rdparty/libtiff/html/man/tiff2ps.1.html new file mode 100644 index 0000000..e58887d --- /dev/null +++ b/src/3rdparty/libtiff/html/man/tiff2ps.1.html @@ -0,0 +1,536 @@ +<!-- 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> |