xref: /libtiff-4.0.7/html/man/tiff2ps.1.html (revision e49fae91)
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
2<HTML><HEAD><TITLE>Manpage of TIFF2PS</TITLE>
3</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
4<H1>TIFF2PS</H1>
5Section: User Commands  (1)<BR>Updated: January 27, 1997<BR><A HREF="#index">Index</A>
6<BR><A HREF="index.html">Return to Main Contents</A>
7<HR>
8
9<A NAME="lbAB">&nbsp;</A>
10<H2>NAME</H2>
11
12tiff2ps - convert a
13<FONT SIZE="-1">TIFF</FONT>
14image to P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT>tm
15<A NAME="lbAC">&nbsp;</A>
16<H2>SYNOPSIS</H2>
17
18<B>tiff2ps</B>
19
20[
21<I>options</I>
22
23]
24<I>input.tif ...</I>
25
26<A NAME="lbAD">&nbsp;</A>
27<H2>DESCRIPTION</H2>
28
29<I>tiff2ps</I>
30
31reads
32<FONT SIZE="-1">TIFF</FONT>
33images and writes P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> or Encapsulated P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> (EPS)
34on the standard output.
35By default,
36<I>tiff2ps</I>
37
38writes Encapsulated P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> for the first image in the specified
39<FONT SIZE="-1">TIFF</FONT>
40image file.
41<P>
42
43By default,
44<I>tiff2ps</I>
45
46will generate P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> that fills a printed area specified
47by the
48<FONT SIZE="-1">TIFF</FONT>
49tags in the input file.
50If the file does not contain
51<I>XResolution</I>
52
53or
54<I>YResolution</I>
55
56tags, then the printed area is set according to the image dimensions.
57The
58<B>-w</B>
59
60and
61<B>-h</B>
62
63options (see below)
64can be used to set the dimensions of the printed area in inches;
65overriding any relevant
66<FONT SIZE="-1">TIFF</FONT>
67tags.
68<P>
69
70The P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> generated for
71<FONT SIZE="-1">RGB,</FONT>
72palette, and
73<FONT SIZE="-1">CMYK</FONT>
74images uses the
75<I>colorimage</I>
76
77operator.
78The P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> generated for
79greyscale and bilevel images
80uses the
81<I>image</I>
82
83operator.
84When the
85<I>colorimage</I>
86
87operator is used, P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> code to emulate this operator
88on older P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> printers is also generated.
89Note that this emulation code can be very slow.
90<P>
91
92Color images with associated alpha data are composited over
93a white background.
94<A NAME="lbAE">&nbsp;</A>
95<H2>OPTIONS</H2>
96
97<DL COMPACT>
98<DT><B>-1</B>
99
100<DD>
101Generate P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> Level I (the default).
102<DT><B>-2</B>
103
104<DD>
105Generate P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> Level II.
106<DT><B>-a</B>
107
108<DD>
109Generate output for all IFDs (pages) in the input file.
110<DT><B>-d</B>
111
112<DD>
113Set the initial
114<FONT SIZE="-1">TIFF</FONT>
115directory to the specified directory number.
116(NB: directories are numbered starting at zero.)
117This option is useful for selecting individual pages in a
118multi-page (e.g. facsimile) file.
119<DT><B>-e</B>
120
121<DD>
122Force the generation of Encapsulated P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT>.
123<DT><B>-h</B>
124
125<DD>
126Specify the vertical size of the printed area (in inches).
127<DT><B>-o</B>
128
129<DD>
130Set the initial
131<FONT SIZE="-1">TIFF</FONT>
132directory to the
133<FONT SIZE="-1">IFD</FONT>
134at the specified file offset.
135This option is useful for selecting thumbnail images and the
136like which are hidden using the SubIFD tag.
137<DT><B>-p</B>
138
139<DD>
140Force the generation of (non-Encapsulated) P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT>.
141<DT><B>-s</B>
142
143<DD>
144Generate output for a single IFD (page) in the input file.
145<DT><B>-w</B>
146
147<DD>
148Specify the horizontal size of the printed area (in inches).
149<DT><B>-z</B>
150
151<DD>
152When generating P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> Level II, data is scaled so that it does not
153image into the
154<I>deadzone</I>
155
156on a page (the outer margin that the printing device is unable to mark).
157This option suppresses this behaviour.
158When P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> Level I is generated, data is imaged to the entire printed
159page and this option has no affect.
160</DL>
161<A NAME="lbAF">&nbsp;</A>
162<H2>EXAMPLES</H2>
163
164The following generates P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> Level II for all pages of a facsimile:
165<DL COMPACT><DT><DD>
166<PRE>
167tiff2ps -a2 fax.tif | lpr
168</PRE>
169
170</DL>
171
172Note also that if you have version 2.6.1 or newer of Ghostscript then you
173can efficiently preview facsimile generated with the above command.
174<P>
175
176To generate Encapsulated P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> for a the image at directory 2
177of an image use:
178<DL COMPACT><DT><DD>
179<PRE>
180tiff2ps -d 1 foo.tif
181</PRE>
182
183</DL>
184
185(notice that directories are numbered starting at zero.)
186<A NAME="lbAG">&nbsp;</A>
187<H2>BUGS</H2>
188
189Because P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> does not support the notion of a colormap,
1908-bit palette images produce 24-bit P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> images.
191This conversion results in output that is six times
192bigger than the original image and which takes a long time
193to send to a printer over a serial line.
194Matters are even worse for 4-, 2-, and 1-bit palette images.
195<A NAME="lbAH">&nbsp;</A>
196<H2>BUGS</H2>
197
198Does not handle tiled images when generating PS Level I output.
199<A NAME="lbAI">&nbsp;</A>
200<H2>SEE ALSO</H2>
201
202<I><A HREF="pal2rgb+1.html">pal2rgb</A></I>(1),
203
204<I><A HREF="tiffinfo+1.html">tiffinfo</A></I>(1),
205
206<I><A HREF="tiffcp+1.html">tiffcp</A></I>(1),
207
208<I><A HREF="tiffgt+1.html">tiffgt</A></I>(1),
209
210<I><A HREF="tiffmedian+1.html">tiffmedian</A></I>(1),
211
212<I><A HREF="tiff2bw+1.html">tiff2bw</A></I>(1),
213
214<I><A HREF="tiffsv+1.html">tiffsv</A></I>(1),
215
216<I><A HREF="libtiff+3">libtiff</A></I>(3)
217
218
219<HR>
220<A NAME="index">&nbsp;</A><H2>Index</H2>
221<DL>
222<DT><A HREF="#lbAB">NAME</A><DD>
223<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
224<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
225<DT><A HREF="#lbAE">OPTIONS</A><DD>
226<DT><A HREF="#lbAF">EXAMPLES</A><DD>
227<DT><A HREF="#lbAG">BUGS</A><DD>
228<DT><A HREF="#lbAH">BUGS</A><DD>
229<DT><A HREF="#lbAI">SEE ALSO</A><DD>
230</DL>
231<HR>
232This document was created by
233<A HREF="index.html">man2html</A>,
234using the manual pages.<BR>
235Time: 01:31:47 GMT, November 23, 1999
236</BODY>
237</HTML>
238