src/tiff/html/man/tiff2ps.1.html

   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>