Ubuntu Manpage: xpdfrc - configuration file for xpdf (xpopple)

Provided by: xpdf_3.04+git20240202-1build3_amd64

NAME

       xpdfrc - configuration file for xpdf (xpopple)

DESCRIPTION

       The  xpdf  program reads a single configuration file.  If you have a .xpdfrc file in your home directory,
       it will be read.  Otherwise, a system-wide configuration file will be read from /etc/xpdf/xpdfrc,  if  it
       exists.  (This is its default location; depending on build options, it may be placed elsewhere.)

       The  xpdfrc  file  consists  of  a  series of configuration options, one per line.  Blank lines and lines
       starting with a '#' (comments) are ignored.

       Arguments may be quoted, using "double-quote" characters, e.g., for file names that contain spaces.

       The following sections list all of the configuration options, sorted into functional groups.  There is an
       examples section at the end.

       Note that all settings are case-sensitive; in particular, boolean options are "yes" and "no" (rather than
       "Yes" or "No").

INCLUDE FILES

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

GENERAL FONT CONFIGURATION

       fontFile PDF-font-name font-file
              Maps  a  PDF  font,  PDF-font-name,  to  a  font for display or PostScript output.  The font file,
              font-file, can be any type allowed in a PDF file.  This command can be used for  8-bit  or  16-bit
              (CID) fonts.

POSTSCRIPT CONTROL

psPaperSize width(pts) height(pts)
Sets the paper size for PostScript output. The width and height parameters give the paper size in
PostScript points (1 point = 1/72 inch).

psPaperSize letter | legal | A4 | A3 | match
Sets the paper size for PostScript output to a standard size. The default paper size is set when
xpdf and pdftops are built, typically to "letter" or "A4". This can also be set to "match", which
will set the paper size to match the size specified in the PDF file.

psImageableArea llx lly urx ury
Sets the imageable area for PostScript output. The four integers are the coordinates of the
lower-left and upper-right corners of the imageable region, specified in points (with the origin
being the lower-left corner of the paper). This defaults to the full paper size; the psPaperSize
option will reset the imageable area coordinates.

psCrop yes | no
If set to "yes", PostScript output is cropped to the CropBox specified in the PDF file; otherwise
no cropping is done. This defaults to "yes".

psExpandSmaller yes | no
If set to "yes", PDF pages smaller than the PostScript imageable area are expanded to fill the
imageable area. Otherwise, no scalling is done on smaller pages. This defaults to "no".

psShrinkLarger yes | no
If set to yes, PDF pages larger than the PostScript imageable area are shrunk to fit the imageable
area. Otherwise, no scaling is done on larger pages. This defaults to "yes".

psDuplex yes | no
If set to "yes", the generated PostScript will set the "Duplex" pagedevice entry. This tells
duplex-capable printers to enable duplexing. This defaults to "no".

psFile file-or-command
Sets the default PostScript file or print command for xpdf. Commands start with a '|' character;
anything else is a file. If the file name or command contains spaces it must be quoted. This
defaults to unset, which tells xpdf to generate a name of the form <file>.ps for a PDF file
<file>.pdf.

TEXT CONTROL

       textEncoding encoding-name
              Sets  the  encoding to use for text output.  (This can be overridden with the "-enc" switch on the
              command line.)  The encoding-name must be defined with the unicodeMap command (see  above).   This
              defaults to "Latin1".

MISCELLANEOUS SETTINGS

initialZoom percentage | page | width | height
Sets the initial zoom factor. A number specifies a zoom percentage, where 100 means 72 dpi. You
may also specify 'page', to fit the page to the window size, 'width', to fit the page width to the
window width, or 'height', to fit the page height to the window height.

continuousView yes | no
If set to "yes", xpdf will start in continuous view mode, i.e., with one vertical screoll bar for
the whole document. This defaults to "no".

overprintPreview yes | no
If set to "yes", generate overprint preview output, honoring the OP/op/OPM settings in the PDF
file. Ignored for non-CMYK output. The default value is "no".

launchCommand command
Sets the command executed when you click on a "launch"-type link. The intent is for the command
to be a program/script which determines the file type and runs the appropriate viewer. The
command line will consist of the file to be launched, followed by any parameters specified with
the link. Do not use "%s" in "command". By default, this is unset, and Xpdf will simply try to
execute the file (after prompting the user).

urlCommand command
Sets the command executed when you click on a URL link. The string "%s" will be replaced with the
URL. (See the example below.) This has no default value.

movieCommand command
Sets the command executed when you click on a movie annotation. The string "%s" will be replaced
with the movie file name. This has no default value.

bind modifiers-key context command ...
Add a key or mouse button binding. Modifiers can be zero or more of:

shift-
ctrl-

alt-
Key can be a regular ASCII character, or any one of:

space
tab
return
enter
backspace
insert
delete
home
end
pgup
pgdn
left / right / up / down (arrow keys)
f1 .. f35 (function keys)
mousePress1 .. mousePress7 (mouse buttons)
mouseRelease1 .. mouseRelease7 (mouse buttons)

