~ubuntu-branches/ubuntu/quantal/tiff/quantal

« back to all changes in this revision

Viewing changes to man/tiff2ps.1

  • Committer: Bazaar Package Importer
  • Author(s): Jay Berkenbilt
  • Date: 2009-08-28 15:44:23 UTC
  • mfrom: (1.1.3 upstream)
  • Revision ID: james.westby@ubuntu.com-20090828154423-7oisj77n302jrroa
Tags: 3.9.1-1
New upstream release

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.\" $Id: tiff2ps.1,v 1.9.2.2 2009-08-20 18:40:33 bfriesen Exp $
 
2
.\"
 
3
.\" Copyright (c) 1988-1997 Sam Leffler
 
4
.\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
 
5
.\"
 
6
.\" Permission to use, copy, modify, distribute, and sell this software and 
 
7
.\" its documentation for any purpose is hereby granted without fee, provided
 
8
.\" that (i) the above copyright notices and this permission notice appear in
 
9
.\" all copies of the software and related documentation, and (ii) the names of
 
10
.\" Sam Leffler and Silicon Graphics may not be used in any advertising or
 
11
.\" publicity relating to the software without the specific, prior written
 
12
.\" permission of Sam Leffler and Silicon Graphics.
 
13
.\" 
 
14
.\" THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, 
 
15
.\" EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY 
 
16
.\" WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  
 
17
.\" 
 
18
.\" IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
 
19
.\" ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
 
20
.\" OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
 
21
.\" WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF 
 
22
.\" LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE 
 
23
.\" OF THIS SOFTWARE.
 
24
.\"
 
25
.ds Ps PostScript
 
26
.if n .po 0
 
27
.TH TIFF2PS 1 "November 2, 2005" "libtiff"
 
28
.SH NAME
 
29
tiff2ps \- convert a
 
30
.SM TIFF
 
