tiff2ps.1.html 15 KB

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