1 | xpdfrc(5) File Formats Manual xpdfrc(5)
|
---|
2 |
|
---|
3 |
|
---|
4 |
|
---|
5 | NAME
|
---|
6 | xpdfrc - configuration file for Xpdf tools (version 4.00)
|
---|
7 |
|
---|
8 | DESCRIPTION
|
---|
9 | All of the Xpdf tools read a single configuration file. If you have a
|
---|
10 | .xpdfrc file in your home directory, it will be read. Otherwise, a
|
---|
11 | system-wide configuration file will be read from /usr/local/etc/xpdfrc,
|
---|
12 | if it exists. (This is its default location; depending on build
|
---|
13 | options, it may be placed elsewhere.) On Win32 systems, the xpdfrc
|
---|
14 | file should be placed in the same directory as the executables.
|
---|
15 |
|
---|
16 | The xpdfrc file consists of a series of configuration options, one per
|
---|
17 | line. Blank lines and lines starting with a '#' (comments) are
|
---|
18 | ignored.
|
---|
19 |
|
---|
20 | Arguments may be quoted, using "double-quote" characters, e.g., for
|
---|
21 | file names that contain spaces.
|
---|
22 |
|
---|
23 | The following sections list all of the configuration options, sorted
|
---|
24 | into functional groups. There is an examples section at the end.
|
---|
25 |
|
---|
26 | INCLUDE FILES
|
---|
27 | include config-file
|
---|
28 | Includes the specified config file. The effect of this is
|
---|
29 | equivalent to inserting the contents of config-file directly
|
---|
30 | into the parent config file in place of the include command.
|
---|
31 | Config files can be nested arbitrarily deeply.
|
---|
32 |
|
---|
33 | GENERAL FONT CONFIGURATION
|
---|
34 | fontFile PDF-font-name font-file
|
---|
35 | Maps a PDF font, PDF-font-name, to a font for display or Post-
|
---|
36 | Script output. The font file, font-file, can be any type
|
---|
37 | allowed in a PDF file. This command can be used for 8-bit or
|
---|
38 | 16-bit (CID) fonts.
|
---|
39 |
|
---|
40 | fontDir dir
|
---|
41 | Specifies a search directory for font files. There can be mul-
|
---|
42 | tiple fontDir commands; all of the specified directories will be
|
---|
43 | searched in order. The font files can be Type 1 (.pfa or .pfb)
|
---|
44 | or TrueType (.ttf or .ttc); other files in the directory will be
|
---|
45 | ignored. The font file name (not including the extension) must
|
---|
46 | exactly match the PDF font name. This search is performed if
|
---|
47 | the font name doesn't match any of the fonts declared with the
|
---|
48 | fontFile command. There are no default fontDir directories.
|
---|
49 |
|
---|
50 | fontFileCC registry-ordering font-file
|
---|
51 | Maps the registry-ordering character collection to a font for
|
---|
52 | display or PostScript output. This mapping is used if the font
|
---|
53 | name doesn't match any of the fonts declared with the fontFile,
|
---|
54 | fontDir, psResidentFont16, or psResidentFontCC commands.
|
---|
55 |
|
---|
56 | POSTSCRIPT FONT CONFIGURATION
|
---|
57 | psFontPassthrough yes | no
|
---|
58 | If set to "yes", pass 8-bit font names through to the PostScript
|
---|
59 | output without substitution. Fonts which are not embedded in
|
---|
60 | the PDF file are expected to be available on the printer. This
|
---|
61 | defaults to "no".
|
---|
62 |
|
---|
63 | psResidentFont PDF-font-name PS-font-name
|
---|
64 | When the 8-bit font PDF-font-name is used (without embedding) in
|
---|
65 | a PDF file, it will be translated to the PostScript font
|
---|
66 | PS-font-name, which is assumed to be resident in the printer.
|
---|
67 | Typically, PDF-font-name and PS-font-name are the same. By
|
---|
68 | default, only the Base-14 fonts are assumed to be resident.
|
---|
69 |
|
---|
70 | psResidentFont16 PDF-font-name wMode PS-font-name encoding
|
---|
71 | When the 16-bit (CID) font PDF-font-name with writing mode wMode
|
---|
72 | is used (without embedding) in a PDF file, it will be translated
|
---|
73 | to the PostScript font PS-font-name, which is assumed to be res-
|
---|
74 | ident in the printer. The writing mode must be either 'H' for
|
---|
75 | horizontal or 'V' for vertical. The resident font is assumed to
|
---|
76 | use the specified encoding (which must have been defined with
|
---|
77 | the unicodeMap command).
|
---|
78 |
|
---|
79 | psResidentFontCC registry-ordering wMode PS-font-name encoding
|
---|
80 | When a 16-bit (CID) font using the registry-ordering character
|
---|
81 | collection and wMode writing mode is used (without embedding) in
|
---|
82 | a PDF file, the PostScript font, PS-font-name, is substituted
|
---|
83 | for it. The substituted font is assumed to be resident in the
|
---|
84 | printer. The writing mode must be either 'H' for horizontal or
|
---|
85 | 'V' for vertical. The resident font is assumed to use the spec-
|
---|
86 | ified encoding (which must have been defined with the unicodeMap
|
---|
87 | command).
|
---|
88 |
|
---|
89 | psEmbedType1Fonts yes | no
|
---|
90 | If set to "no", prevents embedding of Type 1 fonts in generated
|
---|
91 | PostScript. This defaults to "yes".
|
---|
92 |
|
---|
93 | psEmbedTrueTypeFonts yes | no
|
---|
94 | If set to "no", prevents embedding of TrueType fonts in gener-
|
---|
95 | ated PostScript. This defaults to "yes".
|
---|
96 |
|
---|
97 | psEmbedCIDTrueTypeFonts yes | no
|
---|
98 | If set to "no", prevents embedding of CID TrueType fonts in gen-
|
---|
99 | erated PostScript. For Level 3 PostScript, this generates a CID
|
---|
100 | font, for lower levels it generates a non-CID composite font.
|
---|
101 | This defaults to "yes".
|
---|
102 |
|
---|
103 | psEmbedCIDPostScriptFonts yes | no
|
---|
104 | If set to "no", prevents embedding of CID PostScript fonts in
|
---|
105 | generated PostScript. For Level 3 PostScript, this generates a
|
---|
106 | CID font, for lower levels it generates a non-CID composite
|
---|
107 | font. This defaults to "yes".
|
---|
108 |
|
---|
109 | POSTSCRIPT CONTROL
|
---|
110 | psPaperSize width(pts) height(pts)
|
---|
111 | Sets the paper size for PostScript output. The width and height
|
---|
112 | parameters give the paper size in PostScript points (1 point =
|
---|
113 | 1/72 inch).
|
---|
114 |
|
---|
115 | psPaperSize letter | legal | A4 | A3 | match
|
---|
116 | Sets the paper size for PostScript output to a standard size.
|
---|
117 | The default paper size is set when xpdf and pdftops are built,
|
---|
118 | typically to "letter" or "A4". This can also be set to "match",
|
---|
119 | which will set the paper size to match the size specified in the
|
---|
120 | PDF file.
|
---|
121 |
|
---|
122 | psImageableArea llx lly urx ury
|
---|
123 | Sets the imageable area for PostScript output. The four inte-
|
---|
124 | gers are the coordinates of the lower-left and upper-right cor-
|
---|
125 | ners of the imageable region, specified in points (with the ori-
|
---|
126 | gin being the lower-left corner of the paper). This defaults to
|
---|
127 | the full paper size; the psPaperSize option will reset the
|
---|
128 | imageable area coordinates.
|
---|
129 |
|
---|
130 | psCrop yes | no
|
---|
131 | If set to "yes", PostScript output is cropped to the CropBox
|
---|
132 | specified in the PDF file; otherwise no cropping is done. This
|
---|
133 | defaults to "yes".
|
---|
134 |
|
---|
135 | psUseCropBoxAsPage yes | no
|
---|
136 | If set to "yes", PostScript output treats the CropBox as the
|
---|
137 | page size. By default, this is "no", and the MediaBox is used
|
---|
138 | as the page size.
|
---|
139 |
|
---|
140 | psExpandSmaller yes | no
|
---|
141 | If set to "yes", PDF pages smaller than the PostScript imageable
|
---|
142 | area are expanded to fill the imageable area. Otherwise, no
|
---|
143 | scaling is done on smaller pages. This defaults to "no".
|
---|
144 |
|
---|
145 | psShrinkLarger yes | no
|
---|
146 | If set to yes, PDF pages larger than the PostScript imageable
|
---|
147 | area are shrunk to fit the imageable area. Otherwise, no scal-
|
---|
148 | ing is done on larger pages. This defaults to "yes".
|
---|
149 |
|
---|
150 | psCenter yes | no
|
---|
151 | If set to yes, PDF pages smaller than the PostScript imageable
|
---|
152 | area (after any scaling) are centered in the imageable area.
|
---|
153 | Otherwise, they are aligned at the lower-left corner of the
|
---|
154 | imageable area. This defaults to "yes".
|
---|
155 |
|
---|
156 | psDuplex yes | no
|
---|
157 | If set to "yes", the generated PostScript will set the "Duplex"
|
---|
158 | pagedevice entry. This tells duplex-capable printers to enable
|
---|
159 | duplexing. This defaults to "no".
|
---|
160 |
|
---|
161 | psLevel level1 | level1sep | level2 | level2gray | level2sep | level3 |
|
---|
162 | level3gray | level3Sep
|
---|
163 | Sets the PostScript level to generate. This defaults to
|
---|
164 | "level2".
|
---|
165 |
|
---|
166 | psPreload yes | no
|
---|
167 | If set to "yes", PDF forms are converted to PS procedures, and
|
---|
168 | image data is preloaded. This uses more memory in the Post-
|
---|
169 | Script interpreter, but generates significantly smaller PS files
|
---|
170 | in situations where, e.g., the same image is drawn on every page
|
---|
171 | of a long document. This defaults to "no".
|
---|
172 |
|
---|
173 | psOPI yes | no
|
---|
174 | If set to "yes", generates PostScript OPI comments for all
|
---|
175 | images and forms which have OPI information. This option is
|
---|
176 | only available if the Xpdf tools were compiled with OPI support.
|
---|
177 | This defaults to "no".
|
---|
178 |
|
---|
179 | psASCIIHex yes | no
|
---|
180 | If set to "yes", the ASCIIHexEncode filter will be used instead
|
---|
181 | of ASCII85Encode for binary data. This defaults to "no".
|
---|
182 |
|
---|
183 | psLZW yes | no
|
---|
184 | If set to "yes", the LZWEncode filter will be used for lossless
|
---|
185 | compression in PostScript output; if set to "no", the RunLength-
|
---|
186 | Encode filter will be used instead. LZW generates better com-
|
---|
187 | pression (smaller PS files), but may not be supported by some
|
---|
188 | printers. This defaults to "yes".
|
---|
189 |
|
---|
190 | psUncompressPreloadedImages yes | no
|
---|
191 | If set to "yes", all preloaded images in PS files will uncom-
|
---|
192 | pressed. If set to "no", the original compressed images will be
|
---|
193 | used when possible. The "yes" setting is useful to work around
|
---|
194 | certain buggy PostScript interpreters. This defaults to "no".
|
---|
195 |
|
---|
196 | psMinLineWidth float
|
---|
197 | Set the minimum line width, in points, for PostScript output.
|
---|
198 | The default value is 0 (no minimum).
|
---|
199 |
|
---|
200 | psRasterResolution float
|
---|
201 | Set the resolution (in dpi) for rasterized pages in PostScript
|
---|
202 | output. (Pdftops will rasterize pages which use transparency.)
|
---|
203 | This defaults to 300.
|
---|
204 |
|
---|
205 | psRasterMono yes | no
|
---|
206 | If set to "yes", rasterized pages in PS files will be monochrome
|
---|
207 | (8-bit gray) instead of color. This defaults to "no".
|
---|
208 |
|
---|
209 | psRasterSliceSize pixels
|
---|
210 | When rasterizing pages, pdftops splits the page into horizontal
|
---|
211 | "slices", to limit memory usage. This option sets the maximum
|
---|
212 | slice size, in pixels. This defaults to 20000000 (20 million).
|
---|
213 |
|
---|
214 | psAlwaysRasterize yes | no
|
---|
215 | If set to "yes", all PostScript output will be rasterized. This
|
---|
216 | defaults to "no".
|
---|
217 |
|
---|
218 | psNeverRasterize yes | no
|
---|
219 | If set to "yes", PostScript output will never be rasterized.
|
---|
220 | This will likely result in incorrect output for PDF files that
|
---|
221 | use transparency. (If both psAlwaysRasterize and psNeverRaster-
|
---|
222 | ize are set to "yes", the psAlwaysRasterize setting wins.) This
|
---|
223 | defaults to "no".
|
---|
224 |
|
---|
225 | psFile file-or-command
|
---|
226 | Sets the default PostScript file or print command for xpdf.
|
---|
227 | Commands start with a '|' character; anything else is a file.
|
---|
228 | If the file name or command contains spaces it must be quoted.
|
---|
229 | This defaults to unset, which tells xpdf to generate a name of
|
---|
230 | the form <file>.ps for a PDF file <file>.pdf.
|
---|
231 |
|
---|
232 | fontDir dir
|
---|
233 | See the description above, in the DISPLAY FONTS section.
|
---|
234 |
|
---|
235 | TEXT CONTROL AND CHARACTER MAPPING
|
---|
236 | textEncoding encoding-name
|
---|
237 | Sets the encoding to use for text output. (This can be overrid-
|
---|
238 | den with the "-enc" switch on the command line.) The encod-
|
---|
239 | ing-name must be defined with the unicodeMap command (see
|
---|
240 | above). This defaults to "Latin1".
|
---|
241 |
|
---|
242 | textEOL unix | dos | mac
|
---|
243 | Sets the end-of-line convention to use for text output. The
|
---|
244 | options are:
|
---|
245 |
|
---|
246 | unix = LF
|
---|
247 | dos = CR+LF
|
---|
248 | mac = CR
|
---|
249 |
|
---|
250 | (This can be overridden with the "-eol" switch on the command
|
---|
251 | line.) The default value is based on the OS where xpdf and
|
---|
252 | pdftotext were built.
|
---|
253 |
|
---|
254 | textPageBreaks yes | no
|
---|
255 | If set to "yes", text extraction will insert page breaks (form
|
---|
256 | feed characters) between pages. This defaults to "yes".
|
---|
257 |
|
---|
258 | textKeepTinyChars yes | no
|
---|
259 | If set to "yes", text extraction will keep all characters. If
|
---|
260 | set to "no", text extraction will discard tiny (smaller than 3
|
---|
261 | point) characters after the first 50000 per page, avoiding
|
---|
262 | extremely slow run times for PDF files that use special fonts to
|
---|
263 | do shading or cross-hatching. This defaults to "yes".
|
---|
264 |
|
---|
265 | nameToUnicode map-file
|
---|
266 | Specifies a file with the mapping from character names to Uni-
|
---|
267 | code. This is used to handle PDF fonts that have valid encod-
|
---|
268 | ings but no ToUnicode entry. Each line of a nameToUnicode file
|
---|
269 | looks like this:
|
---|
270 |
|
---|
271 | hex-string name
|
---|
272 |
|
---|
273 | The hex-string is the Unicode (UCS-2) character index, and name
|
---|
274 | is the corresponding character name. Multiple nameToUnicode
|
---|
275 | files can be used; if a character name is given more than once,
|
---|
276 | the code in the last specified file is used. There is a built-
|
---|
277 | in default nameToUnicode table with all of Adobe's standard
|
---|
278 | character names.
|
---|
279 |
|
---|
280 | cidToUnicode registry-ordering map-file
|
---|
281 | Specifies the file with the mapping from character collection to
|
---|
282 | Unicode. Each line of a cidToUnicode file represents one char-
|
---|
283 | acter:
|
---|
284 |
|
---|
285 | hex-string
|
---|
286 |
|
---|
287 | The hex-string is the Unicode (UCS-2) index for that character.
|
---|
288 | The first line maps CID 0, the second line CID 1, etc. File
|
---|
289 | size is determined by size of the character collection. Only
|
---|
290 | one file is allowed per character collection; the last specified
|
---|
291 | file is used. There are no built-in cidToUnicode mappings.
|
---|
292 |
|
---|
293 | unicodeToUnicode font-name-substring map-file
|
---|
294 | This is used to work around PDF fonts which have incorrect Uni-
|
---|
295 | code information. It specifies a file which maps from the given
|
---|
296 | (incorrect) Unicode indexes to the correct ones. The mapping
|
---|
297 | will be used for any font whose name contains font-name-sub-
|
---|
298 | string. Each line of a unicodeToUnicode file represents one
|
---|
299 | Unicode character:
|
---|
300 |
|
---|
301 | in-hex out-hex1 out-hex2 ...
|
---|
302 |
|
---|
303 | The in-hex field is an input (incorrect) Unicode index, and the
|
---|
304 | rest of the fields are one or more output (correct) Unicode
|
---|
305 | indexes. Each occurrence of in-hex will be converted to the
|
---|
306 | specified output sequence.
|
---|
307 |
|
---|
308 | unicodeMap encoding-name map-file
|
---|
309 | Specifies the file with mapping from Unicode to encoding-name.
|
---|
310 | These encodings are used for text output (see below). Each line
|
---|
311 | of a unicodeMap file represents a range of one or more Unicode
|
---|
312 | characters which maps linearly to a range in the output encod-
|
---|
313 | ing:
|
---|
314 |
|
---|
315 | in-start-hex in-end-hex out-start-hex
|
---|
316 |
|
---|
317 | Entries for single characters can be abbreviated to:
|
---|
318 |
|
---|
319 | in-hex out-hex
|
---|
320 |
|
---|
321 | The in-start-hex and in-end-hex fields (or the single in-hex
|
---|
322 | field) specify the Unicode range. The out-start-hex field (or
|
---|
323 | the out-hex field) specifies the start of the output encoding
|
---|
324 | range. The length of the out-start-hex (or out-hex) string
|
---|
325 | determines the length of the output characters (e.g., UTF-8 uses
|
---|
326 | different numbers of bytes to represent characters in different
|
---|
327 | ranges). Entries must be given in increasing Unicode order.
|
---|
328 | Only one file is allowed per encoding; the last specified file
|
---|
329 | is used. The Latin1, ASCII7, Symbol, ZapfDingbats, UTF-8, and
|
---|
330 | UCS-2 encodings are predefined.
|
---|
331 |
|
---|
332 | cMapDir registry-ordering dir
|
---|
333 | Specifies a search directory, dir, for CMaps for the reg-
|
---|
334 | istry-ordering character collection. There can be multiple
|
---|
335 | directories for a particular collection. There are no default
|
---|
336 | CMap directories.
|
---|
337 |
|
---|
338 | toUnicodeDir dir
|
---|
339 | Specifies a search directory, dir, for ToUnicode CMaps. There
|
---|
340 | can be multiple ToUnicode directories. There are no default
|
---|
341 | ToUnicode directories.
|
---|
342 |
|
---|
343 | mapNumericCharNames yes | no
|
---|
344 | If set to "yes", the Xpdf tools will attempt to map various
|
---|
345 | numeric character names sometimes used in font subsets. In some
|
---|
346 | cases this leads to usable text, and in other cases it leads to
|
---|
347 | gibberish -- there is no way for Xpdf to tell. This defaults to
|
---|
348 | "yes".
|
---|
349 |
|
---|
350 | mapUnknownCharNames yes | no
|
---|
351 | If set to "yes", and mapNumericCharNames is set to "no", the
|
---|
352 | Xpdf tools will apply a simple pass-through mapping (Unicode
|
---|
353 | index = character code) for all unrecognized glyph names. (For
|
---|
354 | CID fonts, setting mapNumericCharNames to "no" is unnecessary.)
|
---|
355 | In some cases, this leads to usable text, and in other cases it
|
---|
356 | leads to gibberish -- there is no way for Xpdf to tell. This
|
---|
357 | defaults to "no".
|
---|
358 |
|
---|
359 | mapExtTrueTypeFontsViaUnicode yes | no
|
---|
360 | When rasterizing text using an external TrueType font, there are
|
---|
361 | two options for handling character codes. If mapExtTrueType-
|
---|
362 | FontsViaUnicode is set to "yes", Xpdf will use the font encod-
|
---|
363 | ing/ToUnicode info to map character codes to Unicode, and then
|
---|
364 | use the font's Unicode cmap to map Unicode to GIDs. If mapExt-
|
---|
365 | TrueTypeFontsViaUnicode is set to "no", Xpdf will assume the
|
---|
366 | character codes are GIDs (i.e., use an identity mapping). This
|
---|
367 | defaults to "yes".
|
---|
368 |
|
---|
369 | RASTERIZER SETTINGS
|
---|
370 | enableFreeType yes | no
|
---|
371 | Enables or disables use of FreeType (a TrueType / Type 1 font
|
---|
372 | rasterizer). This is only relevant if the Xpdf tools were built
|
---|
373 | with FreeType support. ("enableFreeType" replaces the old
|
---|
374 | "freetypeControl" option.) This option defaults to "yes".
|
---|
375 |
|
---|
376 | disableFreeTypeHinting yes | no
|
---|
377 | If this is set to "yes", FreeType hinting will be forced off.
|
---|
378 | This option defaults to "no".
|
---|
379 |
|
---|
380 | antialias yes | no
|
---|
381 | Enables or disables font anti-aliasing in the PDF rasterizer.
|
---|
382 | This option affects all font rasterizers. ("antialias" replaces
|
---|
383 | the anti-aliasing control provided by the old "t1libControl" and
|
---|
384 | "freetypeControl" options.) This default to "yes".
|
---|
385 |
|
---|
386 | vectorAntialias yes | no
|
---|
387 | Enables or disables anti-aliasing of vector graphics in the PDF
|
---|
388 | rasterizer. This defaults to "yes".
|
---|
389 |
|
---|
390 | antialiasPrinting yes | no
|
---|
391 | If this is "yes", bitmaps sent to the printer will be
|
---|
392 | antialiased (according to the "antialias" and "vectorAntialias"
|
---|
393 | settings). If this is "no", printed bitmaps will not be
|
---|
394 | antialiased. This defaults to "no".
|
---|
395 |
|
---|
396 | strokeAdjust yes | no | cad
|
---|
397 | Sets the stroke adjustment mode. If set to "no", no stroke
|
---|
398 | adjustment will be done. If set to "yes", normal stroke adjust-
|
---|
399 | ment will be done: horizontal and vertical lines will be moved
|
---|
400 | by up to half a pixel to make them look cleaner when vector
|
---|
401 | anti-aliasing is enabled. If set to "cad", a slightly different
|
---|
402 | stroke adjustment algorithm will be used to ensure that lines of
|
---|
403 | the same original width will always have the same adjusted width
|
---|
404 | (at the expense of allowing gaps and overlaps between adjacent
|
---|
405 | lines). This defaults to "yes".
|
---|
406 |
|
---|
407 | screenType dispersed | clustered | stochasticClustered
|
---|
408 | Sets the halftone screen type, which will be used when generat-
|
---|
409 | ing a monochrome (1-bit) bitmap. The three options are dis-
|
---|
410 | persed-dot dithering, clustered-dot dithering (with a round dot
|
---|
411 | and 45-degree screen angle), and stochastic clustered-dot
|
---|
412 | dithering. By default, "stochasticClustered" is used for reso-
|
---|
413 | lutions of 300 dpi and higher, and "dispersed" is used for reso-
|
---|
414 | lutions lower then 300 dpi.
|
---|
415 |
|
---|
416 | screenSize integer
|
---|
417 | Sets the size of the (square) halftone screen threshold matrix.
|
---|
418 | By default, this is 4 for dispersed-dot dithering, 10 for clus-
|
---|
419 | tered-dot dithering, and 100 for stochastic clustered-dot
|
---|
420 | dithering.
|
---|
421 |
|
---|
422 | screenDotRadius integer
|
---|
423 | Sets the halftone screen dot radius. This is only used when
|
---|
424 | screenType is set to stochasticClustered, and it defaults to 2.
|
---|
425 | In clustered-dot mode, the dot radius is half of the screen
|
---|
426 | size. Dispersed-dot dithering doesn't have a dot radius.
|
---|
427 |
|
---|
428 | screenGamma float
|
---|
429 | Sets the halftone screen gamma correction parameter. Gamma val-
|
---|
430 | ues greater than 1 make the output brighter; gamma values less
|
---|
431 | than 1 make it darker. The default value is 1.
|
---|
432 |
|
---|
433 | screenBlackThreshold float
|
---|
434 | When halftoning, all values below this threshold are forced to
|
---|
435 | solid black. This parameter is a floating point value between 0
|
---|
436 | (black) and 1 (white). The default value is 0.
|
---|
437 |
|
---|
438 | screenWhiteThreshold float
|
---|
439 | When halftoning, all values above this threshold are forced to
|
---|
440 | solid white. This parameter is a floating point value between 0
|
---|
441 | (black) and 1 (white). The default value is 1.
|
---|
442 |
|
---|
443 | minLineWidth float
|
---|
444 | Set the minimum line width, in device pixels. This affects the
|
---|
445 | rasterizer only, not the PostScript converter (except when it
|
---|
446 | uses rasterization to handle transparency). The default value
|
---|
447 | is 0 (no minimum).
|
---|
448 |
|
---|
449 | enablePathSimplification yes | no
|
---|
450 | If set to "yes", simplify paths by removing points where it
|
---|
451 | won't make a significant difference to the shape. The default
|
---|
452 | value is "no".
|
---|
453 |
|
---|
454 | overprintPreview yes | no
|
---|
455 | If set to "yes", generate overprint preview output, honoring the
|
---|
456 | OP/op/OPM settings in the PDF file. Ignored for non-CMYK out-
|
---|
457 | put. The default value is "no".
|
---|
458 |
|
---|
459 | VIEWER SETTINGS
|
---|
460 | These settings only apply to the Xpdf GUI PDF viewer.
|
---|
461 |
|
---|
462 | initialZoom percentage | page | width
|
---|
463 | Sets the initial zoom factor. A number specifies a zoom per-
|
---|
464 | centage, where 100 means 72 dpi. You may also specify 'page',
|
---|
465 | to fit the page to the window size, or 'width', to fit the page
|
---|
466 | width to the window width.
|
---|
467 |
|
---|
468 | defaultFitZoom percentage
|
---|
469 | If xpdf is started with fit-page or fit-width zoom and no window
|
---|
470 | geometry, it will calculate a desired window size based on the
|
---|
471 | PDF page size and this defaultFitZoom value. I.e., the window
|
---|
472 | size will be chosen such that exactly one page will fit in the
|
---|
473 | window at this zoom factor (which must be a percentage). The
|
---|
474 | default value is based on the screen resolution.
|
---|
475 |
|
---|
476 | initialSidebarState yes | no
|
---|
477 | If set to "yes", xpdf opens with the sidebar (tabs, outline,
|
---|
478 | etc.) visible. If set to "no", xpdf opens with the sidebar
|
---|
479 | collapsed. The default is "no".
|
---|
480 |
|
---|
481 | paperColor color
|
---|
482 | Set the "paper color", i.e., the background of the page display.
|
---|
483 | The color can be #RRGGBB (hexadecimal) or a named color. This
|
---|
484 | option will not work well with PDF files that do things like
|
---|
485 | filling in white behind the text.
|
---|
486 |
|
---|
487 | matteColor color
|
---|
488 | Set the matte color, i.e., the color used for background outside
|
---|
489 | the actual page area. The color can be #RRGGBB (hexadecimal) or
|
---|
490 | a named color.
|
---|
491 |
|
---|
492 | fullScreenMatteColor color
|
---|
493 | Set the matte color for full-screen mode. The color can be
|
---|
494 | #RRGGBB (hexadecimal) or a named color.
|
---|
495 |
|
---|
496 | popupMenuCmd title command ...
|
---|
497 | Add a command to the popup menu. Title is the text to be dis-
|
---|
498 | played in the menu. Command is an Xpdf command (see the COM-
|
---|
499 | MANDS section of the xpdf(1) man page for details). Multiple
|
---|
500 | commands are separated by whitespace.
|
---|
501 |
|
---|
502 | maxTileWidth pixels
|
---|
503 | Set the maximum width of tiles to be used by xpdf when rasteriz-
|
---|
504 | ing pages. This defaults to 1500.
|
---|
505 |
|
---|
506 | maxTileHeight pixels
|
---|
507 | Set the maximum height of tiles to be used by xpdf when raster-
|
---|
508 | izing pages. This defaults to 1500.
|
---|
509 |
|
---|
510 | tileCacheSize tiles
|
---|
511 | Set the maximum number of tiles to be cached by xpdf when ras-
|
---|
512 | terizing pages. This defaults to 10.
|
---|
513 |
|
---|
514 | workerThreads numThreads
|
---|
515 | Set the number of worker threads to be used by xpdf when raster-
|
---|
516 | izing pages. This defaults to 1.
|
---|
517 |
|
---|
518 | launchCommand command
|
---|
519 | Sets the command executed when you click on a "launch"-type
|
---|
520 | link. The intent is for the command to be a program/script
|
---|
521 | which determines the file type and runs the appropriate viewer.
|
---|
522 | The command line will consist of the file to be launched, fol-
|
---|
523 | lowed by any parameters specified with the link. Do not use
|
---|
524 | "%s" in "command". By default, this is unset, and Xpdf will
|
---|
525 | simply try to execute the file (after prompting the user).
|
---|
526 |
|
---|
527 | movieCommand command
|
---|
528 | Sets the command executed when you click on a movie annotation.
|
---|
529 | The string "%s" will be replaced with the movie file name. This
|
---|
530 | has no default value.
|
---|
531 |
|
---|
532 | bind modifiers-key context command ...
|
---|
533 | Add a key or mouse button binding. Modifiers can be zero or
|
---|
534 | more of:
|
---|
535 |
|
---|
536 | shift-
|
---|
537 | ctrl-
|
---|
538 | alt-
|
---|
539 |
|
---|
540 | Key can be a regular ASCII character, or any one of:
|
---|
541 |
|
---|
542 | space
|
---|
543 | tab
|
---|
544 | return
|
---|
545 | enter
|
---|
546 | backspace
|
---|
547 | esc
|
---|
548 | insert
|
---|
549 | delete
|
---|
550 | home
|
---|
551 | end
|
---|
552 | pgup
|
---|
553 | pgdn
|
---|
554 | left / right / up / down (arrow keys)
|
---|
555 | f1 .. f35 (function keys)
|
---|
556 | mousePress1 .. mousePress7 (mouse buttons)
|
---|
557 | mouseRelease1 .. mouseRelease7 (mouse buttons)
|
---|
558 | mouseClick1 .. mouseClick7 (mouse buttons)
|
---|
559 |
|
---|
560 | Context is either "any" or a comma-separated combination of:
|
---|
561 |
|
---|
562 | fullScreen / window (full screen mode on/off)
|
---|
563 | continuous / singlePage (continuous mode on/off)
|
---|
564 | overLink / offLink (mouse over link or not)
|
---|
565 | scrLockOn / scrLockOff (scroll lock on/off)
|
---|
566 |
|
---|
567 | The context string can include only one of each pair in the
|
---|
568 | above list.
|
---|
569 |
|
---|
570 | Command is an Xpdf command (see the COMMANDS section of the
|
---|
571 | xpdf(1) man page for details). Multiple commands are separated
|
---|
572 | by whitespace.
|
---|
573 |
|
---|
574 | The bind command replaces any existing binding, but only if it
|
---|
575 | was defined for the exact same modifiers, key, and context. All
|
---|
576 | tokens (modifiers, key, context, commands) are case-sensitive.
|
---|
577 |
|
---|
578 | Example key bindings:
|
---|
579 |
|
---|
580 | # bind ctrl-a in any context to the nextPage
|
---|
581 | # command
|
---|
582 | bind ctrl-a any nextPage
|
---|
583 |
|
---|
584 | # bind uppercase B, when in continuous mode
|
---|
585 | # with scroll lock on, to the reload command
|
---|
586 | # followed by the prevPage command
|
---|
587 | bind B continuous,scrLockOn reload prevPage
|
---|
588 |
|
---|
589 | See the xpdf(1) man page for more examples.
|
---|
590 |
|
---|
591 | unbind modifiers-key context
|
---|
592 | Removes a key binding established with the bind command. This
|
---|
593 | is most useful to remove default key bindings before establish-
|
---|
594 | ing new ones (e.g., if the default key binding is given for
|
---|
595 | "any" context, and you want to create new key bindings for mul-
|
---|
596 | tiple contexts).
|
---|
597 |
|
---|
598 | MISCELLANEOUS SETTINGS
|
---|
599 | drawAnnotations yes | no
|
---|
600 | If set to "no", annotations will not be drawn or printed. The
|
---|
601 | default value is "yes".
|
---|
602 |
|
---|
603 | drawFormFields yes | no
|
---|
604 | If set to "no", form fields will not be drawn or printed. The
|
---|
605 | default value is "yes".
|
---|
606 |
|
---|
607 | enableXFA yes | no
|
---|
608 | If set to "yes", an XFA form (if present) will be rendered in
|
---|
609 | place of an AcroForm. If "no", an XFA form will never be ren-
|
---|
610 | dered. This defaults to "yes".
|
---|
611 |
|
---|
612 | printCommands yes | no
|
---|
613 | If set to "yes", drawing commands are printed as they're exe-
|
---|
614 | cuted (useful for debugging). This defaults to "no".
|
---|
615 |
|
---|
616 | errQuiet yes | no
|
---|
617 | If set to "yes", this suppresses all error and warning messages
|
---|
618 | from all of the Xpdf tools. This defaults to "no".
|
---|
619 |
|
---|
620 | EXAMPLES
|
---|
621 | The following is a sample xpdfrc file.
|
---|
622 |
|
---|
623 | # from the Thai support package
|
---|
624 | nameToUnicode /usr/local/share/xpdf/Thai.nameToUnicode
|
---|
625 |
|
---|
626 | # from the Japanese support package
|
---|
627 | cidToUnicode Adobe-Japan1 /usr/local/share/xpdf/Adobe-Japan1.cidToUnicode
|
---|
628 | unicodeMap JISX0208 /usr/local/share/xpdf/JISX0208.unicodeMap
|
---|
629 | cMapDir Adobe-Japan1 /usr/local/share/xpdf/cmap/Adobe-Japan1
|
---|
630 |
|
---|
631 | # use the Base-14 Type 1 fonts from ghostscript
|
---|
632 | fontFile Times-Roman /usr/local/share/ghostscript/fonts/n021003l.pfb
|
---|
633 | fontFile Times-Italic /usr/local/share/ghostscript/fonts/n021023l.pfb
|
---|
634 | fontFile Times-Bold /usr/local/share/ghostscript/fonts/n021004l.pfb
|
---|
635 | fontFile Times-BoldItalic /usr/local/share/ghostscript/fonts/n021024l.pfb
|
---|
636 | fontFile Helvetica /usr/local/share/ghostscript/fonts/n019003l.pfb
|
---|
637 | fontFile Helvetica-Oblique /usr/local/share/ghostscript/fonts/n019023l.pfb
|
---|
638 | fontFile Helvetica-Bold /usr/local/share/ghostscript/fonts/n019004l.pfb
|
---|
639 | fontFile Helvetica-BoldOblique /usr/local/share/ghostscript/fonts/n019024l.pfb
|
---|
640 | fontFile Courier /usr/local/share/ghostscript/fonts/n022003l.pfb
|
---|
641 | fontFile Courier-Oblique /usr/local/share/ghostscript/fonts/n022023l.pfb
|
---|
642 | fontFile Courier-Bold /usr/local/share/ghostscript/fonts/n022004l.pfb
|
---|
643 | fontFile Courier-BoldOblique /usr/local/share/ghostscript/fonts/n022024l.pfb
|
---|
644 | fontFile Symbol /usr/local/share/ghostscript/fonts/s050000l.pfb
|
---|
645 | fontFile ZapfDingbats /usr/local/share/ghostscript/fonts/d050000l.pfb
|
---|
646 |
|
---|
647 | # use the Bakoma Type 1 fonts
|
---|
648 | # (this assumes they happen to be installed in /usr/local/fonts/bakoma)
|
---|
649 | fontDir /usr/local/fonts/bakoma
|
---|
650 |
|
---|
651 | # set some PostScript options
|
---|
652 | psPaperSize letter
|
---|
653 | psDuplex no
|
---|
654 | psLevel level2
|
---|
655 | psEmbedType1Fonts yes
|
---|
656 | psEmbedTrueTypeFonts yes
|
---|
657 | psFile "| lpr -Pprinter5"
|
---|
658 |
|
---|
659 | # assume that the PostScript printer has the Univers and
|
---|
660 | # Univers-Bold fonts
|
---|
661 | psResidentFont Univers Univers
|
---|
662 | psResidentFont Univers-Bold Univers-Bold
|
---|
663 |
|
---|
664 | # set the text output options
|
---|
665 | textEncoding UTF-8
|
---|
666 | textEOL unix
|
---|
667 |
|
---|
668 | # misc options
|
---|
669 | enableFreeType yes
|
---|
670 | launchCommand viewer-script
|
---|
671 | urlCommand "netscape -remote 'openURL(%s)'"
|
---|
672 |
|
---|
673 |
|
---|
674 | FILES
|
---|
675 | /usr/local/etc/xpdfrc
|
---|
676 | This is the default location for the system-wide configuration
|
---|
677 | file. Depending on build options, it may be placed elsewhere.
|
---|
678 |
|
---|
679 | $HOME/.xpdfrc
|
---|
680 | This is the user's configuration file. If it exists, it will be
|
---|
681 | read in place of the system-wide file.
|
---|
682 |
|
---|
683 | AUTHOR
|
---|
684 | The Xpdf software and documentation are copyright 1996-2017 Glyph &
|
---|
685 | Cog, LLC.
|
---|
686 |
|
---|
687 | SEE ALSO
|
---|
688 | xpdf(1), pdftops(1), pdftotext(1), pdftohtml(1), pdfinfo(1), pdf-
|
---|
689 | fonts(1), pdfdetach(1), pdftoppm(1), pdftopng(1), pdfimages(1)
|
---|
690 | http://www.xpdfreader.com/
|
---|
691 |
|
---|
692 |
|
---|
693 |
|
---|
694 | 10 Aug 2017 xpdfrc(5)
|
---|