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