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

NAME

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

DESCRIPTION

9       All of the Xpdf tools read a single configuration file.
10
11       On Linux/Unix/MacOS: if you have a .xpdfrc file in your home directory,
12       it will be read.  Otherwise, a system-wide configuration file  will  be
13       read  from  /etc/xpdfrc,  if it exists.  (This is its default location;
14       depending on build options, it may be placed elsewhere.)
15
16       On Windows: the file must be named xpdfrc (no leading  dot,  no  exten‐
17       sion),  and  must  be  placed  in  the same directory as the executable
18       (pdftotext.exe, xpdf.exe, etc.)
19
20       The xpdfrc file consists of a series of configuration options, one  per
21       line.   Blank  lines  and  lines starting with a ´#' (comments) are ig‐
22       nored.
23
24       Arguments can be single-quoted or double-quoted, e.g., for  file  names
25       that contain spaces ("aaa bbb", 'aaa bbb').  This quoting does not pro‐
26       vide any escaping, so there's no way to include a  double  quote  in  a
27       double-quoted argument or a single quote in a single-quoted argument.
28
29       Arguments  can  also be at-quoted: @"aaa bbb".  At-quoted strings allow
30       use of the DATADIR variable, which is set to the 'data' subdirectory in
31       the  xpdf install directory.  The percent sign (%) is an escape charac‐
32       ter: a percent sign followed by any other character  is  replaced  with
33       that character.
34
35              @"abc %"def%" ghi" --> abc "def" ghi
36              @"${DATADIR}/foo"  --> ...install-dir.../data/foo
37              @"%${DATADIR}/foo" --> ${DATADIR}/foo
38
39       The  following  sections  list all of the configuration options, sorted
40       into functional groups.  There is an examples section at the end.
41

INCLUDE FILES

43       include config-file
44              Includes the specified config  file.   The  effect  of  this  is
45              equivalent  to  inserting  the  contents of config-file directly
46              into the parent config file in place  of  the  include  command.
47              Config files can be nested arbitrarily deeply.
48

GENERAL FONT CONFIGURATION

50       fontFile PDF-font-name font-file
51              Maps  a  PDF font, PDF-font-name, to a font for display or Post‐
52              Script output.  The font file, font-file, can be  any  type  al‐
53              lowed  in  a  PDF  file.   This command can be used for 8-bit or
54              16-bit (CID) fonts.
55
56       fontDir dir
57              Specifies a search directory for font files.  There can be  mul‐
58              tiple fontDir commands; all of the specified directories will be
59              searched in order.  The font files can be Type 1 (.pfa or  .pfb)
60              or TrueType (.ttf or .ttc); other files in the directory will be
61              ignored.  The font file name (not including the extension)  must
62              exactly  match  the  PDF font name.  This search is performed if
63              the font name doesn't match any of the fonts declared  with  the
64              fontFile command.  There are no default fontDir directories.
65
66       fontFileCC registry-ordering font-file
67              Maps  the  registry-ordering  character collection to a font for
68              display or PostScript output.  This mapping is used if the  font
69              name  doesn't match any of the fonts declared with the fontFile,
70              fontDir, psResidentFont16, or psResidentFontCC commands.
71

POSTSCRIPT FONT CONFIGURATION