Context is either "any" or a comma-separated combination of:

fullScreen / window (full screen mode on/off)
continuous / singlePage (continuous mode on/off)
overLink / offLink (mouse over link or not)
scrLockOn / scrLockOff (scroll lock on/off)

The context string can include only one of each pair in the above list.

Command is an Xpdf command (see the COMMANDS section of the xpdf(1) man page for details).
Multiple commands are separated by whitespace.

The bind command replaces any existing binding, but only if it was defined for the exact same
modifiers, key, and context. All tokens (modifiers, key, context, commands) are case-sensitive.

Example key bindings:

# bind ctrl-a in any context to the nextPage
# command
bind ctrl-a any nextPage

# bind uppercase B, when in continuous mode
# with scroll lock on, to the reload command
# followed by the prevPage command
bind B continuous,scrLockOn reload prevPage

See the xpdf(1) man page for more examples.

unbind modifiers-key context
Removes a key binding established with the bind command. This is most useful to remove default
key bindings before establishing new ones (e.g., if the default key binding is given for "any"
context, and you want to create new key bindings for multiple contexts).

printCommands yes | no
If set to "yes", drawing commands are printed as they're executed (useful for debugging). This
defaults to "no".

errQuiet yes | no
If set to "yes", this suppresses all error and warning messages from all of the Xpdf tools. This
defaults to "no".

OBSOLETE CONFIGURATION OPTIONS

The following options were accepted by earlier versions of Xpdf but are no longer allowed. In most
cases, this is because they control rendering options that Poppler does not support, or they were only
used by tools other than Xpdf itself.

antialias yes | no
Obsolete. Controlled the use of font anti-aliasing in the PDF rasterizer.

antialiasPrinting yes | no
Obsolete. Controlled the use of font anti-aliasing when printing.

cidToUnicode
Obsolete. Specified a file with the mapping from character collection to Unicode.

cMapDir registry-ordering dir
Obsolete. Specified a search directory for CMaps for a character collection.

disableFreeTypeHinting yes | no
Obsolete. Forced FreeType hinting to be disabled.

displayCIDFontX registry-ordering XLFD encoding-name
Obsolete. Mapped a character collection to an X font for display.

displayFontX PDF-font-name XLFD encoding-name
Obsolete. Mapped a PDF font to an X font for display.

displayNamedCIDFontX PDF-font-name XLFD encoding-name
Obsolete. Mapped a PDF CID font to an X font for display.

drawAnnotations yes | no
Obsolete. Controlled whether annotations would be drawn or printed.

enableFreeType yes | no
Obsolete. Controlled whether FreeType was used for font rasterization.

enableT1lib yes | no
Obsolete. Controlled whether t1lib was used for font rasterization.

enableXFA yes | no
Obsolete. Controlled whether XFA forms were rendered in place of AcroForms.

fontDir dir
Obsolete. Specified a search directory for font files.

fontFileCC registry-ordering font-file
Obsolete. Mapped a character collection to a font.

fontmap
Obsolete. From the configuration file format used before Xpdf 1.0.

fontpath
Obsolete. From the configuration file format used before Xpdf 1.0.

freetypeControl none | plain | low | high
Obsolete. Set the type of font rendering for FreeType to use.

mapExtTrueTypeFontsViaUnicode yes | no
Obsolete. Controlled how character codes were mapped when using external TrueType fonts.

mapNumericCharNames yes | no
Obsolete. Controlled how numeric character names in font subsets were mapped.

mapUnknownCharNames yes | no
Obsolete. Controlled how unrecognized glyph names were mapped.

minLineWidth float
Obsolete. Set the minimum line width during rasterization.

nameToUnicode map-file
Obsolete. Specified a file with the mapping from character names to Unicode.

psASCIIHex yes | no
Obsolete. Controlled whether the ASCIIHexEncode filter was be used for binary data in PostScript
output.

psAlwaysRasterize yes | no
Obsolete. Controlled whether all PostScript output would be rasterized.

psCenter yes | no
Obsolete. Controlled whether small PDF pages were centered in PostScript output.

psEmbedCIDPostScriptFonts yes | no
Obsolete. Prevented embedding of CID PostScript fonts in PostScript output.

psEmbedCIDTrueTypeFonts yes | no
Obsolete. Prevented embedding of CID TrueType fonts in PostScript output.

psEmbedTrueTypeFonts yes | no
Obsolete. Prevented embedding of TrueType fonts in PostScript output.

psEmbedType1Fonts yes | no
Obsolete. Prevented embedding of Type 1 fonts in PostScript output.

psFontPassthrough yes | no
Obsolete. Caused 8-bit font names to be passed through to the PostScript output without
substitution.

psLZW yes | no
Obsolete. Controlled whether the LZWEncode filter was used for lossless compression in PostScript
output.

psMinLineWidth float
Obsolete. Set the minimum line width for PostScript output.

