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 | ---- |