← Back to branch summary

~ubuntu-branches/ubuntu/wily/luatex/wily

« back to all changes in this revision

Viewing changes to source/libs/xpdf/xpdf-3.02/doc/pdftops.1

  • Committer: Bazaar Package Importer
  • Author(s): Norbert Preining
  • Date: 2010-04-29 00:47:19 UTC
  • mfrom: (1.1.10 upstream)
  • Revision ID: james.westby@ubuntu.com-20100429004719-o42etkqe90n97b9e
Tags: 0.60.1-1
* new upstream release, adapt build-script patch
* disable patch: upstream-epstopdf_cc_no_xpdf_patching, included upstream
* disable patch: libpoppler-0.12, not needed anymore

Show diffs side-by-side

added added

removed removed

Lines of Context:
source/libs/xpdf/xpdf-3.02/doc/pdftops.1
 
1
.\" Copyright 1996-2007 Glyph & Cog, LLC
 
2
.TH pdftops 1 "27 February 2007"
 
3
.SH NAME
 
4
pdftops \- Portable Document Format (PDF) to PostScript converter
 
5
(version 3.02)
 
6
.SH SYNOPSIS
 
7
.B pdftops
 
8
[options]
 
9
.RI [ PDF-file
 
10
.RI [ PS-file ]]
 
11
.SH DESCRIPTION
 
12
.B Pdftops
 
13
converts Portable Document Format (PDF) files to PostScript so they
 
14
can be printed.
 
15
.PP
 
16
Pdftops reads the PDF file,
 
17
.IR PDF-file ,
 
18
and writes a PostScript file,
 
19
.IR PS-file .
 
20
If
 
21
.I PS-file
 
22
is not specified, pdftops converts
 
23
.I file.pdf
 
24
to
 
25
.I file.ps
 
26
(or
 
27
.I file.eps
 
28
with the -eps option).  If 
 
29
.I PS-file
 
30
is \'-', the PostScript is sent to stdout.
 
31
.SH CONFIGURATION FILE
 
32
Pdftops reads a configuration file at startup.  It first tries to find
 
33
the user's private config file, ~/.xpdfrc.  If that doesn't exist, it
 
34
looks for a system-wide config file, typically /usr/local/etc/xpdfrc
 
35
(but this location can be changed when pdftops is built).  See the
 
36
.BR xpdfrc (5)
 
37
man page for details.
 
38
.SH OPTIONS
 
39
Many of the following options can be set with configuration file
 
40
commands.  These are listed in square brackets with the description of
 
41
the corresponding command line option.
 
42
.TP
 
43
.BI \-f " number"
 
44
Specifies the first page to print.
 
45
.TP
 
46
.BI \-l " number"
 
47
Specifies the last page to print.
 
48
.TP
 
49
.B \-level1
 
50
Generate Level 1 PostScript.  The resulting PostScript files will be
 
51
significantly larger (if they contain images), but will print on Level
 
52
1 printers.  This also converts all images to black and white.  No
 
53
more than one of the PostScript level options (-level1, -level1sep,
 
54
-level2, -level2sep, -level3, -level3Sep) may be given.
 
55
.RB "[config file: " psLevel ]
 
56
.TP
 
57
.B \-level1sep
 
58
Generate Level 1 separable PostScript.  All colors are converted to
 
59
CMYK.  Images are written with separate stream data for the four
 
60
components.
 
61
.RB "[config file: " psLevel ]
 
62
.TP
 
63
.B \-level2
 
64
Generate Level 2 PostScript.  Level 2 supports color images and image
 
65
compression.  This is the default setting.
 
66
.RB "[config file: " psLevel ]
 
67
.TP
 
68
.B \-level2sep
 
69
Generate Level 2 separable PostScript.  All colors are converted to
 
70
CMYK.  The PostScript separation convention operators are used to
 
71
handle custom (spot) colors.
 
72
.RB "[config file: " psLevel ]
 
73
.TP
 
74
.B \-level3
 
75
Generate Level 3 PostScript.  This enables all Level 2 features plus
 
76
CID font embedding and masked image generation.
 
77
.RB "[config file: " psLevel ]
 
78
.TP
 
79
.B \-level3Sep
 
80
Generate Level 3 separable PostScript.  The separation handling is the
 
81
same as for -level2Sep.
 
82
.RB "[config file: " psLevel ]
 
83
.TP
 
84
.B \-eps
 
85
Generate an Encapsulated PostScript (EPS) file.  An EPS file contains
 
86
a single image, so if you use this option with a multi-page PDF file,
 
87
you must use -f and -l to specify a single page.  No more than one of
 
88
the mode options (-eps, -form) may be given.
 
89
.TP
 
90
.B \-form
 
91
Generate a PostScript form which can be imported by software that
 
92
understands forms.  A form contains a single page, so if you use this
 
93
option with a multi-page PDF file, you must use -f and -l to specify a
 
94
single page.  The -level1 option cannot be used with -form.
 
95
.TP
 
96
.B \-opi
 
97
Generate OPI comments for all images and forms which have OPI
 
98
information.  (This option is only available if pdftops was compiled
 
99
with OPI support.)
 
100
.RB "[config file: " psOPI ]
 
101
.TP
 
102
.B \-noembt1
 
103
By default, any Type 1 fonts which are embedded in the PDF file are
 
104
copied into the PostScript file.  This option causes pdftops to
 
