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

NAME

6       xpdfrc - configuration file for Xpdf tools (version 4.02)
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       initialDisplayMode single | continuous | sideBySideSingle | sideBySide‐
497       Continuous | horizontalContinuous
498              Sets the initial display mode.  The default setting is "continu‐
499              ous".
500
501       initialToolbarState yes | no
502              If set to "yes", xpdf opens with the toolbar visible.  If set to
503              "no", xpdf opens with the toolbar hidden.  The default is "yes".
504
505       initialSidebarState yes | no
506              If  set  to  "yes",  xpdf opens with the sidebar (tabs, outline,
507              etc.)  visible.  If set to "no", xpdf  opens  with  the  sidebar
508              collapsed.  The default is "yes".
509
510       initialSelectMode block | linear
511              Sets  the  initial selection mode.  The default setting is "lin‐
512              ear".
513
514       paperColor color
515              Set the "paper color", i.e., the background of the page display.
516              The  color  can be #RRGGBB (hexadecimal) or a named color.  This
517              option will not work well with PDF files  that  do  things  like
518              filling in white behind the text.
519
520       matteColor color
521              Set the matte color, i.e., the color used for background outside
522              the actual page area.  The color can be #RRGGBB (hexadecimal) or
523              a named color.
524
525       fullScreenMatteColor color
526              Set  the  matte  color  for  full-screen mode.  The color can be
527              #RRGGBB (hexadecimal) or a named color.
528
529       reverseVideoInvertImages yes | no
530              If set to "no", xpdf's reverse-video mode inverts text and  vec‐
531              tor  graphic  content,  but  not  images.  If set to "yes", xpdf
532              inverts images as well.  The default is "no".
533
534       popupMenuCmd title command ...
535              Add a command to the popup menu.  Title is the text to  be  dis‐
536              played  in  the  menu.  Command is an Xpdf command (see the COM‐
537              MANDS section of the xpdf(1) man page  for  details).   Multiple
538              commands are separated by whitespace.
539
540       maxTileWidth pixels
541              Set the maximum width of tiles to be used by xpdf when rasteriz‐
542              ing pages.  This defaults to 1500.
543
544       maxTileHeight pixels
545              Set the maximum height of tiles to be used by xpdf when  raster‐
546              izing pages.  This defaults to 1500.
547
548       tileCacheSize tiles
549              Set  the  maximum number of tiles to be cached by xpdf when ras‐
550              terizing pages.  This defaults to 10.
551
552       workerThreads numThreads
553              Set the number of worker threads to be used by xpdf when raster‐
554              izing pages.  This defaults to 1.
555
556       launchCommand command
557              Sets  the  command  executed  when  you click on a "launch"-type
558              link.  The intent is for the  command  to  be  a  program/script
559              which  determines the file type and runs the appropriate viewer.
560              The command line will consist of the file to be  launched,  fol‐
561              lowed  by  any  parameters  specified with the link.  Do not use
562              "%s" in "command".  By default, this is  unset,  and  Xpdf  will
563              simply try to execute the file (after prompting the user).
564
565       movieCommand command
566              Sets  the command executed when you click on a movie annotation.
567              The string "%s" will be replaced with the movie file name.  This
568              has no default value.
569
570       defaultPrinter printer
571              Sets the default printer used in the viewer's print dialog.
572
573       bind modifiers-key context command ...
574              Add  a  key  or  mouse button binding.  Modifiers can be zero or
575              more of:
576
577                  shift-
578                  ctrl-
579                  alt-
580
581              Key can be a regular ASCII character, or any one of:
582
583                  space
584                  tab
585                  return
586                  enter
587                  backspace
588                  esc
589                  insert
590                  delete
591                  home
592                  end
593                  pgup
594                  pgdn
595                  left / right / up / down        (arrow keys)
596                  f1 .. f35                       (function keys)
597                  mousePress1 .. mousePress7      (mouse buttons)
598                  mouseRelease1 .. mouseRelease7  (mouse buttons)
599                  mouseClick1 .. mouseClick7      (mouse buttons)
600
601              Context is either "any" or a comma-separated combination of:
602
603                  fullScreen / window       (full screen mode on/off)
604                  continuous / singlePage   (continuous mode on/off)
605                  overLink / offLink        (mouse over link or not)
606                  scrLockOn / scrLockOff    (scroll lock on/off)
607
608              The context string can include only one  of  each  pair  in  the
609              above list.
610
611              Command  is  an  Xpdf  command  (see the COMMANDS section of the
612              xpdf(1) man page for details).  Multiple commands are  separated
613              by whitespace.
614
615              The  bind  command replaces any existing binding, but only if it
616              was defined for the exact same modifiers, key, and context.  All
617              tokens (modifiers, key, context, commands) are case-sensitive.
618
619              Example key bindings:
620
621                  # bind ctrl-a in any context to the nextPage
622                  # command
623                  bind ctrl-a any nextPage
624
625                  # bind uppercase B, when in continuous mode
626                  # with scroll lock on, to the reload command
627                  # followed by the prevPage command
628                  bind B continuous,scrLockOn reload prevPage
629
630              See the xpdf(1) man page for more examples.
631
632       unbind modifiers-key context
633              Removes  a  key binding established with the bind command.  This
634              is most useful to remove default key bindings before  establish‐
635              ing  new  ones  (e.g.,  if  the default key binding is given for
636              "any" context, and you want to create new key bindings for  mul‐
637              tiple contexts).
638
639       tabStateFile path
640              Sets the file used by the loadTabState and saveTabState commands
641              (see the xpdf(1) man page for more information).
642

