summaryrefslogtreecommitdiff
path: root/Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.hlp
blob: 2cdf8daf2407e87449092240d5e345beac3fe316 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
! Generated automatically by mantohlp
1 pdftops

       pdftops  -  Portable  Document  Format (PDF) to PostScript
       converter

       pdftops [options] [PDF-file [PS-file]]

       Pdftops converts Portable Document Format (PDF)  files  to
       PostScript so they can be printed.

       Pdftops  reads  the  PDF  file,  PDF-file,  and  writes  a
       PostScript file, PS-file.  If PS-file  is  not  specified,
       pdftops converts file.pdf to file.ps (or file.eps with the
       -eps option).  If PS-file is '-', the PostScript  is  sent
       to stdout.

                                                               ()

2 ONFIGURATION_FIL

       Pdftops  reads  a configuration file at startup.  It first
       tries to find the user's private config  file,  ~/.xpdfrc.
       If  that  doesn't exist, it looks for a system-wide config
       file, typically /usr/local/etc/xpdfrc (but  this  location
       can  be changed when pdftops is built).  See the xpdfrc(5)
       man page for details.

                                                               ()

2 OPTIONS

       Many  of  the following options can be set with configura-
       tion file commands.  These are listed in  square  brackets
       with  the  description  of  the corresponding command line
       option.

       -f number
              Specifies the first page to print.

       -l number
              Specifies the last page to print.

       -level1
              Generate  Level  1   PostScript.    The   resulting
              PostScript  files  will be significantly larger (if
              they contain images), but will  print  on  Level  1
              printers.   This  also converts all images to black
              and white.  No more  than  one  of  the  PostScript
              level   options   (-level1,   -level1sep,  -level2,
              -level2sep,  -level3,  -level3Sep)  may  be  given.
              [config file: psLevel]

       -level1sep
              Generate  Level 1 separable PostScript.  All colors
              are converted to CMYK.   Images  are  written  with
              separate  stream  data  for  the  four  components.
              [config file: psLevel]

       -level2
              Generate Level  2  PostScript.   Level  2  supports
              color  images  and  image compression.  This is the
              default setting.  [config file: psLevel]

       -level2sep
              Generate Level 2 separable PostScript.  All  colors
              are  converted  to CMYK.  The PostScript separation
              convention operators  are  used  to  handle  custom
              (spot) colors.  [config file: psLevel]

       -level3
              Generate  Level  3  PostScript.   This  enables all
              Level 2 features plus CID font embedding and masked
              image generation.  [config file: psLevel]

       -level3Sep
              Generate Level 3 separable PostScript.  The separa-
              tion handling is the same as for -level2Sep.  [con-
              fig file: psLevel]

       -eps   Generate an Encapsulated PostScript (EPS) file.  An
              EPS file contains a single image,  so  if  you  use
              this  option  with  a multi-page PDF file, you must
              use -f and -l to specify a single  page.   No  more
              than  one  of the mode options (-eps, -form) may be
              given.

       -form  Generate a PostScript form which can be imported by
              software that understands forms.  A form contains a
              single page, so if  you  use  this  option  with  a
              multi-page  PDF  file,  you  must  use -f and -l to
              specify a single page.  The -level1  option  cannot
              be used with -form.

       -opi   Generate  OPI  comments  for  all  images and forms
              which have OPI information.  (This option  is  only
              available  if  pdftops  was  compiled with OPI sup-
              port.)  [config file: psOPI]

       -noembt1
              By default, any Type 1 fonts which are embedded  in
              the  PDF  file are copied into the PostScript file.
              This option causes pdftops to substitute base fonts
              instead.   Embedded  fonts  make  PostScript  files
              larger, but may be necessary for  readable  output.
              [config file: psEmbedType1Fonts]

       -noembtt
              By  default,  any TrueType fonts which are embedded
              in the PDF file  are  copied  into  the  PostScript
              file.   This  option  causes  pdftops to substitute
              base fonts instead.  Embedded fonts make PostScript
              files  larger,  but  may  be necessary for readable
              output.  Also, some PostScript interpreters do  not
              have  TrueType  rasterizers.   [config  file: psEm-
              bedTrueTypeFonts]

       -noembcidps
              By default, any  CID  PostScript  fonts  which  are
              embedded  in  the  PDF  file  are  copied  into the
              PostScript file.  This option disables that  embed-
              ding.   No  attempt  is made to substitute for non-
              embedded CID PostScript fonts.  [config file: psEm-
              bedCIDPostScriptFonts]

       -noembcidtt
              By default, any CID TrueType fonts which are embed-
              ded in the PDF file are copied into the  PostScript
              file.   This  option  disables  that embedding.  No
              attempt is made to substitute for non-embedded  CID
              TrueType  fonts.  [config file: psEmbedCIDTrueType-
              Fonts]

       -preload
              Convert PDF forms to  PS  procedures,  and  preload
              image   data.    This   uses  more  memory  in  the
              PostScript interpreter, but generates significantly
              smaller  PS  files  in  situations where, e.g., the
              same image is drawn on every page of a  long  docu-
              ment.

       -paper size
              Set  the  paper  size  to one of "letter", "legal",
              "A4", or "A3".  This can also be  set  to  "match",
              which  will  set  the  paper size to match the size
              specified in the PDF file.  [config file:  psPaper-
              Size]

       -paperw size
              Set  the  paper  width,  in  points.  [config file:
              psPaperSize]

       -paperh size
              Set the paper height,  in  points.   [config  file:
              psPaperSize]

       -nocrop
              By default, output is cropped to the CropBox speci-
              fied  in  the  PDF  file.   This  option   disables
              cropping.  [config file: psCrop]

       -expand
              Expand PDF pages smaller than the paper to fill the
              paper.  By default, these  pages  are  not  scaled.
              [config file: psExpandSmaller]

       -noshrink
              Don't  scale  PDF  pages  which are larger than the
              paper.  By default, pages larger than the paper are
              shrunk to fit.  [config file: psShrinkLarger]

       -nocenter
              By default, PDF pages smaller than the paper (after
              any scaling)  are  centered  on  the  paper.   This
              option  causes them to be aligned to the lower-left
              corner of the paper instead.  [config file:  psCen-
              ter]

       -pagecrop
              Treat  the  CropBox  as  the  PDF  page  size.   By
              default, the MediaBox is used as the page size.

       -duplex
              Set the Duplex pagedevice entry in  the  PostScript
              file.  This tells duplex-capable printers to enable
              duplexing.  [config file: psDuplex]

       -opw password
              Specify the owner password for the PDF file.   Pro-
              viding  this will bypass all security restrictions.

       -upw password
              Specify the user password for the PDF file.

       -q     Don't print any messages or errors.  [config  file:
              errQuiet]

       -cfg config-file
              Read  config-file in place of ~/.xpdfrc or the sys-
              tem-wide config file.

       -v     Print copyright and version information.

       -h     Print usage information.   (-help  and  --help  are
              equivalent.)

                                                               ()

2 XIT_CODE

       The Xpdf tools use the following exit codes:

       0      No error.

       1      Error opening a PDF file.

       2      Error opening an output file.

       3      Error related to PDF permissions.

       99     Other error.

                                                               ()

2 AUTHOR

       The  pdftops  software  and  documentation  are  copyright
       1996-2007 Glyph & Cog, LLC.

                                                               ()

2 SEE_ALSO

       xpdf(1),     pdftotext(1),     pdfinfo(1),    pdffonts(1),
       pdftoppm(1), pdfimages(1), xpdfrc(5)
       http://www.foolabs.com/xpdf/

                                                               ()