]> git.saurik.com Git - wxWidgets.git/blame_incremental - src/tiff/html/man/tiff2pdf.1.html
fix bug with adding entries to a root group containing only subgroups (as shown by...
[wxWidgets.git] / src / tiff / html / man / tiff2pdf.1.html
... / ...
CommitLineData
1<!-- Creator : groff version 1.18.1 -->
2<!-- CreationDate: Mon Mar 13 18:03:12 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>TIFF2PDF</title>
8</head>
9<body>
10
11<h1 align=center>TIFF2PDF</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="10%"></td>
28<td width="89%">
29<p>tiff2pdf - convert a TIFF image to a PDF document</p>
30</td>
31</table>
32<a name="SYNOPSIS"></a>
33<h2>SYNOPSIS</h2>
34<!-- INDENTATION -->
35<table width="100%" border=0 rules="none" frame="void"
36 cols="2" cellspacing="0" cellpadding="0">
37<tr valign="top" align="left">
38<td width="10%"></td>
39<td width="89%">
40<p><b>tiff2pdf [</b> <i>options</i> <b>]</b>
41<i>input.tiff</i></p>
42</td>
43</table>
44<a name="DESCRIPTION"></a>
45<h2>DESCRIPTION</h2>
46<!-- INDENTATION -->
47<table width="100%" border=0 rules="none" frame="void"
48 cols="2" cellspacing="0" cellpadding="0">
49<tr valign="top" align="left">
50<td width="10%"></td>
51<td width="89%">
52<p><b>tiff2pdf</b> opens a TIFF image and writes a PDF
53document to standard output.</p>
54<!-- INDENTATION -->
55<p>The program converts one TIFF file to one PDF file,
56including multiple page TIFF files, tiled TIFF files, black
57and white. grayscale, and color TIFF files that contain data
58of TIFF photometric interpretations of bilevel, grayscale,
59RGB, YCbCr, CMYK separation, and ICC L*a*b* as supported by
60<i>libtiff</i> and PDF.</p>
61<!-- INDENTATION -->
62<p>If you have multiple TIFF files to convert into one PDF
63file then use <i>tiffcp</i> or other program to concatenate
64the files into a multiple page TIFF file. If the input TIFF
65file is of huge dimensions (greater than 10000 pixels height
66or width) convert the input image to a tiled TIFF if it is
67not already.</p>
68<!-- INDENTATION -->
69<p>The standard output is standard output. Set the output
70file name with the <b>-o</b><i>output.pdf</i> option.</p>
71<!-- INDENTATION -->
72<p>All black and white files are compressed into a single
73strip CCITT G4 Fax compressed PDF, unless tiled, where tiled
74black and white images are compressed into tiled CCITT G4
75Fax compressed PDF, <i>libtiff</i> CCITT support is
76assumed.</p>
77<!-- INDENTATION -->
78<p>Color and grayscale data can be compressed using either
79JPEG compression, ITU-T T.81, or Zip/Deflate LZ77
80compression. Set the compression type using the
81<b>&minus;j</b> or <b>&minus;z</b> options. JPEG compression
82support requires that <i>libtiff</i> be configured with JPEG
83support, and Zip/Deflate compression support requires that
84<i>libtiff</i> be configured with Zip support, in
85tiffconf.h. Use only one or the other of <b>&minus;j</b> and
86<b>&minus;z.</b></p>
87<!-- INDENTATION -->
88<p>If the input TIFF contains single strip CCITT G4 Fax
89compressed information, then that is written to the PDF file
90without transcoding, unless the options of no compression
91and no passthrough are set, <b>&minus;d</b> and
92<b>&minus;n.</b></p>
93<!-- INDENTATION -->
94<p>If the input TIFF contains JPEG or single strip
95Zip/Deflate compressed information, and they are configured,
96then that is written to the PDF file without transcoding,
97unless the options of no compression and no passthrough are
98set.</p>
99<!-- INDENTATION -->
100<p>The default page size upon which the TIFF image is placed
101is determined by the resolution and extent of the image
102data. Default values for the TIFF image resolution can be
103set using the <b>&minus;x</b> and <b>&minus;y</b> options.
104The page size can be set using the <b>&minus;p</b> option
105for paper size, or <b>&minus;w</b> and <b>&minus;l</b> for
106paper width and length, then each page of the TIFF image is
107centered on its page. The distance unit for default
108resolution and page width and length can be set by the
109<b>&minus;u</b> option, the default unit is inch.</p>
110<!-- INDENTATION -->
111<p>Various items of the output document information can be
112set with the <b>&minus;e, &minus;c, &minus;a, &minus;t,
113&minus;s,</b> and <b>&minus;k</b> options. Setting the
114argument of the option to &quot;&quot; for these tags causes
115the relevant document information field to be not written.
116Some of the document information values otherwise get their
117information from the input TIFF image, the software, author,
118document name, and image description.</p>
119<!-- INDENTATION -->
120<p>The Portable Document Format (PDF) specification is
121copyrighted by Adobe Systems, Incorporated.</p>
122</td>
123</table>
124<a name="OPTIONS"></a>
125<h2>OPTIONS</h2>
126<!-- INDENTATION -->
127<table width="100%" border=0 rules="none" frame="void"
128 cols="2" cellspacing="0" cellpadding="0">
129<tr valign="top" align="left">
130<td width="10%"></td>
131<td width="89%">
132<p><b>&minus;o</b><i>output-file</i></p></td>
133</table>
134<!-- INDENTATION -->
135<table width="100%" border=0 rules="none" frame="void"
136 cols="2" cellspacing="0" cellpadding="0">
137<tr valign="top" align="left">
138<td width="21%"></td>
139<td width="77%">
140<p>Set the output to go to file <i>output-file</i></p>
141</td>
142</table>
143<!-- TABS -->
144<table width="100%" border=0 rules="none" frame="void"
145 cols="4" cellspacing="0" cellpadding="0">
146<tr valign="top" align="left">
147<td width="11%"></td>
148<td width="4%">
149
150<p><b>&minus;j</b></p>
151</td>
152<td width="5%"></td>
153<td width="77%">
154
155<p>Compress with JPEG (requires libjpeg configured with
156libtiff).</p>
157</td>
158<tr valign="top" align="left">
159<td width="11%"></td>
160<td width="4%">
161
162<p><b>&minus;z</b></p>
163</td>
164<td width="5%"></td>
165<td width="77%">
166
167<p>Compress with Zip/Deflate (requires zlib configured with
168libtiff).</p>
169</td>
170</table>
171<!-- INDENTATION -->
172<table width="100%" border=0 rules="none" frame="void"
173 cols="2" cellspacing="0" cellpadding="0">
174<tr valign="top" align="left">
175<td width="10%"></td>
176<td width="89%">
177<p><b>&minus;q</b><i>quality</i></p></td>
178</table>
179<!-- INDENTATION -->
180<table width="100%" border=0 rules="none" frame="void"
181 cols="2" cellspacing="0" cellpadding="0">
182<tr valign="top" align="left">
183<td width="21%"></td>
184<td width="77%">
185<p>Set the compression quality, 1-100 for JPEG.</p>
186</td>
187</table>
188<!-- TABS -->
189<table width="100%" border=0 rules="none" frame="void"
190 cols="4" cellspacing="0" cellpadding="0">
191<tr valign="top" align="left">
192<td width="11%"></td>
193<td width="2%">
194
195<p><b>&minus;n</b></p>
196</td>
197<td width="7%"></td>
198<td width="77%">
199
200<p>Do not allow data to be converted without uncompressing,
201no compressed data passthrough.</p>
202</td>
203<tr valign="top" align="left">
204<td width="11%"></td>
205<td width="2%">
206
207<p><b>&minus;b</b></p>
208</td>
209<td width="7%"></td>
210<td width="77%">
211
212<p>Set PDF &quot;Interpolate&quot; user preference.</p>
213</td>
214<tr valign="top" align="left">
215<td width="11%"></td>
216<td width="2%">
217
218<p><b>&minus;d</b></p>
219</td>
220<td width="7%"></td>
221<td width="77%">
222
223<p>Do not compress (decompress).</p>
224</td>
225<tr valign="top" align="left">
226<td width="11%"></td>
227<td width="2%">
228
229<p><b>&minus;i</b></p>
230</td>
231<td width="7%"></td>
232<td width="77%">
233
234<p>Invert colors.</p>
235</td>
236</table>
237<!-- INDENTATION -->
238<table width="100%" border=0 rules="none" frame="void"
239 cols="2" cellspacing="0" cellpadding="0">
240<tr valign="top" align="left">
241<td width="10%"></td>
242<td width="89%">
243<p><b>&minus;p</b><i>paper-size</i></p></td>
244</table>
245<!-- INDENTATION -->
246<table width="100%" border=0 rules="none" frame="void"
247 cols="2" cellspacing="0" cellpadding="0">
248<tr valign="top" align="left">
249<td width="21%"></td>
250<td width="77%">
251<p>Set paper size, eg &quot;letter&quot;, &quot;legal&quot;,
252&quot;A4&quot;.</p>
253</td>
254</table>
255<!-- INDENTATION -->
256<table width="100%" border=0 rules="none" frame="void"
257 cols="2" cellspacing="0" cellpadding="0">
258<tr valign="top" align="left">
259<td width="10%"></td>
260<td width="89%">
261<p><b>&minus;u</b><i>[i|m]</i></p></td>
262</table>
263<!-- INDENTATION -->
264<table width="100%" border=0 rules="none" frame="void"
265 cols="2" cellspacing="0" cellpadding="0">
266<tr valign="top" align="left">
267<td width="21%"></td>
268<td width="77%">
269<p>Set distance unit, <i>i</i> for inch, <i>m</i> for
270centimeter.</p>
271</td>
272</table>
273<!-- INDENTATION -->
274<table width="100%" border=0 rules="none" frame="void"
275 cols="2" cellspacing="0" cellpadding="0">
276<tr valign="top" align="left">
277<td width="10%"></td>
278<td width="89%">
279<p><b>&minus;w</b><i>width</i></p></td>
280</table>
281<!-- INDENTATION -->
282<table width="100%" border=0 rules="none" frame="void"
283 cols="2" cellspacing="0" cellpadding="0">
284<tr valign="top" align="left">
285<td width="21%"></td>
286<td width="77%">
287<p>Set width in units.</p>
288</td>
289</table>
290<!-- INDENTATION -->
291<table width="100%" border=0 rules="none" frame="void"
292 cols="2" cellspacing="0" cellpadding="0">
293<tr valign="top" align="left">
294<td width="10%"></td>
295<td width="89%">
296<p><b>&minus;l</b><i>length</i></p></td>
297</table>
298<!-- INDENTATION -->
299<table width="100%" border=0 rules="none" frame="void"
300 cols="2" cellspacing="0" cellpadding="0">
301<tr valign="top" align="left">
302<td width="21%"></td>
303<td width="77%">
304<p>Set length in units.</p>
305</td>
306</table>
307<!-- TABS -->
308<table width="100%" border=0 rules="none" frame="void"
309 cols="5" cellspacing="0" cellpadding="0">
310<tr valign="top" align="left">
311<td width="11%"></td>
312<td width="8%">
313
314<p><b>&minus;x</b><i>xres</i></p>
315</td>
316<td width="13%"></td>
317<td width="47%">
318
319<p>Set x/width resolution default.</p>
320</td>
321<td width="19%">
322</td>
323<tr valign="top" align="left">
324<td width="11%"></td>
325<td width="8%">
326
327<p><b>&minus;y</b><i>yres</i></p>
328</td>
329<td width="13%"></td>
330<td width="47%">
331
332<p>Set y/length resolution default.</p>
333</td>
334<td width="19%">
335</td>
336</table>
337<!-- INDENTATION -->
338<table width="100%" border=0 rules="none" frame="void"
339 cols="2" cellspacing="0" cellpadding="0">
340<tr valign="top" align="left">
341<td width="10%"></td>
342<td width="89%">
343<p><b>&minus;r</b><i>[d|o]</i></p></td>
344</table>
345<!-- INDENTATION -->
346<table width="100%" border=0 rules="none" frame="void"
347 cols="2" cellspacing="0" cellpadding="0">
348<tr valign="top" align="left">
349<td width="21%"></td>
350<td width="77%">
351<p>Set <i>d</i> for resolution default for images without
352resolution, <i>o for resolution override for all
353images.</i></p>
354</td>
355</table>
356<!-- TABS -->
357<table width="100%" border=0 rules="none" frame="void"
358 cols="5" cellspacing="0" cellpadding="0">
359<tr valign="top" align="left">
360<td width="11%"></td>
361<td width="2%">
362
363<p><b>&minus;f</b></p>
364</td>
365<td width="13%"></td>
366<td width="54%">
367
368<p>Set PDF &quot;Fit Window&quot; user preference.</p>
369</td>
370<td width="17%">
371</td>
372</table>
373<!-- INDENTATION -->
374<table width="100%" border=0 rules="none" frame="void"
375 cols="2" cellspacing="0" cellpadding="0">
376<tr valign="top" align="left">
377<td width="10%"></td>
378<td width="89%">
379<p><b>&minus;e</b><i>YYYYMMDDHHMMSS</i></p></td>
380</table>
381<!-- INDENTATION -->
382<table width="100%" border=0 rules="none" frame="void"
383 cols="2" cellspacing="0" cellpadding="0">
384<tr valign="top" align="left">
385<td width="21%"></td>
386<td width="77%">
387<p>Set document information date, overrides image or current
388date/time default, <i>YYYYMMDDHHMMSS.</i></p>
389</td>
390</table>
391<!-- INDENTATION -->
392<table width="100%" border=0 rules="none" frame="void"
393 cols="2" cellspacing="0" cellpadding="0">
394<tr valign="top" align="left">
395<td width="10%"></td>
396<td width="89%">
397<p><b>&minus;c</b><i>creator</i></p></td>
398</table>
399<!-- INDENTATION -->
400<table width="100%" border=0 rules="none" frame="void"
401 cols="2" cellspacing="0" cellpadding="0">
402<tr valign="top" align="left">
403<td width="21%"></td>
404<td width="77%">
405<p>Set document information creator, overrides image
406software default.</p>
407</td>
408</table>
409<!-- INDENTATION -->
410<table width="100%" border=0 rules="none" frame="void"
411 cols="2" cellspacing="0" cellpadding="0">
412<tr valign="top" align="left">
413<td width="10%"></td>
414<td width="89%">
415<p><b>&minus;a</b><i>author</i></p></td>
416</table>
417<!-- INDENTATION -->
418<table width="100%" border=0 rules="none" frame="void"
419 cols="2" cellspacing="0" cellpadding="0">
420<tr valign="top" align="left">
421<td width="21%"></td>
422<td width="77%">
423<p>Set document information author, overrides image artist
424default</p>
425</td>
426</table>
427<!-- INDENTATION -->
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="10%"></td>
432<td width="89%">
433<p><b>&minus;t</b><i>title</i></p></td>
434</table>
435<!-- INDENTATION -->
436<table width="100%" border=0 rules="none" frame="void"
437 cols="2" cellspacing="0" cellpadding="0">
438<tr valign="top" align="left">
439<td width="21%"></td>
440<td width="77%">
441<p>Set document information title, overrides image document
442name default</p>
443</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="10%"></td>
450<td width="89%">
451<p><b>&minus;s</b><i>subject</i></p></td>
452</table>
453<!-- INDENTATION -->
454<table width="100%" border=0 rules="none" frame="void"
455 cols="2" cellspacing="0" cellpadding="0">
456<tr valign="top" align="left">
457<td width="21%"></td>
458<td width="77%">
459<p>Set document information subject, overrides image image
460description default</p>
461</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="10%"></td>
468<td width="89%">
469<p><b>&minus;k</b><i>keywords</i></p></td>
470</table>
471<!-- INDENTATION -->
472<table width="100%" border=0 rules="none" frame="void"
473 cols="2" cellspacing="0" cellpadding="0">
474<tr valign="top" align="left">
475<td width="21%"></td>
476<td width="77%">
477<p>Set document information keywords.</p>
478</td>
479</table>
480<!-- TABS -->
481<table width="100%" border=0 rules="none" frame="void"
482 cols="5" cellspacing="0" cellpadding="0">
483<tr valign="top" align="left">
484<td width="11%"></td>
485<td width="2%">
486
487<p><b>&minus;h</b></p>
488</td>
489<td width="13%"></td>
490<td width="57%">
491
492<p>List usage reminder to stderr and exit.</p>
493</td>
494<td width="14%">
495</td>
496<tr valign="top" align="left">
497<td width="11%"></td>
498<td width="2%">
499</td>
500<td width="13%"></td>
501<td width="57%">
502<a name="EXAMPLES"></a>
503<h2>EXAMPLES</h2>
504<!-- INDENTATION -->
505<table width="100%" border=0 rules="none" frame="void"
506 cols="2" cellspacing="0" cellpadding="0">
507<tr valign="top" align="left">
508<td width="10%"></td>
509<td width="89%">
510<p>The following example would generate the file output.pdf
511from input.tiff.</p></td>
512</table>
513<!-- INDENTATION -->
514<table width="100%" border=0 rules="none" frame="void"
515 cols="2" cellspacing="0" cellpadding="0">
516<tr valign="top" align="left">
517<td width="20%"></td>
518<td width="79%">
519<p>tiff2pdf -o output.pdf input.tiff</p></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="10%"></td>
526<td width="89%">
527<p>The following example would generate PDF output from
528input.tiff and write it to standard output.</p>
529</td>
530</table>
531<!-- INDENTATION -->
532<table width="100%" border=0 rules="none" frame="void"
533 cols="2" cellspacing="0" cellpadding="0">
534<tr valign="top" align="left">
535<td width="20%"></td>
536<td width="79%">
537<p>tiff2pdf input.tiff</p></td>
538</table>
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="10%"></td>
544<td width="89%">
545<p>The following example would generate the file output.pdf
546from input.tiff, putting the image pages on a letter sized
547page, compressing the output with JPEG, with JPEG quality
54875, setting the title to &quot;Document&quot;, and setting
549the &quot;Fit Window&quot; option.</p>
550</td>
551</table>
552<!-- INDENTATION -->
553<table width="100%" border=0 rules="none" frame="void"
554 cols="2" cellspacing="0" cellpadding="0">
555<tr valign="top" align="left">
556<td width="20%"></td>
557<td width="79%">
558<p>tiff2pdf -p letter -j -q 75 -t &quot;Document&quot; -f -o
559output.pdf input.tiff</p></td>
560</table>
561<a name="BUGS"></a>
562<h2>BUGS</h2>
563<!-- INDENTATION -->
564<table width="100%" border=0 rules="none" frame="void"
565 cols="2" cellspacing="0" cellpadding="0">
566<tr valign="top" align="left">
567<td width="10%"></td>
568<td width="89%">
569<p>Please report bugs via the web interface at</p>
570</td>
571</table>
572<!-- INDENTATION -->
573<table width="100%" border=0 rules="none" frame="void"
574 cols="2" cellspacing="0" cellpadding="0">
575<tr valign="top" align="left">
576<td width="20%"></td>
577<td width="79%">
578
579<p>http://bugzilla.remotesensing.org/enter_bug.cgi?product=libtiff</p>
580</td>
581</table>
582<a name="SEE ALSO"></a>
583<h2>SEE ALSO</h2>
584<!-- INDENTATION -->
585<table width="100%" border=0 rules="none" frame="void"
586 cols="2" cellspacing="0" cellpadding="0">
587<tr valign="top" align="left">
588<td width="10%"></td>
589<td width="89%">
590<p><b>libtiff</b>(3)<b>, tiffcp</b>(1)<b>,
591tiff2ps</b>(1)</p>
592<!-- INDENTATION -->
593<p>Libtiff library home page:
594<b>http://www.remotesensing.org/libtiff/</b></p>
595</td>
596</table>
597<hr>
598</body>
599</html>