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

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