Penguin
Recent Changes
Annotated edit history of pdftops(1) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 pdftops
2 !!!pdftops
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 CONFIGURATION FILE
7 OPTIONS
8 BUGS
9 AUTHOR
10 SEE ALSO
11 ----
12 !!NAME
13
14
2 perry 15 pdftops - Portable Document Format (PDF) to !PostScript converter (version 1.00)
1 perry 16 !!SYNOPSIS
17
18
19 __pdftops__ [[options] [[''PDF-file''
20 [[''PS-file'']]
21 !!DESCRIPTION
22
23
24 __Pdftops__ converts Portable Document Format (PDF) files
2 perry 25 to !PostScript so they can be printed.
1 perry 26
27
28 Pdftops reads the PDF file, ''PDF-file'', and writes a
2 perry 29 !PostScript file, ''PS-file''. If ''PS-file'' is not
1 perry 30 specified, pdftops converts ''file.pdf'' to
31 ''file.ps'' (or ''file.eps'' with the -eps option). If
2 perry 32 ''PS-file'' is -', the !PostScript is sent to
1 perry 33 stdout.
34 !!CONFIGURATION FILE
35
36
37 Pdftops reads a configuration file at startup. It first
38 tries to find the user's private config file, ~/.xpdfrc. If
39 that doesn't exist, it looks for a system-wide config file,
40 typically /usr/local/etc/xpdfrc (but this location can be
41 changed when pdftops is built). See the xpdfrc(5) man
42 page for details.
43 !!OPTIONS
44
45
46 Many of the following options can be set with configuration
47 file commands. These are listed in square brackets with the
48 description of the corresponding command line
49 option.
50
51
52 __-f__ ''number''
53
54
55 Specifies the first page to print.
56
57
58 __-l__ ''number''
59
60
61 Specifies the last page to print.
62
63
64 __-level1__
65
66
2 perry 67 Generate Level 1 !PostScript. The resulting !PostScript files
1 perry 68 will be significantly larger (if they contain images), but
69 will print on Level 1 printers. This also converts all
70 images to black and white. The default behavior is to
2 perry 71 generate Level 2 !PostScript. In particular, Level 2 supports
1 perry 72 color images and image compression. No more than one of the
2 perry 73 !PostScript level options (-level1, -level1sep, -level2sep)
1 perry 74 may be given. [[config file: __psLevel__]
75
76
77 __-level1sep__
78
79
2 perry 80 Generate Level 1 separable !PostScript. All colors are
1 perry 81 converted to CMYK. Images are written with separate stream
82 data for the four components. [[config file:
83 __psLevel__]
84
85
86 __-level2sep__
87
88
2 perry 89 Generate Level 2 separable !PostScript. All colors are
90 converted to CMYK. The !PostScript separation convention
1 perry 91 operators are used to handle custom (spot) colors. [[config
92 file: __psLevel__]
93
94
95 __-eps__
96
97
2 perry 98 Generate an Encapsulated !PostScript (EPS) file. An EPS file
1 perry 99 contains a single image, so if you use this option with a
100 multi-page PDF file, you must use -f and -l to specify a
101 single page. No more than one of the mode options (-eps,
102 -form) may be given.
103
104
105 __-form__
106
107
2 perry 108 Generate a !PostScript form which can be imported by software
1 perry 109 that understands forms. A form contains a single page, so if
110 you use this option with a multi-page PDF file, you must use
111 -f and -l to specify a single page. The -level1 option
112 cannot be used with -form.
113
114
115 __-opi__
116
117
118 Generate OPI comments for all images and forms which have
119 OPI information. (This option is only available if pdftops
120 was compiled with OPI support.) [[config file:
121 __psOPI__]
122
123
124 __-noembt1__
125
126
127 By default, any Type 1 fonts which are embedded in the PDF
2 perry 128 file are copied into the !PostScript file. This option causes
1 perry 129 pdftops to substitute base fonts instead. Embedded fonts
2 perry 130 make !PostScript files larger, but may be necessary for
1 perry 131 readable output. [[config file:
132 __psEmbedType1Fonts__]
133
134
135 __-noembtt__
136
137
2 perry 138 By default, any !TrueType fonts which are embedded in the PDF
139 file are copied into the !PostScript file. This option causes
1 perry 140 pdftops to substitute base fonts instead. Embedded fonts
2 perry 141 make !PostScript files larger, but may be necessary for
142 readable output. Also, some !PostScript interpreters do not
143 have !TrueType rasterizers. [[config file:
1 perry 144 __psEmbedTrueTypeFonts__]
145
146
147 __-paper__ ''size''
148
149
150 Set the paper size to one of
151 psPaperSize__]
152
153
154 __-paperw__ ''size''
155
156
157 Set the paper width, in points. [[config file:
158 __psPaperSize__]
159
160
161 __-paperh__ ''size''
162
163
164 Set the paper height, in points. [[config file:
165 __psPaperSize__]
166
167
168 __-duplex__
169
170
2 perry 171 Set the Duplex pagedevice entry in the !PostScript file. This
1 perry 172 tells duplex-capable printers to enable duplexing. [[config
173 file: __psDuplex__]
174
175
176 __-opw__ ''password''
177
178
179 Specify the owner password for the PDF file. Providing this
180 will bypass all security restrictions.
181
182
183 __-upw__ ''password''
184
185
186 Specify the user password for the PDF file.
187
188
189 __-q__
190
191
192 Don't print any messages or errors. [[config file:
193 __errQuiet__]
194
195
196 __-cfg__ ''config-file''
197
198
199 Read ''config-file'' in place of ~/.xpdfrc or the
200 system-wide config file.
201
202
203 __-v__
204
205
206 Print copyright and version information.
207
208
209 __-h__
210
211
212 Print usage information. (__-help__ and __--help__ are
213 equivalent.)
214 !!BUGS
215
216
217 No support for Type 3 fonts.
218 !!AUTHOR
219
220
221 The pdftops software and documentation are copyright
222 1996-2002 Derek B. Noonburg
223 (derekn@foolabs.com).
224 !!SEE ALSO
225
226
227 xpdf(1), pdftotext(1), pdfinfo(1),
228 pdffonts(1), pdftopbm(1), pdfimages(1),
229 xpdfrc(5)__
230 http://www.foolabs.com/xpdf/__
231 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.