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