73       psFontPassthrough yes | no
74              If set to "yes", pass 8-bit font names through to the PostScript
75              output  without  substitution.   Fonts which are not embedded in
76              the PDF file are expected to be available on the printer.   This
77              defaults to "no".
78
79       psResidentFont PDF-font-name PS-font-name
80              When the 8-bit font PDF-font-name is used (without embedding) in
81              a PDF file,  it  will  be  translated  to  the  PostScript  font
82              PS-font-name,  which  is  assumed to be resident in the printer.
83              Typically, PDF-font-name and PS-font-name are the same.  By  de‐
84              fault, only the Base-14 fonts are assumed to be resident.
85
86       psResidentFont16 PDF-font-name wMode PS-font-name encoding
87              When the 16-bit (CID) font PDF-font-name with writing mode wMode
88              is used (without embedding) in a PDF file, it will be translated
89              to the PostScript font PS-font-name, which is assumed to be res‐
90              ident in the printer.  The writing mode must be either  ´H'  for
91              horizontal or ´V' for vertical.  The resident font is assumed to
92              use the specified encoding (which must have  been  defined  with
93              the unicodeMap command).
94
95       psResidentFontCC registry-ordering wMode PS-font-name encoding
96              When  a  16-bit (CID) font using the registry-ordering character
97              collection and wMode writing mode is used (without embedding) in
98              a  PDF  file,  the PostScript font, PS-font-name, is substituted
99              for it.  The substituted font is assumed to be resident  in  the
100              printer.   The writing mode must be either ´H' for horizontal or
101              ´V' for vertical.  The resident font is assumed to use the spec‐
102              ified encoding (which must have been defined with the unicodeMap
103              command).
104
105       psEmbedType1Fonts yes | no
106              If set to "no", prevents embedding of Type 1 fonts in  generated
107              PostScript.  This defaults to "yes".
108
109       psEmbedTrueTypeFonts yes | no
110              If  set  to "no", prevents embedding of TrueType fonts in gener‐
111              ated PostScript.  This defaults to "yes".
112
113       psEmbedCIDTrueTypeFonts yes | no
114              If set to "no", prevents embedding of CID TrueType fonts in gen‐
115              erated PostScript.  For Level 3 PostScript, this generates a CID
116              font, for lower levels it generates a  non-CID  composite  font.
117              This defaults to "yes".
118
119       psEmbedCIDPostScriptFonts yes | no
120              If  set  to  "no", prevents embedding of CID PostScript fonts in
121              generated PostScript.  For Level 3 PostScript, this generates  a
122              CID  font,  for  lower  levels  it generates a non-CID composite
123              font.  This defaults to "yes".
124

POSTSCRIPT CONTROL

