]> git.saurik.com Git - wxWidgets.git/blame_incremental - src/tiff/html/man/tiff2ps.1.html
No changes, just get rid of some wxT()s in wxString unit test.
[wxWidgets.git] / src / tiff / html / man / tiff2ps.1.html
... / ...
CommitLineData
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
30PostScript&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
54writes PostScript or Encapsulated PostScript (EPS) on the
55standard output. By default, <i>tiff2ps</i> writes
56Encapsulated 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
60fills a printed area specified by the <small>TIFF</small>
61tags in the input file. If the file does not contain
62<i>XResolution</i> or <i>YResolution</i> tags, then the
63printed area is set according to the image dimensions. The
64<b>&minus;w</b> and <b>&minus;h</b> options (see below) can
65be used to set the dimensions of the printed area in inches;
66overriding any relevant <small>TIFF</small> tags.</p>
67<!-- INDENTATION -->
68<p>The PostScript generated for <small>RGB,</small> palette,
69and <small>CMYK</small> images uses the <i>colorimage</i>
70operator. The PostScript generated for greyscale and bilevel
71images uses the <i>image</i> operator. When the
72<i>colorimage</i> operator is used, PostScript code to
73emulate this operator on older PostScript printers is also
74generated. Note that this emulation code can be very
75slow.</p>
76<!-- INDENTATION -->
77<p>Color images with associated alpha data are composited
78over 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
122use the /flateDecode filter for ZIP compressed TIFF
123images.</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
137file.</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).
151This 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
165an 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
180specified directory number. (NB: Directories are numbered
181starting at zero.) This option is useful for selecting
182individual 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
210inches).</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
224with larger sizes will be split in several pages. Option
225<b>&minus;L</b> may be used for specifying size of split
226images 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
240a single numeric value: zero to disable pixel interpolation
241and 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
255inches). Used in conjunction with <b>&minus;H</b>
256option.</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
270does 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>
284PostScript operator instead of the <i>image</i> operator.
285When this option is specified <i>tiff2ps</i> will use
286<i>imagemask</i> for rendering 1 bit deep images. If this
287option is not specified or if the image depth is greater
288than 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
303is useful for selecting thumbnail images and the like which
304are 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)
318PostScript.</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
345file.</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
359inches).</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
373centimeters.</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
387inches.</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
401that it does not image into the <i>deadzone</i> on a page
402(the outer margin that the printing device is unable to
403mark). This option suppresses this behavior. When PostScript
404Level 1 is generated, data is imaged to the entire printed
405page 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
419of 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
439Ghostscript then you can efficiently preview facsimile
440generated with the above command.</p>
441<!-- INDENTATION -->
442<p>To generate Encapsulated PostScript for a the image at
443directory 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
463zero.)</p>
464<!-- INDENTATION -->
465<p>If you have a long image, it may be split in several
466pages:</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
487vertical compression, so <b>&minus;H</b> set to 14. Any
488pages between 11 and 14 inches will be fit onto one page.
489Pages longer than 14 inches are cut off at 11 and continued
490on the next page. The <b>&minus;L.5</b> option says to
491repeat a half inch on the next page (to improve
492readability).</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
504colormap, 8-bit palette images produce 24-bit PostScript
505images. This conversion results in output that is six times
506bigger than the original image and which takes a long time
507to send to a printer over a serial line. Matters are even
508worse for 4-, 2-, and 1-bit palette images.</p>
509<!-- INDENTATION -->
510<p>Does not handle tiled images when generating PostScript
511Level 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>