1xpdfrc(5)                     File Formats Manual                    xpdfrc(5)
2
3
4

NAME

6       xpdfrc - configuration file for Xpdf tools (version 4.01)
7

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

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

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

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

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              Pdftops rasterizes an pages that use transparency (because Post‐
220              Script  doesn't  support  transparency).  If psNeverRasterize is
221              set to "yes", rasterization is disabled:  pages  will  never  be
222              rasterized, even if they contain transparency.  This will likely
223              result in incorrect output for PDF files that use  transparency,
224              and  a  warning  message  to  that effect will be printed.  This
225              defaults to "no".
226
227       fontDir dir
228              See the description above, in the DISPLAY FONTS section.
229

TEXT CONTROL AND CHARACTER MAPPING

231       textEncoding encoding-name
232              Sets the encoding to use for text output.  (This can be overrid‐
233              den  with  the  "-enc"  switch on the command line.)  The encod‐
234              ing-name must  be  defined  with  the  unicodeMap  command  (see
235              above).  This defaults to "Latin1".
236
237       textEOL unix | dos | mac
238              Sets  the  end-of-line  convention  to use for text output.  The
239              options are:
240
241                  unix = LF
242                  dos  = CR+LF
243                  mac  = CR
244
245              (This can be overridden with the "-eol" switch  on  the  command
246              line.)   The  default  value  is  based on the OS where xpdf and
247              pdftotext were built.
248
249       textPageBreaks yes | no
250              If set to "yes", text extraction will insert page  breaks  (form
251              feed characters) between pages.  This defaults to "yes".
252
253       textKeepTinyChars yes | no
254              If  set  to "yes", text extraction will keep all characters.  If
255              set to "no", text extraction will discard tiny (smaller  than  3
256              point)  characters  after  the  first  50000  per page, avoiding
257              extremely slow run times for PDF files that use special fonts to
258              do shading or cross-hatching.  This defaults to "yes".
259
260       nameToUnicode map-file
261              Specifies  a  file with the mapping from character names to Uni‐
262              code.  This is used to handle PDF fonts that have  valid  encod‐
263              ings  but no ToUnicode entry.  Each line of a nameToUnicode file
264              looks like this:
265
266                   hex-string name
267
268              The hex-string is the Unicode (UCS-2) character index, and  name
269              is  the  corresponding  character  name.  Multiple nameToUnicode
270              files can be used; if a character name is given more than  once,
271              the  code in the last specified file is used.  There is a built-
272              in default nameToUnicode table  with  all  of  Adobe's  standard
273              character names.
274
275       cidToUnicode registry-ordering map-file
276              Specifies the file with the mapping from character collection to
277              Unicode.  Each line of a cidToUnicode file represents one  char‐
278              acter:
279
280                   hex-string
281
282              The  hex-string is the Unicode (UCS-2) index for that character.
283              The first line maps CID 0, the second line  CID  1,  etc.   File
284              size  is  determined  by size of the character collection.  Only
285              one file is allowed per character collection; the last specified
286              file is used.  There are no built-in cidToUnicode mappings.
287
288       unicodeToUnicode font-name-substring map-file
289              This  is used to work around PDF fonts which have incorrect Uni‐
290              code information.  It specifies a file which maps from the given
291              (incorrect)  Unicode  indexes  to the correct ones.  The mapping
292              will be used for any font  whose  name  contains  font-name-sub‐
293              string.   Each  line  of  a unicodeToUnicode file represents one
294              Unicode character:
295
296                  in-hex out-hex1 out-hex2 ...
297
298              The in-hex field is an input (incorrect) Unicode index, and  the
299              rest  of  the  fields  are  one or more output (correct) Unicode
300              indexes.  Each occurrence of in-hex will  be  converted  to  the
301              specified output sequence.
302
303       unicodeRemapping remap-file
304              Remap Unicode characters when doing text extraction.  This spec‐
305              ifies a file that maps from a particular Unicode index  to  zero
306              or  more  replacement  Unicode  indexes.  Each line of the remap
307              file represents one Unicode character:
308
309                  in-hex out-hex1 out-hex2 ...
310
311              Any Unicode characters not listed will be left unchanged.   This
312              function  is  typically  used  to remap things like non-breaking
313              spaces, soft hyphens, ligatures, etc.
314
315       unicodeMap encoding-name map-file
316              Specifies the file with mapping from Unicode  to  encoding-name.
317              These encodings are used for text output (see below).  Each line
318              of a unicodeMap file represents a range of one or  more  Unicode
319              characters  which  maps linearly to a range in the output encod‐
320              ing:
321
322                   in-start-hex in-end-hex out-start-hex
323
324              Entries for single characters can be abbreviated to:
325
326                   in-hex out-hex
327
328              The in-start-hex and in-end-hex fields  (or  the  single  in-hex
329              field)  specify  the Unicode range.  The out-start-hex field (or
330              the out-hex field) specifies the start of  the  output  encoding
331              range.   The  length  of  the  out-start-hex (or out-hex) string
332              determines the length of the output characters (e.g., UTF-8 uses
333              different  numbers of bytes to represent characters in different
334              ranges).  Entries must be given  in  increasing  Unicode  order.
335              Only  one  file is allowed per encoding; the last specified file
336              is used.  The Latin1, ASCII7, Symbol, ZapfDingbats,  UTF-8,  and
337              UCS-2 encodings are predefined.
338
339       cMapDir registry-ordering dir
340              Specifies  a  search  directory,  dir,  for  CMaps  for the reg‐
341              istry-ordering character  collection.   There  can  be  multiple
342              directories  for  a particular collection.  There are no default
343              CMap directories.
344
345       toUnicodeDir dir
346              Specifies a search directory, dir, for ToUnicode  CMaps.   There
347              can  be  multiple  ToUnicode  directories.  There are no default
348              ToUnicode directories.
349
350       mapNumericCharNames yes | no
351              If set to "yes", the Xpdf tools  will  attempt  to  map  various
352              numeric character names sometimes used in font subsets.  In some
353              cases this leads to usable text, and in other cases it leads  to
354              gibberish -- there is no way for Xpdf to tell.  This defaults to
355              "yes".
356
357       mapUnknownCharNames yes | no
358              If set to "yes", and mapNumericCharNames is  set  to  "no",  the
359              Xpdf  tools  will  apply  a simple pass-through mapping (Unicode
360              index = character code) for all unrecognized glyph names.   (For
361              CID  fonts, setting mapNumericCharNames to "no" is unnecessary.)
362              In some cases, this leads to usable text, and in other cases  it
363              leads  to  gibberish  -- there is no way for Xpdf to tell.  This
364              defaults to "no".
365
366       mapExtTrueTypeFontsViaUnicode yes | no
367              When rasterizing text using an external TrueType font, there are
368              two  options  for  handling character codes.  If mapExtTrueType‐
369              FontsViaUnicode is set to "yes", Xpdf will use the  font  encod‐
370              ing/ToUnicode  info  to map character codes to Unicode, and then
371              use the font's Unicode cmap to map Unicode to GIDs.  If  mapExt‐
372              TrueTypeFontsViaUnicode  is  set  to  "no", Xpdf will assume the
373              character codes are GIDs (i.e., use an identity mapping).   This
374              defaults to "yes".
375
376       dropFont font-name
377              Drop  all  text drawn in the specified font.  To drop text drawn
378              in unnamed fonts, use:
379
380                  dropFont ""
381
382              There can be any number of dropFont commands.
383

RASTERIZER SETTINGS

385       enableFreeType yes | no
386              Enables or disables use of FreeType (a TrueType /  Type  1  font
387              rasterizer).  This is only relevant if the Xpdf tools were built
388              with  FreeType  support.   ("enableFreeType"  replaces  the  old
389              "freetypeControl" option.)  This option defaults to "yes".
390
391       disableFreeTypeHinting yes | no
392              If  this  is  set to "yes", FreeType hinting will be forced off.
393              This option defaults to "no".
394
395       antialias yes | no
396              Enables or disables font anti-aliasing in  the  PDF  rasterizer.
397              This option affects all font rasterizers.  ("antialias" replaces
398              the anti-aliasing control provided by the old "t1libControl" and
399              "freetypeControl" options.)  This default to "yes".
400
401       vectorAntialias yes | no
402              Enables  or disables anti-aliasing of vector graphics in the PDF
403              rasterizer.  This defaults to "yes".
404
405       antialiasPrinting yes | no
406              If  this  is  "yes",  bitmaps  sent  to  the  printer  will   be
407              antialiased  (according to the "antialias" and "vectorAntialias"
408              settings).  If  this  is  "no",  printed  bitmaps  will  not  be
409              antialiased.  This defaults to "no".
410
411       strokeAdjust yes | no | cad
412              Sets  the  stroke  adjustment  mode.   If set to "no", no stroke
413              adjustment will be done.  If set to "yes", normal stroke adjust‐
414              ment  will  be done: horizontal and vertical lines will be moved
415              by up to half a pixel to make  them  look  cleaner  when  vector
416              anti-aliasing is enabled.  If set to "cad", a slightly different
417              stroke adjustment algorithm will be used to ensure that lines of
418              the same original width will always have the same adjusted width
419              (at the expense of allowing gaps and overlaps  between  adjacent
420              lines).  This defaults to "yes".
421
422       forceAccurateTiling yes | no
423              If  this is set to "yes", the TilingType is forced to 2 (no dis‐
424              tortion) for all tiling patterns, regardless of the  setting  in
425              the pattern dictionary.  This defaults to "no".
426
427       screenType dispersed | clustered | stochasticClustered
428              Sets  the halftone screen type, which will be used when generat‐
429              ing a monochrome (1-bit) bitmap.  The  three  options  are  dis‐
430              persed-dot  dithering, clustered-dot dithering (with a round dot
431              and  45-degree  screen  angle),  and  stochastic   clustered-dot
432              dithering.   By default, "stochasticClustered" is used for reso‐
433              lutions of 300 dpi and higher, and "dispersed" is used for reso‐
434              lutions lower then 300 dpi.
435
436       screenSize integer
437              Sets  the size of the (square) halftone screen threshold matrix.
438              By default, this is 4 for dispersed-dot dithering, 10 for  clus‐
439              tered-dot   dithering,  and  100  for  stochastic  clustered-dot
440              dithering.
441
442       screenDotRadius integer
443              Sets the halftone screen dot radius.  This  is  only  used  when
444              screenType  is set to stochasticClustered, and it defaults to 2.
445              In clustered-dot mode, the dot radius  is  half  of  the  screen
446              size.  Dispersed-dot dithering doesn't have a dot radius.
447
448       screenGamma float
449              Sets the halftone screen gamma correction parameter.  Gamma val‐
450              ues greater than 1 make the output brighter; gamma  values  less
451              than 1 make it darker.  The default value is 1.
452
453       screenBlackThreshold float
454              When  halftoning,  all values below this threshold are forced to
455              solid black.  This parameter is a floating point value between 0
456              (black) and 1 (white).  The default value is 0.
457
458       screenWhiteThreshold float
459              When  halftoning,  all values above this threshold are forced to
460              solid white.  This parameter is a floating point value between 0
461              (black) and 1 (white).  The default value is 1.
462
463       minLineWidth float
464              Set  the minimum line width, in device pixels.  This affects the
465              rasterizer only, not the PostScript converter  (except  when  it
466              uses  rasterization  to handle transparency).  The default value
467              is 0 (no minimum).
468
469       enablePathSimplification yes | no
470              If set to "yes", simplify paths  by  removing  points  where  it
471              won't  make  a significant difference to the shape.  The default
472              value is "no".
473
474       overprintPreview yes | no
475              If set to "yes", generate overprint preview output, honoring the
476              OP/op/OPM  settings  in the PDF file.  Ignored for non-CMYK out‐
477              put.  The default value is "no".
478

VIEWER SETTINGS

480       These settings only apply to the Xpdf GUI PDF viewer.
481
482       initialZoom percentage | page | width
483              Sets the initial zoom factor.  A number specifies  a  zoom  per‐
484              centage,  where  100 means 72 dpi.  You may also specify ´page',
485              to fit the page to the window size, or ´width', to fit the  page
486              width to the window width.
487
488       defaultFitZoom percentage
489              If xpdf is started with fit-page or fit-width zoom and no window
490              geometry, it will calculate a desired window size based  on  the
491              PDF  page  size and this defaultFitZoom value.  I.e., the window
492              size will be chosen such that exactly one page will fit  in  the
493              window  at  this  zoom factor (which must be a percentage).  The
494              default value is based on the screen resolution.
495
496       initialSidebarState yes | no
497              If set to "yes", xpdf opens with  the  sidebar  (tabs,  outline,
498              etc.)   visible.   If  set  to "no", xpdf opens with the sidebar
499              collapsed.  The default is "yes".
500
501       paperColor color
502              Set the "paper color", i.e., the background of the page display.
503              The  color  can be #RRGGBB (hexadecimal) or a named color.  This
504              option will not work well with PDF files  that  do  things  like
505              filling in white behind the text.
506
507       matteColor color
508              Set the matte color, i.e., the color used for background outside
509              the actual page area.  The color can be #RRGGBB (hexadecimal) or
510              a named color.
511
512       fullScreenMatteColor color
513              Set  the  matte  color  for  full-screen mode.  The color can be
514              #RRGGBB (hexadecimal) or a named color.
515
516       popupMenuCmd title command ...
517              Add a command to the popup menu.  Title is the text to  be  dis‐
518              played  in  the  menu.  Command is an Xpdf command (see the COM‐
519              MANDS section of the xpdf(1) man page  for  details).   Multiple
520              commands are separated by whitespace.
521
522       maxTileWidth pixels
523              Set the maximum width of tiles to be used by xpdf when rasteriz‐
524              ing pages.  This defaults to 1500.
525
526       maxTileHeight pixels
527              Set the maximum height of tiles to be used by xpdf when  raster‐
528              izing pages.  This defaults to 1500.
529
530       tileCacheSize tiles
531              Set  the  maximum number of tiles to be cached by xpdf when ras‐
532              terizing pages.  This defaults to 10.
533
534       workerThreads numThreads
535              Set the number of worker threads to be used by xpdf when raster‐
536              izing pages.  This defaults to 1.
537
538       launchCommand command
539              Sets  the  command  executed  when  you click on a "launch"-type
540              link.  The intent is for the  command  to  be  a  program/script
541              which  determines the file type and runs the appropriate viewer.
542              The command line will consist of the file to be  launched,  fol‐
543              lowed  by  any  parameters  specified with the link.  Do not use
544              "%s" in "command".  By default, this is  unset,  and  Xpdf  will
545              simply try to execute the file (after prompting the user).
546
547       movieCommand command
548              Sets  the command executed when you click on a movie annotation.
549              The string "%s" will be replaced with the movie file name.  This
550              has no default value.
551
552       defaultPrinter printer
553              Sets the default printer used in the viewer's print dialog.
554
555       bind modifiers-key context command ...
556              Add  a  key  or  mouse button binding.  Modifiers can be zero or
557              more of:
558
559                  shift-
560                  ctrl-
561                  alt-
562
563              Key can be a regular ASCII character, or any one of:
564
565                  space
566                  tab
567                  return
568                  enter
569                  backspace
570                  esc
571                  insert
572                  delete
573                  home
574                  end
575                  pgup
576                  pgdn
577                  left / right / up / down        (arrow keys)
578                  f1 .. f35                       (function keys)
579                  mousePress1 .. mousePress7      (mouse buttons)
580                  mouseRelease1 .. mouseRelease7  (mouse buttons)
581                  mouseClick1 .. mouseClick7      (mouse buttons)
582
583              Context is either "any" or a comma-separated combination of:
584
585                  fullScreen / window       (full screen mode on/off)
586                  continuous / singlePage   (continuous mode on/off)
587                  overLink / offLink        (mouse over link or not)
588                  scrLockOn / scrLockOff    (scroll lock on/off)
589
590              The context string can include only one  of  each  pair  in  the
591              above list.
592
593              Command  is  an  Xpdf  command  (see the COMMANDS section of the
594              xpdf(1) man page for details).  Multiple commands are  separated
595              by whitespace.
596
597              The  bind  command replaces any existing binding, but only if it
598              was defined for the exact same modifiers, key, and context.  All
599              tokens (modifiers, key, context, commands) are case-sensitive.
600
601              Example key bindings:
602
603                  # bind ctrl-a in any context to the nextPage
604                  # command
605                  bind ctrl-a any nextPage
606
607                  # bind uppercase B, when in continuous mode
608                  # with scroll lock on, to the reload command
609                  # followed by the prevPage command
610                  bind B continuous,scrLockOn reload prevPage
611
612              See the xpdf(1) man page for more examples.
613
614       unbind modifiers-key context
615              Removes  a  key binding established with the bind command.  This
616              is most useful to remove default key bindings before  establish‐
617              ing  new  ones  (e.g.,  if  the default key binding is given for
618              "any" context, and you want to create new key bindings for  mul‐
619              tiple contexts).
620
621       tabStateFile path
622              Sets the file used by the loadTabState and saveTabState commands
623              (see the xpdf(1) man page for more information).
624

MISCELLANEOUS SETTINGS

626       drawAnnotations yes | no
627              If set to "no", annotations will not be drawn or  printed.   The
628              default value is "yes".
629
630       drawFormFields yes | no
631              If  set  to "no", form fields will not be drawn or printed.  The
632              default value is "yes".
633
634       enableXFA yes | no
635              If set to "yes", an XFA form (if present) will  be  rendered  in
636              place  of  an AcroForm.  If "no", an XFA form will never be ren‐
637              dered.  This defaults to "yes".
638
639       printCommands yes | no
640              If set to "yes", drawing commands are printed  as  they're  exe‐
641              cuted (useful for debugging).  This defaults to "no".
642
643       errQuiet yes | no
644              If  set to "yes", this suppresses all error and warning messages
645              from all of the Xpdf tools.  This defaults to "no".
646

EXAMPLES

648       The following is a sample xpdfrc file.
649
650       # from the Thai support package
651       nameToUnicode /usr/local/share/xpdf/Thai.nameToUnicode
652
653       # from the Japanese support package
654       cidToUnicode Adobe-Japan1 /usr/local/share/xpdf/Adobe-Japan1.cidToUnicode
655       unicodeMap   JISX0208     /usr/local/share/xpdf/JISX0208.unicodeMap
656       cMapDir      Adobe-Japan1 /usr/local/share/xpdf/cmap/Adobe-Japan1
657
658       # use the Base-14 Type 1 fonts from ghostscript
659       fontFile Times-Roman           /usr/local/share/ghostscript/fonts/n021003l.pfb
660       fontFile Times-Italic          /usr/local/share/ghostscript/fonts/n021023l.pfb
661       fontFile Times-Bold            /usr/local/share/ghostscript/fonts/n021004l.pfb
662       fontFile Times-BoldItalic      /usr/local/share/ghostscript/fonts/n021024l.pfb
663       fontFile Helvetica             /usr/local/share/ghostscript/fonts/n019003l.pfb
664       fontFile Helvetica-Oblique     /usr/local/share/ghostscript/fonts/n019023l.pfb
665       fontFile Helvetica-Bold        /usr/local/share/ghostscript/fonts/n019004l.pfb
666       fontFile Helvetica-BoldOblique /usr/local/share/ghostscript/fonts/n019024l.pfb
667       fontFile Courier               /usr/local/share/ghostscript/fonts/n022003l.pfb
668       fontFile Courier-Oblique       /usr/local/share/ghostscript/fonts/n022023l.pfb
669       fontFile Courier-Bold          /usr/local/share/ghostscript/fonts/n022004l.pfb
670       fontFile Courier-BoldOblique   /usr/local/share/ghostscript/fonts/n022024l.pfb
671       fontFile Symbol                /usr/local/share/ghostscript/fonts/s050000l.pfb
672       fontFile ZapfDingbats          /usr/local/share/ghostscript/fonts/d050000l.pfb
673
674       # use the Bakoma Type 1 fonts
675       # (this assumes they happen to be installed in /usr/local/fonts/bakoma)
676       fontDir /usr/local/fonts/bakoma
677
678       # set some PostScript options
679       psPaperSize          letter
680       psDuplex             no
681       psLevel              level2
682       psEmbedType1Fonts    yes
683       psEmbedTrueTypeFonts yes
684
685       # assume that the PostScript printer has the Univers and
686       # Univers-Bold fonts
687       psResidentFont Univers      Univers
688       psResidentFont Univers-Bold Univers-Bold
689
690       # set the text output options
691       textEncoding UTF-8
692       textEOL      unix
693
694       # misc options
695       enableFreeType  yes
696       launchCommand   viewer-script
697
698

FILES

700       /usr/local/etc/xpdfrc
701              This is the default location for the  system-wide  configuration
702              file.  Depending on build options, it may be placed elsewhere.
703
704       $HOME/.xpdfrc
705              This is the user's configuration file.  If it exists, it will be
706              read in place of the system-wide file.
707

AUTHOR

709       The Xpdf software and documentation are  copyright  1996-2019  Glyph  &
710       Cog, LLC.
711

SEE ALSO

713       xpdf(1),   pdftops(1),  pdftotext(1),  pdftohtml(1),  pdfinfo(1),  pdf‐
714       fonts(1), pdfdetach(1), pdftoppm(1), pdftopng(1), pdfimages(1)
715       http://www.xpdfreader.com/
716
717
718
719                                  18 Feb 2019                        xpdfrc(5)
Impressum