MISCELLANEOUS SETTINGS

644       drawAnnotations yes | no
645              If set to "no", annotations will not be drawn or  printed.   The
646              default value is "yes".
647
648       drawFormFields yes | no
649              If  set  to "no", form fields will not be drawn or printed.  The
650              default value is "yes".
651
652       enableXFA yes | no
653              If set to "yes", an XFA form (if present) will  be  rendered  in
654              place  of  an AcroForm.  If "no", an XFA form will never be ren‐
655              dered.  This defaults to "yes".
656
657       printCommands yes | no
658              If set to "yes", drawing commands are printed  as  they're  exe‐
659              cuted (useful for debugging).  This defaults to "no".
660
661       errQuiet yes | no
662              If  set to "yes", this suppresses all error and warning messages
663              from all of the Xpdf tools.  This defaults to "no".
664

EXAMPLES

666       The following is a sample xpdfrc file.
667
668       # from the Thai support package
669       nameToUnicode /usr/local/share/xpdf/Thai.nameToUnicode
670
671       # from the Japanese support package
672       cidToUnicode Adobe-Japan1 /usr/local/share/xpdf/Adobe-Japan1.cidToUnicode
673       unicodeMap   JISX0208     /usr/local/share/xpdf/JISX0208.unicodeMap
674       cMapDir      Adobe-Japan1 /usr/local/share/xpdf/cmap/Adobe-Japan1
675
676       # use the Base-14 Type 1 fonts from ghostscript
677       fontFile Times-Roman           /usr/local/share/ghostscript/fonts/n021003l.pfb
678       fontFile Times-Italic          /usr/local/share/ghostscript/fonts/n021023l.pfb
679       fontFile Times-Bold            /usr/local/share/ghostscript/fonts/n021004l.pfb
680       fontFile Times-BoldItalic      /usr/local/share/ghostscript/fonts/n021024l.pfb
681       fontFile Helvetica             /usr/local/share/ghostscript/fonts/n019003l.pfb
682       fontFile Helvetica-Oblique     /usr/local/share/ghostscript/fonts/n019023l.pfb
683       fontFile Helvetica-Bold        /usr/local/share/ghostscript/fonts/n019004l.pfb
684       fontFile Helvetica-BoldOblique /usr/local/share/ghostscript/fonts/n019024l.pfb
685       fontFile Courier               /usr/local/share/ghostscript/fonts/n022003l.pfb
686       fontFile Courier-Oblique       /usr/local/share/ghostscript/fonts/n022023l.pfb
687       fontFile Courier-Bold          /usr/local/share/ghostscript/fonts/n022004l.pfb
688       fontFile Courier-BoldOblique   /usr/local/share/ghostscript/fonts/n022024l.pfb
689       fontFile Symbol                /usr/local/share/ghostscript/fonts/s050000l.pfb
690       fontFile ZapfDingbats          /usr/local/share/ghostscript/fonts/d050000l.pfb
691
692       # use the Bakoma Type 1 fonts
693       # (this assumes they happen to be installed in /usr/local/fonts/bakoma)
694       fontDir /usr/local/fonts/bakoma
695
696       # set some PostScript options
697       psPaperSize          letter
698       psDuplex             no
699       psLevel              level2
700       psEmbedType1Fonts    yes
701       psEmbedTrueTypeFonts yes
702
703       # assume that the PostScript printer has the Univers and
704       # Univers-Bold fonts
705       psResidentFont Univers      Univers
706       psResidentFont Univers-Bold Univers-Bold
707
708       # set the text output options
709       textEncoding UTF-8
710       textEOL      unix
711
712       # misc options
713       enableFreeType  yes
714       launchCommand   viewer-script
715
716

FILES

718       /usr/local/etc/xpdfrc
719              This is the default location for the  system-wide  configuration
720              file.  Depending on build options, it may be placed elsewhere.
721
722       $HOME/.xpdfrc
723              This is the user's configuration file.  If it exists, it will be
724              read in place of the system-wide file.
725

AUTHOR

727       The Xpdf software and documentation are  copyright  1996-2019  Glyph  &
728       Cog, LLC.
729

SEE ALSO

731       xpdf(1),   pdftops(1),  pdftotext(1),  pdftohtml(1),  pdfinfo(1),  pdf‐
732       fonts(1), pdfdetach(1), pdftoppm(1), pdftopng(1), pdfimages(1)
733       http://www.xpdfreader.com/
734
735
736
737                                  25 Sep 2019                        xpdfrc(5)
Impressum