31
image to \*(Ps\*(Tm
 
32
.SH SYNOPSIS
 
33
.B tiff2ps
 
34
[
 
35
.I options
 
36
]
 
37
.I "input.tif ..."
 
38
.SH DESCRIPTION
 
39
.I tiff2ps
 
40
reads
 
41
.SM TIFF
 
42
images and writes \*(Ps or Encapsulated \*(Ps (EPS)
 
43
on the standard output.
 
44
By default,
 
45
.I tiff2ps
 
46
writes Encapsulated \*(Ps for the first image in the specified
 
47
.SM TIFF
 
48
image file.
 
49
.PP
 
50
By default,
 
51
.I tiff2ps
 
52
will generate \*(Ps that fills a printed area specified
 
53
by the 
 
54
.SM TIFF
 
55
tags in the input file.
 
56
If the file does not contain
 
57
.I XResolution
 
58
or
 
59
.I YResolution
 
60
tags, then the printed area is set according to the image dimensions.
 
61
The
 
62
.B \-w
 
63
and
 
64
.B \-h
 
65
options (see below)
 
66
can be used to set the dimensions of the printed area in inches;
 
67
overriding any relevant
 
68
.SM TIFF
 
69
tags.
 
70
.PP
 
71
The \*(Ps generated for
 
72
.SM RGB,
 
73
palette, and
 
74
.SM CMYK
 
75
images uses the
 
76
.I colorimage
 
77
operator.
 
78
The \*(Ps generated for
 
79
greyscale and bilevel images
 
80
uses the
 
81
.I image
 
82
operator.
 
83
When the
 
84
.I colorimage
 
85
operator is used, \*(Ps code to emulate this operator
 
86
on older \*(Ps printers is also generated.
 
87
Note that this emulation code can be very slow.
 
88
.PP
 
89
Color images with associated alpha data are composited over
 
90
a white background.
 
91
.SH OPTIONS
 
92
.TP
 
93
.B \-1
 
94
Generate \*(Ps Level 1 (the default).
 
95
.TP
 
96
.B \-2
 
97
Generate \*(Ps Level 2.
 
98
.TP
 
99
.B \-3
 
100
Generate \*(Ps Level 3. It basically allows one to use the /flateDecode
 
101
filter for ZIP compressed TIFF images.
 
102
.TP
 
103
.B \-a
 
104
Generate output for all IFDs (pages) in the input file.
 
105
.TP
 
106
.B \-b
 
107
Specify the bottom margin for the output (in inches). This does not affect
 
108
the height of the printed image.
 
109
.TP
 
110
.B \-c
 
111
Center the image in the output. This option only shows an effect if both
 
112
the
 
113
.B \-w
 
114
and the
 
115
.B \-h
 
116
option are given.
 
117
.TP
 
118
.B \-d
 
119
Set the initial
 
120
.SM TIFF
 
121
directory to the specified directory number.
 
122
(NB: Directories are numbered starting at zero.)
 
123
This option is useful for selecting individual pages in a
 
124
multi-page (e.g. facsimile) file.
 
125
.TP
 
126
.B \-e
 
127
Force the generation of Encapsulated \*(Ps (implies
 
128
.BR \-z ).
 
129
.TP
 
130
.B \-h
 
131
Specify the vertical size of the printed area (in inches).
 
132
.TP
 
133
.B \-H
 
134
Specify the maximum height of image (in inches). Images with larger sizes will
 
135
be split in several pages. Option
 
136
.B \-L
 
137
may be used for specifying size of split images overlapping.
 
138
.TP
 
139
.B \-W
 
140
Specify the maximum width of image (in inches). Images with larger sizes will
 
141
be split in several pages. Options
 
142
.B \-L
 
143
and 
 
144
.B \-W
 
145
are mutually exclusive.
 
146
.B \-i
 
147
Enable/disable pixel interpolation.  This option requires a
 
148
single numeric value: zero to disable pixel interpolation and
 
149
non-zero to enable.  The default is enabled.
 
150
.TP
 
151
.B \-L
 
152
Specify the size of overlapping for split images (in inches). Used in
 
153
conjunction with
 
154
.B \-H
 
155
option.
 
156
.TP
 
157
.B \-l
 
158
Specify the left margin for the output (in inches). This does not affect
 
159
the width of the printed image.
 
160
.TP
 
161
.B \-m
 
162
Where possible render using the
 
163
.I imagemask
 
164
\*(Ps operator instead of the
 
165
.I image
 
166
operator.  When this option is specified
 
167
.I tiff2ps
 
168
will use
 
169
.I imagemask
 
170
for rendering 1 bit deep images.  If this option is not specified
 
171
or if the image depth is greater than 1 then the
 
172
.I image
 
173
operator is used.
 
174
.TP
 
175
.B \-o
 
176
Set the initial
 
177
.SM TIFF
 
178
directory to the
 
179
.SM IFD
 
180
at the specified file offset.
 
181
This option is useful for selecting thumbnail images and the
 
182
like which are hidden using the
 
183
.I SubIFD
 
184
tag.
 
185
.TP
 
186
.B \-p
 
187
Force the generation of (non-Encapsulated) \*(Ps.
 
188
.TP
 
189
.B \-r
 
190
Rotate image by 180 degrees.
 
191
.TP
 
192
.B \-s
 
193
Generate output for a single IFD (page) in the input file.
 
194
.TP
 
195
.B \-w
 
196
Specify the horizontal size of the printed area (in inches).
 
197
.TP
 
198
.B \-x
 
199
Override resolution units specified in the TIFF as centimeters.
 
200
.TP
 
201
.B \-y
 
202
Override resolution units specified in the TIFF as inches.
 
203
.TP
 
204
.B \-z
 
205
When generating \*(Ps Level 2, data is scaled so that it does not
 
206
image into the 
 
207
.I deadzone
 
208
on a page (the outer margin that the printing device is unable to mark).
 
209
This option suppresses this behavior.
 
210
When \*(Ps Level 1 is generated, data is imaged to the entire printed
 
211
page and this option has no affect.
 
212
.SH EXAMPLES
 
213
The following generates \*(Ps Level 2 for all pages of a facsimile:
 
214
.RS
 
215
.nf
 
216
tiff2ps \-a2 fax.tif | lpr
 
217
.fi
 
218
.RE
 
219
Note also that if you have version 2.6.1 or newer of Ghostscript then you
 
220
can efficiently preview facsimile generated with the above command.
 
221
.PP
 
222
To generate Encapsulated \*(Ps for a the image at directory 2
 
223
of an image use:
 
224
.RS
 
225
.nf
 
226
tiff2ps \-d 1 foo.tif
 
227
.fi
 
228
.RE
 
229
(Notice that directories are numbered starting at zero.)
 
230
.PP
 
231
If you have a long image, it may be split in several pages:
 
232
.RS
 
233
.nf
 
234
tiff2ps \-h11 \-w8.5 \-H14 \-L.5 foo.tif > foo.ps
 
235
.fi
 
236
.RE
 
237
The page size is set to 8.5x11 by
 
238
.B \-w
 
239
and
 
240
.B \-h
 
241
options. We will accept a small amount of vertical compression, so
 
242
.B \-H
 
243
set to 14. Any pages between 11 and 14 inches will be fit onto one page.
 
244
Pages longer than 14 inches are cut off at 11 and continued on the next
 
245
page. The
 
246
.B \-L.5
 
247
option says to repeat a half inch on the next page (to improve readability).
 
248
.SH BUGS
 
249
Because \*(Ps does not support the notion of a colormap,
 
250
8-bit palette images produce 24-bit \*(Ps images.
 
251
This conversion results in output that is six times
 
252
bigger than the original image and which takes a long time
 
253
to send to a printer over a serial line.
 
254
Matters are even worse for 4-, 2-, and 1-bit palette images.
 
255
.PP
 
256
Does not handle tiled images when generating \*(Ps Level I output.
 
257
.SH "SEE ALSO"
 
258
.BR pal2rgb (1),
 
259
.BR tiffinfo (1),
 
260
.BR tiffcp (1),
 
261
.BR tiffgt (1),
 
262
.BR tiffmedian (1),
 
263
.BR tiff2bw (1),
 
264
.BR tiffsv (1),
 
265
.BR libtiff (3)
 
266
.PP
 
267
Libtiff library home page:
 
268
.BR http://www.remotesensing.org/libtiff/