1 .\" Copyright 1996-2005 Glyph & Cog, LLC
2 .TH pdftops 1 "17 August 2005"
4 pdftops \- Portable Document Format (PDF) to PostScript converter
13 converts Portable Document Format (PDF) files to PostScript so they
16 Pdftops reads the PDF file,
18 and writes a PostScript file,
22 is not specified, pdftops converts
28 with the -eps option). If
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
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.
44 Specifies the first page to print.
47 Specifies the last page to print.
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 ]
58 Generate Level 1 separable PostScript. All colors are converted to
59 CMYK. Images are written with separate stream data for the four
61 .RB "[config file: " psLevel ]
64 Generate Level 2 PostScript. Level 2 supports color images and image
65 compression. This is the default setting.
66 .RB "[config file: " psLevel ]
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 ]
75 Generate Level 3 PostScript. This enables all Level 2 features plus
77 .RB "[config file: " psLevel ]
80 Generate Level 3 separable PostScript. The separation handling is the
81 same as for -level2Sep.
82 .RB "[config file: " psLevel ]
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.
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.
97 Generate OPI comments for all images and forms which have OPI
98 information. (This option is only available if pdftops was compiled
100 .RB "[config file: " psOPI ]
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 ]
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 ]
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
122 .RB "[config file: " psEmbedCIDPostScriptFonts ]
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
129 .RB "[config file: " psEmbedCIDTrueTypeFonts ]
132 Set the paper size to one of "letter", "legal", "A4", or "A3". This
133 can also be set to "match", which will set the paper size to match the
134 size specified in the PDF file.
135 .RB "[config file: " psPaperSize ]
138 Set the paper width, in points.
139 .RB "[config file: " psPaperSize ]
142 Set the paper height, in points.
143 .RB "[config file: " psPaperSize ]
146 By default, output is cropped to the CropBox specified in the PDF
147 file. This option disables cropping.
148 .RB "[config file: " psCrop ]
151 Expand PDF pages smaller than the paper to fill the paper. By
152 default, these pages are not scaled.
153 .RB "[config file: " psExpandSmaller ]
156 Don't scale PDF pages which are larger than the paper. By default,
157 pages larger than the paper are shrunk to fit.
158 .RB "[config file: " psShrinkLarger ]
161 By default, PDF pages smaller than the paper (after any scaling) are
162 centered on the paper. This option causes them to be aligned to the
163 lower-left corner of the paper instead.
164 .RB "[config file: " psCenter ]
167 Treat the CropBox as the PDF page size. By default, the MediaBox is
168 used as the page size.
171 Set the Duplex pagedevice entry in the PostScript file. This tells
172 duplex-capable printers to enable duplexing.
173 .RB "[config file: " psDuplex ]
175 .BI \-opw " password"
176 Specify the owner password for the PDF file. Providing this will
177 bypass all security restrictions.
179 .BI \-upw " password"
180 Specify the user password for the PDF file.
183 Don't print any messages or errors.
184 .RB "[config file: " errQuiet ]
186 .BI \-cfg " config-file"
189 in place of ~/.xpdfrc or the system-wide config file.
192 Print copyright and version information.
195 Print usage information.
201 The Xpdf tools use the following exit codes:
207 Error opening a PDF file.
210 Error opening an output file.
213 Error related to PDF permissions.
218 The pdftops software and documentation are copyright 1996-2005 Glyph &
229 .B http://www.foolabs.com/xpdf/