← Back to branch summary

~brian-sidebotham/wxwidgets-cmake/wxpython-2.9.4

« back to all changes in this revision

Viewing changes to src/tiff/man/tiff2ps.1

  • Committer: Brian Sidebotham
  • Date: 2013-08-03 14:30:08 UTC
  • Revision ID: brian.sidebotham@gmail.com-20130803143008-c7806tkych1tp6fc
Initial import into Bazaar

Show diffs side-by-side

added added

removed removed

Lines of Context:
src/tiff/man/tiff2ps.1
 
1
.\" $Id: tiff2ps.1,v 1.8 2005/11/02 11:07:19 dron 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
.if n .po 0
 
26
.TH TIFF2PS 1 "November 2, 2005" "libtiff"
 
27
.SH NAME
 
28
tiff2ps \- convert a
 
29
.SM TIFF
 
30
image to \*(Ps\(tm
 
31
.SH SYNOPSIS
 
32
.B tiff2ps
 
33
[
 
34
.I options
 
35
]
 
36
.I "input.tif ..."
 
37
.SH DESCRIPTION
 
38
.I tiff2ps
 
39
reads
 
40
.SM TIFF
 
41
images and writes \*(Ps or Encapsulated \*(Ps (EPS)
 
42
on the standard output.
 
43
By default,
 
44
.I tiff2ps
 
45
writes Encapsulated \*(Ps for the first image in the specified
 
46
.SM TIFF
 
47
image file.
 
48
.PP
 
49
By default,
 
50
.I tiff2ps
 
51
will generate \*(Ps that fills a printed area specified
 
52
by the 
 
53
.SM TIFF
 
54
tags in the input file.
 
55
If the file does not contain
 
56
.I XResolution
 
57
or
 
58
.I YResolution
 
59
tags, then the printed area is set according to the image dimensions.
 
60
The
 
61
.B \-w
 
62
and
 
63
.B \-h
 
64
options (see below)
 
65
can be used to set the dimensions of the printed area in inches;
 
66
overriding any relevant
 
67
.SM TIFF
 
68
tags.
 
69
.PP
 
70
The \*(Ps generated for
 
71
.SM RGB,
 
72
palette, and
 
73
.SM CMYK
 
74
images uses the
 
75
.I colorimage
 
76
operator.
 
77
The \*(Ps generated for
 
78
greyscale and bilevel images
 
79
uses the
 
80
.I image
 
81
operator.
 
82
When the
 
83
.I colorimage
 
84
operator is used, \*(Ps code to emulate this operator
 
85
on older \*(Ps printers is also generated.
 
86
Note that this emulation code can be very slow.
 
87
.PP
 
88
Color images with associated alpha data are composited over
 
89
a white background.
 
90
.SH OPTIONS
 
91
.TP
 
92
.B \-1
 
93
Generate \*(Ps Level 1 (the default).
 
94
.TP
 
95
.B \-2
 
96
Generate \*(Ps Level 2.
 
97
.TP
 
98
.B \-3
 
99
Generate \*(Ps Level 3. It basically allows one to use the /flateDecode
 
100
filter for ZIP compressed TIFF images.
 
101
.TP
 
102
.B \-a
 
103
Generate output for all IFDs (pages) in the input file.
 
104
.TP
 
105
.B \-b
 
106
Specify the bottom margin for the output (in inches). This does not affect
 
107
the height of the printed image.
 
108
.TP
 
109
.B \-c
 
110
Center the image in the output. This option only shows an effect if both
 
111
the -w and the -h option are given.
 
112
.TP
 
113
.B \-d
 
114
Set the initial
 
115
.SM TIFF
 
116
directory to the specified directory number.
 
117
(NB: directories are numbered starting at zero.)
 
118
This option is useful for selecting individual pages in a
 
119
multi-page (e.g. facsimile) file.
 
120
.TP
 
121
.B \-e
 
122
Force the generation of Encapsulated \*(Ps (implies -z).
 
123
.TP
 
124
.B \-h
 
125
Specify the vertical size of the printed area (in inches).
 
126
.TP
 
127
.B \-H
 
128
Specify the maximum height of image (in inches). Images with larger sizes will
 
129
be split in several pages. Option
 
130
.B \-L
 
131
may be used for specifying size of split images overlapping.
 
132
.TP
 
133
.B \-i
 
134
Enable/disable pixel interpolation.  This option requires a
 
135
single numeric value: zero to disable pixel interpolation and
 
136
non-zero to enable.  The default is enabled.
 
137
.TP
 
138
.B \-L
 
139
Specify the size of overlapping for split images (in inches). Used in
 
140
conjunction with
 
141
.B \-H
 
142
option.
 
143
.TP
 
144
.B \-l
 
145
Specify the left margin for the output (in inches). This does not affect
 
146
the width of the printed image.
 
147
.TP
 
148
.B \-m
 
149
Where possible render using the
 
150
.B imagemask
 
151
\*(Ps operator instead of the image operator.  When this option is specified
 
152
.I tiff2ps
 
153
will use
 
154
.B imagemask
 
155
for rendering 1 bit deep images.  If this option is not specified
 
156
or if the image depth is greater than 1 then the image operator
 
157
is used.
 
158
.TP
 
159
.B \-o
 
160
Set the initial
 
161
.SM TIFF
 
162
directory to the
 
163
.SM IFD
 
164
at the specified file offset.
 
165
This option is useful for selecting thumbnail images and the
 
166
like which are hidden using the SubIFD tag.
 
167
.TP
 
168
.B \-p
 
169
Force the generation of (non-Encapsulated) \*(Ps.
 
170
.TP
 
171
.B \-r
 
172
Rotate image by 180 degrees.
 
173
.TP
 
174
.B \-s
 
175
Generate output for a single IFD (page) in the input file.
 
176
.TP
 
177
.B \-w
 
178
Specify the horizontal size of the printed area (in inches).
 
179
.TP
 
180
.B \-x
 
181
Override resolution units specified in the TIFF as centimeters.
 
182
.TP
 
183
.B \-y
 
184
Override resolution units specified in the TIFF as inches.
 
185
.TP
 
186
.B \-z
 
187
When generating \*(Ps Level 2, data is scaled so that it does not
 
188
image into the 
 
189
.I deadzone
 
190
on a page (the outer margin that the printing device is unable to mark).
 
191
This option suppresses this behavior.
 
192
When \*(Ps Level 1 is generated, data is imaged to the entire printed
 
193
page and this option has no affect.
 
194
.SH EXAMPLES
 
195
The following generates \*(Ps Level 2 for all pages of a facsimile:
 
196
.RS
 
197
.nf
 
198
tiff2ps -a2 fax.tif | lpr
 
199
.fi
 
200
.RE
 
201
Note also that if you have version 2.6.1 or newer of Ghostscript then you
 
202
can efficiently preview facsimile generated with the above command.
 
203
.PP
 
204
To generate Encapsulated \*(Ps for a the image at directory 2
 
205
of an image use:
 
206
.RS
 
207
.nf
 
208
tiff2ps -d 1 foo.tif
 
209
.fi
 
210
.RE
 
211
(notice that directories are numbered starting at zero.)
 
212
.PP
 
213
If you have a long image, it may be split in several pages:
 
214
.RS
 
215
.nf
 
216
tiff2ps -h11 -w8.5 -H14 -L.5 foo.tif > foo.ps
 
217
.fi
 
218
.RE
 
219
The page size is set to 8.5x11 by
 
220
.B \-w
 
221
and
 
222
.B \-h
 
223
options. We will accept a small amount of vertical compression, so
 
224
.B \-H
 
225
set to 14. Any pages between 11 and 14 inches will be fit onto one page.
 
226
Pages longer than 14 inches are cut off at 11 and continued on the next
 
227
page. The
 
228
.B \-L.5
 
229
option says to repeat a half inch on the next page (to improve readability).
 
230
.SH BUGS
 
231
Because \*(Ps does not support the notion of a colormap,
 
232
8-bit palette images produce 24-bit \*(Ps images.
 
233
This conversion results in output that is six times
 
234
bigger than the original image and which takes a long time
 
235
to send to a printer over a serial line.
 
236
Matters are even worse for 4-, 2-, and 1-bit palette images.
 
237
.SH BUGS
 
238
Does not handle tiled images when generating PS Level I output.
 
239
.SH "SEE ALSO"
 
240
.BR pal2rgb (1),
 
241
.BR tiffinfo (1),
 
242
.BR tiffcp (1),
 
243
.BR tiffgt (1),
 
244
.BR tiffmedian (1),
 
245
.BR tiff2bw (1),
 
246
.BR tiffsv (1),
 
247
.BR libtiff (3)
 
248
.PP
 
249
Libtiff library home page:
 
250
.BR http://www.remotesensing.org/libtiff/