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