xpdfrc.cat

source code: Covert TXT to PDF

xpdfrc(5)                                               xpdfrc(5)


NAME
       xpdfrc - configuration file for Xpdf tools (version 2.01)

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 exe-
       cutables.

       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 exam-
       ples section at the end.

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 deep.

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



                         05 December 2002                       1





xpdfrc(5)                                               xpdfrc(5)


              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 speci-
              fied file is used.  There are no built-in cidToUni-
              code mappings.

       unicodeMap encoding-name map-file
              Specifies  the  file  with  mapping from Unicode to
              encoding-name.  These encodings are used for X dis-
              play  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 sin-
              gle in-hex field) specify the Unicode  range.   The
              out-start-hex  field  (or the out-hex field) speci-
              fies 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  speci-
              fied  file  is  used.   The Latin1, ASCII7, Symbol,
              ZapfDingbats, UTF-8, and UCS-2 encodings are prede-
              fined.

       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 col-
              lection.  There are no default CMap directories.

       toUnicodeDir dir
              Specifies a search directory,  dir,  for  ToUnicode
              CMaps.   There  can  be multiple ToUnicode directo-
              ries.  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  "%s",  which  will be
              replaced by xpdf with the font size.  If  the  XLFD
              contains   spaces   it   must   be   quoted.    The



                         05 December 2002                       2





xpdfrc(5)                                               xpdfrc(5)


              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.

       displayNamedCIDFontX PDF-font-name XLFD encoding-name
              Maps    a   specific   PDF   CID   (16-bit)   font,
              PDF-font-name, 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.

       displayCIDFontX registry-ordering XLFD encoding-name
              Maps  the registry-ordering character collection to
              the X font, XLFD, for  display.   This  mapping  is
              used  if  the  font  name  doesn't match any of the
              fonts declared with displayNamedCIDFont*  commands.
              The encoding given by encoding-name must be defined
              with the unicodeMap command.  There are no  default
              display CID font mappings.

       displayNamedCIDFontT1 PDF-font-name T1-file
              Maps    a   specific   PDF   CID   (16-bit)   font,
              PDF-font-name, to a  CID  font  (16-bit  PostScript
              font),  for display.  There are no default CID font
              mappings.

       displayCIDFontT1 registry-ordering T1-file
              Maps the registry-ordering character collection  to
              a  CID  font (16-bit PostScript font), for display.
              This mapping is used if the font name doesn't match
              any of the fonts declared with displayNamedCIDFont*
              commands.  There are no default 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  gener-
              ated  PostScript).   Only  files  with  suffixes of
              ".pfa", ".pfb", or ".ttf" will be used; other files
              in these directories will be ignored.  There are no



                         05 December 2002                       3





xpdfrc(5)                                               xpdfrc(5)


              default fontDir directories.

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  "letter"
              or "A4".

       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".

       psLevel level1 | level1sep  |  level2  |  level2sep  |
              level3  | level3Sep
              Sets  the  PostScript  level  to  generate.    This
              defaults to "level2".

       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.

       psNamedFont16 PDF-font-name wMode PS-font-name encoding
              When the 16-bit font PDF-font-name is used in a PDF
              file  with the wMode writing mode and is not embed-
              ded, the PS-font-name font is substituted  for  it.
              The  writing mode must be either 'H' for horizontal
              or 'V' for  vertical.   The  PS-font-name  font  is
              assumed  to  be  resident in the printer and to use
              the  specified  encoding  (which  must  have   been
              defined with the unicodeMap command).

       psFont16 registry-ordering wMode PS-font-name encoding
              When  a  16-bit  font  using  the registry-ordering
              character collection and wMode writing mode is  not
              embedded  and  does  not  match  any  of  the fonts
              declared    in    psNamedFont16    commands,    the
              PS-font-name font is substituted for it.  The writ-
              ing mode must be either 'H' for horizontal  or  'V'
              for  vertical.  The PS-font-name font is assumed to
              be resident in the printer and to use the specified
              writing  mode  and  encoding  (which must have been
              defined with the unicodeMap command).



                         05 December 2002                       4