summaryrefslogtreecommitdiff
path: root/Build/source/libs/xpdf/xpdf-3.02/doc/xpdfrc.cat
diff options
context:
space:
mode:
Diffstat (limited to 'Build/source/libs/xpdf/xpdf-3.02/doc/xpdfrc.cat')
-rw-r--r--Build/source/libs/xpdf/xpdf-3.02/doc/xpdfrc.cat614
1 files changed, 614 insertions, 0 deletions
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/xpdfrc.cat b/Build/source/libs/xpdf/xpdf-3.02/doc/xpdfrc.cat
new file mode 100644
index 00000000000..3201f091c5a
--- /dev/null
+++ b/Build/source/libs/xpdf/xpdf-3.02/doc/xpdfrc.cat
@@ -0,0 +1,614 @@
+xpdfrc(5) xpdfrc(5)
+
+
+
+NAME
+ xpdfrc - configuration file for Xpdf tools (version 3.02)
+
+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 deeply.
+
+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 speci-
+ fied file is used. There are no built-in cidToUni-
+ code mappings.
+
+ unicodeToUnicode font-name-substring map-file
+ This is used to work around PDF fonts which have
+ incorrect Unicode information. It specifies a file
+ which maps from the given (incorrect) Unicode
+ indexes to the correct ones. The mapping will be
+ used for any font whose name contains
+ font-name-substring. Each line of a unicodeToUni-
+ code file represents one Unicode character:
+
+ in-hex out-hex1 out-hex2 ...
+
+ The in-hex field is an input (incorrect) Unicode
+ index, and the rest of the fields are one or more
+ output (correct) Unicode indexes. Each occurrence
+ of in-hex will be converted to the specified output
+ sequence.
+
+ 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
+ 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.
+
+ 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.
+
+ displayNamedCIDFontTT PDF-font-name TT-file
+ Maps a specific PDF CID (16-bit) font,
+ PDF-font-name, to a (16-bit) TrueType font, for
+ display. There are no default CID font mappings.
+
+ displayCIDFontTT registry-ordering TT-file
+ Maps the registry-ordering character collection to
+ a (16-bit) TrueType font, for display. This map-
+ ping is used if the font name doesn't match any of
+ the fonts declared with displayNamedCIDFont* com-
+ mands. 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). Type 1 fonts must have a suffix
+ of ".pfa", ".pfb", ".ps", or no suffix at all.
+ TrueType fonts must have a ".ttf" suffix. Other
+ files in these directories will be ignored. There
+ are no 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 (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".
+
+ psCenter yes | no
+ If set to yes, PDF pages smaller than the
+ PostScript imageable area (after any scaling) are
+ centered in the imageable area. Otherwise, they
+ are aligned at the lower-left corner of the image-
+ able area. 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".
+
+ 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).
+
+ psEmbedType1Fonts yes | no
+ If set to "no", prevents embedding of Type 1 fonts
+ in generated PostScript. This defaults to "yes".
+
+ psEmbedTrueTypeFonts yes | no
+ If set to "no", prevents embedding of TrueType
+ fonts in generated PostScript. This defaults to
+ "yes".
+
+ psEmbedCIDTrueTypeFonts yes | no
+ If set to "no", prevents embedding of CID TrueType
+ fonts in generated PostScript. For Level 3
+ PostScript, this generates a CID font, for lower
+ levels it generates a non-CID composite font.
+
+ psEmbedCIDPostScriptFonts yes | no
+ If set to "no", prevents embedding of CID
+ PostScript fonts in generated PostScript. For
+ Level 3 PostScript, this generates a CID font, for
+ lower levels it generates a non-CID composite font.
+
+ psPreload yes | no
+ If set to "yes", PDF forms are converted to PS pro-
+ cedures, and image data is preloaded. This uses
+ more memory in the PostScript interpreter, but gen-
+ erates significantly smaller PS files in situations
+ where, e.g., the same image is drawn on every page
+ of a long document. This defaults to "no".
+
+ psOPI yes | no
+ If set to "yes", generates PostScript OPI comments
+ for all images and forms which have OPI informa-
+ tion. This option is only available if the Xpdf
+ tools were compiled with OPI support. This
+ defaults to "no".
+
+ psASCIIHex yes | no
+ If set to "yes", the ASCIIHexEncode filter will be
+ used instead of ASCII85Encode for binary data.
+ 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 com-
+ mand 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.
+
+ 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 "-enc" switch on the
+ command line.) The encoding-name must be defined
+ with the unicodeMap command (see above). This
+ defaults to "Latin1".
+
+ 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 "-eol" switch on
+ the command line.) The default value is based on
+ the OS where xpdf and pdftotext were built.
+
+ textPageBreaks yes | no
+ If set to "yes", text extraction will insert page
+ breaks (form feed characters) between pages. This
+ defaults to "yes".
+
+ textKeepTinyChars yes | no
+ If set to "yes", text extraction will keep all
+ characters. If set to "no", text extraction will
+ discard tiny (smaller than 3 point) characters
+ after the first 50000 per page, avoiding extremely
+ slow run times for PDF files that use special fonts
+ to do shading or cross-hatching. This defaults to
+ "no".
+
+MISCELLANEOUS SETTINGS
+ initialZoom percentage | page | width
+ 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, or 'width', to fit the page width to the win-
+ dow width.
+
+ 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".
+
+ enableT1lib yes | no
+ Enables or disables use of t1lib (a Type 1 font
+ rasterizer). This is only relevant if the Xpdf
+ tools were built with t1lib support.
+ ("enableT1lib" replaces the old "t1libControl"
+ option.) This option defaults to "yes".
+
+ enableFreeType yes | no
+ Enables or disables use of FreeType (a TrueType /
+ Type 1 font rasterizer). This is only relevant if
+ the Xpdf tools were built with FreeType support.
+ ("enableFreeType" replaces the old "freetypeCon-
+ trol" option.) This option defaults to "yes".
+
+ antialias yes | no
+ Enables or disables font anti-aliasing in the PDF
+ rasterizer. This option affects all font rasteriz-
+ ers. ("antialias" replaces the anti-aliasing con-
+ trol provided by the old "t1libControl" and
+ "freetypeControl" options.) This default to "yes".
+
+ vectorAntialias yes | no
+ Enables or disables anti-aliasing of vector graph-
+ ics in the PDF rasterizer. This defaults to "yes".
+
+ strokeAdjust yes | no
+ Enables or disables stroke adjustment. This
+ defaults to "yes".
+
+ screenType dispersed | clustered | stochasticClustered
+ Sets the halftone screen type, which will be used
+ when generating a monochrome (1-bit) bitmap. The
+ three options are dispersed-dot dithering, clus-
+ tered-dot dithering (with a round dot and 45-degree
+ screen angle), and stochastic clustered-dot dither-
+ ing. By default, "stochasticClustered" is used for
+ resolutions of 300 dpi and higher, and "dispersed"
+ is used for resolutions lower then 300 dpi.
+
+ screenSize integer
+ Sets the size of the (square) halftone screen
+ threshold matrix. By default, this is 4 for dis-
+ persed-dot dithering, 10 for clustered-dot dither-
+ ing, and 100 for stochastic clustered-dot dither-
+ ing.
+
+ screenDotRadius integer
+ Sets the halftone screen dot radius. This is only
+ used when screenType is set to stochasticClustered,
+ and it defaults to 2. In clustered-dot mode, the
+ dot radius is half of the screen size. Dispersed-
+ dot dithering doesn't have a dot radius.
+
+ screenGamma float
+ Sets the halftone screen gamma correction parame-
+ ter. Gamma values greater than 1 make the output
+ brighter; gamma values less than 1 make it darker.
+ The default value is 1.
+
+ screenBlackThreshold float
+ When halftoning, all values below this threshold
+ are forced to solid black. This parameter is a
+ floating point value between 0 (black) and 1
+ (white). The default value is 0.
+
+ screenWhiteThreshold float
+ When halftoning, all values above this threshold
+ are forced to solid white. This parameter is a
+ floating point value between 0 (black) and 1
+ (white). The default value is 1.
+
+ 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.
+
+ mapNumericCharNames yes | no
+ If set to "yes", the Xpdf tools will attempt to map
+ various numeric character names sometimes used in
+ font subsets. In some cases this leads to usable
+ text, and in other cases it leads to gibberish --
+ there is no way for Xpdf to tell. This defaults to
+ "yes".
+
+ mapUnknownCharNames yes | no
+ If set to "yes", and mapNumericCharNames is set to
+ "no", the Xpdf tools will apply a simple pass-
+ through mapping (Unicode index = character code)
+ for all unrecognized glyph names. In some cases,
+ this leads to usable text, and in other cases it
+ leads to gibberish -- there is no way for Xpdf to
+ tell. This defaults to "no".
+
+ 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 combi-
+ nation 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 sec-
+ tion of the xpdf(1) man page for details). Multi-
+ ple commands are separated by whitespace.
+
+ The bind command replaces any existing binding, but
+ only if it was defined for the exact same modi-
+ fiers, 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".
+
+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 the Base-14 Type 1 fonts from ghostscript
+ displayFontT1 Times-Roman /usr/local/share/ghostscript/fonts/n021003l.pfb
+ displayFontT1 Times-Italic /usr/local/share/ghostscript/fonts/n021023l.pfb
+ displayFontT1 Times-Bold /usr/local/share/ghostscript/fonts/n021004l.pfb
+ displayFontT1 Times-BoldItalic /usr/local/share/ghostscript/fonts/n021024l.pfb
+ displayFontT1 Helvetica /usr/local/share/ghostscript/fonts/n019003l.pfb
+ displayFontT1 Helvetica-Oblique /usr/local/share/ghostscript/fonts/n019023l.pfb
+ displayFontT1 Helvetica-Bold /usr/local/share/ghostscript/fonts/n019004l.pfb
+ displayFontT1 Helvetica-BoldOblique /usr/local/share/ghostscript/fonts/n019024l.pfb
+ displayFontT1 Courier /usr/local/share/ghostscript/fonts/n022003l.pfb
+ displayFontT1 Courier-Oblique /usr/local/share/ghostscript/fonts/n022023l.pfb
+ displayFontT1 Courier-Bold /usr/local/share/ghostscript/fonts/n022004l.pfb
+ displayFontT1 Courier-BoldOblique /usr/local/share/ghostscript/fonts/n022024l.pfb
+ displayFontT1 Symbol /usr/local/share/ghostscript/fonts/s050000l.pfb
+ displayFontT1 ZapfDingbats /usr/local/share/ghostscript/fonts/d050000l.pfb
+
+ # use the Bakoma Type 1 fonts
+ # (this assumes they happen to be installed in /usr/local/fonts/bakoma)
+ fontDir /usr/local/fonts/bakoma
+
+ # set some PostScript options
+ psPaperSize letter
+ psDuplex no
+ psLevel level2
+ psEmbedType1Fonts yes
+ psEmbedTrueTypeFonts yes
+ psFile "| lpr -Pprinter5"
+
+ # assume that the PostScript printer has the Univers and
+ # Univers-Bold fonts
+ psFont Univers Univers
+ psFont Univers-Bold Univers-Bold
+
+ # set the text output options
+ textEncoding UTF-8
+ textEOL unix
+
+ # misc options
+ t1libControl low
+ freetypeControl low
+ urlCommand "netscape -remote 'openURL(%s)'"
+
+
+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-2007 Glyph & Cog, LLC.
+
+SEE ALSO
+ xpdf(1), pdftops(1), pdftotext(1), pdfinfo(1),
+ pdftoppm(1), pdfimages(1)
+ http://www.foolabs.com/xpdf/
+
+
+
+ 27 February 2007 xpdfrc(5)