1pdftops(1)                  General Commands Manual                 pdftops(1)
2
3
4

NAME

6       pdftops  - Portable Document Format (PDF) to PostScript converter (ver‐
7       sion 3.03)
8

SYNOPSIS

10       pdftops [options] <PDF-file> [<PS-file>]
11

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

OPTIONS

22       -f number
23              Specifies the first page to print.
24
25       -l number
26              Specifies the last page to print.
27
28       -level1
29              Generate Level 1 PostScript.   The  resulting  PostScript  files
30              will  be significantly larger (if they contain images), but will
31              print on Level 1 printers.  This also  converts  all  images  to
32              black  and  white.   No  more  than  one of the PostScript level
33              options  (-level1,  -level1sep,  -level2,  -level2sep,  -level3,
34              -level3sep) may be given.
35
36       -level1sep
37              Generate Level 1 separable PostScript.  All colors are converted
38              to CMYK.  Images are written with separate stream data  for  the
39              four components.
40
41       -level2
42              Generate  Level 2 PostScript.  Level 2 supports color images and
43              image compression.  This is the default setting.
44
45       -level2sep
46              Generate Level 2 separable PostScript.  All colors are converted
47              to  CMYK.   The  PostScript  separation convention operators are
48              used to handle custom (spot) colors.
49
50       -level3
51              Generate Level 3 PostScript.  This enables all Level 2  features
52              plus CID font embedding.
53
54       -level3sep
55              Generate  Level 3 separable PostScript.  The separation handling
56              is the same as for -level2sep.
57
58       -eps   Generate an Encapsulated PostScript (EPS)  file.   An  EPS  file
59              contains a single image, so if you use this option with a multi-
60              page PDF file, you must use -f and -l to specify a single  page.
61              No more than one of the mode options (-eps, -form) may be given.
62
63       -form  Generate  a  PostScript  form  which can be imported by software
64              that understands forms.  A form contains a single  page,  so  if
65              you  use this option with a multi-page PDF file, you must use -f
66              and -l to specify a single page.  The -level1 option  cannot  be
67              used  with  -form.   No more than one of the mode options (-eps,
68              -form) may be given.
69
70       -opi   Generate OPI comments for all images and forms  which  have  OPI
71              information.  (This option is only available if pdftops was com‐
72              piled with OPI support.)
73
74       -binary
75              Write binary data in Level 1 PostScript.   By  default,  pdftops
76              writes  hex-encoded  data in Level 1 PostScript.  Binary data is
77              non-standard in Level 1 PostScript but reduces the file size and
78              can  be  useful when Level 1 PostScript is required only for its
79              restricted use of PostScript operators.
80
81       -r number
82              Set the resolution in DPI when pdftops  rasterizes  images  with
83              transparencies  or, for Level 1 PostScript, when pdftops raster‐
84              izes images with color masks.  By  default,  pdftops  rasterizes
85              images to 300 DPI.
86
87       -noembt1
88              By  default, any Type 1 fonts which are embedded in the PDF file
89              are copied into the PostScript file.  This option causes pdftops
90              to  substitute  base  fonts  instead.  Embedded fonts make Post‐
91              Script files larger, but may be necessary for readable output.
92
93       -noembtt
94              By default, any TrueType fonts which are  embedded  in  the  PDF
95              file  are  copied  into the PostScript file.  This option causes
96              pdftops to substitute base fonts instead.  Embedded  fonts  make
97              PostScript  files larger, but may be necessary for readable out‐
98              put.  Also, some PostScript interpreters do  not  have  TrueType
99              rasterizers.
100
101       -noembcidps
102              By  default,  any CID PostScript fonts which are embedded in the
103              PDF file are copied into the PostScript file.  This option  dis‐
104              ables that embedding.  No attempt is made to substitute for non-
105              embedded CID PostScript fonts.
106
107       -noembcidtt
108              By default, any CID TrueType fonts which are embedded in the PDF
109              file  are copied into the PostScript file.  This option disables
110              that embedding.  No attempt is made to substitute for non-embed‐
111              ded CID TrueType fonts.
112
113       -passfonts
114              By  default,  references  to non-embedded 8-bit fonts in the PDF
115              file are  substituted  with  the  closest  "Helvetica",  "Times-
116              Roman",  or  "Courier"  font.   This option passes references to
117              non-embedded fonts through to the PostScript file.
118
119       -preload
120              preload images and forms
121
122       -paper size
123              Set the paper size to one of "letter", "legal", "A4",  or  "A3".
124              This  can  also be set to "match", which will set the paper size
125              of each page to match the size specified in  the  PDF  file.  If
126              none  the -paper, -paperw, or -paperh options are spoecified the
127              default is to match the paper size.
128
129       -paperw size
130              Set the paper width, in points.
131
132       -paperh size
133              Set the paper height, in points.
134
135       -origpagesizes
136              This option is the same as "-paper match".
137
138       -nocrop
139              By default, output is cropped to the CropBox  specified  in  the
140              PDF file.  This option disables cropping.
141
142       -expand
143              Expand  PDF  pages smaller than the paper to fill the paper.  By
144              default, these pages are not scaled.
145
146       -noshrink
147              Don't scale PDF pages which  are  larger  than  the  paper.   By
148              default, pages larger than the paper are shrunk to fit.
149
150       -nocenter
151              By default, PDF pages smaller than the paper (after any scaling)
152              are centered on the  paper.   This  option  causes  them  to  be
153              aligned to the lower-left corner of the paper instead.
154
155       -duplex
156              Set  the  Duplex  pagedevice entry in the PostScript file.  This
157              tells duplex-capable printers to enable duplexing.
158
159       -opw password
160              Specify the owner password for the  PDF  file.   Providing  this
161              will bypass all security restrictions.
162
163       -upw password
164              Specify the user password for the PDF file.
165
166       -q     Don't print any messages or errors.
167
168       -v     Print copyright and version information.
169
170       -h     Print usage information.  (-help and --help are equivalent.)
171

EXIT CODES

173       The Xpdf tools use the following exit codes:
174
175       0      No error.
176
177       1      Error opening a PDF file.
178
179       2      Error opening an output file.
180
181       3      Error related to PDF permissions.
182
183       99     Other error.
184

AUTHOR

186       The  pdftops software and documentation are copyright 1996-2011 Glyph &
187       Cog, LLC.
188

SEE ALSO

190       pdfdetach(1),  pdffonts(1),  pdfimages(1),  pdfinfo(1),  pdftocairo(1),
191       pdftohtml(1), pdftoppm(1), pdftotext(1)
192
193
194
195                                15 August 2011                      pdftops(1)
Impressum