View Source: xpdfrc(5) - Waikato Linux Users Group

Edit PageHistory Diff Info LikePages
xpdfrc
!!!xpdfrc
NAME
DESCRIPTION
CHARACTER MAPPING
DISPLAY FONTS
POSTSCRIPT CONTROL
TEXT CONTROL
MISCELLANEOUS SETTINGS
EXAMPLES
FILES
AUTHOR
SEE ALSO
----
!!NAME


xpdfrc - configuration file for Xpdf tools (version 1.00)
!!DESCRIPTION


All of the Xpdf tools read 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 ''/usr/local/etc/xpdfrc'', if it
exists. (This is its default location; depending on build
options, it may be placed elsewhere.) On Win32 systems, the
''xpdfrc'' file should be placed in the same directory as
the executables.


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


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


__nameToUnicode__ ''map-file''


Specifies a file with the mapping from character names to
Unicode. This is used to handle PDF fonts that have valid
encodings but no !ToUnicode entry. Each line of a
nameToUnicode file looks like this:


''hex-string name''


The ''hex-string'' is the Unicode (UCS-2) character
index, and ''name'' is the corresponding character name.
Multiple nameToUnicode files can be used; if a character
name is given more than once, the code in the last specified
file is used. There is a built-in default nameToUnicode
table with all of Adobe's standard character
names.


__cidToUnicode__ ''registry-ordering
map-file''


Specifies the file with the mapping from character
collection to Unicode. Each line of a cidToUnicode file
represents one character:


''hex-string''


The ''hex-string'' is the Unicode (UCS-2) index for that
character. The first line maps CID 0, the second line CID 1,
etc. File size is determined by size of the character
collection. Only one file is allowed per character
collection; the last specified file is used. There are no
built-in cidToUnicode mappings.


__unicodeMap__ ''encoding-name map-file''


Specifies the file with mapping from Unicode to
''encoding-name''. These encodings are used for X display
fonts and text output (see below). Each line of a unicodeMap
file represents a range of one or more Unicode characters
which maps linearly to a range in the output
encoding:


''     in-start-hex in-end-hex out-start-hex
''Entries for single characters can be abbreviated to:


''     in-hex out-hex
''The ''in-start-hex'' and ''in-end-hex'' fields (or the single ''in-hex'' field) specify the Unicode range. The ''out-start-hex'' field (or the ''out-hex'' field) specifies the start of the output encoding range. The length of the ''out-start-hex'' (or ''out-hex'') string determines the length of the output characters (e.g., UTF-8 uses different numbers of bytes to represent characters in different ranges). Entries must be given in increasing Unicode order. Only one file is allowed per encoding; the last specified file is used. The ''Latin1'', ''ASCII7'', ''Symbol'', ''!ZapfDingbats'', and ''UTF-8'' encodings are predefined.


__cMapDir__ ''registry-ordering dir''


Specifies a search directory, ''dir'', for CMaps for the
''registry-ordering'' character collection. There can be
multiple directories for a particular collection. There are
no default CMap directories.


__toUnicodeDir__ ''dir''


Specifies a search directory, ''dir'', for !ToUnicode
CMaps. There can be multiple !ToUnicode directories. There
are no default !ToUnicode directories.
!!DISPLAY FONTS


__displayFontX__ ''PDF-font-name XLFD
encoding-name''


Maps a PDF font, ''PDF-font-name'', to an X font,
''XLFD'', for display. The XLFD (X Logical Font
Descriptor) should contain the string
''encoding-name''
must be defined with the ''unicodeMap'' command (see
above). By default, the Base-14 fonts are mapped to standard
X fonts, using the ''Latin1'', ''Symbol'', and
''!ZapfDingbats'' encodings.


__displayFontT1__ ''PDF-font-name
T1-file''


Maps a PDF font, ''PDF-font-name'', to a Type 1 font for
display. The Type 1 font file, ''T1-file'', should be a
standard .pfa or .pfb file.


__displayFontTT__ ''PDF-font-name
TT-file''


Maps a PDF font, ''PDF-font-name'', to a !TrueType font
for display. The !TrueType font file, ''TT-file'', should
be a standard .ttf file.


__displayCIDFontX__ ''registry-ordering XLFD
encoding-name''


Maps the ''registry-ordering'' character collection to
the X font, ''XLFD'', for display. The encoding given by
''encoding-name'' must be defined with the unicodeMap
command. There are no default display CID font
mappings.


__fontDir__ ''dir''


Specifies a search directory for external font files. There
can be multiple fontDir directories. If a PDF file uses a
font but doesn't embed it, these directories will be
searched for a matching font file. These fonts are used by
both xpdf (for display) and pdftops (for embedding in the
generated !PostScript). Only files with suffixes of
!!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.


__psPaperSize__ letter | legal | A4 | A3


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


__psDuplex__ yes | no


If set to


__psLevel__ level1 | level1sep | level2 |
level2sep


Sets the !PostScript level to generate. This defaults to


__psFont__ ''PDF-font-name PS-font-name''


When the ''PDF-font-name'' font is used in a PDF file, it
will be translated to the !PostScript font
''PS-font-name'', which is assumed to be resident in the
printer. Typically, ''PDF-font-name'' and
''PS-font-name'' are the same. By default, only the
Base-14 fonts are assumed to be resident.


__psEmbedType1Fonts__ yes | no


If set to


__psEmbedTrueTypeFonts__ yes | no


If set to


__psOPI__ yes | no


If set to


__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


__fontDir__ ''dir''


See the description above, in the DISPLAY FONTS
section.
!!TEXT CONTROL


__textEncoding__ ''encoding-name''


Sets the encoding to use for text output. (This can be
overridden with the
encoding-name'' must be defined with the
unicodeMap command (see above). This defaults to
''


__textEOL__ unix | dos | mac


Sets the end-of-line convention to use for text output. The
options are:


unix = LF
dos  = CR+LF
mac  = CR
(This can be overridden with the
!!MISCELLANEOUS SETTINGS


__t1libControl__ none | plain | low | high


Sets the type of font rendering for t1lib (the Type 1
rasterizer) to use. Options are


__freetypeControl__ none | plain | low |
high


Sets the type of font rendering for !FreeType (the !TrueType
rasterizer) to use. Options are


__urlCommand__ ''command''


Sets the command executed when you click on a URL link. The
string


__mapNumericCharNames__ ''yes | no''


If set to


__errQuiet__ ''yes | no''


If set to
!!EXAMPLES


The following is a sample xpdfrc file.


# from the Thai support package
nameToUnicode /usr/local/share/xpdf/Thai.nameToUnicode
# from the Japanese support package
cidToUnicode Adobe-Japan1 /usr/local/share/xpdf/Adobe-Japan1.cidToUnicode
unicodeMap   JISX0208     /usr/local/share/xpdf/JISX0208.unicodeMap
cMapDir      Adobe-Japan1 /usr/local/share/xpdf/cmap/Adobe-Japan1
# use an X server font for Times-Roman
# (this is the built-in default)
displayFontX Times-Roman
!!FILES


__/usr/local/etc/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.
!!AUTHOR


The Xpdf software and documentation are copyright 1996-2002
Derek B. Noonburg (derekn@foolabs.com).
!!SEE ALSO


xpdf(1), pdftops(1), pdftotext(1),
pdfinfo(1), pdftopbm(1),
pdfimages(1)__
http://www.foolabs.com/xpdf/__
----
9 pages link to xpdfrc(5):
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
Last edited on Tuesday, June 4, 2002 12:30:42 am by "perry"
Edit PageHistory Diff Info LikePages