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

NAME

6       xpdfrc - configuration file for Xpdf tools (version 4.03)
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 can be single-quoted or double-quoted, e.g., for  file  names
21       that contain spaces ("aaa bbb", 'aaa bbb').  This quoting does not pro‐
22       vide any escaping, so there's no way to include a  double  quote  in  a
23       double-quoted argument or a single quote in a single-quoted argument.
24
25       Arguments  can  also be at-quoted: @"aaa bbb".  At-quoted strings allow
26       use of the DATADIR variable, which is set to the 'data' subdirectory in
27       the  xpdf install directory.  The percent sign (%) is an escape charac‐
28       ter: a percent sign followed by any other character  is  replaced  with
29       that character.
30
31              @"abc %"def%" ghi" --> abc "def" ghi
32              @"${DATADIR}/foo"  --> ...install-dir.../data/foo
33              @"%${DATADIR}/foo" --> ${DATADIR}/foo
34
35       The  following  sections  list all of the configuration options, sorted
36       into functional groups.  There is an examples section at the end.
37

INCLUDE FILES

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

GENERAL FONT CONFIGURATION

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

POSTSCRIPT FONT CONFIGURATION

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

POSTSCRIPT CONTROL

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

TEXT CONTROL AND CHARACTER MAPPING

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

RASTERIZER SETTINGS

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

VIEWER SETTINGS

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

MISCELLANEOUS SETTINGS

667       drawAnnotations yes | no
668              If  set  to "no", annotations will not be drawn or printed.  The
669              default value is "yes".
670
671       drawFormFields yes | no
672              If set to "no", form fields will not be drawn or  printed.   The
673              default value is "yes".
674
675       printCommands yes | no
676              If  set  to  "yes", drawing commands are printed as they're exe‐
677              cuted (useful for debugging).  This defaults to "no".
678
679       errQuiet yes | no
680              If set to "yes", this suppresses all error and warning  messages
681              from all of the Xpdf tools.  This defaults to "no".
682

EXAMPLES

684       The following is a sample xpdfrc file.
685
686       # from the Thai support package
687       nameToUnicode /usr/local/share/xpdf/Thai.nameToUnicode
688
689       # from the Japanese support package
690       cidToUnicode Adobe-Japan1 /usr/local/share/xpdf/Adobe-Japan1.cidToUnicode
691       unicodeMap   JISX0208     /usr/local/share/xpdf/JISX0208.unicodeMap
692       cMapDir      Adobe-Japan1 /usr/local/share/xpdf/cmap/Adobe-Japan1
693
694       # use the Base-14 Type 1 fonts from ghostscript
695       fontFile Times-Roman           /usr/local/share/ghostscript/fonts/n021003l.pfb
696       fontFile Times-Italic          /usr/local/share/ghostscript/fonts/n021023l.pfb
697       fontFile Times-Bold            /usr/local/share/ghostscript/fonts/n021004l.pfb
698       fontFile Times-BoldItalic      /usr/local/share/ghostscript/fonts/n021024l.pfb
699       fontFile Helvetica             /usr/local/share/ghostscript/fonts/n019003l.pfb
700       fontFile Helvetica-Oblique     /usr/local/share/ghostscript/fonts/n019023l.pfb
701       fontFile Helvetica-Bold        /usr/local/share/ghostscript/fonts/n019004l.pfb
702       fontFile Helvetica-BoldOblique /usr/local/share/ghostscript/fonts/n019024l.pfb
703       fontFile Courier               /usr/local/share/ghostscript/fonts/n022003l.pfb
704       fontFile Courier-Oblique       /usr/local/share/ghostscript/fonts/n022023l.pfb
705       fontFile Courier-Bold          /usr/local/share/ghostscript/fonts/n022004l.pfb
706       fontFile Courier-BoldOblique   /usr/local/share/ghostscript/fonts/n022024l.pfb
707       fontFile Symbol                /usr/local/share/ghostscript/fonts/s050000l.pfb
708       fontFile ZapfDingbats          /usr/local/share/ghostscript/fonts/d050000l.pfb
709
710       # use the Bakoma Type 1 fonts
711       # (this assumes they happen to be installed in /usr/local/fonts/bakoma)
712       fontDir /usr/local/fonts/bakoma
713
714       # set some PostScript options
715       psPaperSize          letter
716       psDuplex             no
717       psLevel              level2
718       psEmbedType1Fonts    yes
719       psEmbedTrueTypeFonts yes
720
721       # assume that the PostScript printer has the Univers and
722       # Univers-Bold fonts
723       psResidentFont Univers      Univers
724       psResidentFont Univers-Bold Univers-Bold
725
726       # set the text output options
727       textEncoding UTF-8
728       textEOL      unix
729
730       # misc options
731       enableFreeType  yes
732       launchCommand   viewer-script
733
734

FILES

736       /usr/local/etc/xpdfrc
737              This  is  the default location for the system-wide configuration
738              file.  Depending on build options, it may be placed elsewhere.
739
740       $HOME/.xpdfrc
741              This is the user's configuration file.  If it exists, it will be
742              read in place of the system-wide file.
743

AUTHOR

745       The  Xpdf  software  and  documentation are copyright 1996-2021 Glyph &
746       Cog, LLC.
747

SEE ALSO

749       xpdf(1),  pdftops(1),  pdftotext(1),  pdftohtml(1),  pdfinfo(1),   pdf‐
750       fonts(1), pdfdetach(1), pdftoppm(1), pdftopng(1), pdfimages(1)
751       http://www.xpdfreader.com/
752
753
754
755                                  28 Jan 2021                        xpdfrc(5)
Impressum