psOPI yes | no
Obsolete. Generated PostScript OPI comments for all images and forms which have OPI information.

psPreload yes | no
Obsolete. Controlled whether forms and images were preloaded in PostScript output.

psRasterMono yes | no
Obsolete. Made rasterized pages in PS files monochrome instead of color.

psRasterResolution float
Obsolete. Set the resolution for rasterized pages in PostScript output.

psRasterSliceSize pixels
Obsolete. Set the maximum slice size used in rasterized PostScript output.

psResidentFont PDF-font-name PS-font-name
Obsolete. Indicated additional printer-resident PostScript fonts.

psResidentFont16 PDF-font-name wMode PS-font-name encoding
Obsolete. Indicated additional printer-resident PostScript fonts.

psResidentFontCC registry-ordering wMode PS-font-name encoding
Obsolete. Indicated additional printer-resident PostScript fonts.

psUncompressPreloadedImages yes | no
Obsolete. Made all preloaded images in PostScript files uncompressed.

psUseCropBoxAsPage yes | no
Obsolete. Controlled whether PostScript output treats the CropBox as the page size.

screenBlackThreshold float
Obsolete. Set the black threshold for halftoning.

screenDotRadius integer
Obsolete. Set the halftone screen dot radius.

screenGamma float
Obsolete. Set the halftone screen gamma correction parameter.

screenSize integer
Obsolete. Set the size of the halftone screen threshold matrix.

screenType dispersed | clustered | stochasticClustered
Obsolete. Set the halftone screen type when generating 1-bit bitmaps.

screenWhiteThreshold float
Obsolete. Set the white threshold for halftoning.

strokeAdjust yes | no
Obsolete. Controlled the use of stroke adjustment during antialiasing.

t1libControl none | plain | low | high
Obsolete. Set the type of font rendering for t1lib to use.

textEOL unix | dos | mac
Obsolete. Set the end-of-line convention to use for text output.

textKeepTinyChars yes | no
Obsolete. Controlled whether very small characters were discarded in text output.

textPageBreaks yes | no
Obsolete. Controlled whether page breaks were represented as form feed characters in text output.

toUnicodeDir dir
Obsolete. Specified a search directory for ToUnicode CMaps.

unicodeMap encoding-name map-file
Obsolete. Specified a mapping file from Unicode to a text output encoding.

unicodeToUnicode font-name-substring map-file
Obsolete. Specified a mapping file to work around PDF fonts which have incorrect Unicode
information.

vectorAntialias yes | no
Obsolete. Controlled anti-aliasing of vector graphics during rasterization.

EXAMPLES

       The following is a sample xpdfrc file.

       # use the Base-14 Type 1 fonts from ghostscript
       fontFile Times-Roman           /usr/local/share/ghostscript/fonts/n021003l.pfb
       fontFile Times-Italic          /usr/local/share/ghostscript/fonts/n021023l.pfb
       fontFile Times-Bold            /usr/local/share/ghostscript/fonts/n021004l.pfb
       fontFile Times-BoldItalic      /usr/local/share/ghostscript/fonts/n021024l.pfb
       fontFile Helvetica             /usr/local/share/ghostscript/fonts/n019003l.pfb
       fontFile Helvetica-Oblique     /usr/local/share/ghostscript/fonts/n019023l.pfb
       fontFile Helvetica-Bold        /usr/local/share/ghostscript/fonts/n019004l.pfb
       fontFile Helvetica-BoldOblique /usr/local/share/ghostscript/fonts/n019024l.pfb
       fontFile Courier               /usr/local/share/ghostscript/fonts/n022003l.pfb
       fontFile Courier-Oblique       /usr/local/share/ghostscript/fonts/n022023l.pfb
       fontFile Courier-Bold          /usr/local/share/ghostscript/fonts/n022004l.pfb
       fontFile Courier-BoldOblique   /usr/local/share/ghostscript/fonts/n022024l.pfb
       fontFile Symbol                /usr/local/share/ghostscript/fonts/s050000l.pfb
       fontFile ZapfDingbats          /usr/local/share/ghostscript/fonts/d050000l.pfb

       # set some PostScript options
       psPaperSize          letter
       psDuplex             no
       psLevel              level2
       psFile               "| lpr -Pprinter5"

       # set the text output options
       textEncoding UTF-8

       # misc options
       launchCommand   viewer-script
       urlCommand      "netscape -remote 'openURL(%s)'"

FILES

       /etc/xpdf/xpdfrc
              This is the default location for the system-wide configuration file.  Depending on build  options,
              it may be placed elsewhere.

       $HOME/.xpdfrc
              This  is the user's configuration file.  If it exists, it will be read in place of the system-wide
              file.

AUTHORS

       The original Xpdf software and documentation are copyright 1996–2014 Glyph & Cog, LLC.  Modifications for
       Poppler support and further development were done by the Debian  and  Gentoo  Xpdf  maintainers,  and  by
       xpopple contributors.