126       psPaperSize width(pts) height(pts)
127              Sets the paper size for PostScript output.  The width and height
128              parameters  give  the paper size in PostScript points (1 point =
129              1/72 inch).
130
131       psPaperSize letter | legal | A4 | A3 | match
132              Sets the paper size for PostScript output to  a  standard  size.
133              The  default  paper size is set when xpdf and pdftops are built,
134              typically to "letter" or "A4".  This can also be set to "match",
135              which will set the paper size to match the size specified in the
136              PDF file.
137
138       psImageableArea llx lly urx ury
139              Sets the imageable area for PostScript output.  The  four  inte‐
140              gers  are the coordinates of the lower-left and upper-right cor‐
141              ners of the imageable region, specified in points (with the ori‐
142              gin being the lower-left corner of the paper).  This defaults to
143              the full paper size; the psPaperSize option will reset  the  im‐
144              ageable area coordinates.
145
146       psCrop yes | no
147              If  set  to  "yes",  PostScript output is cropped to the CropBox
148              specified in the PDF file; otherwise no cropping is done.   This
149              defaults to "yes".
150
151       psUseCropBoxAsPage yes | no
152              If  set  to  "yes",  PostScript output treats the CropBox as the
153              page size.  By default, this is "no", and the MediaBox  is  used
154              as the page size.
155
156       psExpandSmaller yes | no
157              If set to "yes", PDF pages smaller than the PostScript imageable
158              area are expanded to fill the  imageable  area.   Otherwise,  no
159              scaling is done on smaller pages.  This defaults to "no".
160
161       psShrinkLarger yes | no
162              If  set  to  yes, PDF pages larger than the PostScript imageable
163              area are shrunk to fit the imageable area.  Otherwise, no  scal‐
164              ing is done on larger pages.  This defaults to "yes".
165
166       psCenter yes | no
167              If  set  to yes, PDF pages smaller than the PostScript imageable
168              area (after any scaling) are centered  in  the  imageable  area.
169              Otherwise,  they are aligned at the lower-left corner of the im‐
170              ageable area.  This defaults to "yes".
171
172       psDuplex yes | no
173              If set to "yes", the generated PostScript will set the  "Duplex"
174              pagedevice  entry.  This tells duplex-capable printers to enable
175              duplexing.  This defaults to "no".
176
177       psLevel level1 | level1sep | level2 | level2gray | level2sep | level3 |
178       level3gray | level3Sep
179              Sets  the  PostScript  level  to  generate.   This  defaults  to
180              "level2".
181
182       psPreload yes | no
183              If set to "yes", PDF forms are converted to PS  procedures,  and
184              image  data  is  preloaded.   This uses more memory in the Post‐
185              Script interpreter, but generates significantly smaller PS files
186              in situations where, e.g., the same image is drawn on every page
187              of a long document.  This defaults to "no".
188
189       psOPI yes | no
190              If set to "yes", generates PostScript OPI comments for  all  im‐
191              ages  and forms which have OPI information.  This option is only
192              available if the Xpdf tools  were  compiled  with  OPI  support.
193              This defaults to "no".
194
195       psASCIIHex yes | no
196              If  set to "yes", the ASCIIHexEncode filter will be used instead
197              of ASCII85Encode for binary data.  This defaults to "no".
198
199       psLZW yes | no
200              If set to "yes", the LZWEncode filter will be used for  lossless
201              compression in PostScript output; if set to "no", the RunLength‐
202              Encode filter will be used instead.  LZW generates  better  com‐
203              pression  (smaller  PS  files), but may not be supported by some
204              printers.  This defaults to "yes".
205
206       psUncompressPreloadedImages yes | no
207              If set to "yes", all preloaded images in PS  files  will  uncom‐
208              pressed.  If set to "no", the original compressed images will be
209              used when possible.  The "yes" setting is useful to work  around
210              certain buggy PostScript interpreters.  This defaults to "no".
211
212       psMinLineWidth float
213              Set  the  minimum  line width, in points, for PostScript output.
214              The default value is 0 (no minimum).
215
216       psRasterResolution float
217              Set the resolution (in dpi) for rasterized pages  in  PostScript
218              output.   (Pdftops will rasterize pages which use transparency.)
219              This defaults to 300.
220
221       psRasterMono yes | no
222              If set to "yes", rasterized pages in PS files will be monochrome
223              (8-bit gray) instead of color.  This defaults to "no".
224
225       psRasterSliceSize pixels
226              When  rasterizing pages, pdftops splits the page into horizontal
227              "slices", to limit memory usage.  This option sets  the  maximum
228              slice size, in pixels.  This defaults to 20000000 (20 million).
229
230       psAlwaysRasterize yes | no
231              If set to "yes", all PostScript output will be rasterized.  This
232              defaults to "no".
233
234       psNeverRasterize yes | no
235              Pdftops rasterizes an pages that use transparency (because Post‐
236              Script  doesn't  support  transparency).  If psNeverRasterize is
237              set to "yes", rasterization is disabled:  pages  will  never  be
238              rasterized, even if they contain transparency.  This will likely
239              result in incorrect output for PDF files that use  transparency,
240              and  a warning message to that effect will be printed.  This de‐
241              faults to "no".
242
243       fontDir dir
244              See the description above, in the DISPLAY FONTS section.
245

TEXT CONTROL AND CHARACTER MAPPING

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

RASTERIZER SETTINGS

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

VIEWER SETTINGS

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

MISCELLANEOUS SETTINGS

682       drawAnnotations yes | no
683              If set to "no", annotations will not be drawn or  printed.   The
684              default value is "yes".
685
686       drawFormFields yes | no
687              If  set  to "no", form fields will not be drawn or printed.  The
688              default value is "yes".
689
690       enableXFA yes | no
691              If an XFA form is present, and this option is set to "yes", Xpdf
692              will parse the XFA form and use certain XFA information to over‐
693              ride AcroForm information.  If set to "no", the  XFA  form  will
694              not be read.  The default value is "yes".
695
696       savePageNumbers yes | no
697              If  set to "yes", xpdf will save the current page numbers of all
698              open files in ~/.xpdf.pages when the files are closed  (or  when
699              quitting  xpdf).   Next time the file is opened, the last-viewed
700              page number will be restored.  The default value is "yes".
701
702       printCommands yes | no
703              If set to "yes", drawing commands are printed  as  they're  exe‐
704              cuted (useful for debugging).  This defaults to "no".
705
706       printStatusInfo
707              If  set to "yes", print a status message (to stdout) before each
708              page is processed.  This defaults to "no".
709
710       errQuiet yes | no
711              If set to "yes", this suppresses all error and warning  messages
712              from all of the Xpdf tools.  This defaults to "no".
713

EXAMPLES

715       The following is a sample xpdfrc file.
716
717       # from the Thai support package
718       nameToUnicode /usr/local/share/xpdf/Thai.nameToUnicode
719
720       # from the Japanese support package
721       cidToUnicode Adobe-Japan1 /usr/local/share/xpdf/Adobe-Japan1.cidToUnicode
722       unicodeMap   JISX0208     /usr/local/share/xpdf/JISX0208.unicodeMap
723       cMapDir      Adobe-Japan1 /usr/local/share/xpdf/cmap/Adobe-Japan1
724
725       # use the Base-14 Type 1 fonts from ghostscript
726       fontFile Times-Roman           /usr/local/share/ghostscript/fonts/n021003l.pfb
727       fontFile Times-Italic          /usr/local/share/ghostscript/fonts/n021023l.pfb
728       fontFile Times-Bold            /usr/local/share/ghostscript/fonts/n021004l.pfb
729       fontFile Times-BoldItalic      /usr/local/share/ghostscript/fonts/n021024l.pfb
730       fontFile Helvetica             /usr/local/share/ghostscript/fonts/n019003l.pfb
731       fontFile Helvetica-Oblique     /usr/local/share/ghostscript/fonts/n019023l.pfb
732       fontFile Helvetica-Bold        /usr/local/share/ghostscript/fonts/n019004l.pfb
733       fontFile Helvetica-BoldOblique /usr/local/share/ghostscript/fonts/n019024l.pfb
734       fontFile Courier               /usr/local/share/ghostscript/fonts/n022003l.pfb
735       fontFile Courier-Oblique       /usr/local/share/ghostscript/fonts/n022023l.pfb
736       fontFile Courier-Bold          /usr/local/share/ghostscript/fonts/n022004l.pfb
737       fontFile Courier-BoldOblique   /usr/local/share/ghostscript/fonts/n022024l.pfb
738       fontFile Symbol                /usr/local/share/ghostscript/fonts/s050000l.pfb
739       fontFile ZapfDingbats          /usr/local/share/ghostscript/fonts/d050000l.pfb
740
741       # use the Bakoma Type 1 fonts
742       # (this assumes they happen to be installed in /usr/local/fonts/bakoma)
743       fontDir /usr/local/fonts/bakoma
744
745       # set some PostScript options
746       psPaperSize          letter
747       psDuplex             no
748       psLevel              level2
749       psEmbedType1Fonts    yes
750       psEmbedTrueTypeFonts yes
751
752       # assume that the PostScript printer has the Univers and
753       # Univers-Bold fonts
754       psResidentFont Univers      Univers
755       psResidentFont Univers-Bold Univers-Bold
756
757       # set the text output options
758       textEncoding UTF-8
759       textEOL      unix
760
761       # misc options
762       enableFreeType  yes
763       launchCommand   viewer-script
764
765

FILES

767       /etc/xpdfrc
768              This  is  the default location for the system-wide configuration
769              file.  Depending on build options, it may be placed elsewhere.
770
771       $HOME/.xpdfrc
772              This is the user's configuration file.  If it exists, it will be
773              read in place of the system-wide file.
774

AUTHOR

776       The  Xpdf  software  and  documentation are copyright 1996-2022 Glyph &
777       Cog, LLC.
778

SEE ALSO

780       xpdf(1),  pdftops(1),  pdftotext(1),  pdftohtml(1),  pdfinfo(1),   pdf‐
781       fonts(1), pdfdetach(1), pdftoppm(1), pdftopng(1), pdfimages(1)
782       http://www.xpdfreader.com/
783
784
785
786                                  18 Apr 202                         xpdfrc(5)
Impressum