root/main/trunk/binaries/mac/intel/xpdf-tools/doc/xpdfrc.5 @ 32219

Revision 32219, 27.5 KB (checked in by ak19, 4 months ago)

Committing xpdf-tools binaries for mac (v. 4.00 as for Win and Linux xpdf-tools binaries committed before) as they work with the test files. Aiming to build our own xpdf-tools from src for unix sometime hereafter, but in the meantime, there are these binaries.

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