105
substitute base fonts instead.  Embedded fonts make PostScript files
 
106
larger, but may be necessary for readable output.
 
107
.RB "[config file: " psEmbedType1Fonts ]
 
108
.TP
 
109
.B \-noembtt
 
110
By default, any TrueType fonts which are embedded in the PDF file are
 
111
copied into the PostScript file.  This option causes pdftops to
 
112
substitute base fonts instead.  Embedded fonts make PostScript files
 
113
larger, but may be necessary for readable output.  Also, some
 
114
PostScript interpreters do not have TrueType rasterizers.
 
115
.RB "[config file: " psEmbedTrueTypeFonts ]
 
116
.TP
 
117
.B \-noembcidps
 
118
By default, any CID PostScript fonts which are embedded in the PDF
 
119
file are copied into the PostScript file.  This option disables that
 
120
embedding.  No attempt is made to substitute for non-embedded CID
 
121
PostScript fonts.
 
122
.RB "[config file: " psEmbedCIDPostScriptFonts ]
 
123
.TP
 
124
.B \-noembcidtt
 
125
By default, any CID TrueType fonts which are embedded in the PDF file
 
126
are copied into the PostScript file.  This option disables that
 
127
embedding.  No attempt is made to substitute for non-embedded CID
 
128
TrueType fonts.
 
129
.RB "[config file: " psEmbedCIDTrueTypeFonts ]
 
130
.TP
 
131
.B \-preload
 
132
Convert PDF forms to PS procedures, and preload image data.  This uses
 
133
more memory in the PostScript interpreter, but generates significantly
 
134
smaller PS files in situations where, e.g., the same image is drawn on
 
135
every page of a long document.
 
136
.TP
 
137
.BI \-paper " size"
 
138
Set the paper size to one of "letter", "legal", "A4", or "A3".  This
 
139
can also be set to "match", which will set the paper size to match the
 
140
size specified in the PDF file.
 
141
.RB "[config file: " psPaperSize ]
 
142
.TP
 
143
.BI \-paperw " size"
 
144
Set the paper width, in points.
 
145
.RB "[config file: " psPaperSize ]
 
146
.TP
 
147
.BI \-paperh " size"
 
148
Set the paper height, in points.
 
149
.RB "[config file: " psPaperSize ]
 
150
.TP
 
151
.B \-nocrop
 
152
By default, output is cropped to the CropBox specified in the PDF
 
153
file.  This option disables cropping.
 
154
.RB "[config file: " psCrop ]
 
155
.TP
 
156
.B \-expand
 
157
Expand PDF pages smaller than the paper to fill the paper.  By
 
158
default, these pages are not scaled.
 
159
.RB "[config file: " psExpandSmaller ]
 
160
.TP
 
161
.B \-noshrink
 
162
Don't scale PDF pages which are larger than the paper.  By default,
 
163
pages larger than the paper are shrunk to fit.
 
164
.RB "[config file: " psShrinkLarger ]
 
165
.TP
 
166
.B \-nocenter
 
167
By default, PDF pages smaller than the paper (after any scaling) are
 
168
centered on the paper.  This option causes them to be aligned to the
 
169
lower-left corner of the paper instead.
 
170
.RB "[config file: " psCenter ]
 
171
.TP
 
172
.B \-pagecrop
 
173
Treat the CropBox as the PDF page size.  By default, the MediaBox is
 
174
used as the page size.
 
175
.TP
 
176
.B \-duplex
 
177
Set the Duplex pagedevice entry in the PostScript file.  This tells
 
178
duplex-capable printers to enable duplexing.
 
179
.RB "[config file: " psDuplex ]
 
180
.TP
 
181
.BI \-opw " password"
 
182
Specify the owner password for the PDF file.  Providing this will
 
183
bypass all security restrictions.
 
184
.TP
 
185
.BI \-upw " password"
 
186
Specify the user password for the PDF file.
 
187
.TP
 
188
.B \-q
 
189
Don't print any messages or errors.
 
190
.RB "[config file: " errQuiet ]
 
191
.TP
 
192
.BI \-cfg " config-file"
 
193
Read
 
194
.I config-file
 
195
in place of ~/.xpdfrc or the system-wide config file.
 
196
.TP
 
197
.B \-v
 
198
Print copyright and version information.
 
199
.TP
 
200
.B \-h
 
201
Print usage information.
 
202
.RB ( \-help
 
203
and
 
204
.B \-\-help
 
205
are equivalent.)
 
206
.SH EXIT CODES
 
207
The Xpdf tools use the following exit codes:
 
208
.TP
 
209
0
 
210
No error.
 
211
.TP
 
212
1
 
213
Error opening a PDF file.
 
214
.TP
 
215
2
 
216
Error opening an output file.
 
217
.TP
 
218
3
 
219
Error related to PDF permissions.
 
220
.TP
 
221
99
 
222
Other error.
 
223
.SH AUTHOR
 
224
The pdftops software and documentation are copyright 1996-2007 Glyph &
 
225
Cog, LLC.
 
226
.SH "SEE ALSO"
 
227
.BR xpdf (1),
 
228
.BR pdftotext (1),
 
229
.BR pdfinfo (1),
 
230
.BR pdffonts (1),
 
231
.BR pdftoppm (1),
 
232
.BR pdfimages (1),
 
233
.BR xpdfrc (5)
 
234
.br
 
235
.B http://www.foolabs.com/xpdf/