src/3rdparty/libtiff/html/man/tiff2ps.1.html
changeset 30 5dc02b23752f
parent 0 1918ee327afb
equal deleted inserted replaced
29:b72c6db6890b 30:5dc02b23752f
     1 <!-- Creator     : groff version 1.18.1 -->
     1 <!-- Creator     : groff version 1.18.1 -->
     2 <!-- CreationDate: Mon Mar 13 18:03:13 2006 -->
     2 <!-- CreationDate: Fri Jul 13 17:43:19 2007 -->
     3 <html>
     3 <html>
     4 <head>
     4 <head>
     5 <meta name="generator" content="groff -Thtml, see www.gnu.org">
     5 <meta name="generator" content="groff -Thtml, see www.gnu.org">
     6 <meta name="Content-Style" content="text/css">
     6 <meta name="Content-Style" content="text/css">
     7 <title>TIFF2PS</title>
     7 <title>TIFF2PS</title>
    13 <a href="#SYNOPSIS">SYNOPSIS</a><br>
    13 <a href="#SYNOPSIS">SYNOPSIS</a><br>
    14 <a href="#DESCRIPTION">DESCRIPTION</a><br>
    14 <a href="#DESCRIPTION">DESCRIPTION</a><br>
    15 <a href="#OPTIONS">OPTIONS</a><br>
    15 <a href="#OPTIONS">OPTIONS</a><br>
    16 <a href="#EXAMPLES">EXAMPLES</a><br>
    16 <a href="#EXAMPLES">EXAMPLES</a><br>
    17 <a href="#BUGS">BUGS</a><br>
    17 <a href="#BUGS">BUGS</a><br>
    18 <a href="#BUGS">BUGS</a><br>
       
    19 <a href="#SEE ALSO">SEE ALSO</a><br>
    18 <a href="#SEE ALSO">SEE ALSO</a><br>
    20 
    19 
    21 <hr>
    20 <hr>
    22 <a name="NAME"></a>
    21 <a name="NAME"></a>
    23 <h2>NAME</h2>
    22 <h2>NAME</h2>
    26        cols="2" cellspacing="0" cellpadding="0">
    25        cols="2" cellspacing="0" cellpadding="0">
    27 <tr valign="top" align="left">
    26 <tr valign="top" align="left">
    28 <td width="8%"></td>
    27 <td width="8%"></td>
    29 <td width="91%">
    28 <td width="91%">
    30 <p>tiff2ps &minus; convert a <small>TIFF</small> image to
    29 <p>tiff2ps &minus; convert a <small>TIFF</small> image to
    31 &trade;</p>
    30 PostScript&trade;</p>
    32 </td>
    31 </td>
    33 </table>
    32 </table>
    34 <a name="SYNOPSIS"></a>
    33 <a name="SYNOPSIS"></a>
    35 <h2>SYNOPSIS</h2>
    34 <h2>SYNOPSIS</h2>
    36 <!-- INDENTATION -->
    35 <!-- INDENTATION -->
    50        cols="2" cellspacing="0" cellpadding="0">
    49        cols="2" cellspacing="0" cellpadding="0">
    51 <tr valign="top" align="left">
    50 <tr valign="top" align="left">
    52 <td width="8%"></td>
    51 <td width="8%"></td>
    53 <td width="91%">
    52 <td width="91%">
    54 <p><i>tiff2ps</i> reads <small>TIFF</small> images and
    53 <p><i>tiff2ps</i> reads <small>TIFF</small> images and
    55 writes or Encapsulated (EPS) on the standard output. By
    54 writes PostScript or Encapsulated PostScript (EPS) on the
    56 default, <i>tiff2ps</i> writes Encapsulated for the first
    55 standard output. By default, <i>tiff2ps</i> writes
    57 image in the specified <small>TIFF</small> image file.</p>
    56 Encapsulated PostScript for the first image in the specified
    58 <!-- INDENTATION -->
    57 <small>TIFF</small> image file.</p>
    59 <p>By default, <i>tiff2ps</i> will generate that fills a
    58 <!-- INDENTATION -->
    60 printed area specified by the <small>TIFF</small> tags in
    59 <p>By default, <i>tiff2ps</i> will generate PostScript that
    61 the input file. If the file does not contain
    60 fills a printed area specified by the <small>TIFF</small>
       
    61 tags in the input file. If the file does not contain
    62 <i>XResolution</i> or <i>YResolution</i> tags, then the
    62 <i>XResolution</i> or <i>YResolution</i> tags, then the
    63 printed area is set according to the image dimensions. The
    63 printed area is set according to the image dimensions. The
    64 <b>&minus;w</b> and <b>&minus;h</b> options (see below) can
    64 <b>&minus;w</b> and <b>&minus;h</b> options (see below) can
    65 be used to set the dimensions of the printed area in inches;
    65 be used to set the dimensions of the printed area in inches;
    66 overriding any relevant <small>TIFF</small> tags.</p>
    66 overriding any relevant <small>TIFF</small> tags.</p>
    67 <!-- INDENTATION -->
    67 <!-- INDENTATION -->
    68 <p>The generated for <small>RGB,</small> palette, and
    68 <p>The PostScript generated for <small>RGB,</small> palette,
    69 <small>CMYK</small> images uses the <i>colorimage</i>
    69 and <small>CMYK</small> images uses the <i>colorimage</i>
    70 operator. The generated for greyscale and bilevel images
    70 operator. The PostScript generated for greyscale and bilevel
    71 uses the <i>image</i> operator. When the <i>colorimage</i>
    71 images uses the <i>image</i> operator. When the
    72 operator is used, code to emulate this operator on older
    72 <i>colorimage</i> operator is used, PostScript code to
    73 printers is also generated. Note that this emulation code
    73 emulate this operator on older PostScript printers is also
    74 can be very slow.</p>
    74 generated. Note that this emulation code can be very
       
    75 slow.</p>
    75 <!-- INDENTATION -->
    76 <!-- INDENTATION -->
    76 <p>Color images with associated alpha data are composited
    77 <p>Color images with associated alpha data are composited
    77 over a white background.</p>
    78 over a white background.</p>
    78 </td>
    79 </td>
    79 </table>
    80 </table>
    89 <p><b>&minus;1</b></p>
    90 <p><b>&minus;1</b></p>
    90 </td>
    91 </td>
    91 <td width="5%"></td>
    92 <td width="5%"></td>
    92 <td width="80%">
    93 <td width="80%">
    93 
    94 
    94 <p>Generate Level 1 (the default).</p>
    95 <p>Generate PostScript Level 1 (the default).</p>
    95 </td>
    96 </td>
    96 <td width="0%">
    97 <td width="0%">
    97 </td>
    98 </td>
    98 <tr valign="top" align="left">
    99 <tr valign="top" align="left">
    99 <td width="10%"></td>
   100 <td width="10%"></td>
   102 <p><b>&minus;2</b></p>
   103 <p><b>&minus;2</b></p>
   103 </td>
   104 </td>
   104 <td width="5%"></td>
   105 <td width="5%"></td>
   105 <td width="80%">
   106 <td width="80%">
   106 
   107 
   107 <p>Generate Level 2.</p>
   108 <p>Generate PostScript Level 2.</p>
   108 </td>
   109 </td>
   109 <td width="0%">
   110 <td width="0%">
   110 </td>
   111 </td>
   111 <tr valign="top" align="left">
   112 <tr valign="top" align="left">
   112 <td width="10%"></td>
   113 <td width="10%"></td>
   115 <p><b>&minus;3</b></p>
   116 <p><b>&minus;3</b></p>
   116 </td>
   117 </td>
   117 <td width="5%"></td>
   118 <td width="5%"></td>
   118 <td width="80%">
   119 <td width="80%">
   119 
   120 
   120 <p>Generate Level 3. It basically allows one to use the
   121 <p>Generate PostScript Level 3. It basically allows one to
   121 /flateDecode filter for ZIP compressed TIFF images.</p>
   122 use the /flateDecode filter for ZIP compressed TIFF
       
   123 images.</p>
   122 </td>
   124 </td>
   123 <td width="0%">
   125 <td width="0%">
   124 </td>
   126 </td>
   125 <tr valign="top" align="left">
   127 <tr valign="top" align="left">
   126 <td width="10%"></td>
   128 <td width="10%"></td>
   158 </td>
   160 </td>
   159 <td width="5%"></td>
   161 <td width="5%"></td>
   160 <td width="80%">
   162 <td width="80%">
   161 
   163 
   162 <p>Center the image in the output. This option only shows
   164 <p>Center the image in the output. This option only shows
   163 an effect if both the -w and the -h option are given.</p>
   165 an effect if both the <b>&minus;w</b> and the
       
   166 <b>&minus;h</b> option are given.</p>
   164 </td>
   167 </td>
   165 <td width="0%">
   168 <td width="0%">
   166 </td>
   169 </td>
   167 <tr valign="top" align="left">
   170 <tr valign="top" align="left">
   168 <td width="10%"></td>
   171 <td width="10%"></td>
   172 </td>
   175 </td>
   173 <td width="5%"></td>
   176 <td width="5%"></td>
   174 <td width="80%">
   177 <td width="80%">
   175 
   178 
   176 <p>Set the initial <small>TIFF</small> directory to the
   179 <p>Set the initial <small>TIFF</small> directory to the
   177 specified directory number. (NB: directories are numbered
   180 specified directory number. (NB: Directories are numbered
   178 starting at zero.) This option is useful for selecting
   181 starting at zero.) This option is useful for selecting
   179 individual pages in a multi-page (e.g. facsimile) file.</p>
   182 individual pages in a multi-page (e.g. facsimile) file.</p>
   180 </td>
   183 </td>
   181 <td width="0%">
   184 <td width="0%">
   182 </td>
   185 </td>
   187 <p><b>&minus;e</b></p>
   190 <p><b>&minus;e</b></p>
   188 </td>
   191 </td>
   189 <td width="5%"></td>
   192 <td width="5%"></td>
   190 <td width="80%">
   193 <td width="80%">
   191 
   194 
   192 <p>Force the generation of Encapsulated (implies -z).</p>
   195 <p>Force the generation of Encapsulated PostScript (implies
       
   196 <b>&minus;z</b>).</p>
   193 </td>
   197 </td>
   194 <td width="0%">
   198 <td width="0%">
   195 </td>
   199 </td>
   196 <tr valign="top" align="left">
   200 <tr valign="top" align="left">
   197 <td width="10%"></td>
   201 <td width="10%"></td>
   274 <p><b>&minus;m</b></p>
   278 <p><b>&minus;m</b></p>
   275 </td>
   279 </td>
   276 <td width="5%"></td>
   280 <td width="5%"></td>
   277 <td width="80%">
   281 <td width="80%">
   278 
   282 
   279 <p>Where possible render using the <b>imagemask</b>
   283 <p>Where possible render using the <i>imagemask</i>
   280 operator instead of the image operator. When this option is
   284 PostScript operator instead of the <i>image</i> operator.
   281 specified <i>tiff2ps</i> will use <b>imagemask</b> for
   285 When this option is specified <i>tiff2ps</i> will use
   282 rendering 1 bit deep images. If this option is not specified
   286 <i>imagemask</i> for rendering 1 bit deep images. If this
   283 or if the image depth is greater than 1 then the image
   287 option is not specified or if the image depth is greater
   284 operator is used.</p>
   288 than 1 then the <i>image</i> operator is used.</p>
   285 </td>
   289 </td>
   286 <td width="0%">
   290 <td width="0%">
   287 </td>
   291 </td>
   288 <tr valign="top" align="left">
   292 <tr valign="top" align="left">
   289 <td width="10%"></td>
   293 <td width="10%"></td>
   295 <td width="80%">
   299 <td width="80%">
   296 
   300 
   297 <p>Set the initial <small>TIFF</small> directory to the
   301 <p>Set the initial <small>TIFF</small> directory to the
   298 <small>IFD</small> at the specified file offset. This option
   302 <small>IFD</small> at the specified file offset. This option
   299 is useful for selecting thumbnail images and the like which
   303 is useful for selecting thumbnail images and the like which
   300 are hidden using the SubIFD tag.</p>
   304 are hidden using the <i>SubIFD</i> tag.</p>
   301 </td>
   305 </td>
   302 <td width="0%">
   306 <td width="0%">
   303 </td>
   307 </td>
   304 <tr valign="top" align="left">
   308 <tr valign="top" align="left">
   305 <td width="10%"></td>
   309 <td width="10%"></td>
   308 <p><b>&minus;p</b></p>
   312 <p><b>&minus;p</b></p>
   309 </td>
   313 </td>
   310 <td width="5%"></td>
   314 <td width="5%"></td>
   311 <td width="80%">
   315 <td width="80%">
   312 
   316 
   313 <p>Force the generation of (non-Encapsulated) .</p>
   317 <p>Force the generation of (non-Encapsulated)
       
   318 PostScript.</p>
   314 </td>
   319 </td>
   315 <td width="0%">
   320 <td width="0%">
   316 </td>
   321 </td>
   317 <tr valign="top" align="left">
   322 <tr valign="top" align="left">
   318 <td width="10%"></td>
   323 <td width="10%"></td>
   390 <p><b>&minus;z</b></p>
   395 <p><b>&minus;z</b></p>
   391 </td>
   396 </td>
   392 <td width="5%"></td>
   397 <td width="5%"></td>
   393 <td width="80%">
   398 <td width="80%">
   394 
   399 
   395 <p>When generating Level 2, data is scaled so that it does
   400 <p>When generating PostScript Level 2, data is scaled so
   396 not image into the <i>deadzone</i> on a page (the outer
   401 that it does not image into the <i>deadzone</i> on a page
   397 margin that the printing device is unable to mark). This
   402 (the outer margin that the printing device is unable to
   398 option suppresses this behavior. When Level 1 is generated,
   403 mark). This option suppresses this behavior. When PostScript
   399 data is imaged to the entire printed page and this option
   404 Level 1 is generated, data is imaged to the entire printed
   400 has no affect.</p>
   405 page and this option has no affect.</p>
   401 </td>
   406 </td>
   402 <td width="0%">
   407 <td width="0%">
   403 </td>
   408 </td>
   404 </table>
   409 </table>
   405 <a name="EXAMPLES"></a>
   410 <a name="EXAMPLES"></a>
   408 <table width="100%" border=0 rules="none" frame="void"
   413 <table width="100%" border=0 rules="none" frame="void"
   409        cols="2" cellspacing="0" cellpadding="0">
   414        cols="2" cellspacing="0" cellpadding="0">
   410 <tr valign="top" align="left">
   415 <tr valign="top" align="left">
   411 <td width="8%"></td>
   416 <td width="8%"></td>
   412 <td width="91%">
   417 <td width="91%">
   413 <p>The following generates Level 2 for all pages of a
   418 <p>The following generates PostScript Level 2 for all pages
   414 facsimile:</p></td>
   419 of a facsimile:</p></td>
   415 </table>
   420 </table>
   416 <!-- INDENTATION -->
   421 <!-- INDENTATION -->
   417 <table width="100%" border=0 rules="none" frame="void"
   422 <table width="100%" border=0 rules="none" frame="void"
   418        cols="2" cellspacing="0" cellpadding="0">
   423        cols="2" cellspacing="0" cellpadding="0">
   419 <tr valign="top" align="left">
   424 <tr valign="top" align="left">
   420 <td width="17%"></td>
   425 <td width="17%"></td>
   421 <td width="82%">
   426 <td width="82%">
   422 <pre>tiff2ps -a2 fax.tif | lpr
   427 <pre>tiff2ps &minus;a2 fax.tif | lpr
   423 </pre>
   428 </pre>
   424 </td>
   429 </td>
   425 </table>
   430 </table>
   426 <!-- INDENTATION -->
   431 <!-- INDENTATION -->
   427 
   432 
   432 <td width="91%">
   437 <td width="91%">
   433 <p>Note also that if you have version 2.6.1 or newer of
   438 <p>Note also that if you have version 2.6.1 or newer of
   434 Ghostscript then you can efficiently preview facsimile
   439 Ghostscript then you can efficiently preview facsimile
   435 generated with the above command.</p>
   440 generated with the above command.</p>
   436 <!-- INDENTATION -->
   441 <!-- INDENTATION -->
   437 <p>To generate Encapsulated for a the image at directory 2
   442 <p>To generate Encapsulated PostScript for a the image at
   438 of an image use:</p></td>
   443 directory 2 of an image use:</p></td>
   439 </table>
   444 </table>
   440 <!-- INDENTATION -->
   445 <!-- INDENTATION -->
   441 <table width="100%" border=0 rules="none" frame="void"
   446 <table width="100%" border=0 rules="none" frame="void"
   442        cols="2" cellspacing="0" cellpadding="0">
   447        cols="2" cellspacing="0" cellpadding="0">
   443 <tr valign="top" align="left">
   448 <tr valign="top" align="left">
   444 <td width="17%"></td>
   449 <td width="17%"></td>
   445 <td width="82%">
   450 <td width="82%">
   446 <pre>tiff2ps -d 1 foo.tif
   451 <pre>tiff2ps &minus;d 1 foo.tif
   447 </pre>
   452 </pre>
   448 </td>
   453 </td>
   449 </table>
   454 </table>
   450 <!-- INDENTATION -->
   455 <!-- INDENTATION -->
   451 
   456 
   452 <table width="100%" border=0 rules="none" frame="void"
   457 <table width="100%" border=0 rules="none" frame="void"
   453        cols="2" cellspacing="0" cellpadding="0">
   458        cols="2" cellspacing="0" cellpadding="0">
   454 <tr valign="top" align="left">
   459 <tr valign="top" align="left">
   455 <td width="8%"></td>
   460 <td width="8%"></td>
   456 <td width="91%">
   461 <td width="91%">
   457 <p>(notice that directories are numbered starting at
   462 <p>(Notice that directories are numbered starting at
   458 zero.)</p>
   463 zero.)</p>
   459 <!-- INDENTATION -->
   464 <!-- INDENTATION -->
   460 <p>If you have a long image, it may be split in several
   465 <p>If you have a long image, it may be split in several
   461 pages:</p></td>
   466 pages:</p></td>
   462 </table>
   467 </table>
   464 <table width="100%" border=0 rules="none" frame="void"
   469 <table width="100%" border=0 rules="none" frame="void"
   465        cols="2" cellspacing="0" cellpadding="0">
   470        cols="2" cellspacing="0" cellpadding="0">
   466 <tr valign="top" align="left">
   471 <tr valign="top" align="left">
   467 <td width="17%"></td>
   472 <td width="17%"></td>
   468 <td width="82%">
   473 <td width="82%">
   469 <pre>tiff2ps -h11 -w8.5 -H14 -L.5 foo.tif &gt; foo.ps
   474 <pre>tiff2ps &minus;h11 &minus;w8.5 &minus;H14 &minus;L.5 foo.tif &gt; foo.ps
   470 </pre>
   475 </pre>
   471 </td>
   476 </td>
   472 </table>
   477 </table>
   473 <!-- INDENTATION -->
   478 <!-- INDENTATION -->
   474 
   479 
   493 <table width="100%" border=0 rules="none" frame="void"
   498 <table width="100%" border=0 rules="none" frame="void"
   494        cols="2" cellspacing="0" cellpadding="0">
   499        cols="2" cellspacing="0" cellpadding="0">
   495 <tr valign="top" align="left">
   500 <tr valign="top" align="left">
   496 <td width="8%"></td>
   501 <td width="8%"></td>
   497 <td width="91%">
   502 <td width="91%">
   498 <p>Because does not support the notion of a colormap, 8-bit
   503 <p>Because PostScript does not support the notion of a
   499 palette images produce 24-bit images. This conversion
   504 colormap, 8-bit palette images produce 24-bit PostScript
   500 results in output that is six times bigger than the original
   505 images. This conversion results in output that is six times
   501 image and which takes a long time to send to a printer over
   506 bigger than the original image and which takes a long time
   502 a serial line. Matters are even worse for 4-, 2-, and 1-bit
   507 to send to a printer over a serial line. Matters are even
   503 palette images.</p>
   508 worse for 4-, 2-, and 1-bit palette images.</p>
   504 </td>
   509 <!-- INDENTATION -->
   505 </table>
   510 <p>Does not handle tiled images when generating PostScript
   506 <a name="BUGS"></a>
   511 Level I output.</p>
   507 <h2>BUGS</h2>
       
   508 <!-- INDENTATION -->
       
   509 <table width="100%" border=0 rules="none" frame="void"
       
   510        cols="2" cellspacing="0" cellpadding="0">
       
   511 <tr valign="top" align="left">
       
   512 <td width="8%"></td>
       
   513 <td width="91%">
       
   514 <p>Does not handle tiled images when generating PS Level I
       
   515 output.</p>
       
   516 </td>
   512 </td>
   517 </table>
   513 </table>
   518 <a name="SEE ALSO"></a>
   514 <a name="SEE ALSO"></a>
   519 <h2>SEE ALSO</h2>
   515 <h2>SEE ALSO</h2>
   520 <!-- INDENTATION -->
   516 <!-- INDENTATION -->