src/3rdparty/libtiff/html/man/tiff2ps.1.html
changeset 0 1918ee327afb
equal deleted inserted replaced
-1:000000000000 0:1918ee327afb
       
     1 <!-- Creator     : groff version 1.18.1 -->
       
     2 <!-- CreationDate: Mon Mar 13 18:03:13 2006 -->
       
     3 <html>
       
     4 <head>
       
     5 <meta name="generator" content="groff -Thtml, see www.gnu.org">
       
     6 <meta name="Content-Style" content="text/css">
       
     7 <title>TIFF2PS</title>
       
     8 </head>
       
     9 <body>
       
    10 
       
    11 <h1 align=center>TIFF2PS</h1>
       
    12 <a href="#NAME">NAME</a><br>
       
    13 <a href="#SYNOPSIS">SYNOPSIS</a><br>
       
    14 <a href="#DESCRIPTION">DESCRIPTION</a><br>
       
    15 <a href="#OPTIONS">OPTIONS</a><br>
       
    16 <a href="#EXAMPLES">EXAMPLES</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>
       
    20 
       
    21 <hr>
       
    22 <a name="NAME"></a>
       
    23 <h2>NAME</h2>
       
    24 <!-- INDENTATION -->
       
    25 <table width="100%" border=0 rules="none" frame="void"
       
    26        cols="2" cellspacing="0" cellpadding="0">
       
    27 <tr valign="top" align="left">
       
    28 <td width="8%"></td>
       
    29 <td width="91%">
       
    30 <p>tiff2ps &minus; convert a <small>TIFF</small> image to
       
    31 &trade;</p>
       
    32 </td>
       
    33 </table>
       
    34 <a name="SYNOPSIS"></a>
       
    35 <h2>SYNOPSIS</h2>
       
    36 <!-- INDENTATION -->
       
    37 <table width="100%" border=0 rules="none" frame="void"
       
    38        cols="2" cellspacing="0" cellpadding="0">
       
    39 <tr valign="top" align="left">
       
    40 <td width="8%"></td>
       
    41 <td width="91%">
       
    42 <p><b>tiff2ps</b> [ <i>options</i> ] <i>input.tif
       
    43 ...</i></p>
       
    44 </td>
       
    45 </table>
       
    46 <a name="DESCRIPTION"></a>
       
    47 <h2>DESCRIPTION</h2>
       
    48 <!-- INDENTATION -->
       
    49 <table width="100%" border=0 rules="none" frame="void"
       
    50        cols="2" cellspacing="0" cellpadding="0">
       
    51 <tr valign="top" align="left">
       
    52 <td width="8%"></td>
       
    53 <td width="91%">
       
    54 <p><i>tiff2ps</i> reads <small>TIFF</small> images and
       
    55 writes or Encapsulated (EPS) on the standard output. By
       
    56 default, <i>tiff2ps</i> writes Encapsulated for the first
       
    57 image in the specified <small>TIFF</small> image file.</p>
       
    58 <!-- INDENTATION -->
       
    59 <p>By default, <i>tiff2ps</i> will generate that fills a
       
    60 printed area specified by the <small>TIFF</small> tags in
       
    61 the input file. If the file does not contain
       
    62 <i>XResolution</i> or <i>YResolution</i> tags, then 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
       
    65 be used to set the dimensions of the printed area in inches;
       
    66 overriding any relevant <small>TIFF</small> tags.</p>
       
    67 <!-- INDENTATION -->
       
    68 <p>The generated for <small>RGB,</small> palette, and
       
    69 <small>CMYK</small> images uses the <i>colorimage</i>
       
    70 operator. The generated for greyscale and bilevel images
       
    71 uses the <i>image</i> operator. When the <i>colorimage</i>
       
    72 operator is used, code to emulate this operator on older
       
    73 printers is also generated. Note that this emulation code
       
    74 can be very slow.</p>
       
    75 <!-- INDENTATION -->
       
    76 <p>Color images with associated alpha data are composited
       
    77 over a white background.</p>
       
    78 </td>
       
    79 </table>
       
    80 <a name="OPTIONS"></a>
       
    81 <h2>OPTIONS</h2>
       
    82 <!-- TABS -->
       
    83 <table width="100%" border=0 rules="none" frame="void"
       
    84        cols="5" cellspacing="0" cellpadding="0">
       
    85 <tr valign="top" align="left">
       
    86 <td width="10%"></td>
       
    87 <td width="3%">
       
    88 
       
    89 <p><b>&minus;1</b></p>
       
    90 </td>
       
    91 <td width="5%"></td>
       
    92 <td width="80%">
       
    93 
       
    94 <p>Generate Level 1 (the default).</p>
       
    95 </td>
       
    96 <td width="0%">
       
    97 </td>
       
    98 <tr valign="top" align="left">
       
    99 <td width="10%"></td>
       
   100 <td width="3%">
       
   101 
       
   102 <p><b>&minus;2</b></p>
       
   103 </td>
       
   104 <td width="5%"></td>
       
   105 <td width="80%">
       
   106 
       
   107 <p>Generate Level 2.</p>
       
   108 </td>
       
   109 <td width="0%">
       
   110 </td>
       
   111 <tr valign="top" align="left">
       
   112 <td width="10%"></td>
       
   113 <td width="3%">
       
   114 
       
   115 <p><b>&minus;3</b></p>
       
   116 </td>
       
   117 <td width="5%"></td>
       
   118 <td width="80%">
       
   119 
       
   120 <p>Generate Level 3. It basically allows one to use the
       
   121 /flateDecode filter for ZIP compressed TIFF images.</p>
       
   122 </td>
       
   123 <td width="0%">
       
   124 </td>
       
   125 <tr valign="top" align="left">
       
   126 <td width="10%"></td>
       
   127 <td width="3%">
       
   128 
       
   129 <p><b>&minus;a</b></p>
       
   130 </td>
       
   131 <td width="5%"></td>
       
   132 <td width="80%">
       
   133 
       
   134 <p>Generate output for all IFDs (pages) in the input
       
   135 file.</p>
       
   136 </td>
       
   137 <td width="0%">
       
   138 </td>
       
   139 <tr valign="top" align="left">
       
   140 <td width="10%"></td>
       
   141 <td width="3%">
       
   142 
       
   143 <p><b>&minus;b</b></p>
       
   144 </td>
       
   145 <td width="5%"></td>
       
   146 <td width="80%">
       
   147 
       
   148 <p>Specify the bottom margin for the output (in inches).
       
   149 This does not affect the height of the printed image.</p>
       
   150 </td>
       
   151 <td width="0%">
       
   152 </td>
       
   153 <tr valign="top" align="left">
       
   154 <td width="10%"></td>
       
   155 <td width="3%">
       
   156 
       
   157 <p><b>&minus;c</b></p>
       
   158 </td>
       
   159 <td width="5%"></td>
       
   160 <td width="80%">
       
   161 
       
   162 <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>
       
   164 </td>
       
   165 <td width="0%">
       
   166 </td>
       
   167 <tr valign="top" align="left">
       
   168 <td width="10%"></td>
       
   169 <td width="3%">
       
   170 
       
   171 <p><b>&minus;d</b></p>
       
   172 </td>
       
   173 <td width="5%"></td>
       
   174 <td width="80%">
       
   175 
       
   176 <p>Set the initial <small>TIFF</small> directory to the
       
   177 specified directory number. (NB: directories are numbered
       
   178 starting at zero.) This option is useful for selecting
       
   179 individual pages in a multi-page (e.g. facsimile) file.</p>
       
   180 </td>
       
   181 <td width="0%">
       
   182 </td>
       
   183 <tr valign="top" align="left">
       
   184 <td width="10%"></td>
       
   185 <td width="3%">
       
   186 
       
   187 <p><b>&minus;e</b></p>
       
   188 </td>
       
   189 <td width="5%"></td>
       
   190 <td width="80%">
       
   191 
       
   192 <p>Force the generation of Encapsulated (implies -z).</p>
       
   193 </td>
       
   194 <td width="0%">
       
   195 </td>
       
   196 <tr valign="top" align="left">
       
   197 <td width="10%"></td>
       
   198 <td width="3%">
       
   199 
       
   200 <p><b>&minus;h</b></p>
       
   201 </td>
       
   202 <td width="5%"></td>
       
   203 <td width="80%">
       
   204 
       
   205 <p>Specify the vertical size of the printed area (in
       
   206 inches).</p>
       
   207 </td>
       
   208 <td width="0%">
       
   209 </td>
       
   210 <tr valign="top" align="left">
       
   211 <td width="10%"></td>
       
   212 <td width="3%">
       
   213 
       
   214 <p><b>&minus;H</b></p>
       
   215 </td>
       
   216 <td width="5%"></td>
       
   217 <td width="80%">
       
   218 
       
   219 <p>Specify the maximum height of image (in inches). Images
       
   220 with larger sizes will be split in several pages. Option
       
   221 <b>&minus;L</b> may be used for specifying size of split
       
   222 images overlapping.</p>
       
   223 </td>
       
   224 <td width="0%">
       
   225 </td>
       
   226 <tr valign="top" align="left">
       
   227 <td width="10%"></td>
       
   228 <td width="3%">
       
   229 
       
   230 <p><b>&minus;i</b></p>
       
   231 </td>
       
   232 <td width="5%"></td>
       
   233 <td width="80%">
       
   234 
       
   235 <p>Enable/disable pixel interpolation. This option requires
       
   236 a single numeric value: zero to disable pixel interpolation
       
   237 and non-zero to enable. The default is enabled.</p>
       
   238 </td>
       
   239 <td width="0%">
       
   240 </td>
       
   241 <tr valign="top" align="left">
       
   242 <td width="10%"></td>
       
   243 <td width="3%">
       
   244 
       
   245 <p><b>&minus;L</b></p>
       
   246 </td>
       
   247 <td width="5%"></td>
       
   248 <td width="80%">
       
   249 
       
   250 <p>Specify the size of overlapping for split images (in
       
   251 inches). Used in conjunction with <b>&minus;H</b>
       
   252 option.</p>
       
   253 </td>
       
   254 <td width="0%">
       
   255 </td>
       
   256 <tr valign="top" align="left">
       
   257 <td width="10%"></td>
       
   258 <td width="3%">
       
   259 
       
   260 <p><b>&minus;l</b></p>
       
   261 </td>
       
   262 <td width="5%"></td>
       
   263 <td width="80%">
       
   264 
       
   265 <p>Specify the left margin for the output (in inches). This
       
   266 does not affect the width of the printed image.</p>
       
   267 </td>
       
   268 <td width="0%">
       
   269 </td>
       
   270 <tr valign="top" align="left">
       
   271 <td width="10%"></td>
       
   272 <td width="3%">
       
   273 
       
   274 <p><b>&minus;m</b></p>
       
   275 </td>
       
   276 <td width="5%"></td>
       
   277 <td width="80%">
       
   278 
       
   279 <p>Where possible render using the <b>imagemask</b>
       
   280 operator instead of the image operator. When this option is
       
   281 specified <i>tiff2ps</i> will use <b>imagemask</b> for
       
   282 rendering 1 bit deep images. If this option is not specified
       
   283 or if the image depth is greater than 1 then the image
       
   284 operator is used.</p>
       
   285 </td>
       
   286 <td width="0%">
       
   287 </td>
       
   288 <tr valign="top" align="left">
       
   289 <td width="10%"></td>
       
   290 <td width="3%">
       
   291 
       
   292 <p><b>&minus;o</b></p>
       
   293 </td>
       
   294 <td width="5%"></td>
       
   295 <td width="80%">
       
   296 
       
   297 <p>Set the initial <small>TIFF</small> directory to the
       
   298 <small>IFD</small> at the specified file offset. This option
       
   299 is useful for selecting thumbnail images and the like which
       
   300 are hidden using the SubIFD tag.</p>
       
   301 </td>
       
   302 <td width="0%">
       
   303 </td>
       
   304 <tr valign="top" align="left">
       
   305 <td width="10%"></td>
       
   306 <td width="3%">
       
   307 
       
   308 <p><b>&minus;p</b></p>
       
   309 </td>
       
   310 <td width="5%"></td>
       
   311 <td width="80%">
       
   312 
       
   313 <p>Force the generation of (non-Encapsulated) .</p>
       
   314 </td>
       
   315 <td width="0%">
       
   316 </td>
       
   317 <tr valign="top" align="left">
       
   318 <td width="10%"></td>
       
   319 <td width="3%">
       
   320 
       
   321 <p><b>&minus;r</b></p>
       
   322 </td>
       
   323 <td width="5%"></td>
       
   324 <td width="80%">
       
   325 
       
   326 <p>Rotate image by 180 degrees.</p>
       
   327 </td>
       
   328 <td width="0%">
       
   329 </td>
       
   330 <tr valign="top" align="left">
       
   331 <td width="10%"></td>
       
   332 <td width="3%">
       
   333 
       
   334 <p><b>&minus;s</b></p>
       
   335 </td>
       
   336 <td width="5%"></td>
       
   337 <td width="80%">
       
   338 
       
   339 <p>Generate output for a single IFD (page) in the input
       
   340 file.</p>
       
   341 </td>
       
   342 <td width="0%">
       
   343 </td>
       
   344 <tr valign="top" align="left">
       
   345 <td width="10%"></td>
       
   346 <td width="3%">
       
   347 
       
   348 <p><b>&minus;w</b></p>
       
   349 </td>
       
   350 <td width="5%"></td>
       
   351 <td width="80%">
       
   352 
       
   353 <p>Specify the horizontal size of the printed area (in
       
   354 inches).</p>
       
   355 </td>
       
   356 <td width="0%">
       
   357 </td>
       
   358 <tr valign="top" align="left">
       
   359 <td width="10%"></td>
       
   360 <td width="3%">
       
   361 
       
   362 <p><b>&minus;x</b></p>
       
   363 </td>
       
   364 <td width="5%"></td>
       
   365 <td width="80%">
       
   366 
       
   367 <p>Override resolution units specified in the TIFF as
       
   368 centimeters.</p>
       
   369 </td>
       
   370 <td width="0%">
       
   371 </td>
       
   372 <tr valign="top" align="left">
       
   373 <td width="10%"></td>
       
   374 <td width="3%">
       
   375 
       
   376 <p><b>&minus;y</b></p>
       
   377 </td>
       
   378 <td width="5%"></td>
       
   379 <td width="80%">
       
   380 
       
   381 <p>Override resolution units specified in the TIFF as
       
   382 inches.</p>
       
   383 </td>
       
   384 <td width="0%">
       
   385 </td>
       
   386 <tr valign="top" align="left">
       
   387 <td width="10%"></td>
       
   388 <td width="3%">
       
   389 
       
   390 <p><b>&minus;z</b></p>
       
   391 </td>
       
   392 <td width="5%"></td>
       
   393 <td width="80%">
       
   394 
       
   395 <p>When generating Level 2, data is scaled so that it does
       
   396 not image into the <i>deadzone</i> on a page (the outer
       
   397 margin that the printing device is unable to mark). This
       
   398 option suppresses this behavior. When Level 1 is generated,
       
   399 data is imaged to the entire printed page and this option
       
   400 has no affect.</p>
       
   401 </td>
       
   402 <td width="0%">
       
   403 </td>
       
   404 </table>
       
   405 <a name="EXAMPLES"></a>
       
   406 <h2>EXAMPLES</h2>
       
   407 <!-- INDENTATION -->
       
   408 <table width="100%" border=0 rules="none" frame="void"
       
   409        cols="2" cellspacing="0" cellpadding="0">
       
   410 <tr valign="top" align="left">
       
   411 <td width="8%"></td>
       
   412 <td width="91%">
       
   413 <p>The following generates Level 2 for all pages of a
       
   414 facsimile:</p></td>
       
   415 </table>
       
   416 <!-- INDENTATION -->
       
   417 <table width="100%" border=0 rules="none" frame="void"
       
   418        cols="2" cellspacing="0" cellpadding="0">
       
   419 <tr valign="top" align="left">
       
   420 <td width="17%"></td>
       
   421 <td width="82%">
       
   422 <pre>tiff2ps -a2 fax.tif | lpr
       
   423 </pre>
       
   424 </td>
       
   425 </table>
       
   426 <!-- INDENTATION -->
       
   427 
       
   428 <table width="100%" border=0 rules="none" frame="void"
       
   429        cols="2" cellspacing="0" cellpadding="0">
       
   430 <tr valign="top" align="left">
       
   431 <td width="8%"></td>
       
   432 <td width="91%">
       
   433 <p>Note also that if you have version 2.6.1 or newer of
       
   434 Ghostscript then you can efficiently preview facsimile
       
   435 generated with the above command.</p>
       
   436 <!-- INDENTATION -->
       
   437 <p>To generate Encapsulated for a the image at directory 2
       
   438 of an image use:</p></td>
       
   439 </table>
       
   440 <!-- INDENTATION -->
       
   441 <table width="100%" border=0 rules="none" frame="void"
       
   442        cols="2" cellspacing="0" cellpadding="0">
       
   443 <tr valign="top" align="left">
       
   444 <td width="17%"></td>
       
   445 <td width="82%">
       
   446 <pre>tiff2ps -d 1 foo.tif
       
   447 </pre>
       
   448 </td>
       
   449 </table>
       
   450 <!-- INDENTATION -->
       
   451 
       
   452 <table width="100%" border=0 rules="none" frame="void"
       
   453        cols="2" cellspacing="0" cellpadding="0">
       
   454 <tr valign="top" align="left">
       
   455 <td width="8%"></td>
       
   456 <td width="91%">
       
   457 <p>(notice that directories are numbered starting at
       
   458 zero.)</p>
       
   459 <!-- INDENTATION -->
       
   460 <p>If you have a long image, it may be split in several
       
   461 pages:</p></td>
       
   462 </table>
       
   463 <!-- INDENTATION -->
       
   464 <table width="100%" border=0 rules="none" frame="void"
       
   465        cols="2" cellspacing="0" cellpadding="0">
       
   466 <tr valign="top" align="left">
       
   467 <td width="17%"></td>
       
   468 <td width="82%">
       
   469 <pre>tiff2ps -h11 -w8.5 -H14 -L.5 foo.tif &gt; foo.ps
       
   470 </pre>
       
   471 </td>
       
   472 </table>
       
   473 <!-- INDENTATION -->
       
   474 
       
   475 <table width="100%" border=0 rules="none" frame="void"
       
   476        cols="2" cellspacing="0" cellpadding="0">
       
   477 <tr valign="top" align="left">
       
   478 <td width="8%"></td>
       
   479 <td width="91%">
       
   480 <p>The page size is set to 8.5x11 by <b>&minus;w</b> and
       
   481 <b>&minus;h</b> options. We will accept a small amount of
       
   482 vertical compression, so <b>&minus;H</b> set to 14. Any
       
   483 pages between 11 and 14 inches will be fit onto one page.
       
   484 Pages longer than 14 inches are cut off at 11 and continued
       
   485 on the next page. The <b>&minus;L.5</b> option says to
       
   486 repeat a half inch on the next page (to improve
       
   487 readability).</p>
       
   488 </td>
       
   489 </table>
       
   490 <a name="BUGS"></a>
       
   491 <h2>BUGS</h2>
       
   492 <!-- INDENTATION -->
       
   493 <table width="100%" border=0 rules="none" frame="void"
       
   494        cols="2" cellspacing="0" cellpadding="0">
       
   495 <tr valign="top" align="left">
       
   496 <td width="8%"></td>
       
   497 <td width="91%">
       
   498 <p>Because does not support the notion of a colormap, 8-bit
       
   499 palette images produce 24-bit images. This conversion
       
   500 results in output that is six times bigger than the original
       
   501 image and which takes a long time to send to a printer over
       
   502 a serial line. Matters are even worse for 4-, 2-, and 1-bit
       
   503 palette images.</p>
       
   504 </td>
       
   505 </table>
       
   506 <a name="BUGS"></a>
       
   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>
       
   517 </table>
       
   518 <a name="SEE ALSO"></a>
       
   519 <h2>SEE ALSO</h2>
       
   520 <!-- INDENTATION -->
       
   521 <table width="100%" border=0 rules="none" frame="void"
       
   522        cols="2" cellspacing="0" cellpadding="0">
       
   523 <tr valign="top" align="left">
       
   524 <td width="8%"></td>
       
   525 <td width="91%">
       
   526 <p><b>pal2rgb</b>(1), <b>tiffinfo</b>(1), <b>tiffcp</b>(1),
       
   527 <b>tiffgt</b>(1), <b>tiffmedian</b>(1), <b>tiff2bw</b>(1),
       
   528 <b>tiffsv</b>(1), <b>libtiff</b>(3)</p>
       
   529 <!-- INDENTATION -->
       
   530 <p>Libtiff library home page:
       
   531 <b>http://www.remotesensing.org/libtiff/</b></p>
       
   532 </td>
       
   533 </table>
       
   534 <hr>
       
   535 </body>
       
   536 </html>