diff options
Diffstat (limited to 'Build/source/libs/xpdf/xpdf-3.02/doc')
25 files changed, 6951 insertions, 0 deletions
diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdffonts.1 b/Build/source/libs/xpdf/xpdf-3.02/doc/pdffonts.1 new file mode 100644 index 00000000000..4cb3059c95d --- /dev/null +++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdffonts.1 @@ -0,0 +1,142 @@ +.\" Copyright 1999-2007 Glyph & Cog, LLC +.TH pdffonts 1 "27 February 2007" +.SH NAME +pdffonts \- Portable Document Format (PDF) font analyzer (version +3.02) +.SH SYNOPSIS +.B pdffonts +[options] +.RI [ PDF-file ] +.SH DESCRIPTION +.B Pdffonts +lists the fonts used in a Portable Document Format (PDF) file along +with various information for each font. +.PP +The following information is listed for each font: +.TP +.B name +the font name, exactly as given in the PDF file (potentially including +a subset prefix) +.TP +.B type +the font type -- see below for details +.TP +.B emb +"yes" if the font is embedded in the PDF file +.TP +.B sub +"yes" if the font is a subset +.TP +.B uni +"yes" if there is an explicit "ToUnicode" map in the PDF file (the +absence of a ToUnicode map doesn't necessarily mean that the text +can't be converted to Unicode) +.TP +.B object ID +the font dictionary object ID (number and generation) +.PP +PDF files can contain the following types of fonts: +.PP +.RS +Type 1 +.RE +.RS +Type 1C -- aka Compact Font Format (CFF) +.RE +.RS +Type 1C (OT) -- OpenType with 8-bit CFF data +.RE +.RS +Type 3 +.RE +.RS +TrueType +.RE +.RS +TrueType (OT) -- OpenType with 8-bit TrueType data +.RE +.RS +CID Type 0 -- 16-bit font with no specified type +.RE +.RS +CID Type 0C -- 16-bit PostScript CFF font +.RE +.RS +CID Type 0C (OT) -- OpenType with CID CFF data +.RE +.RS +CID TrueType -- 16-bit TrueType font +.RE +.RS +CID TrueType (OT) -- OpenType with CID TrueType data +.RE +.SH CONFIGURATION FILE +Pdffonts reads a configuration file at startup. It first tries to +find the user's private config file, ~/.xpdfrc. If that doesn't +exist, it looks for a system-wide config file, typically +/usr/local/etc/xpdfrc (but this location can be changed when pdffonts +is built). See the +.BR xpdfrc (5) +man page for details. +.SH OPTIONS +Many of the following options can be set with configuration file +commands. These are listed in square brackets with the description of +the corresponding command line option. +.TP +.BI \-f " number" +Specifies the first page to analyze. +.TP +.BI \-l " number" +Specifies the last page to analyze. +.TP +.BI \-opw " password" +Specify the owner password for the PDF file. Providing this will +bypass all security restrictions. +.TP +.BI \-upw " password" +Specify the user password for the PDF file. +.TP +.BI \-cfg " config-file" +Read +.I config-file +in place of ~/.xpdfrc or the system-wide config file. +.TP +.B \-v +Print copyright and version information. +.TP +.B \-h +Print usage information. +.RB ( \-help +and +.B \-\-help +are equivalent.) +.SH EXIT CODES +The Xpdf tools use the following exit codes: +.TP +0 +No error. +.TP +1 +Error opening a PDF file. +.TP +2 +Error opening an output file. +.TP +3 +Error related to PDF permissions. +.TP +99 +Other error. +.SH AUTHOR +The pdffonts software and documentation are copyright 1996-2007 Glyph +& Cog, LLC. +.SH "SEE ALSO" +.BR xpdf (1), +.BR pdftops (1), +.BR pdftotext (1), +.BR pdfinfo (1), +.BR pdftoppm (1), +.BR pdfimages (1), +.BR xpdfrc (5) +.br +.B http://www.foolabs.com/xpdf/ diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdffonts.cat b/Build/source/libs/xpdf/xpdf-3.02/doc/pdffonts.cat new file mode 100644 index 00000000000..fa50dcfeb89 --- /dev/null +++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdffonts.cat @@ -0,0 +1,112 @@ +pdffonts(1) pdffonts(1) + + + +NAME + pdffonts - Portable Document Format (PDF) font analyzer + (version 3.02) + +SYNOPSIS + pdffonts [options] [PDF-file] + +DESCRIPTION + Pdffonts lists the fonts used in a Portable Document For- + mat (PDF) file along with various information for each + font. + + The following information is listed for each font: + + name the font name, exactly as given in the PDF file + (potentially including a subset prefix) + + type the font type -- see below for details + + emb "yes" if the font is embedded in the PDF file + + sub "yes" if the font is a subset + + uni "yes" if there is an explicit "ToUnicode" map in + the PDF file (the absence of a ToUnicode map + doesn't necessarily mean that the text can't be + converted to Unicode) + + object ID + the font dictionary object ID (number and genera- + tion) + + PDF files can contain the following types of fonts: + + Type 1 + Type 1C -- aka Compact Font Format (CFF) + Type 1C (OT) -- OpenType with 8-bit CFF data + Type 3 + TrueType + TrueType (OT) -- OpenType with 8-bit TrueType data + CID Type 0 -- 16-bit font with no specified type + CID Type 0C -- 16-bit PostScript CFF font + CID Type 0C (OT) -- OpenType with CID CFF data + CID TrueType -- 16-bit TrueType font + CID TrueType (OT) -- OpenType with CID TrueType + data + +CONFIGURATION FILE + Pdffonts reads a configuration file at startup. It first + tries to find the user's private config file, ~/.xpdfrc. + If that doesn't exist, it looks for a system-wide config + file, typically /usr/local/etc/xpdfrc (but this location + can be changed when pdffonts is built). See the xpdfrc(5) + man page for details. + +OPTIONS + Many of the following options can be set with configura- + tion file commands. These are listed in square brackets + with the description of the corresponding command line + option. + + -f number + Specifies the first page to analyze. + + -l number + Specifies the last page to analyze. + + -opw password + Specify the owner password for the PDF file. Pro- + viding this will bypass all security restrictions. + + -upw password + Specify the user password for the PDF file. + + -cfg config-file + Read config-file in place of ~/.xpdfrc or the sys- + tem-wide config file. + + -v Print copyright and version information. + + -h Print usage information. (-help and --help are + equivalent.) + +EXIT CODES + The Xpdf tools use the following exit codes: + + 0 No error. + + 1 Error opening a PDF file. + + 2 Error opening an output file. + + 3 Error related to PDF permissions. + + 99 Other error. + +AUTHOR + The pdffonts software and documentation are copyright + 1996-2007 Glyph & Cog, LLC. + +SEE ALSO + xpdf(1), pdftops(1), pdftotext(1), pdfinfo(1), + pdftoppm(1), pdfimages(1), xpdfrc(5) + http://www.foolabs.com/xpdf/ + + + + 27 February 2007 pdffonts(1) diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdffonts.hlp b/Build/source/libs/xpdf/xpdf-3.02/doc/pdffonts.hlp new file mode 100644 index 00000000000..f964dc1abfe --- /dev/null +++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdffonts.hlp @@ -0,0 +1,122 @@ +! Generated automatically by mantohlp +1 pdffonts + + pdffonts - Portable Document Format (PDF) font analyzer + (version + + pdffonts [options] [PDF-file] + + Pdffonts lists the fonts used in a Portable Document For- + mat (PDF) file along with various information for each + font. + + The following information is listed for each font: + + name the font name, exactly as given in the PDF file + (potentially including a subset prefix) + + type the font type -- see below for details + + emb "yes" if the font is embedded in the PDF file + + sub "yes" if the font is a subset + + uni "yes" if there is an explicit "ToUnicode" map in + the PDF file (the absence of a ToUnicode map + doesn't necessarily mean that the text can't be + converted to Unicode) + + object ID + the font dictionary object ID (number and genera- + tion) + + PDF files can contain the following types of fonts: + + Type 1 + Type 1C -- aka Compact Font Format (CFF) + Type 1C (OT) -- OpenType with 8-bit CFF data + Type 3 + TrueType + TrueType (OT) -- OpenType with 8-bit TrueType data + CID Type 0 -- 16-bit font with no specified type + CID Type 0C -- 16-bit PostScript CFF font + CID Type 0C (OT) -- OpenType with CID CFF data + CID TrueType -- 16-bit TrueType font + CID TrueType (OT) -- OpenType with CID TrueType + data + + () + +2 ONFIGURATION_FIL + + Pdffonts reads a configuration file at startup. It first + tries to find the user's private config file, ~/.xpdfrc. + If that doesn't exist, it looks for a system-wide config + file, typically /usr/local/etc/xpdfrc (but this location + can be changed when pdffonts is built). See the xpdfrc(5) + man page for details. + + () + +2 OPTIONS + + Many of the following options can be set with configura- + tion file commands. These are listed in square brackets + with the description of the corresponding command line + option. + + -f number + Specifies the first page to analyze. + + -l number + Specifies the last page to analyze. + + -opw password + Specify the owner password for the PDF file. Pro- + viding this will bypass all security restrictions. + + -upw password + Specify the user password for the PDF file. + + -cfg config-file + Read config-file in place of ~/.xpdfrc or the sys- + tem-wide config file. + + -v Print copyright and version information. + + -h Print usage information. (-help and --help are + equivalent.) + + () + +2 XIT_CODE + + The Xpdf tools use the following exit codes: + + 0 No error. + + 1 Error opening a PDF file. + + 2 Error opening an output file. + + 3 Error related to PDF permissions. + + 99 Other error. + + () + +2 AUTHOR + + The pdffonts software and documentation are copyright + 1996-2007 Glyph & Cog, LLC. + + () + +2 SEE_ALSO + + xpdf(1), pdftops(1), pdftotext(1), pdfinfo(1), + pdftoppm(1), pdfimages(1), xpdfrc(5) + http://www.foolabs.com/xpdf/ + + () + diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdfimages.1 b/Build/source/libs/xpdf/xpdf-3.02/doc/pdfimages.1 new file mode 100644 index 00000000000..844014799a7 --- /dev/null +++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdfimages.1 @@ -0,0 +1,102 @@ +.\" Copyright 1998-2007 Glyph & Cog, LLC +.TH pdfimages 1 "27 February 2007" +.SH NAME +pdfimages \- Portable Document Format (PDF) image extractor +(version 3.02) +.SH SYNOPSIS +.B pdfimages +[options] +.I PDF-file image-root +.SH DESCRIPTION +.B Pdfimages +saves images from a Portable Document Format (PDF) file as Portable +Pixmap (PPM), Portable Bitmap (PBM), or JPEG files. +.PP +Pdfimages reads the PDF file, scans one or more pages, +.IR PDF-file , +and writes one PPM, PBM, or JPEG file for each image, +.IR image-root - nnn . xxx , +where +.I nnn +is the image number and +.I xxx +is the image type (.ppm, .pbm, .jpg). +.PP +NB: pdfimages extracts the raw image data from the PDF file, without +performing any additional transforms. Any rotation, clipping, +color inversion, etc. done by the PDF content stream is ignored. +.SH CONFIGURATION FILE +Pdfimages reads a configuration file at startup. It first tries to +find the user's private config file, ~/.xpdfrc. If that doesn't +exist, it looks for a system-wide config file, typically +/usr/local/etc/xpdfrc (but this location can be changed when pdfimages +is built). See the +.BR xpdfrc (5) +man page for details. +.SH OPTIONS +Many of the following options can be set with configuration file +commands. These are listed in square brackets with the description of +the corresponding command line option. +.TP +.BI \-f " number" +Specifies the first page to scan. +.TP +.BI \-l " number" +Specifies the last page to scan. +.TP +.B \-j +Normally, all images are written as PBM (for monochrome images) or PPM +(for non-monochrome images) files. With this option, images in DCT +format are saved as JPEG files. All non-DCT images are saved in +PBM/PPM format as usual. +.TP +.BI \-opw " password" +Specify the owner password for the PDF file. Providing this will +bypass all security restrictions. +.TP +.BI \-upw " password" +Specify the user password for the PDF file. +.TP +.B \-q +Don't print any messages or errors. +.RB "[config file: " errQuiet ] +.TP +.B \-v +Print copyright and version information. +.TP +.B \-h +Print usage information. +.RB ( \-help +and +.B \-\-help +are equivalent.) +.SH EXIT CODES +The Xpdf tools use the following exit codes: +.TP +0 +No error. +.TP +1 +Error opening a PDF file. +.TP +2 +Error opening an output file. +.TP +3 +Error related to PDF permissions. +.TP +99 +Other error. +.SH AUTHOR +The pdfimages software and documentation are copyright 1998-2007 Glyph +& Cog, LLC. +.SH "SEE ALSO" +.BR xpdf (1), +.BR pdftops (1), +.BR pdftotext (1), +.BR pdfinfo (1), +.BR pdffonts (1), +.BR pdftoppm (1), +.BR xpdfrc (5) +.br +.B http://www.foolabs.com/xpdf/ diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdfimages.cat b/Build/source/libs/xpdf/xpdf-3.02/doc/pdfimages.cat new file mode 100644 index 00000000000..b5ae119a2d2 --- /dev/null +++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdfimages.cat @@ -0,0 +1,92 @@ +pdfimages(1) pdfimages(1) + + + +NAME + pdfimages - Portable Document Format (PDF) image extractor + (version 3.02) + +SYNOPSIS + pdfimages [options] PDF-file image-root + +DESCRIPTION + Pdfimages saves images from a Portable Document Format + (PDF) file as Portable Pixmap (PPM), Portable Bitmap + (PBM), or JPEG files. + + Pdfimages reads the PDF file, scans one or more pages, + PDF-file, and writes one PPM, PBM, or JPEG file for each + image, image-root-nnn.xxx, where nnn is the image number + and xxx is the image type (.ppm, .pbm, .jpg). + + NB: pdfimages extracts the raw image data from the PDF + file, without performing any additional transforms. Any + rotation, clipping, color inversion, etc. done by the PDF + content stream is ignored. + +CONFIGURATION FILE + Pdfimages reads a configuration file at startup. It first + tries to find the user's private config file, ~/.xpdfrc. + If that doesn't exist, it looks for a system-wide config + file, typically /usr/local/etc/xpdfrc (but this location + can be changed when pdfimages is built). See the + xpdfrc(5) man page for details. + +OPTIONS + Many of the following options can be set with configura- + tion file commands. These are listed in square brackets + with the description of the corresponding command line + option. + + -f number + Specifies the first page to scan. + + -l number + Specifies the last page to scan. + + -j Normally, all images are written as PBM (for + monochrome images) or PPM (for non-monochrome + images) files. With this option, images in DCT + format are saved as JPEG files. All non-DCT images + are saved in PBM/PPM format as usual. + + -opw password + Specify the owner password for the PDF file. Pro- + viding this will bypass all security restrictions. + + -upw password + Specify the user password for the PDF file. + + -q Don't print any messages or errors. [config file: + errQuiet] + + -v Print copyright and version information. + + -h Print usage information. (-help and --help are + equivalent.) + +EXIT CODES + The Xpdf tools use the following exit codes: + + 0 No error. + + 1 Error opening a PDF file. + + 2 Error opening an output file. + + 3 Error related to PDF permissions. + + 99 Other error. + +AUTHOR + The pdfimages software and documentation are copyright + 1998-2007 Glyph & Cog, LLC. + +SEE ALSO + xpdf(1), pdftops(1), pdftotext(1), pdfinfo(1), pdf- + fonts(1), pdftoppm(1), xpdfrc(5) + http://www.foolabs.com/xpdf/ + + + + 27 February 2007 pdfimages(1) diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdfimages.hlp b/Build/source/libs/xpdf/xpdf-3.02/doc/pdfimages.hlp new file mode 100644 index 00000000000..9706099a616 --- /dev/null +++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdfimages.hlp @@ -0,0 +1,101 @@ +! Generated automatically by mantohlp +1 pdfimages + + pdfimages - Portable Document Format (PDF) image extractor + + pdfimages [options] PDF-file image-root + + Pdfimages saves images from a Portable Document Format + (PDF) file as Portable Pixmap (PPM), Portable Bitmap + (PBM), or JPEG files. + + Pdfimages reads the PDF file, scans one or more pages, + PDF-file, and writes one PPM, PBM, or JPEG file for each + image, image-root-nnn.xxx, where nnn is the image number + and xxx is the image type (.ppm, .pbm, .jpg). + + NB: pdfimages extracts the raw image data from the PDF + file, without performing any additional transforms. Any + rotation, clipping, color inversion, etc. done by the PDF + content stream is ignored. + + () + +2 ONFIGURATION_FIL + + Pdfimages reads a configuration file at startup. It first + tries to find the user's private config file, ~/.xpdfrc. + If that doesn't exist, it looks for a system-wide config + file, typically /usr/local/etc/xpdfrc (but this location + can be changed when pdfimages is built). See the + xpdfrc(5) man page for details. + + () + +2 OPTIONS + + Many of the following options can be set with configura- + tion file commands. These are listed in square brackets + with the description of the corresponding command line + option. + + -f number + Specifies the first page to scan. + + -l number + Specifies the last page to scan. + + -j Normally, all images are written as PBM (for + monochrome images) or PPM (for non-monochrome + images) files. With this option, images in DCT + format are saved as JPEG files. All non-DCT images + are saved in PBM/PPM format as usual. + + -opw password + Specify the owner password for the PDF file. Pro- + viding this will bypass all security restrictions. + + -upw password + Specify the user password for the PDF file. + + -q Don't print any messages or errors. [config file: + errQuiet] + + -v Print copyright and version information. + + -h Print usage information. (-help and --help are + equivalent.) + + () + +2 XIT_CODE + + The Xpdf tools use the following exit codes: + + 0 No error. + + 1 Error opening a PDF file. + + 2 Error opening an output file. + + 3 Error related to PDF permissions. + + 99 Other error. + + () + +2 AUTHOR + + The pdfimages software and documentation are copyright + 1998-2007 Glyph & Cog, LLC. + + () + +2 SEE_ALSO + + xpdf(1), pdftops(1), pdftotext(1), pdfinfo(1), pdf- + fonts(1), pdftoppm(1), xpdfrc(5) + http://www.foolabs.com/xpdf/ + + () + diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdfinfo.1 b/Build/source/libs/xpdf/xpdf-3.02/doc/pdfinfo.1 new file mode 100644 index 00000000000..ca2a81374b9 --- /dev/null +++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdfinfo.1 @@ -0,0 +1,158 @@ +.\" Copyright 1999-2007 Glyph & Cog, LLC +.TH pdfinfo 1 "27 February 2007" +.SH NAME +pdfinfo \- Portable Document Format (PDF) document information +extractor (version 3.02) +.SH SYNOPSIS +.B pdfinfo +[options] +.RI [ PDF-file ] +.SH DESCRIPTION +.B Pdfinfo +prints the contents of the \'Info' dictionary (plus some other useful +information) from a Portable Document Format (PDF) file. +.PP +The \'Info' dictionary contains the following values: +.PP +.RS +title +.RE +.RS +subject +.RE +.RS +keywords +.RE +.RS +author +.RE +.RS +creator +.RE +.RS +producer +.RE +.RS +creation date +.RE +.RS +modification date +.RE +.PP +In addition, the following information is printed: +.PP +.RS +tagged (yes/no) +.RE +.RS +page count +.RE +.RS +encrypted flag (yes/no) +.RE +.RS +print and copy permissions (if encrypted) +.RE +.RS +page size +.RE +.RS +file size +.RE +.RS +linearized (yes/no) +.RE +.RS +PDF version +.RE +.RS +metadata (only if requested) +.RE +.SH CONFIGURATION FILE +Pdfinfo reads a configuration file at startup. It first tries to find +the user's private config file, ~/.xpdfrc. If that doesn't exist, it +looks for a system-wide config file, typically /usr/local/etc/xpdfrc +(but this location can be changed when pdfinfo is built). See the +.BR xpdfrc (5) +man page for details. +.SH OPTIONS +Many of the following options can be set with configuration file +commands. These are listed in square brackets with the description of +the corresponding command line option. +.TP +.BI \-f " number" +Specifies the first page to examine. If multiple pages are requested +using the "-f" and "-l" options, the size of each requested page (and, +optionally, the bounding boxes for each requested page) are printed. +Otherwise, only page one is examined. +.TP +.BI \-l " number" +Specifies the last page to examine. +.TP +.B \-box +Prints the page box bounding boxes: MediaBox, CropBox, BleedBox, +TrimBox, and ArtBox. +.TP +.B \-meta +Prints document-level metadata. (This is the "Metadata" stream from +the PDF file's Catalog object.) +.TP +.BI \-enc " encoding-name" +Sets the encoding to use for text output. The +.I encoding\-name +must be defined with the unicodeMap command (see +.BR xpdfrc (5)). +This defaults to "Latin1" (which is a built-in encoding). +.RB "[config file: " textEncoding ] +.TP +.BI \-opw " password" +Specify the owner password for the PDF file. Providing this will +bypass all security restrictions. +.TP +.BI \-upw " password" +Specify the user password for the PDF file. +.TP +.BI \-cfg " config-file" +Read +.I config-file +in place of ~/.xpdfrc or the system-wide config file. +.TP +.B \-v +Print copyright and version information. +.TP +.B \-h +Print usage information. +.RB ( \-help +and +.B \-\-help +are equivalent.) +.SH EXIT CODES +The Xpdf tools use the following exit codes: +.TP +0 +No error. +.TP +1 +Error opening a PDF file. +.TP +2 +Error opening an output file. +.TP +3 +Error related to PDF permissions. +.TP +99 +Other error. +.SH AUTHOR +The pdfinfo software and documentation are copyright 1996-2007 Glyph & +Cog, LLC. +.SH "SEE ALSO" +.BR xpdf (1), +.BR pdftops (1), +.BR pdftotext (1), +.BR pdffonts (1), +.BR pdftoppm (1), +.BR pdfimages (1), +.BR xpdfrc (5) +.br +.B http://www.foolabs.com/xpdf/ diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdfinfo.cat b/Build/source/libs/xpdf/xpdf-3.02/doc/pdfinfo.cat new file mode 100644 index 00000000000..4b429abbc23 --- /dev/null +++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdfinfo.cat @@ -0,0 +1,119 @@ +pdfinfo(1) pdfinfo(1) + + + +NAME + pdfinfo - Portable Document Format (PDF) document informa- + tion extractor (version 3.02) + +SYNOPSIS + pdfinfo [options] [PDF-file] + +DESCRIPTION + Pdfinfo prints the contents of the 'Info' dictionary (plus + some other useful information) from a Portable Document + Format (PDF) file. + + The 'Info' dictionary contains the following values: + + title + subject + keywords + author + creator + producer + creation date + modification date + + In addition, the following information is printed: + + tagged (yes/no) + page count + encrypted flag (yes/no) + print and copy permissions (if encrypted) + page size + file size + linearized (yes/no) + PDF version + metadata (only if requested) + +CONFIGURATION FILE + Pdfinfo reads a configuration file at startup. It first + tries to find the user's private config file, ~/.xpdfrc. + If that doesn't exist, it looks for a system-wide config + file, typically /usr/local/etc/xpdfrc (but this location + can be changed when pdfinfo is built). See the xpdfrc(5) + man page for details. + +OPTIONS + Many of the following options can be set with configura- + tion file commands. These are listed in square brackets + with the description of the corresponding command line + option. + + -f number + Specifies the first page to examine. If multiple + pages are requested using the "-f" and "-l" + options, the size of each requested page (and, + optionally, the bounding boxes for each requested + page) are printed. Otherwise, only page one is + examined. + + -l number + Specifies the last page to examine. + + -box Prints the page box bounding boxes: MediaBox, Crop- + Box, BleedBox, TrimBox, and ArtBox. + + -meta Prints document-level metadata. (This is the + "Metadata" stream from the PDF file's Catalog + object.) + + -enc encoding-name + Sets the encoding to use for text output. The + encoding-name must be defined with the unicodeMap + command (see xpdfrc(5)). This defaults to "Latin1" + (which is a built-in encoding). [config file: tex- + tEncoding] + + -opw password + Specify the owner password for the PDF file. Pro- + viding this will bypass all security restrictions. + + -upw password + Specify the user password for the PDF file. + + -cfg config-file + Read config-file in place of ~/.xpdfrc or the sys- + tem-wide config file. + + -v Print copyright and version information. + + -h Print usage information. (-help and --help are + equivalent.) + +EXIT CODES + The Xpdf tools use the following exit codes: + + 0 No error. + + 1 Error opening a PDF file. + + 2 Error opening an output file. + + 3 Error related to PDF permissions. + + 99 Other error. + +AUTHOR + The pdfinfo software and documentation are copyright + 1996-2007 Glyph & Cog, LLC. + +SEE ALSO + xpdf(1), pdftops(1), pdftotext(1), pdffonts(1), + pdftoppm(1), pdfimages(1), xpdfrc(5) + http://www.foolabs.com/xpdf/ + + + + 27 February 2007 pdfinfo(1) diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdfinfo.hlp b/Build/source/libs/xpdf/xpdf-3.02/doc/pdfinfo.hlp new file mode 100644 index 00000000000..559a123210c --- /dev/null +++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdfinfo.hlp @@ -0,0 +1,129 @@ +! Generated automatically by mantohlp +1 pdfinfo + + pdfinfo - Portable Document Format (PDF) document informa- + tion + + pdfinfo [options] [PDF-file] + + Pdfinfo prints the contents of the 'Info' dictionary (plus + some other useful information) from a Portable Document + Format (PDF) file. + + The 'Info' dictionary contains the following values: + + title + subject + keywords + author + creator + producer + creation date + modification date + + In addition, the following information is printed: + + tagged (yes/no) + page count + encrypted flag (yes/no) + print and copy permissions (if encrypted) + page size + file size + linearized (yes/no) + PDF version + metadata (only if requested) + + () + +2 ONFIGURATION_FIL + + Pdfinfo reads a configuration file at startup. It first + tries to find the user's private config file, ~/.xpdfrc. + If that doesn't exist, it looks for a system-wide config + file, typically /usr/local/etc/xpdfrc (but this location + can be changed when pdfinfo is built). See the xpdfrc(5) + man page for details. + + () + +2 OPTIONS + + Many of the following options can be set with configura- + tion file commands. These are listed in square brackets + with the description of the corresponding command line + option. + + -f number + Specifies the first page to examine. If multiple + pages are requested using the "-f" and "-l" + options, the size of each requested page (and, + optionally, the bounding boxes for each requested + page) are printed. Otherwise, only page one is + examined. + + -l number + Specifies the last page to examine. + + -box Prints the page box bounding boxes: MediaBox, Crop- + Box, BleedBox, TrimBox, and ArtBox. + + -meta Prints document-level metadata. (This is the + "Metadata" stream from the PDF file's Catalog + object.) + + -enc encoding-name + Sets the encoding to use for text output. The + encoding-name must be defined with the unicodeMap + command (see xpdfrc(5)). This defaults to "Latin1" + (which is a built-in encoding). [config file: tex- + tEncoding] + + -opw password + Specify the owner password for the PDF file. Pro- + viding this will bypass all security restrictions. + + -upw password + Specify the user password for the PDF file. + + -cfg config-file + Read config-file in place of ~/.xpdfrc or the sys- + tem-wide config file. + + -v Print copyright and version information. + + -h Print usage information. (-help and --help are + equivalent.) + + () + +2 XIT_CODE + + The Xpdf tools use the following exit codes: + + 0 No error. + + 1 Error opening a PDF file. + + 2 Error opening an output file. + + 3 Error related to PDF permissions. + + 99 Other error. + + () + +2 AUTHOR + + The pdfinfo software and documentation are copyright + 1996-2007 Glyph & Cog, LLC. + + () + +2 SEE_ALSO + + xpdf(1), pdftops(1), pdftotext(1), pdffonts(1), + pdftoppm(1), pdfimages(1), xpdfrc(5) + http://www.foolabs.com/xpdf/ + + () + diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdftoppm.1 b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftoppm.1 new file mode 100644 index 00000000000..f1594900221 --- /dev/null +++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftoppm.1 @@ -0,0 +1,119 @@ +.\" Copyright 2005-2007 Glyph & Cog, LLC +.TH pdftoppm 1 "27 February 2007" +.SH NAME +pdftoppm \- Portable Document Format (PDF) to Portable Pixmap (PPM) +converter (version 3.02) +.SH SYNOPSIS +.B pdftoppm +[options] +.I PDF-file PPM-root +.SH DESCRIPTION +.B Pdftoppm +converts Portable Document Format (PDF) files to color image files in +Portable Pixmap (PPM) format, grayscale image files in Portable +Graymap (PGM) format, or monochrome image files in Portable Bitmap +(PBM) format. +.PP +Pdftoppm reads the PDF file, +.IR PDF-file , +and writes one PPM file for each page, +.IR PPM-root - nnnnnn .ppm, +where +.I nnnnnn +is the page number. +.SH CONFIGURATION FILE +Pdftoppm reads a configuration file at startup. It first tries to +find the user's private config file, ~/.xpdfrc. If that doesn't +exist, it looks for a system-wide config file, typically +/usr/local/etc/xpdfrc (but this location can be changed when pdftoppm +is built). See the +.BR xpdfrc (5) +man page for details. +.SH OPTIONS +Many of the following options can be set with configuration file +commands. These are listed in square brackets with the description of +the corresponding command line option. +.TP +.BI \-f " number" +Specifies the first page to convert. +.TP +.BI \-l " number" +Specifies the last page to convert. +.TP +.BI \-r " number" +Specifies the resolution, in DPI. The default is 150 DPI. +.TP +.B \-mono +Generate a monochrome PBM file (instead of a color PPM file). +.TP +.B \-gray +Generate a grayscale PGM file (instead of a color PPM file). +.TP +.BI \-t1lib " yes | no" +Enable or disable t1lib (a Type 1 font rasterizer). This defaults to +"yes". +.RB "[config file: " enableT1lib ] +.TP +.BI \-freetype " yes | no" +Enable or disable FreeType (a TrueType / Type 1 font rasterizer). +This defaults to "yes". +.RB "[config file: " enableFreeType ] +.TP +.BI \-aa " yes | no" +Enable or disable font anti-aliasing. This defaults to "yes". +.RB "[config file: " antialias ] +.TP +.BI \-aaVector " yes | no" +Enable or disable vector anti-aliasing. This defaults to "yes". +.RB "[config file: " vectorAntialias ] +.TP +.BI \-opw " password" +Specify the owner password for the PDF file. Providing this will +bypass all security restrictions. +.TP +.BI \-upw " password" +Specify the user password for the PDF file. +.TP +.B \-q +Don't print any messages or errors. +.RB "[config file: " errQuiet ] +.TP +.B \-v +Print copyright and version information. +.TP +.B \-h +Print usage information. +.RB ( \-help +and +.B \-\-help +are equivalent.) +.SH EXIT CODES +The Xpdf tools use the following exit codes: +.TP +0 +No error. +.TP +1 +Error opening a PDF file. +.TP +2 +Error opening an output file. +.TP +3 +Error related to PDF permissions. +.TP +99 +Other error. +.SH AUTHOR +The pdftoppm software and documentation are copyright 1996-2007 Glyph +& Cog, LLC. +.SH "SEE ALSO" +.BR xpdf (1), +.BR pdftops (1), +.BR pdftotext (1), +.BR pdfinfo (1), +.BR pdffonts (1), +.BR pdfimages (1), +.BR xpdfrc (5) +.br +.B http://www.foolabs.com/xpdf/ diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdftoppm.cat b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftoppm.cat new file mode 100644 index 00000000000..af7d3c95dfb --- /dev/null +++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftoppm.cat @@ -0,0 +1,108 @@ +pdftoppm(1) pdftoppm(1) + + + +NAME + pdftoppm - Portable Document Format (PDF) to Portable + Pixmap (PPM) converter (version 3.02) + +SYNOPSIS + pdftoppm [options] PDF-file PPM-root + +DESCRIPTION + Pdftoppm converts Portable Document Format (PDF) files to + color image files in Portable Pixmap (PPM) format, + grayscale image files in Portable Graymap (PGM) format, or + monochrome image files in Portable Bitmap (PBM) format. + + Pdftoppm reads the PDF file, PDF-file, and writes one PPM + file for each page, PPM-root-nnnnnn.ppm, where nnnnnn is + the page number. + +CONFIGURATION FILE + Pdftoppm reads a configuration file at startup. It first + tries to find the user's private config file, ~/.xpdfrc. + If that doesn't exist, it looks for a system-wide config + file, typically /usr/local/etc/xpdfrc (but this location + can be changed when pdftoppm is built). See the xpdfrc(5) + man page for details. + +OPTIONS + Many of the following options can be set with configura- + tion file commands. These are listed in square brackets + with the description of the corresponding command line + option. + + -f number + Specifies the first page to convert. + + -l number + Specifies the last page to convert. + + -r number + Specifies the resolution, in DPI. The default is + 150 DPI. + + -mono Generate a monochrome PBM file (instead of a color + PPM file). + + -gray Generate a grayscale PGM file (instead of a color + PPM file). + + -t1lib yes | no + Enable or disable t1lib (a Type 1 font rasterizer). + This defaults to "yes". [config file: enableT1lib] + + -freetype yes | no + Enable or disable FreeType (a TrueType / Type 1 + font rasterizer). This defaults to "yes". [config + file: enableFreeType] + + -aa yes | no + Enable or disable font anti-aliasing. This + defaults to "yes". [config file: antialias] + + -aaVector yes | no + Enable or disable vector anti-aliasing. This + defaults to "yes". [config file: vectorAntialias] + + -opw password + Specify the owner password for the PDF file. Pro- + viding this will bypass all security restrictions. + + -upw password + Specify the user password for the PDF file. + + -q Don't print any messages or errors. [config file: + errQuiet] + + -v Print copyright and version information. + + -h Print usage information. (-help and --help are + equivalent.) + +EXIT CODES + The Xpdf tools use the following exit codes: + + 0 No error. + + 1 Error opening a PDF file. + + 2 Error opening an output file. + + 3 Error related to PDF permissions. + + 99 Other error. + +AUTHOR + The pdftoppm software and documentation are copyright + 1996-2007 Glyph & Cog, LLC. + +SEE ALSO + xpdf(1), pdftops(1), pdftotext(1), pdfinfo(1), pdf- + fonts(1), pdfimages(1), xpdfrc(5) + http://www.foolabs.com/xpdf/ + + + + 27 February 2007 pdftoppm(1) diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdftoppm.hlp b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftoppm.hlp new file mode 100644 index 00000000000..bc83e7c52f1 --- /dev/null +++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftoppm.hlp @@ -0,0 +1,118 @@ +! Generated automatically by mantohlp +1 pdftoppm + + pdftoppm - Portable Document Format (PDF) to Portable + Pixmap (PPM) + + pdftoppm [options] PDF-file PPM-root + + Pdftoppm converts Portable Document Format (PDF) files to + color image files in Portable Pixmap (PPM) format, + grayscale image files in Portable Graymap (PGM) format, or + monochrome image files in Portable Bitmap (PBM) format. + + Pdftoppm reads the PDF file, PDF-file, and writes one PPM + file for each page, PPM-root-nnnnnn.ppm, where nnnnnn is + the page number. + + () + +2 ONFIGURATION_FIL + + Pdftoppm reads a configuration file at startup. It first + tries to find the user's private config file, ~/.xpdfrc. + If that doesn't exist, it looks for a system-wide config + file, typically /usr/local/etc/xpdfrc (but this location + can be changed when pdftoppm is built). See the xpdfrc(5) + man page for details. + + () + +2 OPTIONS + + Many of the following options can be set with configura- + tion file commands. These are listed in square brackets + with the description of the corresponding command line + option. + + -f number + Specifies the first page to convert. + + -l number + Specifies the last page to convert. + + -r number + Specifies the resolution, in DPI. The default is + 150 DPI. + + -mono Generate a monochrome PBM file (instead of a color + PPM file). + + -gray Generate a grayscale PGM file (instead of a color + PPM file). + + -t1lib yes | no + Enable or disable t1lib (a Type 1 font rasterizer). + This defaults to "yes". [config file: enableT1lib] + + -freetype yes | no + Enable or disable FreeType (a TrueType / Type 1 + font rasterizer). This defaults to "yes". [config + file: enableFreeType] + + -aa yes | no + Enable or disable font anti-aliasing. This + defaults to "yes". [config file: antialias] + + -aaVector yes | no + Enable or disable vector anti-aliasing. This + defaults to "yes". [config file: vectorAntialias] + + -opw password + Specify the owner password for the PDF file. Pro- + viding this will bypass all security restrictions. + + -upw password + Specify the user password for the PDF file. + + -q Don't print any messages or errors. [config file: + errQuiet] + + -v Print copyright and version information. + + -h Print usage information. (-help and --help are + equivalent.) + + () + +2 XIT_CODE + + The Xpdf tools use the following exit codes: + + 0 No error. + + 1 Error opening a PDF file. + + 2 Error opening an output file. + + 3 Error related to PDF permissions. + + 99 Other error. + + () + +2 AUTHOR + + The pdftoppm software and documentation are copyright + 1996-2007 Glyph & Cog, LLC. + + () + +2 SEE_ALSO + + xpdf(1), pdftops(1), pdftotext(1), pdfinfo(1), pdf- + fonts(1), pdfimages(1), xpdfrc(5) + http://www.foolabs.com/xpdf/ + + () + diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.1 b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.1 new file mode 100644 index 00000000000..c9ec258f090 --- /dev/null +++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.1 @@ -0,0 +1,235 @@ +.\" Copyright 1996-2007 Glyph & Cog, LLC +.TH pdftops 1 "27 February 2007" +.SH NAME +pdftops \- Portable Document Format (PDF) to PostScript converter +(version 3.02) +.SH SYNOPSIS +.B pdftops +[options] +.RI [ PDF-file +.RI [ PS-file ]] +.SH DESCRIPTION +.B Pdftops +converts Portable Document Format (PDF) files to PostScript so they +can be printed. +.PP +Pdftops reads the PDF file, +.IR PDF-file , +and writes a PostScript file, +.IR PS-file . +If +.I PS-file +is not specified, pdftops converts +.I file.pdf +to +.I file.ps +(or +.I file.eps +with the -eps option). If +.I PS-file +is \'-', the PostScript is sent to stdout. +.SH CONFIGURATION FILE +Pdftops reads a configuration file at startup. It first tries to find +the user's private config file, ~/.xpdfrc. If that doesn't exist, it +looks for a system-wide config file, typically /usr/local/etc/xpdfrc +(but this location can be changed when pdftops is built). See the +.BR xpdfrc (5) +man page for details. +.SH OPTIONS +Many of the following options can be set with configuration file +commands. These are listed in square brackets with the description of +the corresponding command line option. +.TP +.BI \-f " number" +Specifies the first page to print. +.TP +.BI \-l " number" +Specifies the last page to print. +.TP +.B \-level1 +Generate Level 1 PostScript. The resulting PostScript files will be +significantly larger (if they contain images), but will print on Level +1 printers. This also converts all images to black and white. No +more than one of the PostScript level options (-level1, -level1sep, +-level2, -level2sep, -level3, -level3Sep) may be given. +.RB "[config file: " psLevel ] +.TP +.B \-level1sep +Generate Level 1 separable PostScript. All colors are converted to +CMYK. Images are written with separate stream data for the four +components. +.RB "[config file: " psLevel ] +.TP +.B \-level2 +Generate Level 2 PostScript. Level 2 supports color images and image +compression. This is the default setting. +.RB "[config file: " psLevel ] +.TP +.B \-level2sep +Generate Level 2 separable PostScript. All colors are converted to +CMYK. The PostScript separation convention operators are used to +handle custom (spot) colors. +.RB "[config file: " psLevel ] +.TP +.B \-level3 +Generate Level 3 PostScript. This enables all Level 2 features plus +CID font embedding and masked image generation. +.RB "[config file: " psLevel ] +.TP +.B \-level3Sep +Generate Level 3 separable PostScript. The separation handling is the +same as for -level2Sep. +.RB "[config file: " psLevel ] +.TP +.B \-eps +Generate an Encapsulated PostScript (EPS) file. An EPS file contains +a single image, so if you use this option with a multi-page PDF file, +you must use -f and -l to specify a single page. No more than one of +the mode options (-eps, -form) may be given. +.TP +.B \-form +Generate a PostScript form which can be imported by software that +understands forms. A form contains a single page, so if you use this +option with a multi-page PDF file, you must use -f and -l to specify a +single page. The -level1 option cannot be used with -form. +.TP +.B \-opi +Generate OPI comments for all images and forms which have OPI +information. (This option is only available if pdftops was compiled +with OPI support.) +.RB "[config file: " psOPI ] +.TP +.B \-noembt1 +By default, any Type 1 fonts which are embedded in the PDF file are +copied into the PostScript file. This option causes pdftops to +substitute base fonts instead. Embedded fonts make PostScript files +larger, but may be necessary for readable output. +.RB "[config file: " psEmbedType1Fonts ] +.TP +.B \-noembtt +By default, any TrueType fonts which are embedded in the PDF file are +copied into the PostScript file. This option causes pdftops to +substitute base fonts instead. Embedded fonts make PostScript files +larger, but may be necessary for readable output. Also, some +PostScript interpreters do not have TrueType rasterizers. +.RB "[config file: " psEmbedTrueTypeFonts ] +.TP +.B \-noembcidps +By default, any CID PostScript fonts which are embedded in the PDF +file are copied into the PostScript file. This option disables that +embedding. No attempt is made to substitute for non-embedded CID +PostScript fonts. +.RB "[config file: " psEmbedCIDPostScriptFonts ] +.TP +.B \-noembcidtt +By default, any CID TrueType fonts which are embedded in the PDF file +are copied into the PostScript file. This option disables that +embedding. No attempt is made to substitute for non-embedded CID +TrueType fonts. +.RB "[config file: " psEmbedCIDTrueTypeFonts ] +.TP +.B \-preload +Convert PDF forms to PS procedures, and preload image data. This uses +more memory in the PostScript interpreter, but generates significantly +smaller PS files in situations where, e.g., the same image is drawn on +every page of a long document. +.TP +.BI \-paper " size" +Set the paper size to one of "letter", "legal", "A4", or "A3". This +can also be set to "match", which will set the paper size to match the +size specified in the PDF file. +.RB "[config file: " psPaperSize ] +.TP +.BI \-paperw " size" +Set the paper width, in points. +.RB "[config file: " psPaperSize ] +.TP +.BI \-paperh " size" +Set the paper height, in points. +.RB "[config file: " psPaperSize ] +.TP +.B \-nocrop +By default, output is cropped to the CropBox specified in the PDF +file. This option disables cropping. +.RB "[config file: " psCrop ] +.TP +.B \-expand +Expand PDF pages smaller than the paper to fill the paper. By +default, these pages are not scaled. +.RB "[config file: " psExpandSmaller ] +.TP +.B \-noshrink +Don't scale PDF pages which are larger than the paper. By default, +pages larger than the paper are shrunk to fit. +.RB "[config file: " psShrinkLarger ] +.TP +.B \-nocenter +By default, PDF pages smaller than the paper (after any scaling) are +centered on the paper. This option causes them to be aligned to the +lower-left corner of the paper instead. +.RB "[config file: " psCenter ] +.TP +.B \-pagecrop +Treat the CropBox as the PDF page size. By default, the MediaBox is +used as the page size. +.TP +.B \-duplex +Set the Duplex pagedevice entry in the PostScript file. This tells +duplex-capable printers to enable duplexing. +.RB "[config file: " psDuplex ] +.TP +.BI \-opw " password" +Specify the owner password for the PDF file. Providing this will +bypass all security restrictions. +.TP +.BI \-upw " password" +Specify the user password for the PDF file. +.TP +.B \-q +Don't print any messages or errors. +.RB "[config file: " errQuiet ] +.TP +.BI \-cfg " config-file" +Read +.I config-file +in place of ~/.xpdfrc or the system-wide config file. +.TP +.B \-v +Print copyright and version information. +.TP +.B \-h +Print usage information. +.RB ( \-help +and +.B \-\-help +are equivalent.) +.SH EXIT CODES +The Xpdf tools use the following exit codes: +.TP +0 +No error. +.TP +1 +Error opening a PDF file. +.TP +2 +Error opening an output file. +.TP +3 +Error related to PDF permissions. +.TP +99 +Other error. +.SH AUTHOR +The pdftops software and documentation are copyright 1996-2007 Glyph & +Cog, LLC. +.SH "SEE ALSO" +.BR xpdf (1), +.BR pdftotext (1), +.BR pdfinfo (1), +.BR pdffonts (1), +.BR pdftoppm (1), +.BR pdfimages (1), +.BR xpdfrc (5) +.br +.B http://www.foolabs.com/xpdf/ diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.cat b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.cat new file mode 100644 index 00000000000..b370774d0fe --- /dev/null +++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.cat @@ -0,0 +1,229 @@ +pdftops(1) pdftops(1) + + + +NAME + pdftops - Portable Document Format (PDF) to PostScript + converter (version 3.02) + +SYNOPSIS + pdftops [options] [PDF-file [PS-file]] + +DESCRIPTION + Pdftops converts Portable Document Format (PDF) files to + PostScript so they can be printed. + + Pdftops reads the PDF file, PDF-file, and writes a + PostScript file, PS-file. If PS-file is not specified, + pdftops converts file.pdf to file.ps (or file.eps with the + -eps option). If PS-file is '-', the PostScript is sent + to stdout. + +CONFIGURATION FILE + Pdftops reads a configuration file at startup. It first + tries to find the user's private config file, ~/.xpdfrc. + If that doesn't exist, it looks for a system-wide config + file, typically /usr/local/etc/xpdfrc (but this location + can be changed when pdftops is built). See the xpdfrc(5) + man page for details. + +OPTIONS + Many of the following options can be set with configura- + tion file commands. These are listed in square brackets + with the description of the corresponding command line + option. + + -f number + Specifies the first page to print. + + -l number + Specifies the last page to print. + + -level1 + Generate Level 1 PostScript. The resulting + PostScript files will be significantly larger (if + they contain images), but will print on Level 1 + printers. This also converts all images to black + and white. No more than one of the PostScript + level options (-level1, -level1sep, -level2, + -level2sep, -level3, -level3Sep) may be given. + [config file: psLevel] + + -level1sep + Generate Level 1 separable PostScript. All colors + are converted to CMYK. Images are written with + separate stream data for the four components. + [config file: psLevel] + + -level2 + Generate Level 2 PostScript. Level 2 supports + color images and image compression. This is the + default setting. [config file: psLevel] + + -level2sep + Generate Level 2 separable PostScript. All colors + are converted to CMYK. The PostScript separation + convention operators are used to handle custom + (spot) colors. [config file: psLevel] + + -level3 + Generate Level 3 PostScript. This enables all + Level 2 features plus CID font embedding and masked + image generation. [config file: psLevel] + + -level3Sep + Generate Level 3 separable PostScript. The separa- + tion handling is the same as for -level2Sep. [con- + fig file: psLevel] + + -eps Generate an Encapsulated PostScript (EPS) file. An + EPS file contains a single image, so if you use + this option with a multi-page PDF file, you must + use -f and -l to specify a single page. No more + than one of the mode options (-eps, -form) may be + given. + + -form Generate a PostScript form which can be imported by + software that understands forms. A form contains a + single page, so if you use this option with a + multi-page PDF file, you must use -f and -l to + specify a single page. The -level1 option cannot + be used with -form. + + -opi Generate OPI comments for all images and forms + which have OPI information. (This option is only + available if pdftops was compiled with OPI sup- + port.) [config file: psOPI] + + -noembt1 + By default, any Type 1 fonts which are embedded in + the PDF file are copied into the PostScript file. + This option causes pdftops to substitute base fonts + instead. Embedded fonts make PostScript files + larger, but may be necessary for readable output. + [config file: psEmbedType1Fonts] + + -noembtt + By default, any TrueType fonts which are embedded + in the PDF file are copied into the PostScript + file. This option causes pdftops to substitute + base fonts instead. Embedded fonts make PostScript + files larger, but may be necessary for readable + output. Also, some PostScript interpreters do not + have TrueType rasterizers. [config file: psEm- + bedTrueTypeFonts] + + -noembcidps + By default, any CID PostScript fonts which are + embedded in the PDF file are copied into the + PostScript file. This option disables that embed- + ding. No attempt is made to substitute for non- + embedded CID PostScript fonts. [config file: psEm- + bedCIDPostScriptFonts] + + -noembcidtt + By default, any CID TrueType fonts which are embed- + ded in the PDF file are copied into the PostScript + file. This option disables that embedding. No + attempt is made to substitute for non-embedded CID + TrueType fonts. [config file: psEmbedCIDTrueType- + Fonts] + + -preload + Convert PDF forms to PS procedures, and preload + image data. This uses more memory in the + PostScript interpreter, but generates significantly + smaller PS files in situations where, e.g., the + same image is drawn on every page of a long docu- + ment. + + -paper size + Set the paper size to one of "letter", "legal", + "A4", or "A3". This can also be set to "match", + which will set the paper size to match the size + specified in the PDF file. [config file: psPaper- + Size] + + -paperw size + Set the paper width, in points. [config file: + psPaperSize] + + -paperh size + Set the paper height, in points. [config file: + psPaperSize] + + -nocrop + By default, output is cropped to the CropBox speci- + fied in the PDF file. This option disables crop- + ping. [config file: psCrop] + + -expand + Expand PDF pages smaller than the paper to fill the + paper. By default, these pages are not scaled. + [config file: psExpandSmaller] + + -noshrink + Don't scale PDF pages which are larger than the + paper. By default, pages larger than the paper are + shrunk to fit. [config file: psShrinkLarger] + + -nocenter + By default, PDF pages smaller than the paper (after + any scaling) are centered on the paper. This + option causes them to be aligned to the lower-left + corner of the paper instead. [config file: psCen- + ter] + + -pagecrop + Treat the CropBox as the PDF page size. By + default, the MediaBox is used as the page size. + + -duplex + Set the Duplex pagedevice entry in the PostScript + file. This tells duplex-capable printers to enable + duplexing. [config file: psDuplex] + + -opw password + Specify the owner password for the PDF file. Pro- + viding this will bypass all security restrictions. + + -upw password + Specify the user password for the PDF file. + + -q Don't print any messages or errors. [config file: + errQuiet] + + -cfg config-file + Read config-file in place of ~/.xpdfrc or the sys- + tem-wide config file. + + -v Print copyright and version information. + + -h Print usage information. (-help and --help are + equivalent.) + +EXIT CODES + The Xpdf tools use the following exit codes: + + 0 No error. + + 1 Error opening a PDF file. + + 2 Error opening an output file. + + 3 Error related to PDF permissions. + + 99 Other error. + +AUTHOR + The pdftops software and documentation are copyright + 1996-2007 Glyph & Cog, LLC. + +SEE ALSO + xpdf(1), pdftotext(1), pdfinfo(1), pdffonts(1), + pdftoppm(1), pdfimages(1), xpdfrc(5) + http://www.foolabs.com/xpdf/ + + + + 27 February 2007 pdftops(1) diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.hlp b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.hlp new file mode 100644 index 00000000000..2cdf8daf240 --- /dev/null +++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftops.hlp @@ -0,0 +1,239 @@ +! Generated automatically by mantohlp +1 pdftops + + pdftops - Portable Document Format (PDF) to PostScript + converter + + pdftops [options] [PDF-file [PS-file]] + + Pdftops converts Portable Document Format (PDF) files to + PostScript so they can be printed. + + Pdftops reads the PDF file, PDF-file, and writes a + PostScript file, PS-file. If PS-file is not specified, + pdftops converts file.pdf to file.ps (or file.eps with the + -eps option). If PS-file is '-', the PostScript is sent + to stdout. + + () + +2 ONFIGURATION_FIL + + Pdftops reads a configuration file at startup. It first + tries to find the user's private config file, ~/.xpdfrc. + If that doesn't exist, it looks for a system-wide config + file, typically /usr/local/etc/xpdfrc (but this location + can be changed when pdftops is built). See the xpdfrc(5) + man page for details. + + () + +2 OPTIONS + + Many of the following options can be set with configura- + tion file commands. These are listed in square brackets + with the description of the corresponding command line + option. + + -f number + Specifies the first page to print. + + -l number + Specifies the last page to print. + + -level1 + Generate Level 1 PostScript. The resulting + PostScript files will be significantly larger (if + they contain images), but will print on Level 1 + printers. This also converts all images to black + and white. No more than one of the PostScript + level options (-level1, -level1sep, -level2, + -level2sep, -level3, -level3Sep) may be given. + [config file: psLevel] + + -level1sep + Generate Level 1 separable PostScript. All colors + are converted to CMYK. Images are written with + separate stream data for the four components. + [config file: psLevel] + + -level2 + Generate Level 2 PostScript. Level 2 supports + color images and image compression. This is the + default setting. [config file: psLevel] + + -level2sep + Generate Level 2 separable PostScript. All colors + are converted to CMYK. The PostScript separation + convention operators are used to handle custom + (spot) colors. [config file: psLevel] + + -level3 + Generate Level 3 PostScript. This enables all + Level 2 features plus CID font embedding and masked + image generation. [config file: psLevel] + + -level3Sep + Generate Level 3 separable PostScript. The separa- + tion handling is the same as for -level2Sep. [con- + fig file: psLevel] + + -eps Generate an Encapsulated PostScript (EPS) file. An + EPS file contains a single image, so if you use + this option with a multi-page PDF file, you must + use -f and -l to specify a single page. No more + than one of the mode options (-eps, -form) may be + given. + + -form Generate a PostScript form which can be imported by + software that understands forms. A form contains a + single page, so if you use this option with a + multi-page PDF file, you must use -f and -l to + specify a single page. The -level1 option cannot + be used with -form. + + -opi Generate OPI comments for all images and forms + which have OPI information. (This option is only + available if pdftops was compiled with OPI sup- + port.) [config file: psOPI] + + -noembt1 + By default, any Type 1 fonts which are embedded in + the PDF file are copied into the PostScript file. + This option causes pdftops to substitute base fonts + instead. Embedded fonts make PostScript files + larger, but may be necessary for readable output. + [config file: psEmbedType1Fonts] + + -noembtt + By default, any TrueType fonts which are embedded + in the PDF file are copied into the PostScript + file. This option causes pdftops to substitute + base fonts instead. Embedded fonts make PostScript + files larger, but may be necessary for readable + output. Also, some PostScript interpreters do not + have TrueType rasterizers. [config file: psEm- + bedTrueTypeFonts] + + -noembcidps + By default, any CID PostScript fonts which are + embedded in the PDF file are copied into the + PostScript file. This option disables that embed- + ding. No attempt is made to substitute for non- + embedded CID PostScript fonts. [config file: psEm- + bedCIDPostScriptFonts] + + -noembcidtt + By default, any CID TrueType fonts which are embed- + ded in the PDF file are copied into the PostScript + file. This option disables that embedding. No + attempt is made to substitute for non-embedded CID + TrueType fonts. [config file: psEmbedCIDTrueType- + Fonts] + + -preload + Convert PDF forms to PS procedures, and preload + image data. This uses more memory in the + PostScript interpreter, but generates significantly + smaller PS files in situations where, e.g., the + same image is drawn on every page of a long docu- + ment. + + -paper size + Set the paper size to one of "letter", "legal", + "A4", or "A3". This can also be set to "match", + which will set the paper size to match the size + specified in the PDF file. [config file: psPaper- + Size] + + -paperw size + Set the paper width, in points. [config file: + psPaperSize] + + -paperh size + Set the paper height, in points. [config file: + psPaperSize] + + -nocrop + By default, output is cropped to the CropBox speci- + fied in the PDF file. This option disables + cropping. [config file: psCrop] + + -expand + Expand PDF pages smaller than the paper to fill the + paper. By default, these pages are not scaled. + [config file: psExpandSmaller] + + -noshrink + Don't scale PDF pages which are larger than the + paper. By default, pages larger than the paper are + shrunk to fit. [config file: psShrinkLarger] + + -nocenter + By default, PDF pages smaller than the paper (after + any scaling) are centered on the paper. This + option causes them to be aligned to the lower-left + corner of the paper instead. [config file: psCen- + ter] + + -pagecrop + Treat the CropBox as the PDF page size. By + default, the MediaBox is used as the page size. + + -duplex + Set the Duplex pagedevice entry in the PostScript + file. This tells duplex-capable printers to enable + duplexing. [config file: psDuplex] + + -opw password + Specify the owner password for the PDF file. Pro- + viding this will bypass all security restrictions. + + -upw password + Specify the user password for the PDF file. + + -q Don't print any messages or errors. [config file: + errQuiet] + + -cfg config-file + Read config-file in place of ~/.xpdfrc or the sys- + tem-wide config file. + + -v Print copyright and version information. + + -h Print usage information. (-help and --help are + equivalent.) + + () + +2 XIT_CODE + + The Xpdf tools use the following exit codes: + + 0 No error. + + 1 Error opening a PDF file. + + 2 Error opening an output file. + + 3 Error related to PDF permissions. + + 99 Other error. + + () + +2 AUTHOR + + The pdftops software and documentation are copyright + 1996-2007 Glyph & Cog, LLC. + + () + +2 SEE_ALSO + + xpdf(1), pdftotext(1), pdfinfo(1), pdffonts(1), + pdftoppm(1), pdfimages(1), xpdfrc(5) + http://www.foolabs.com/xpdf/ + + () + diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdftotext.1 b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftotext.1 new file mode 100644 index 00000000000..c16a1ea495e --- /dev/null +++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftotext.1 @@ -0,0 +1,137 @@ +.\" Copyright 1997-2007 Glyph & Cog, LLC +.TH pdftotext 1 "27 Febuary 2007" +.SH NAME +pdftotext \- Portable Document Format (PDF) to text converter +(version 3.02) +.SH SYNOPSIS +.B pdftotext +[options] +.RI [ PDF-file +.RI [ text-file ]] +.SH DESCRIPTION +.B Pdftotext +converts Portable Document Format (PDF) files to plain text. +.PP +Pdftotext reads the PDF file, +.IR PDF-file , +and writes a text file, +.IR text-file . +If +.I text-file +is not specified, pdftotext converts +.I file.pdf +to +.IR file.txt . +If +.I text-file +is \'-', the text is sent to stdout. +.SH CONFIGURATION FILE +Pdftotext reads a configuration file at startup. It first tries to +find the user's private config file, ~/.xpdfrc. If that doesn't +exist, it looks for a system-wide config file, typically +/usr/local/etc/xpdfrc (but this location can be changed when pdftotext +is built). See the +.BR xpdfrc (5) +man page for details. +.SH OPTIONS +Many of the following options can be set with configuration file +commands. These are listed in square brackets with the description of +the corresponding command line option. +.TP +.BI \-f " number" +Specifies the first page to convert. +.TP +.BI \-l " number" +Specifies the last page to convert. +.TP +.B \-layout +Maintain (as best as possible) the original physical layout of the +text. The default is to \'undo' physical layout (columns, +hyphenation, etc.) and output the text in reading order. +.TP +.B \-raw +Keep the text in content stream order. This is a hack which often +"undoes" column formatting, etc. Use of raw mode is no longer +recommended. +.TP +.B \-htmlmeta +Generate a simple HTML file, including the meta information. This +simply wraps the text in <pre> and </pre> and prepends the meta +headers. +.TP +.BI \-enc " encoding-name" +Sets the encoding to use for text output. The +.I encoding\-name +must be defined with the unicodeMap command (see +.BR xpdfrc (5)). +The encoding name is case-sensitive. This defaults to "Latin1" (which +is a built-in encoding). +.RB "[config file: " textEncoding ] +.TP +.BI \-eol " unix | dos | mac" +Sets the end-of-line convention to use for text output. +.RB "[config file: " textEOL ] +.TP +.B \-nopgbrk +Don't insert page breaks (form feed characters) between pages. +.RB "[config file: " textPageBreaks ] +.TP +.BI \-opw " password" +Specify the owner password for the PDF file. Providing this will +bypass all security restrictions. +.TP +.BI \-upw " password" +Specify the user password for the PDF file. +.TP +.B \-q +Don't print any messages or errors. +.RB "[config file: " errQuiet ] +.TP +.BI \-cfg " config-file" +Read +.I config-file +in place of ~/.xpdfrc or the system-wide config file. +.TP +.B \-v +Print copyright and version information. +.TP +.B \-h +Print usage information. +.RB ( \-help +and +.B \-\-help +are equivalent.) +.SH BUGS +Some PDF files contain fonts whose encodings have been mangled beyond +recognition. There is no way (short of OCR) to extract text from +these files. +.SH EXIT CODES +The Xpdf tools use the following exit codes: +.TP +0 +No error. +.TP +1 +Error opening a PDF file. +.TP +2 +Error opening an output file. +.TP +3 +Error related to PDF permissions. +.TP +99 +Other error. +.SH AUTHOR +The pdftotext software and documentation are copyright 1996-2007 Glyph +& Cog, LLC. +.SH "SEE ALSO" +.BR xpdf (1), +.BR pdftops (1), +.BR pdfinfo (1), +.BR pdffonts (1), +.BR pdftoppm (1), +.BR pdfimages (1), +.BR xpdfrc (5) +.br +.B http://www.foolabs.com/xpdf/ diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdftotext.cat b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftotext.cat new file mode 100644 index 00000000000..9990226248a --- /dev/null +++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftotext.cat @@ -0,0 +1,120 @@ +pdftotext(1) pdftotext(1) + + + +NAME + pdftotext - Portable Document Format (PDF) to text con- + verter (version 3.02) + +SYNOPSIS + pdftotext [options] [PDF-file [text-file]] + +DESCRIPTION + Pdftotext converts Portable Document Format (PDF) files to + plain text. + + Pdftotext reads the PDF file, PDF-file, and writes a text + file, text-file. If text-file is not specified, pdftotext + converts file.pdf to file.txt. If text-file is '-', the + text is sent to stdout. + +CONFIGURATION FILE + Pdftotext reads a configuration file at startup. It first + tries to find the user's private config file, ~/.xpdfrc. + If that doesn't exist, it looks for a system-wide config + file, typically /usr/local/etc/xpdfrc (but this location + can be changed when pdftotext is built). See the + xpdfrc(5) man page for details. + +OPTIONS + Many of the following options can be set with configura- + tion file commands. These are listed in square brackets + with the description of the corresponding command line + option. + + -f number + Specifies the first page to convert. + + -l number + Specifies the last page to convert. + + -layout + Maintain (as best as possible) the original physi- + cal layout of the text. The default is to 'undo' + physical layout (columns, hyphenation, etc.) and + output the text in reading order. + + -raw Keep the text in content stream order. This is a + hack which often "undoes" column formatting, etc. + Use of raw mode is no longer recommended. + + -htmlmeta + Generate a simple HTML file, including the meta + information. This simply wraps the text in <pre> + and </pre> and prepends the meta headers. + + -enc encoding-name + Sets the encoding to use for text output. The + encoding-name must be defined with the unicodeMap + command (see xpdfrc(5)). The encoding name is + case-sensitive. This defaults to "Latin1" (which + is a built-in encoding). [config file: textEncod- + ing] + + -eol unix | dos | mac + Sets the end-of-line convention to use for text + output. [config file: textEOL] + + -nopgbrk + Don't insert page breaks (form feed characters) + between pages. [config file: textPageBreaks] + + -opw password + Specify the owner password for the PDF file. Pro- + viding this will bypass all security restrictions. + + -upw password + Specify the user password for the PDF file. + + -q Don't print any messages or errors. [config file: + errQuiet] + + -cfg config-file + Read config-file in place of ~/.xpdfrc or the sys- + tem-wide config file. + + -v Print copyright and version information. + + -h Print usage information. (-help and --help are + equivalent.) + +BUGS + Some PDF files contain fonts whose encodings have been + mangled beyond recognition. There is no way (short of + OCR) to extract text from these files. + +EXIT CODES + The Xpdf tools use the following exit codes: + + 0 No error. + + 1 Error opening a PDF file. + + 2 Error opening an output file. + + 3 Error related to PDF permissions. + + 99 Other error. + +AUTHOR + The pdftotext software and documentation are copyright + 1996-2007 Glyph & Cog, LLC. + +SEE ALSO + xpdf(1), pdftops(1), pdfinfo(1), pdffonts(1), pdftoppm(1), + pdfimages(1), xpdfrc(5) + http://www.foolabs.com/xpdf/ + + + + 27 Febuary 2007 pdftotext(1) diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/pdftotext.hlp b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftotext.hlp new file mode 100644 index 00000000000..f527172504c --- /dev/null +++ b/Build/source/libs/xpdf/xpdf-3.02/doc/pdftotext.hlp @@ -0,0 +1,133 @@ +! Generated automatically by mantohlp +1 pdftotext + + pdftotext - Portable Document Format (PDF) to text con- + verter + + pdftotext [options] [PDF-file [text-file]] + + Pdftotext converts Portable Document Format (PDF) files to + plain text. + + Pdftotext reads the PDF file, PDF-file, and writes a text + file, text-file. If text-file is not specified, pdftotext + converts file.pdf to file.txt. If text-file is '-', the + text is sent to stdout. + + () + +2 ONFIGURATION_FIL + + Pdftotext reads a configuration file at startup. It first + tries to find the user's private config file, ~/.xpdfrc. + If that doesn't exist, it looks for a system-wide config + file, typically /usr/local/etc/xpdfrc (but this location + can be changed when pdftotext is built). See the + xpdfrc(5) man page for details. + + () + +2 OPTIONS + + Many of the following options can be set with configura- + tion file commands. These are listed in square brackets + with the description of the corresponding command line + option. + + -f number + Specifies the first page to convert. + + -l number + Specifies the last page to convert. + + -layout + Maintain (as best as possible) the original physi- + cal layout of the text. The default is to 'undo' + physical layout (columns, hyphenation, etc.) and + output the text in reading order. + + -raw Keep the text in content stream order. This is a + hack which often "undoes" column formatting, etc. + Use of raw mode is no longer recommended. + + -htmlmeta + Generate a simple HTML file, including the meta + information. This simply wraps the text in <pre> + and </pre> and prepends the meta headers. + + -enc encoding-name + Sets the encoding to use for text output. The + encoding-name must be defined with the unicodeMap + command (see xpdfrc(5)). The encoding name is + case-sensitive. This defaults to "Latin1" (which + is a built-in encoding). [config file: textEncod- + ing] + + -eol unix | dos | mac + Sets the end-of-line convention to use for text + output. [config file: textEOL] + + -nopgbrk + Don't insert page breaks (form feed characters) + between pages. [config file: textPageBreaks] + + -opw password + Specify the owner password for the PDF file. Pro- + viding this will bypass all security restrictions. + + -upw password + Specify the user password for the PDF file. + + -q Don't print any messages or errors. [config file: + errQuiet] + + -cfg config-file + Read config-file in place of ~/.xpdfrc or the sys- + tem-wide config file. + + -v Print copyright and version information. + + -h Print usage information. (-help and --help are + equivalent.) + + () + +2 BUGS + + Some PDF files contain fonts whose encodings have been + mangled beyond recognition. There is no way (short of + OCR) to extract text from these files. + + () + +2 XIT_CODE + + The Xpdf tools use the following exit codes: + + 0 No error. + + 1 Error opening a PDF file. + + 2 Error opening an output file. + + 3 Error related to PDF permissions. + + 99 Other error. + + () + +2 AUTHOR + + The pdftotext software and documentation are copyright + 1996-2007 Glyph & Cog, LLC. + + () + +2 SEE_ALSO + + xpdf(1), pdftops(1), pdfinfo(1), pdffonts(1), pdftoppm(1), + pdfimages(1), xpdfrc(5) + http://www.foolabs.com/xpdf/ + + () + diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/sample-xpdfrc b/Build/source/libs/xpdf/xpdf-3.02/doc/sample-xpdfrc new file mode 100644 index 00000000000..481e4179ecc --- /dev/null +++ b/Build/source/libs/xpdf/xpdf-3.02/doc/sample-xpdfrc @@ -0,0 +1,91 @@ +#======================================================================== +# +# Sample xpdfrc file +# +# The Xpdf tools look for a config file in two places: +# 1. ~/.xpdfrc +# 2. in a system-wide directory, typically /usr/local/etc/xpdfrc +# +# This sample config file demonstrates some of the more common +# configuration options. Everything here is commented out. You +# should edit things (especially the file/directory paths, since +# they'll likely be different on your system), and uncomment whichever +# options you want to use. For complete details on config file syntax +# and available options, please see the xpdfrc(5) man page. +# +# Also, the Xpdf language support packages each include a set of +# options to be added to the xpdfrc file. +# +# http://www.foolabs.com/xpdf/ +# +#======================================================================== + +#----- display fonts + +# These map the Base-14 fonts to the Type 1 fonts that ship with +# ghostscript. You'll almost certainly want to use something like +# this, but you'll need to adjust this to point to wherever +# ghostscript is installed on your system. (But if the fonts are +# installed in a "standard" location, xpdf will find them +# automatically.) + +#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 + +# If you need to display PDF files that refer to non-embedded fonts, +# you should add one or more fontDir options to point to the +# directories containing the font files. Xpdf will only look at .pfa, +# .pfb, and .ttf files in those directories (other files will simply +# be ignored). + +#fontDir /usr/local/fonts/bakoma + +#----- PostScript output control + +# Set the default PostScript file or command. + +#psFile "|lpr -Pmyprinter" + +# Set the default PostScript paper size -- this can be letter, legal, +# A4, or A3. You can also specify a paper size as width and height +# (in points). + +#psPaperSize letter + +#----- text output control + +# Choose a text encoding for copy-and-paste and for pdftotext output. +# The Latin1, ASCII7, and UTF-8 encodings are built into Xpdf. Other +# encodings are available in the language support packages. + +#textEncoding UTF-8 + +# Choose the end-of-line convention for multi-line copy-and-past and +# for pdftotext output. The available options are unix, mac, and dos. + +#textEOL unix + +#----- misc settings + +# Enable t1lib, FreeType, and anti-aliased text. + +#enableT1lib yes +#enableFreeType yes +#antialias yes + +# Set the command used to run a web browser when a URL hyperlink is +# clicked. + +#urlCommand "netscape -remote 'openURL(%s)'" diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/xpdf.1 b/Build/source/libs/xpdf/xpdf-3.02/doc/xpdf.1 new file mode 100644 index 00000000000..654855717c0 --- /dev/null +++ b/Build/source/libs/xpdf/xpdf-3.02/doc/xpdf.1 @@ -0,0 +1,863 @@ +.\" Copyright 1996-2007 Glyph & Cog, LLC +.TH xpdf 1 "27 February 2007" +.SH NAME +xpdf \- Portable Document Format (PDF) file viewer for X (version 3.02) +.SH SYNOPSIS +.B xpdf +[options] +.RI [ PDF-file +.RI [ page " | +" dest ]] +.SH DESCRIPTION +.B Xpdf +is a viewer for Portable Document Format (PDF) files. (These are also +sometimes also called \'Acrobat' files, from the name of Adobe's PDF +software.) Xpdf runs under the X Window System on UNIX, VMS, and +OS/2. +.PP +To run xpdf, simply type: +.PP +.RS +xpdf file.pdf +.RE +.PP +where +.I file.pdf +is your PDF file. The file name can be followed by a number +specifying the page which should be displayed first, e.g.: +.PP +.RS +xpdf file.pdf 18 +.RE +.PP +You can also give a named destination, prefixed with \'+' in place of +the page number. (This is only useful with PDF files that provide +named destination targets.) +.PP +You can also start xpdf without opening any files: +.PP +.RS +xpdf +.RE +.SH CONFIGURATION FILE +Xpdf reads a configuration file at startup. It first tries to find +the user's private config file, ~/.xpdfrc. If that doesn't exist, it +looks for a system-wide config file, typically /usr/local/etc/xpdfrc +(but this location can be changed when xpdf is built). See the +.BR xpdfrc (5) +man page for details. +.SH OPTIONS +Many of the following options can be set with configuration file +commands or X resources. These are listed in square brackets with the +description of the corresponding command line option. +.TP +.BI \-g " geometry" +Set the initial window geometry. +.RB ( \-geometry +is equivalent.) +.RB "[X resource: " xpdf.geometry ] +.TP +.BI \-title " title" +Set the window title. By default, the title will be "xpdf: foo.pdf". +.RB "[X resource: " xpdf.title ] +.TP +.B \-cmap +Install a private colormap. This is ignored on TrueColor visuals. +.RB "[X resource: " xpdf.installCmap ] +.TP +.BI \-rgb " number" +Set the size of largest RGB cube xpdf will try to allocate. The +default is 5 (for a 5x5x5 cube); set to a smaller number to conserve +color table entries. This is ignored with private colormaps and on +TrueColor visuals. +.RB "[X resource: " xpdf.rgbCubeSize ] +.TP +.B \-rv +Set reverse video mode. This reverses the colors of everything except +images. It may not always produce great results for PDF files which +do weird things with color. This also causes the paper color to +default to black. +.RB "[X resource: " xpdf.reverseVideo ] +.TP +.BI \-papercolor " color" +Set the "paper color", i.e., the background of the page display. This +will not work too well with PDF files that do things like filling in +white behind the text. +.RB "[X resource: " xpdf.paperColor ] +.TP +.BI \-mattecolor " color" +Set the matte color, i.e., the color used for background outside the +actual page area. (There is a separate setting, +xpdf.fullScreenMatteColor, for full-screen mode.) +.RB "[X resource: " xpdf.matteColor ] +.TP +.BI \-z " zoom" +Set 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 window +width. +.RB "[config file: " initialZoom "; or X resource: " xpdf.initialZoom ] +.TP +.B \-cont +Start in continuous view mode, i.e., with one vertical scroll bar for +the whole document. +.RB "[config file: " continuousView ] +.TP +.BI \-t1lib " yes | no" +Enable or disable t1lib (a Type 1 font rasterizer). This defaults to +"yes". +.RB "[config file: " enableT1lib ] +.TP +.BI \-freetype " yes | no" +Enable or disable FreeType (a TrueType / Type 1 font rasterizer). +This defaults to "yes". +.RB "[config file: " enableFreeType ] +.TP +.BI \-aa " yes | no" +Enable or disable font anti-aliasing. This defaults to "yes". +.RB "[config file: " antialias ] +.TP +.BI \-aaVector " yes | no" +Enable or disable vector anti-aliasing. This defaults to "yes". +.RB "[config file: " vectorAntialias ] +.TP +.BI \-ps " PS-file" +Set the default file name for PostScript output (i.e., the name which +will appear in the print dialog). This can also be of the form +\'|command' to pipe the PostScript through a command. +.RB "[config file: " psFile ] +.TP +.BI \-paper " size" +Set the paper size to one of "letter", "legal", "A4", or "A3". This +can also be set to "match", which will set the paper size to match the +size specified in the PDF file. +.RB "[config file: " psPaperSize ] +.TP +.BI \-paperw " size" +Set the paper width, in points. +.RB "[config file: " psPaperSize ] +.TP +.BI \-paperh " size" +Set the paper height, in points. +.RB "[config file: " psPaperSize ] +.TP +.B \-level1 +Generate Level 1 PostScript. The resulting PostScript files will be +significantly larger (if they contain images), but will print on Level +1 printers. This also converts all images to black and white. +.RB "[config file: " psLevel ] +.TP +.BI \-enc " encoding-name" +Sets the encoding to use for text output. The +.I encoding\-name +must be defined with the unicodeMap command (see +.BR xpdfrc (5)). +This defaults to "Latin1" (which is a built-in encoding). +.RB "[config file: " textEncoding ] +.TP +.BI \-eol " unix | dos | mac" +Sets the end-of-line convention to use for text output. +.RB "[config file: " textEOL ] +.TP +.BI \-opw " password" +Specify the owner password for the PDF file. Providing this will +bypass all security restrictions. +.TP +.BI \-upw " password" +Specify the user password for the PDF file. +.TP +.B \-fullscreen +Open xpdf in full-screen mode, useful for presentations. +.TP +.BI \-remote " name" +Start/contact xpdf remote server with specified name (see the +.B "REMOTE SERVER MODE" +section below). +.TP +.BI \-exec " command" +Execute a command (see the +.B COMMANDS +section below) in an xpdf remote server window (with -remote only). +.TP +.B \-reload +Reload xpdf remote server window (with -remote only). +.TP +.B \-raise +Raise xpdf remote server window (with -remote only). +.TP +.B \-quit +Kill xpdf remote server (with -remote only). +.TP +.B \-cmd +Print commands as they're executed (useful for debugging). +.RB "[config file: " printCommands ] +.TP +.B \-q +Don't print any messages or errors. +.RB "[config file: " errQuiet ] +.TP +.BI \-cfg " config-file" +Read +.I config-file +in place of ~/.xpdfrc or the system-wide config file. +.TP +.B \-v +Print copyright and version information. +.TP +.B \-h +Print usage information. +.RB ( \-help +and +.B \-\-help +are equivalent.) +.PP +Several other standard X options and resources will work as expected: +.TP +.BI \-display " display" +.RB "[X resource: " xpdf.display ] +.TP +.BI \-fg " color" +.RB ( \-foreground +is equivalent.) +.RB "[X resource: " xpdf*Foreground ] +.TP +.BI \-bg " color" +.RB ( \-background +is equivalent.) +.RB "[X resource: " xpdf*Background ] +.TP +.BI \-font " font" +.RB ( \-fn +is equivalent.) +.RB "[X resource: " xpdf*fontList ] +.PP +The color and font options only affect the user interface elements, +not the PDF display (the \'paper'). +.PP +The following X resources do not have command line option equivalents: +.TP +.B xpdf.toolTipEnable +Enables (if set to true) or disables (if set to false) the tool-tips +on the toolbar buttons. +.TP +.B xpdf.fullScreenMatteColor +Sets the matte color to be used in full-screen mode. The default +setting is "black". +.SH CONTROLS +.SS On-screen controls, at the bottom of the xpdf window +.TP +.B "left/right arrow buttons" +Move to the previous/next page. +.TP +.B "double left/right arrow buttons" +Move backward or forward by ten pages. +.TP +.B "dashed left/right arrow buttons" +Move backward or forward along the history path. +.TP +.B "\'Page' entry box" +Move to a specific page number. Click in the box to activate it, type +the page number, then hit return. +.TP +.B "zoom popup menu" +Change the zoom factor (see the description of the -z option above). +.TP +.B "binoculars button" +Find a text string. +.TP +.B "print button" +Bring up a dialog for generating a PostScript file. The dialog has +options to set the pages to be printed and the PostScript file name. +The file name can be \'-' for stdout or \'|command' to pipe the +PostScript through a command, e.g., \'|lpr'. +.TP +.B "\'?' button" +Bring up the \'about xpdf' window. +.TP +.B "link info" +The space between the \'?' and \'Quit' buttons is used to show the URL +or external file name when the mouse is over a link. +.TP +.B "\'Quit' button" +Quit xpdf. +.PP +.SS Menu +Pressing the right mouse button will post a popup menu with the +following commands: +.TP +.B "Open..." +Open a new PDF file via a file requester. +.TP +.B "Open in new window..." +Create a new window and open a new PDF file via a file requester. +.TP +.B "Reload" +Reload the current PDF file. Note that Xpdf will reload the file +automatically (on a page change or redraw) if it has changed since it +was last loaded. +.TP +.B "Save as..." +Save the current file via a file requester. +.TP +.B "Continuous view" +Toggles between single page and continuous view modes. +.TP +.B "Rotate counterclockwise" +Rotate the page 90 degrees counterclockwise. +.TP +.B "Rotate clockwise" +Rotate the page 90 degrees clockwise. The two rotate commands are +intended primarily for PDF files where the rotation isn't correctly +specified in the file. +.TP +.B "Zoom to selection" +Zoom in to the currently selected rectangle. +.TP +.B "Close" +Close the current window. If this is the only open window, the +document is closed, but the window is left open (i.e., this menu +command won't quit xpdf). +.TP +.B "Quit" +Quit xpdf. +.PP +.SS Outline +If the PDF contains an outline (a.k.a., bookmarks), there will be an +outline pane on the left side of the window. The width of the outline +pane is adjustable with a vertical split bar via the knob near its +bottom end. +.PP +.SS Text selection +Dragging the mouse with the left button held down will highlight an +arbitrary rectangle. Any text inside this rectangle will be copied to +the X selection buffer. +.PP +.SS Links +Clicking on a hyperlink will jump to the link's destination. A link +to another PDF document will make xpdf load that document. A +\'launch' link to an executable program will display a dialog, and if +you click \'ok', execute the program. URL links call an external +command (see the +.B WEB BROWSERS +section below). +.PP +.SS Panning +Dragging the mouse with the middle button held down pans the window. +.PP +.SS Key bindings +.TP +.B o +Open a new PDF file via a file requester. +.TP +.B r +Reload the current PDF file. Note that Xpdf will reload the file +automatically (on a page change or redraw) if it has changed since it +was last loaded. +.TP +.B control-L +Redraw the current page. +.TP +.B control-W +Close the current window. +.TP +.B f or control-F +Find a text string. +.TP +.B control-G +Find next occurrence. +.TP +.B control-P +Print. +.TP +.B n +Move to the next page. Scrolls to the top of the page, unless scroll +lock is turned on. +.TP +.B p +Move to the previous page. Scrolls to the top of the page, unless +scroll lock is turned on. +.TP +.BR <Space> " or " <PageDown> " or " <Next> +Scroll down on the current page; if already at bottom, move to next +page. +.TP +.BR <Backspace> " or " <Delete> " or " <PageUp> " or " <Previous> +Scroll up on the current page; if already at top, move to previous +page. +.TP +.B v +Move forward along the history path. +.TP +.B b +Move backward along the history path. +.TP +.B <Home> +Scroll to top of current page. +.TP +.B <End> +Scroll to bottom of current page. +.TP +.B control-<Home> +Scroll to first page of document. +.TP +.B control-<End> +Scroll to last page of document. +.TP +.B arrows +Scroll the current page. +.TP +.B g +Activate the page number text field ("goto page"). +.TP +.B 0 +Set the zoom factor to 125%. +.TP +.B + +Zoom in (increment the zoom factor by 1). +.TP +.B - +Zoom out (decrement the zoom factor by 1). +.TP +.B z +Set the zoom factor to 'page' (fit page to window). +.TP +.B w +Set the zoom factor to 'width' (fit page width to window). +.TP +.B alt-F +Toggle full-screen mode. +.TP +.B q +Quit xpdf. +.SH "WEB BROWSERS" +If you want to run xpdf automatically from netscape or mosaic (and +probably other browsers) when you click on a link to a PDF file, you +need to edit (or create) the files +.I .mime.types +and +.I .mailcap +in your home directory. In +.I .mime.types +add the line: +.PP +.RS +application/pdf pdf +.RE +.PP +In +.I .mailcap +add the lines: +.PP +.RS +# Use xpdf to view PDF files. +.RE +.RS +application/pdf; xpdf -q %s +.RE +.PP +Make sure that xpdf is on your executable search path. +.PP +When you click on a URL link in a PDF file, xpdf will execute the +command specified by the urlCommand config file option, replacing an +occurrence of \'%s' with the URL. For example, to call netscape with +the URL, add this line to your config file: +.PP +.RS +urlCommand "netscape -remote 'openURL(%s)'" +.RE +.SH COMMANDS +Xpdf's key and mouse bindings are user-configurable, using the bind and +unbind options in the config file (see +.BR xpdfrc (5)). +The bind command allows you to bind a key or mouse button to a +sequence of one or more commands. +.SS Available Commands +The following commands are supported: +.TP +.BI gotoPage( page ) +Go to the specified page. +.TP +.BI gotoPageNoScroll( page ) +Go to the specified page, with the current relative scroll position. +.TP +.BI gotoDest( dest ) +Go to a named destination. +.TP +.B gotoLastPage +Go to the last page in the PDF file. +.TP +.B gotoLastPageNoScroll +Go to the last page in the PDF file, with the current relative scroll +position. +.TP +.B nextPage +Go to the next page. +.TP +.B nextPageNoScroll +Go to the next page, with the current relative scroll position. +.TP +.B prevPage +Go to the previous page. +.TP +.B prevPageNoScroll +Go to the previous page, with the current relative scroll position. +.TP +.B pageUp +Scroll up by one screenful. +.TP +.B pageDown +Scroll down by one screenful. +.TP +.BI scrollLeft( n ) +Scroll left by +.I n +pixels. +.TP +.BI scrollRight( n ) +Scroll right by +.I n +pixels. +.TP +.BI scrollUp( n ) +Scroll up by +.I n +pixels. +.TP +.BI scrollDown( n ) +Scroll down by +.I n +pixels. +.TP +.BI scrollUpPrevPage( n ) +Scroll up by +.I n +pixels, moving to the previous page if appropriate. +.TP +.BI scrollDownPrevPage( n ) +Scroll down by +.I n +pixels, moving to the next page if appropriate. +.TP +.B scrollToTopEdge +Scroll to the top edge of the current page, with no horizontal +movement. +.TP +.B scrollToBottomEdge +Scroll to the bottom edge of the current page, with no horizontal +movement. +.TP +.B scrollToLeftEdge +Scroll to the left edge of the current page, with no vertical +movement. +.TP +.B scrollToRightEdge +Scroll to the right edge of the current page, with no vertical +movement. +.TP +.B scrollToTopLeft +Scroll to the top-left corner of the current page. +.TP +.B scrollToBottomRight +Scroll to the bottom-right corner of the current page. +.TP +.B goForward +Move forward along the history path. +.TP +.B goBackward +Move backward along the history path. +.TP +.BI zoomPercent( z ) +Set the zoom factor to +.IR z %. +.TP +.B zoomFitPage +Set the zoom factor to fit-page. +.TP +.B zoomFitWidth +Set the zoom factor to fit-width. +.TP +.B zoomIn +Zoom in - go to the next higher zoom factor. +.TP +.B zoomOut +Zoom out - go the next lower zoom factor. +.TP +.B continuousMode +Go to continuous view mode. +.TP +.B singlePageMode +Go to single-page view mode. +.TP +.B toggleContinuousMode +Toggle between continuous and single page view modes. +.TP +.B fullScreenMode +Go to full-screen mode. +.TP +.B windowMode +Go to window (non-full-screen) mode. +.TP +.B toggleFullScreenMode +Toggle between full-screen and window modes. +.TP +.B open +Open a PDF file in this window, using the open dialog. +.TP +.B openInNewWin +Open a PDF file in a new window, using the open dialog. +.TP +.BI openFile( file ) +Open a specified PDF file in this window. +.TP +.BI openFileInNewWin( file ) +Open a specified PDF file in a new window. +.TP +.BI openFileAtDest( file , dest ) +Open a specified PDF file in this window and go to a named +destination. +.TP +.BI openFileAtDestInNewWin( file , dest ) +Open a specified PDF file in a new window and go to a named +destination. +.TP +.B reload +Reload the current PDF file. +.TP +.B redraw +Redraw the window. +.TP +.B raise +Raise the window to the front. +.TP +.B closeWindow +Close the window. +.TP +.BI run( external-command-string ) +Run an external command. The following escapes are allowed in the +command string: +.nf + + %f => PDF file name (or an empty string if no + file is open) + %b => PDF file base name, i.e., file name minus + the extension (or an empty string if no + file is open) + %u => link URL (or an empty string if not over + a URL link) + %x => selection upper-left x coordinate + (or 0 if there is no selection) + %y => selection upper-left y coordinate + (or 0 if there is no selection) + %X => selection lower-right x coordinate + (or 0 if there is no selection) + %Y => selection lower-right y coordinate + (or 0 if there is no selection) + %% => % + +.fi +.TP +.B openOutline +Open the outline pane. +.TP +.B closeOutline +Close the outline pane. +.TP +.B toggleOutline +Toggle the outline pane between open and closed. +.TP +.BI scrollOutlineDown( n ) +Scroll the outline down by +.I n +increments. +.TP +.BI scrollOutlineUp( n ) +Scroll the outline up by +.I n +increments. +.TP +.B focusToDocWin +Set the keyboard focus to the main document window. +.TP +.B focusToPageNum +Set the keyboard focus to the page number text box. +.TP +.B find +Open the 'find' dialog. +.TP +.B findNext +Finds the next occurrence of the search string (no dialog). +.TP +.B print +Open the 'print' dialog. +.TP +.B about +Open the 'about' dialog. +.TP +.B quit +Quit from xpdf. +.PP +The following commands depend on the current mouse position: +.TP +.B startSelection +Start a selection, which will be extended as the mouse moves. +.TP +.B endSelection +End a selection. +.TP +.B startPan +Start a pan, which will scroll the document as the mouse moves +.TP +.B endPan +End a pan. +.TP +.B postPopupMenu +Display the popup menu. +.TP +.B followLink +Follow a hyperlink (does nothing if the mouse is not over a link). +.TP +.B followLinkInNewWin +Follow a hyperlink, opening PDF files in a new window (does nothing if +the mouse is not over a link). For links to non-PDF files, this +command is identical to followLink. +.TP +.B followLinkNoSel +Same as followLink, but does nothing if there is a non-empty selection. +(This is useful as a mouse button binding.) +.TP +.B followLinkInNewWinNoSel +Same as followLinkInNewWin, but does nothing if there is a non-empty +selection. (This is useful as a mouse button binding.) +.SS Default Bindings +The default mouse bindings are as follows: +.nf + + bind mousePress1 any startSelection + bind mouseRelease1 any endSelection followLinkNoSel + bind mousePress2 any startPan + bind mouseRelease2 any endPan + bind mousePress3 any postPopupMenu + bind mousePress4 any scrollUpPrevPage(16) + bind mousePress5 any scrollDownNextPage(16) + bind mousePress6 any scrollLeft(16) + bind mousePress7 any scrollRight(16) + +.fi +The default key bindings are as follows: +.nf + + bind ctrl-home any gotoPage(1) + bind home any scrollToTopLeft + bind ctrl-end any gotoLastPage + bind end any scrollToBottomRight + bind pgup any pageUp + bind backspace any pageUp + bind delete any pageUp + bind pgdn any pageDown + bind space any pageDown + bind left any scrollLeft(16) + bind right any scrollRight(16) + bind up any scrollUp(16) + bind down any scrollDown(16) + bind o any open + bind O any open + bind r any reload + bind R any reload + bind f any find + bind F any find + bind ctrl-f any find + bind ctrl-g any findNext + bind ctrl-p any print + bind n scrLockOff nextPage + bind N scrLockOff nextPage + bind n scrLockOn nextPageNoScroll + bind N scrLockOn nextPageNoScroll + bind p scrLockOff prevPage + bind P scrLockOff prevPage + bind p scrLockOn prevPageNoScroll + bind P scrLockOn prevPageNoScroll + bind v any goForward + bind b any goBackward + bind g any focusToPageNum + bind 0 any zoomPercent(125) + bind + any zoomIn + bind - any zoomOut + bind z any zoomFitPage + bind w any zoomFitWidth + bind alt-f any toggleFullScreenMode + bind ctrl-l any redraw + bind ctrl-w any closeWindow + bind ? any about + bind q any quit + bind Q any quit + +.fi +Previous versions of xpdf included a "viKeys" X resource. It is no +longer available, but the following bindings are equivalent: +.nf + + bind h any scrollLeft(16) + bind l any scrollRight(16) + bind k any scrollUp(16) + bind j any scrollDown(16) + +.fi +.SH "REMOTE SERVER MODE" +Xpdf can be started in remote server mode by specifying a server name +(in addition to the file name and page number). For example: +.PP +.RS +xpdf -remote myServer file.pdf +.RE +.PP +If there is currently no xpdf running in server mode with the name +\'myServer', a new xpdf window will be opened. If another command: +.PP +.RS +xpdf -remote myServer another.pdf 9 +.RE +.PP +is issued, a new copy of xpdf will not be started. Instead, the first +xpdf (the server) will load +.I another.pdf +and display page nine. If the file name is the same: +.PP +.RS +xpdf -remote myServer another.pdf 4 +.RE +.PP +the xpdf server will simply display the specified page. +.PP +The -raise option tells the server to raise its window; it can be +specified with or without a file name and page number. +.PP +The -quit option tells the server to close its window and exit. +.SH EXIT CODES +The Xpdf tools use the following exit codes: +.TP +0 +No error. +.TP +1 +Error opening a PDF file. +.TP +2 +Error opening an output file. +.TP +3 +Error related to PDF permissions. +.TP +99 +Other error. +.SH AUTHOR +The xpdf software and documentation are copyright 1996-2007 Glyph & +Cog, LLC. +.SH "SEE ALSO" +.BR pdftops (1), +.BR pdftotext (1), +.BR pdfinfo (1), +.BR pdffonts (1), +.BR pdftoppm (1), +.BR pdfimages (1), +.BR xpdfrc (5) +.br +.B http://www.foolabs.com/xpdf/ diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/xpdf.cat b/Build/source/libs/xpdf/xpdf-3.02/doc/xpdf.cat new file mode 100644 index 00000000000..8ab72913edf --- /dev/null +++ b/Build/source/libs/xpdf/xpdf-3.02/doc/xpdf.cat @@ -0,0 +1,809 @@ +xpdf(1) xpdf(1) + + + +NAME + xpdf - Portable Document Format (PDF) file viewer for X + (version 3.02) + +SYNOPSIS + xpdf [options] [PDF-file [page | +dest]] + +DESCRIPTION + Xpdf is a viewer for Portable Document Format (PDF) files. + (These are also sometimes also called 'Acrobat' files, + from the name of Adobe's PDF software.) Xpdf runs under + the X Window System on UNIX, VMS, and OS/2. + + To run xpdf, simply type: + + xpdf file.pdf + + where file.pdf is your PDF file. The file name can be + followed by a number specifying the page which should be + displayed first, e.g.: + + xpdf file.pdf 18 + + You can also give a named destination, prefixed with '+' + in place of the page number. (This is only useful with + PDF files that provide named destination targets.) + + You can also start xpdf without opening any files: + + xpdf + +CONFIGURATION FILE + Xpdf reads a configuration file at startup. It first + tries to find the user's private config file, ~/.xpdfrc. + If that doesn't exist, it looks for a system-wide config + file, typically /usr/local/etc/xpdfrc (but this location + can be changed when xpdf is built). See the xpdfrc(5) man + page for details. + +OPTIONS + Many of the following options can be set with configura- + tion file commands or X resources. These are listed in + square brackets with the description of the corresponding + command line option. + + -g geometry + Set the initial window geometry. (-geometry is + equivalent.) [X resource: xpdf.geometry] + + -title title + Set the window title. By default, the title will + be "xpdf: foo.pdf". [X resource: xpdf.title] + + -cmap Install a private colormap. This is ignored on + TrueColor visuals. [X resource: xpdf.installCmap] + + -rgb number + Set the size of largest RGB cube xpdf will try to + allocate. The default is 5 (for a 5x5x5 cube); set + to a smaller number to conserve color table + entries. This is ignored with private colormaps + and on TrueColor visuals. [X resource: + xpdf.rgbCubeSize] + + -rv Set reverse video mode. This reverses the colors + of everything except images. It may not always + produce great results for PDF files which do weird + things with color. This also causes the paper + color to default to black. [X resource: + xpdf.reverseVideo] + + -papercolor color + Set the "paper color", i.e., the background of the + page display. This will not work too well with PDF + files that do things like filling in white behind + the text. [X resource: xpdf.paperColor] + + -mattecolor color + Set the matte color, i.e., the color used for back- + ground outside the actual page area. (There is a + separate setting, xpdf.fullScreenMatteColor, for + full-screen mode.) [X resource: xpdf.matteColor] + + -z zoom + Set 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. [config file: initialZoom; or X + resource: xpdf.initialZoom] + + -cont Start in continuous view mode, i.e., with one ver- + tical scroll bar for the whole document. [config + file: continuousView] + + -t1lib yes | no + Enable or disable t1lib (a Type 1 font rasterizer). + This defaults to "yes". [config file: enableT1lib] + + -freetype yes | no + Enable or disable FreeType (a TrueType / Type 1 + font rasterizer). This defaults to "yes". [config + file: enableFreeType] + + -aa yes | no + Enable or disable font anti-aliasing. This + defaults to "yes". [config file: antialias] + + -aaVector yes | no + Enable or disable vector anti-aliasing. This + defaults to "yes". [config file: vectorAntialias] + + -ps PS-file + Set the default file name for PostScript output + (i.e., the name which will appear in the print dia- + log). This can also be of the form '|command' to + pipe the PostScript through a command. [config + file: psFile] + + -paper size + Set the paper size to one of "letter", "legal", + "A4", or "A3". This can also be set to "match", + which will set the paper size to match the size + specified in the PDF file. [config file: psPaper- + Size] + + -paperw size + Set the paper width, in points. [config file: + psPaperSize] + + -paperh size + Set the paper height, in points. [config file: + psPaperSize] + + -level1 + Generate Level 1 PostScript. The resulting + PostScript files will be significantly larger (if + they contain images), but will print on Level 1 + printers. This also converts all images to black + and white. [config file: psLevel] + + -enc encoding-name + Sets the encoding to use for text output. The + encoding-name must be defined with the unicodeMap + command (see xpdfrc(5)). This defaults to "Latin1" + (which is a built-in encoding). [config file: tex- + tEncoding] + + -eol unix | dos | mac + Sets the end-of-line convention to use for text + output. [config file: textEOL] + + -opw password + Specify the owner password for the PDF file. Pro- + viding this will bypass all security restrictions. + + -upw password + Specify the user password for the PDF file. + + -fullscreen + Open xpdf in full-screen mode, useful for presenta- + tions. + + -remote name + Start/contact xpdf remote server with specified + name (see the REMOTE SERVER MODE section below). + + -exec command + Execute a command (see the COMMANDS section below) + in an xpdf remote server window (with -remote + only). + + -reload + Reload xpdf remote server window (with -remote + only). + + -raise Raise xpdf remote server window (with -remote + only). + + -quit Kill xpdf remote server (with -remote only). + + -cmd Print commands as they're executed (useful for + debugging). [config file: printCommands] + + -q Don't print any messages or errors. [config file: + errQuiet] + + -cfg config-file + Read config-file in place of ~/.xpdfrc or the sys- + tem-wide config file. + + -v Print copyright and version information. + + -h Print usage information. (-help and --help are + equivalent.) + + Several other standard X options and resources will work + as expected: + + -display display + [X resource: xpdf.display] + + -fg color + (-foreground is equivalent.) [X resource: + xpdf*Foreground] + + -bg color + (-background is equivalent.) [X resource: + xpdf*Background] + + -font font + (-fn is equivalent.) [X resource: xpdf*fontList] + + The color and font options only affect the user interface + elements, not the PDF display (the 'paper'). + + The following X resources do not have command line option + equivalents: + + xpdf.toolTipEnable + Enables (if set to true) or disables (if set to + false) the tool-tips on the toolbar buttons. + + xpdf.fullScreenMatteColor + Sets the matte color to be used in full-screen + mode. The default setting is "black". + +CONTROLS + On-screen controls, at the bottom of the xpdf window + left/right arrow buttons + Move to the previous/next page. + + double left/right arrow buttons + Move backward or forward by ten pages. + + dashed left/right arrow buttons + Move backward or forward along the history path. + + 'Page' entry box + Move to a specific page number. Click in the box + to activate it, type the page number, then hit + return. + + zoom popup menu + Change the zoom factor (see the description of the + -z option above). + + binoculars button + Find a text string. + + print button + Bring up a dialog for generating a PostScript file. + The dialog has options to set the pages to be + printed and the PostScript file name. The file + name can be '-' for stdout or '|command' to pipe + the PostScript through a command, e.g., '|lpr'. + + '?' button + Bring up the 'about xpdf' window. + + link info + The space between the '?' and 'Quit' buttons is + used to show the URL or external file name when the + mouse is over a link. + + 'Quit' button + Quit xpdf. + + + Menu + Pressing the right mouse button will post a popup menu + with the following commands: + + Open... + Open a new PDF file via a file requester. + + Open in new window... + Create a new window and open a new PDF file via a + file requester. + + Reload Reload the current PDF file. Note that Xpdf will + reload the file automatically (on a page change or + redraw) if it has changed since it was last loaded. + + Save as... + Save the current file via a file requester. + + Continuous view + Toggles between single page and continuous view + modes. + + Rotate counterclockwise + Rotate the page 90 degrees counterclockwise. + + Rotate clockwise + Rotate the page 90 degrees clockwise. The two + rotate commands are intended primarily for PDF + files where the rotation isn't correctly specified + in the file. + + Zoom to selection + Zoom in to the currently selected rectangle. + + Close Close the current window. If this is the only open + window, the document is closed, but the window is + left open (i.e., this menu command won't quit + xpdf). + + Quit Quit xpdf. + + + Outline + If the PDF contains an outline (a.k.a., bookmarks), there + will be an outline pane on the left side of the window. + The width of the outline pane is adjustable with a verti- + cal split bar via the knob near its bottom end. + + + Text selection + Dragging the mouse with the left button held down will + highlight an arbitrary rectangle. Any text inside this + rectangle will be copied to the X selection buffer. + + + Links + Clicking on a hyperlink will jump to the link's + destination. A link to another PDF document will make + xpdf load that document. A 'launch' link to an executable + program will display a dialog, and if you click 'ok', exe- + cute the program. URL links call an external command (see + the WEB BROWSERS section below). + + + Panning + Dragging the mouse with the middle button held down pans + the window. + + + Key bindings + o Open a new PDF file via a file requester. + + r Reload the current PDF file. Note that Xpdf will + reload the file automatically (on a page change or + redraw) if it has changed since it was last loaded. + + control-L + Redraw the current page. + + control-W + Close the current window. + + f or control-F + Find a text string. + + control-G + Find next occurrence. + + control-P + Print. + + n Move to the next page. Scrolls to the top of the + page, unless scroll lock is turned on. + + p Move to the previous page. Scrolls to the top of + the page, unless scroll lock is turned on. + + <Space> or <PageDown> or <Next> + Scroll down on the current page; if already at bot- + tom, move to next page. + + <Backspace> or <Delete> or <PageUp> or <Previous> + Scroll up on the current page; if already at top, + move to previous page. + + v Move forward along the history path. + + b Move backward along the history path. + + <Home> Scroll to top of current page. + + <End> Scroll to bottom of current page. + + control-<Home> + Scroll to first page of document. + + control-<End> + Scroll to last page of document. + + arrows Scroll the current page. + + g Activate the page number text field ("goto page"). + + 0 Set the zoom factor to 125%. + + + Zoom in (increment the zoom factor by 1). + + - Zoom out (decrement the zoom factor by 1). + + z Set the zoom factor to 'page' (fit page to window). + + w Set the zoom factor to 'width' (fit page width to + window). + + alt-F Toggle full-screen mode. + + q Quit xpdf. + +WEB BROWSERS + If you want to run xpdf automatically from netscape or + mosaic (and probably other browsers) when you click on a + link to a PDF file, you need to edit (or create) the files + .mime.types and .mailcap in your home directory. In + .mime.types add the line: + + application/pdf pdf + + In .mailcap add the lines: + + # Use xpdf to view PDF files. + application/pdf; xpdf -q %s + + Make sure that xpdf is on your executable search path. + + When you click on a URL link in a PDF file, xpdf will exe- + cute the command specified by the urlCommand config file + option, replacing an occurrence of '%s' with the URL. For + example, to call netscape with the URL, add this line to + your config file: + + urlCommand "netscape -remote 'openURL(%s)'" + +COMMANDS + Xpdf's key and mouse bindings are user-configurable, using + the bind and unbind options in the config file (see + xpdfrc(5)). The bind command allows you to bind a key or + mouse button to a sequence of one or more commands. + + Available Commands + The following commands are supported: + + gotoPage(page) + Go to the specified page. + + gotoPageNoScroll(page) + Go to the specified page, with the current relative + scroll position. + + gotoDest(dest) + Go to a named destination. + + gotoLastPage + Go to the last page in the PDF file. + + gotoLastPageNoScroll + Go to the last page in the PDF file, with the cur- + rent relative scroll position. + + nextPage + Go to the next page. + + nextPageNoScroll + Go to the next page, with the current relative + scroll position. + + prevPage + Go to the previous page. + + prevPageNoScroll + Go to the previous page, with the current relative + scroll position. + + pageUp Scroll up by one screenful. + + pageDown + Scroll down by one screenful. + + scrollLeft(n) + Scroll left by n pixels. + + scrollRight(n) + Scroll right by n pixels. + + scrollUp(n) + Scroll up by n pixels. + + scrollDown(n) + Scroll down by n pixels. + + scrollUpPrevPage(n) + Scroll up by n pixels, moving to the previous page + if appropriate. + + scrollDownPrevPage(n) + Scroll down by n pixels, moving to the next page if + appropriate. + + scrollToTopEdge + Scroll to the top edge of the current page, with no + horizontal movement. + + scrollToBottomEdge + Scroll to the bottom edge of the current page, with + no horizontal movement. + + scrollToLeftEdge + Scroll to the left edge of the current page, with + no vertical movement. + + scrollToRightEdge + Scroll to the right edge of the current page, with + no vertical movement. + + scrollToTopLeft + Scroll to the top-left corner of the current page. + + scrollToBottomRight + Scroll to the bottom-right corner of the current + page. + + goForward + Move forward along the history path. + + goBackward + Move backward along the history path. + + zoomPercent(z) + Set the zoom factor to z%. + + zoomFitPage + Set the zoom factor to fit-page. + + zoomFitWidth + Set the zoom factor to fit-width. + + zoomIn Zoom in - go to the next higher zoom factor. + + zoomOut + Zoom out - go the next lower zoom factor. + + continuousMode + Go to continuous view mode. + + singlePageMode + Go to single-page view mode. + + toggleContinuousMode + Toggle between continuous and single page view + modes. + + fullScreenMode + Go to full-screen mode. + + windowMode + Go to window (non-full-screen) mode. + + toggleFullScreenMode + Toggle between full-screen and window modes. + + open Open a PDF file in this window, using the open dia- + log. + + openInNewWin + Open a PDF file in a new window, using the open + dialog. + + openFile(file) + Open a specified PDF file in this window. + + openFileInNewWin(file) + Open a specified PDF file in a new window. + + openFileAtDest(file,dest) + Open a specified PDF file in this window and go to + a named destination. + + openFileAtDestInNewWin(file,dest) + Open a specified PDF file in a new window and go to + a named destination. + + reload Reload the current PDF file. + + redraw Redraw the window. + + raise Raise the window to the front. + + closeWindow + Close the window. + + run(external-command-string) + Run an external command. The following escapes are + allowed in the command string: + + %f => PDF file name (or an empty string if no + file is open) + %b => PDF file base name, i.e., file name minus + the extension (or an empty string if no + file is open) + %u => link URL (or an empty string if not over + a URL link) + %x => selection upper-left x coordinate + (or 0 if there is no selection) + %y => selection upper-left y coordinate + (or 0 if there is no selection) + %X => selection lower-right x coordinate + (or 0 if there is no selection) + %Y => selection lower-right y coordinate + (or 0 if there is no selection) + %% => % + + + openOutline + Open the outline pane. + + closeOutline + Close the outline pane. + + toggleOutline + Toggle the outline pane between open and closed. + + scrollOutlineDown(n) + Scroll the outline down by n increments. + + scrollOutlineUp(n) + Scroll the outline up by n increments. + + focusToDocWin + Set the keyboard focus to the main document window. + + focusToPageNum + Set the keyboard focus to the page number text box. + + find Open the 'find' dialog. + + findNext + Finds the next occurrence of the search string (no + dialog). + + print Open the 'print' dialog. + + about Open the 'about' dialog. + + quit Quit from xpdf. + + The following commands depend on the current mouse posi- + tion: + + startSelection + Start a selection, which will be extended as the + mouse moves. + + endSelection + End a selection. + + startPan + Start a pan, which will scroll the document as the + mouse moves + + endPan End a pan. + + postPopupMenu + Display the popup menu. + + followLink + Follow a hyperlink (does nothing if the mouse is + not over a link). + + followLinkInNewWin + Follow a hyperlink, opening PDF files in a new win- + dow (does nothing if the mouse is not over a link). + For links to non-PDF files, this command is identi- + cal to followLink. + + followLinkNoSel + Same as followLink, but does nothing if there is a + non-empty selection. (This is useful as a mouse + button binding.) + + followLinkInNewWinNoSel + Same as followLinkInNewWin, but does nothing if + there is a non-empty selection. (This is useful as + a mouse button binding.) + + Default Bindings + The default mouse bindings are as follows: + + bind mousePress1 any startSelection + bind mouseRelease1 any endSelection followLinkNoSel + bind mousePress2 any startPan + bind mouseRelease2 any endPan + bind mousePress3 any postPopupMenu + bind mousePress4 any scrollUpPrevPage(16) + bind mousePress5 any scrollDownNextPage(16) + bind mousePress6 any scrollLeft(16) + bind mousePress7 any scrollRight(16) + + The default key bindings are as follows: + + bind ctrl-home any gotoPage(1) + bind home any scrollToTopLeft + bind ctrl-end any gotoLastPage + bind end any scrollToBottomRight + bind pgup any pageUp + bind backspace any pageUp + bind delete any pageUp + bind pgdn any pageDown + bind space any pageDown + bind left any scrollLeft(16) + bind right any scrollRight(16) + bind up any scrollUp(16) + bind down any scrollDown(16) + bind o any open + bind O any open + bind r any reload + bind R any reload + bind f any find + bind F any find + bind ctrl-f any find + bind ctrl-g any findNext + bind ctrl-p any print + bind n scrLockOff nextPage + bind N scrLockOff nextPage + bind n scrLockOn nextPageNoScroll + bind N scrLockOn nextPageNoScroll + bind p scrLockOff prevPage + bind P scrLockOff prevPage + bind p scrLockOn prevPageNoScroll + bind P scrLockOn prevPageNoScroll + bind v any goForward + bind b any goBackward + bind g any focusToPageNum + bind 0 any zoomPercent(125) + bind + any zoomIn + bind - any zoomOut + bind z any zoomFitPage + bind w any zoomFitWidth + bind alt-f any toggleFullScreenMode + bind ctrl-l any redraw + bind ctrl-w any closeWindow + bind ? any about + bind q any quit + bind Q any quit + + Previous versions of xpdf included a "viKeys" X resource. + It is no longer available, but the following bindings are + equivalent: + + bind h any scrollLeft(16) + bind l any scrollRight(16) + bind k any scrollUp(16) + bind j any scrollDown(16) + + +REMOTE SERVER MODE + Xpdf can be started in remote server mode by specifying a + server name (in addition to the file name and page num- + ber). For example: + + xpdf -remote myServer file.pdf + + If there is currently no xpdf running in server mode with + the name 'myServer', a new xpdf window will be opened. If + another command: + + xpdf -remote myServer another.pdf 9 + + is issued, a new copy of xpdf will not be started. + Instead, the first xpdf (the server) will load another.pdf + and display page nine. If the file name is the same: + + xpdf -remote myServer another.pdf 4 + + the xpdf server will simply display the specified page. + + The -raise option tells the server to raise its window; it + can be specified with or without a file name and page num- + ber. + + The -quit option tells the server to close its window and + exit. + +EXIT CODES + The Xpdf tools use the following exit codes: + + 0 No error. + + 1 Error opening a PDF file. + + 2 Error opening an output file. + + 3 Error related to PDF permissions. + + 99 Other error. + +AUTHOR + The xpdf software and documentation are copyright + 1996-2007 Glyph & Cog, LLC. + +SEE ALSO + pdftops(1), pdftotext(1), pdfinfo(1), pdffonts(1), + pdftoppm(1), pdfimages(1), xpdfrc(5) + http://www.foolabs.com/xpdf/ + + + + 27 February 2007 xpdf(1) diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/xpdf.hlp b/Build/source/libs/xpdf/xpdf-3.02/doc/xpdf.hlp new file mode 100644 index 00000000000..1f90bab755e --- /dev/null +++ b/Build/source/libs/xpdf/xpdf-3.02/doc/xpdf.hlp @@ -0,0 +1,823 @@ +! Generated automatically by mantohlp +1 xpdf + + xpdf - Portable Document Format (PDF) file viewer for X + (version 3.02) + + xpdf [options] [PDF-file [page | +dest]] + + Xpdf is a viewer for Portable Document Format (PDF) files. + (These are also sometimes also called 'Acrobat' files, + from the name of Adobe's PDF software.) Xpdf runs under + the X Window System on UNIX, VMS, and OS/2. + + To run xpdf, simply type: + + xpdf file.pdf + + where file.pdf is your PDF file. The file name can be + followed by a number specifying the page which should be + displayed first, e.g.: + + xpdf file.pdf 18 + + You can also give a named destination, prefixed with '+' + in place of the page number. (This is only useful with + PDF files that provide named destination targets.) + + You can also start xpdf without opening any files: + + xpdf + + () + +2 ONFIGURATION_FIL + + Xpdf reads a configuration file at startup. It first + tries to find the user's private config file, ~/.xpdfrc. + If that doesn't exist, it looks for a system-wide config + file, typically /usr/local/etc/xpdfrc (but this location + can be changed when xpdf is built). See the xpdfrc(5) man + page for details. + + () + +2 OPTIONS + + Many of the following options can be set with configura- + tion file commands or X resources. These are listed in + square brackets with the description of the corresponding + command line option. + + -g geometry + Set the initial window geometry. (-geometry is + equivalent.) [X resource: xpdf.geometry] + + -title title + Set the window title. By default, the title will + be "xpdf: foo.pdf". [X resource: xpdf.title] + + -cmap Install a private colormap. This is ignored on + TrueColor visuals. [X resource: xpdf.installCmap] + + -rgb number + Set the size of largest RGB cube xpdf will try to + allocate. The default is 5 (for a 5x5x5 cube); set + to a smaller number to conserve color table + entries. This is ignored with private colormaps + and on TrueColor visuals. [X resource: + xpdf.rgbCubeSize] + + -rv Set reverse video mode. This reverses the colors + of everything except images. It may not always + produce great results for PDF files which do weird + things with color. This also causes the paper + color to default to black. [X resource: + xpdf.reverseVideo] + + -papercolor color + Set the "paper color", i.e., the background of the + page display. This will not work too well with PDF + files that do things like filling in white behind + the text. [X resource: xpdf.paperColor] + + -mattecolor color + Set the matte color, i.e., the color used for back- + ground outside the actual page area. (There is a + separate setting, xpdf.fullScreenMatteColor, for + full-screen mode.) [X resource: xpdf.matteColor] + + -z zoom + Set 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. [config file: initialZoom; or X + resource: xpdf.initialZoom] + + -cont Start in continuous view mode, i.e., with one ver- + tical scroll bar for the whole document. [config + file: continuousView] + + -t1lib yes | no + Enable or disable t1lib (a Type 1 font rasterizer). + This defaults to "yes". [config file: enableT1lib] + + -freetype yes | no + Enable or disable FreeType (a TrueType / Type 1 + font rasterizer). This defaults to "yes". [config + file: enableFreeType] + + -aa yes | no + Enable or disable font anti-aliasing. This + defaults to "yes". [config file: antialias] + + -aaVector yes | no + Enable or disable vector anti-aliasing. This + defaults to "yes". [config file: vectorAntialias] + + -ps PS-file + Set the default file name for PostScript output + (i.e., the name which will appear in the print dia- + log). This can also be of the form '|command' to + pipe the PostScript through a command. [config + file: psFile] + + -paper size + Set the paper size to one of "letter", "legal", + "A4", or "A3". This can also be set to "match", + which will set the paper size to match the size + specified in the PDF file. [config file: psPaper- + Size] + + -paperw size + Set the paper width, in points. [config file: + psPaperSize] + + -paperh size + Set the paper height, in points. [config file: + psPaperSize] + + -level1 + Generate Level 1 PostScript. The resulting + PostScript files will be significantly larger (if + they contain images), but will print on Level 1 + printers. This also converts all images to black + and white. [config file: psLevel] + + -enc encoding-name + Sets the encoding to use for text output. The + encoding-name must be defined with the unicodeMap + command (see xpdfrc(5)). This defaults to "Latin1" + (which is a built-in encoding). [config file: tex- + tEncoding] + + -eol unix | dos | mac + Sets the end-of-line convention to use for text + output. [config file: textEOL] + + -opw password + Specify the owner password for the PDF file. Pro- + viding this will bypass all security restrictions. + + -upw password + Specify the user password for the PDF file. + + -fullscreen + Open xpdf in full-screen mode, useful for presenta- + tions. + + -remote name + Start/contact xpdf remote server with specified + name (see the REMOTE SERVER MODE section below). + + -exec command + Execute a command (see the COMMANDS section below) + in an xpdf remote server window (with -remote + only). + + -reload + Reload xpdf remote server window (with -remote + only). + + -raise Raise xpdf remote server window (with -remote + only). + + -quit Kill xpdf remote server (with -remote only). + + -cmd Print commands as they're executed (useful for + debugging). [config file: printCommands] + + -q Don't print any messages or errors. [config file: + errQuiet] + + -cfg config-file + Read config-file in place of ~/.xpdfrc or the sys- + tem-wide config file. + + -v Print copyright and version information. + + -h Print usage information. (-help and --help are + equivalent.) + + Several other standard X options and resources will work + as expected: + + -display display + [X resource: xpdf.display] + + -fg color + (-foreground is equivalent.) [X resource: + xpdf*Foreground] + + -bg color + (-background is equivalent.) [X resource: + xpdf*Background] + + -font font + (-fn is equivalent.) [X resource: xpdf*fontList] + + The color and font options only affect the user interface + elements, not the PDF display (the 'paper'). + + The following X resources do not have command line option + equivalents: + + xpdf.toolTipEnable + Enables (if set to true) or disables (if set to + false) the tool-tips on the toolbar buttons. + + xpdf.fullScreenMatteColor + Sets the matte color to be used in full-screen + mode. The default setting is "black". + + () + +2 CONTROLS + + On-screen controls, at the bottom of the xpdf window + left/right arrow buttons + Move to the previous/next page. + + double left/right arrow buttons + Move backward or forward by ten pages. + + dashed left/right arrow buttons + Move backward or forward along the history path. + + 'Page' entry box + Move to a specific page number. Click in the box + to activate it, type the page number, then hit + return. + + zoom popup menu + Change the zoom factor (see the description of the + -z option above). + + binoculars button + Find a text string. + + print button + Bring up a dialog for generating a PostScript file. + The dialog has options to set the pages to be + printed and the PostScript file name. The file + name can be '-' for stdout or '|command' to pipe + the PostScript through a command, e.g., '|lpr'. + + '?' button + Bring up the 'about xpdf' window. + + link info + The space between the '?' and 'Quit' buttons is + used to show the URL or external file name when the + mouse is over a link. + + 'Quit' button + Quit xpdf. + + Menu + Pressing the right mouse button will post a popup menu + with the following commands: + + Open... + Open a new PDF file via a file requester. + + Open in new window... + Create a new window and open a new PDF file via a + file requester. + + Reload Reload the current PDF file. Note that Xpdf will + reload the file automatically (on a page change or + redraw) if it has changed since it was last loaded. + + Save as... + Save the current file via a file requester. + + Continuous view + Toggles between single page and continuous view + modes. + + Rotate counterclockwise + Rotate the page 90 degrees counterclockwise. + + Rotate clockwise + Rotate the page 90 degrees clockwise. The two + rotate commands are intended primarily for PDF + files where the rotation isn't correctly specified + in the file. + + Zoom to selection + Zoom in to the currently selected rectangle. + + Close Close the current window. If this is the only open + window, the document is closed, but the window is + left open (i.e., this menu command won't quit + xpdf). + + Quit Quit xpdf. + + Outline + If the PDF contains an outline (a.k.a., bookmarks), there + will be an outline pane on the left side of the window. + The width of the outline pane is adjustable with a verti- + cal split bar via the knob near its bottom end. + + Text selection + Dragging the mouse with the left button held down will + highlight an arbitrary rectangle. Any text inside this + rectangle will be copied to the X selection buffer. + + Links + Clicking on a hyperlink will jump to the link's destina- + tion. A link to another PDF document will make xpdf load + that document. A 'launch' link to an executable program + will display a dialog, and if you click 'ok', execute the + program. URL links call an external command (see the WEB + BROWSERS section below). + + Panning + Dragging the mouse with the middle button held down pans + the window. + + Key bindings + o Open a new PDF file via a file requester. + + r Reload the current PDF file. Note that Xpdf will + reload the file automatically (on a page change or + redraw) if it has changed since it was last loaded. + + control-L + Redraw the current page. + + control-W + Close the current window. + + f or control-F + Find a text string. + + control-G + Find next occurrence. + + control-P + Print. + + n Move to the next page. Scrolls to the top of the + page, unless scroll lock is turned on. + + p Move to the previous page. Scrolls to the top of + the page, unless scroll lock is turned on. + + <Space> or <PageDown> or <Next> + Scroll down on the current page; if already at bot- + tom, move to next page. + + <Backspace> or <Delete> or <PageUp> or <Previous> + Scroll up on the current page; if already at top, + move to previous page. + + v Move forward along the history path. + + b Move backward along the history path. + + <Home> Scroll to top of current page. + + <End> Scroll to bottom of current page. + + control-<Home> + Scroll to first page of document. + + control-<End> + Scroll to last page of document. + + arrows Scroll the current page. + + g Activate the page number text field ("goto page"). + + 0 Set the zoom factor to 125%. + + + Zoom in (increment the zoom factor by 1). + + - Zoom out (decrement the zoom factor by 1). + + z Set the zoom factor to 'page' (fit page to window). + + w Set the zoom factor to 'width' (fit page width to + window). + + alt-F Toggle full-screen mode. + + q Quit xpdf. + + () + +2 WEB_BROWSERS + + If you want to run xpdf automatically from netscape or + mosaic (and probably other browsers) when you click on a + link to a PDF file, you need to edit (or create) the files + .mime.types and .mailcap in your home directory. In + .mime.types add the line: + + application/pdf pdf + + In .mailcap add the lines: + + # Use xpdf to view PDF files. + application/pdf; xpdf -q %s + + Make sure that xpdf is on your executable search path. + + When you click on a URL link in a PDF file, xpdf will exe- + cute the command specified by the urlCommand config file + option, replacing an occurrence of '%s' with the URL. For + example, to call netscape with the URL, add this line to + your config file: + + urlCommand "netscape -remote 'openURL(%s)'" + + () + +2 COMMANDS + + Xpdf's key and mouse bindings are user-configurable, using + the bind and unbind options in the config file (see + xpdfrc(5)). The bind command allows you to bind a key or + mouse button to a sequence of one or more commands. + + Available Commands + The following commands are supported: + + gotoPage(page) + Go to the specified page. + + gotoPageNoScroll(page) + Go to the specified page, with the current relative + scroll position. + + gotoDest(dest) + Go to a named destination. + + gotoLastPage + Go to the last page in the PDF file. + + gotoLastPageNoScroll + Go to the last page in the PDF file, with the cur- + rent relative scroll position. + + nextPage + Go to the next page. + + nextPageNoScroll + Go to the next page, with the current relative + scroll position. + + prevPage + Go to the previous page. + + prevPageNoScroll + Go to the previous page, with the current relative + scroll position. + + pageUp Scroll up by one screenful. + + pageDown + Scroll down by one screenful. + + scrollLeft(n) + Scroll left by n pixels. + + scrollRight(n) + Scroll right by n pixels. + + scrollUp(n) + Scroll up by n pixels. + + scrollDown(n) + Scroll down by n pixels. + + scrollUpPrevPage(n) + Scroll up by n pixels, moving to the previous page + if appropriate. + + scrollDownPrevPage(n) + Scroll down by n pixels, moving to the next page if + appropriate. + + scrollToTopEdge + Scroll to the top edge of the current page, with no + horizontal movement. + + scrollToBottomEdge + Scroll to the bottom edge of the current page, with + no horizontal movement. + + scrollToLeftEdge + Scroll to the left edge of the current page, with + no vertical movement. + + scrollToRightEdge + Scroll to the right edge of the current page, with + no vertical movement. + + scrollToTopLeft + Scroll to the top-left corner of the current page. + + scrollToBottomRight + Scroll to the bottom-right corner of the current + page. + + goForward + Move forward along the history path. + + goBackward + Move backward along the history path. + + zoomPercent(z) + Set the zoom factor to z%. + + zoomFitPage + Set the zoom factor to fit-page. + + zoomFitWidth + Set the zoom factor to fit-width. + + zoomIn Zoom in - go to the next higher zoom factor. + + zoomOut + Zoom out - go the next lower zoom factor. + + continuousMode + Go to continuous view mode. + + singlePageMode + Go to single-page view mode. + + toggleContinuousMode + Toggle between continuous and single page view + modes. + + fullScreenMode + Go to full-screen mode. + + windowMode + Go to window (non-full-screen) mode. + + toggleFullScreenMode + Toggle between full-screen and window modes. + + open Open a PDF file in this window, using the open + dialog. + + openInNewWin + Open a PDF file in a new window, using the open + dialog. + + openFile(file) + Open a specified PDF file in this window. + + openFileInNewWin(file) + Open a specified PDF file in a new window. + + openFileAtDest(file,dest) + Open a specified PDF file in this window and go to + a named destination. + + openFileAtDestInNewWin(file,dest) + Open a specified PDF file in a new window and go to + a named destination. + + reload Reload the current PDF file. + + redraw Redraw the window. + + raise Raise the window to the front. + + closeWindow + Close the window. + + run(external-command-string) + Run an external command. The following escapes are + allowed in the command string: + + %f => PDF file name (or an empty string if no + file is open) + %b => PDF file base name, i.e., file name minus + the extension (or an empty string if no + file is open) + %u => link URL (or an empty string if not over + a URL link) + %x => selection upper-left x coordinate + (or 0 if there is no selection) + %y => selection upper-left y coordinate + (or 0 if there is no selection) + %X => selection lower-right x coordinate + (or 0 if there is no selection) + %Y => selection lower-right y coordinate + (or 0 if there is no selection) + %% => % + + openOutline + Open the outline pane. + + closeOutline + Close the outline pane. + + toggleOutline + Toggle the outline pane between open and closed. + + scrollOutlineDown(n) + Scroll the outline down by n increments. + + scrollOutlineUp(n) + Scroll the outline up by n increments. + + focusToDocWin + Set the keyboard focus to the main document window. + + focusToPageNum + Set the keyboard focus to the page number text box. + + find Open the 'find' dialog. + + findNext + Finds the next occurrence of the search string (no + dialog). + + print Open the 'print' dialog. + + about Open the 'about' dialog. + + quit Quit from xpdf. + + The following commands depend on the current mouse posi- + tion: + + startSelection + Start a selection, which will be extended as the + mouse moves. + + endSelection + End a selection. + + startPan + Start a pan, which will scroll the document as the + mouse moves + + endPan End a pan. + + postPopupMenu + Display the popup menu. + + followLink + Follow a hyperlink (does nothing if the mouse is + not over a link). + + followLinkInNewWin + Follow a hyperlink, opening PDF files in a new win- + dow (does nothing if the mouse is not over a link). + For links to non-PDF files, this command is identi- + cal to followLink. + + followLinkNoSel + Same as followLink, but does nothing if there is a + non-empty selection. (This is useful as a mouse + button binding.) + + followLinkInNewWinNoSel + Same as followLinkInNewWin, but does nothing if + there is a non-empty selection. (This is useful as + a mouse button binding.) + + Default Bindings + The default mouse bindings are as follows: + + bind mousePress1 any startSelection + bind mouseRelease1 any endSelection followLinkNoSel + bind mousePress2 any startPan + bind mouseRelease2 any endPan + bind mousePress3 any postPopupMenu + bind mousePress4 any scrollUpPrevPage(16) + bind mousePress5 any scrollDownNextPage(16) + bind mousePress6 any scrollLeft(16) + bind mousePress7 any scrollRight(16) + + The default key bindings are as follows: + + bind ctrl-home any gotoPage(1) + bind home any scrollToTopLeft + bind ctrl-end any gotoLastPage + bind end any scrollToBottomRight + bind pgup any pageUp + bind backspace any pageUp + bind delete any pageUp + bind pgdn any pageDown + bind space any pageDown + bind left any scrollLeft(16) + bind right any scrollRight(16) + bind up any scrollUp(16) + bind down any scrollDown(16) + bind o any open + bind O any open + bind r any reload + bind R any reload + bind f any find + bind F any find + bind ctrl-f any find + bind ctrl-g any findNext + bind ctrl-p any print + bind n scrLockOff nextPage + bind N scrLockOff nextPage + bind n scrLockOn nextPageNoScroll + bind N scrLockOn nextPageNoScroll + bind p scrLockOff prevPage + bind P scrLockOff prevPage + bind p scrLockOn prevPageNoScroll + bind P scrLockOn prevPageNoScroll + bind v any goForward + bind b any goBackward + bind g any focusToPageNum + bind 0 any zoomPercent(125) + bind + any zoomIn + bind - any zoomOut + bind z any zoomFitPage + bind w any zoomFitWidth + bind alt-f any toggleFullScreenMode + bind ctrl-l any redraw + bind ctrl-w any closeWindow + bind ? any about + bind q any quit + bind Q any quit + + Previous versions of xpdf included a "viKeys" X resource. + It is no longer available, but the following bindings are + equivalent: + + bind h any scrollLeft(16) + bind l any scrollRight(16) + bind k any scrollUp(16) + bind j any scrollDown(16) + + () + +2 REMOTE_SERVER_MODE + + Xpdf can be started in remote server mode by specifying a + server name (in addition to the file name and page num- + ber). For example: + + xpdf -remote myServer file.pdf + + If there is currently no xpdf running in server mode with + the name 'myServer', a new xpdf window will be opened. If + another command: + + xpdf -remote myServer another.pdf 9 + + is issued, a new copy of xpdf will not be started. + Instead, the first xpdf (the server) will load another.pdf + and display page nine. If the file name is the same: + + xpdf -remote myServer another.pdf 4 + + the xpdf server will simply display the specified page. + + The -raise option tells the server to raise its window; it + can be specified with or without a file name and page num- + ber. + + The -quit option tells the server to close its window and + exit. + + () + +2 XIT_CODE + + The Xpdf tools use the following exit codes: + + 0 No error. + + 1 Error opening a PDF file. + + 2 Error opening an output file. + + 3 Error related to PDF permissions. + + 99 Other error. + + () + +2 AUTHOR + + The xpdf software and documentation are copyright + 1996-2007 Glyph & Cog, LLC. + + () + +2 SEE_ALSO + + pdftops(1), pdftotext(1), pdfinfo(1), pdffonts(1), + pdftoppm(1), pdfimages(1), xpdfrc(5) + http://www.foolabs.com/xpdf/ + + () + diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/xpdfrc.5 b/Build/source/libs/xpdf/xpdf-3.02/doc/xpdfrc.5 new file mode 100644 index 00000000000..4e1545527c9 --- /dev/null +++ b/Build/source/libs/xpdf/xpdf-3.02/doc/xpdfrc.5 @@ -0,0 +1,617 @@ +.\" Copyright 2002-2007 Glyph & Cog, LLC +.TH xpdfrc 5 "27 February 2007" +.SH NAME +xpdfrc \- configuration file for Xpdf tools (version 3.02) +.SH DESCRIPTION +All of the Xpdf tools read a single configuration file. If you have a +.I .xpdfrc +file in your home directory, it will be read. Otherwise, a +system-wide configuration file will be read from +.IR /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 +.I xpdfrc +file should be placed in the same directory as the executables. +.PP +The xpdfrc file consists of a series of configuration options, one +per line. Blank lines and lines starting with a \'#' (comments) are +ignored. +.PP +The following sections list all of the configuration options, sorted +into functional groups. There is an examples section at the end. +.SH INCLUDE FILES +.TP +.BI include " config\-file" +Includes the specified config file. The effect of this is equivalent +to inserting the contents of +.I config\-file +directly into the parent config file in place of the +.I include +command. Config files can be nested arbitrarily deeply. +.SH CHARACTER MAPPING +.TP +.BI 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: + +.I " " hex\-string name + +The +.I hex\-string +is the Unicode (UCS-2) character index, and +.I 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. +.TP +.BI 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: + +.I " " hex\-string + +The +.I 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. +.TP +.BI 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 +.IR font\-name\-substring . +Each line of a unicodeToUnicode file represents one Unicode character: + +.RI " " in\-hex " " out\-hex1 " " out\-hex2 " ..." + +The +.I 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 +.I in\-hex +will be converted to the specified output sequence. +.TP +.BI unicodeMap " encoding\-name map\-file" +Specifies the file with mapping from Unicode to +.IR 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: +.nf + +.I " " in\-start\-hex in\-end\-hex out\-start\-hex + +.fi +Entries for single characters can be abbreviated to: +.nf + +.I " " in\-hex out\-hex + +.fi +The +.I in\-start\-hex +and +.I in\-end\-hex +fields (or the single +.I in\-hex +field) specify the Unicode range. The +.I out\-start\-hex +field (or the +.I out\-hex +field) specifies the start of the output encoding range. The length +of the +.I out\-start\-hex +(or +.IR 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 +.IR Latin1 , +.IR ASCII7 , +.IR Symbol , +.IR ZapfDingbats , +.IR UTF-8 , +and +.I UCS-2 +encodings are predefined. +.TP +.BI cMapDir " registry\-ordering dir" +Specifies a search directory, +.IR dir , +for CMaps for the +.I registry\-ordering +character collection. There can be multiple directories for a +particular collection. There are no default CMap directories. +.TP +.BI toUnicodeDir " dir" +Specifies a search directory, +.IR dir , +for ToUnicode CMaps. There can be multiple ToUnicode directories. +There are no default ToUnicode directories. +.SH DISPLAY FONTS +.TP +.BI displayFontT1 " PDF\-font\-name T1\-file" +Maps a PDF font, +.IR PDF\-font\-name , +to a Type 1 font for display. The Type 1 font file, +.IR T1\-file , +should be a standard .pfa or .pfb file. +.TP +.BI displayFontTT " PDF\-font\-name TT\-file" +Maps a PDF font, +.IR PDF\-font\-name , +to a TrueType font for display. The TrueType font file, +.IR TT\-file , +should be a standard .ttf file. +.TP +.BI displayNamedCIDFontT1 " PDF\-font\-name T1\-file" +Maps a specific PDF CID (16-bit) font, +.IR PDF\-font\-name , +to a CID font (16-bit PostScript font), for display. There are no +default CID font mappings. +.TP +.BI displayCIDFontT1 " registry\-ordering T1\-file" +Maps the +.I 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. +.TP +.BI displayNamedCIDFontTT " PDF\-font\-name TT\-file" +Maps a specific PDF CID (16-bit) font, +.IR PDF\-font\-name , +to a (16-bit) TrueType font, for display. There are no default CID +font mappings. +.TP +.BI displayCIDFontTT " registry\-ordering TT\-file" +Maps the +.I registry\-ordering +character collection to a (16-bit) TrueType 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. +.TP +.BI 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). 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. +.SH POSTSCRIPT CONTROL +.TP +.BI psPaperSize " width(pts) height(pts)" +Sets the paper size for PostScript output. The +.I width +and +.I height +parameters give the paper size in PostScript points (1 point = 1/72 +inch). +.TP +.BR 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. +.TP +.BR 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. +.TP +.BR 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". +.TP +.BR 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". +.TP +.BR 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". +.TP +.BR 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 imageable area. This +defaults to "yes". +.TP +.BR 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". +.TP +.BR psLevel " level1 | level1sep | level2 | level2sep | level3 | level3Sep" +Sets the PostScript level to generate. This defaults to "level2". +.TP +.BI psFont " PDF\-font\-name PS\-font\-name" +When the +.I PDF\-font\-name +font is used in a PDF file, it will be translated to the PostScript +font +.IR PS\-font\-name , +which is assumed to be resident in the printer. Typically, +.I PDF\-font\-name +and +.I PS\-font\-name +are the same. By default, only the Base-14 fonts are assumed to be +resident. +.TP +.BI psNamedFont16 " PDF\-font\-name wMode PS\-font\-name encoding" +When the 16-bit font +.I PDF\-font\-name +is used in a PDF file with the +.I wMode +writing mode and is not embedded, the +.I PS\-font\-name +font is substituted for it. The writing mode must be either \'H' for +horizontal or \'V' for vertical. The +.I 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). +.TP +.BI psFont16 " registry\-ordering wMode PS\-font\-name encoding" +When a 16-bit font using the +.I registry\-ordering +character collection and +.I wMode +writing mode is not embedded and does not match any of the fonts +declared in psNamedFont16 commands, the +.I PS\-font\-name +font is substituted for it. The writing mode must be either \'H' for +horizontal or \'V' for vertical. The +.I 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). +.TP +.BR psEmbedType1Fonts " yes | no" +If set to "no", prevents embedding of Type 1 fonts in generated +PostScript. This defaults to "yes". +.TP +.BR psEmbedTrueTypeFonts " yes | no" +If set to "no", prevents embedding of TrueType fonts in generated +PostScript. This defaults to "yes". +.TP +.BR 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. +.TP +.BR 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. +.TP +.BR psPreload " yes | no" +If set to "yes", PDF forms are converted to PS procedures, and image +data is preloaded. This uses more memory in the PostScript +interpreter, but generates 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". +.TP +.BR psOPI " yes | no" +If set to "yes", generates PostScript OPI comments for all images and +forms which have OPI information. This option is only available if +the Xpdf tools were compiled with OPI support. This defaults to "no". +.TP +.BR psASCIIHex " yes | no" +If set to "yes", the ASCIIHexEncode filter will be used instead of +ASCII85Encode for binary data. This defaults to "no". +.TP +.BI 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. +.TP +.BI fontDir " dir" +See the description above, in the DISPLAY FONTS section. +.SH TEXT CONTROL +.TP +.BI textEncoding " encoding\-name" +Sets the encoding to use for text output. (This can be overridden +with the "-enc" switch on the command line.) The +.I encoding\-name +must be defined with the unicodeMap command (see above). This +defaults to "Latin1". +.TP +.BR textEOL " unix | dos | mac" +Sets the end-of-line convention to use for text output. The options +are: +.nf + + unix = LF + dos = CR+LF + mac = CR + +.fi +(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. +.TP +.BR textPageBreaks " yes | no" +If set to "yes", text extraction will insert page breaks (form feed +characters) between pages. This defaults to "yes". +.TP +.BR 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". +.SH MISCELLANEOUS SETTINGS +.TP +.BR initialZoom " \fIpercentage\fR | 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 window +width. +.TP +.BR 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". +.TP +.BR 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". +.TP +.BR 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 +"freetypeControl" option.) This option defaults to "yes". +.TP +.BR antialias " yes | no" +Enables or disables font anti-aliasing in the PDF rasterizer. This +option affects all font rasterizers. ("antialias" replaces the +anti-aliasing control provided by the old "t1libControl" and +"freetypeControl" options.) This default to "yes". +.TP +.BR vectorAntialias " yes | no" +Enables or disables anti-aliasing of vector graphics in the PDF +rasterizer. This defaults to "yes". +.TP +.BR strokeAdjust " yes | no" +Enables or disables stroke adjustment. This defaults to "yes". +.TP +.BR 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, clustered-dot dithering (with a round dot and 45-degree +screen angle), and stochastic clustered-dot dithering. By default, +"stochasticClustered" is used for resolutions of 300 dpi and higher, +and "dispersed" is used for resolutions lower then 300 dpi. +.TP +.BI screenSize " integer" +Sets the size of the (square) halftone screen threshold matrix. By +default, this is 4 for dispersed-dot dithering, 10 for clustered-dot +dithering, and 100 for stochastic clustered-dot dithering. +.TP +.BI 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. +.TP +.BI screenGamma " float" +Sets the halftone screen gamma correction parameter. Gamma values +greater than 1 make the output brighter; gamma values less than 1 make +it darker. The default value is 1. +.TP +.BI 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. +.TP +.BI 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. +.TP +.BI 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. +.TP +.BI 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. +.TP +.BI 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". +.TP +.BI 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". +.TP +.BI bind " modifiers-key context command ..." +Add a key or mouse button binding. +.I Modifiers +can be zero or more of: +.nf + + shift- + ctrl- + alt- + +.fi +.I Key +can be a regular ASCII character, or any one of: +.nf + + 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) + +.fi +.I Context +is either "any" or a comma-separated combination of: +.nf + + 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) + +.fi +The context string can include only one of each pair in the above +list. + +.I Command +is an Xpdf command (see the COMMANDS section of the +.BR 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: +.nf + + # 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 + +.fi +See the +.BR xpdf (1) +man page for more examples. +.TP +.BI 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). +.TP +.BI printCommands " yes | no" +If set to "yes", drawing commands are printed as they're executed +(useful for debugging). This defaults to "no". +.TP +.BI errQuiet " yes | no" +If set to "yes", this suppresses all error and warning messages from +all of the Xpdf tools. This defaults to "no". +.SH EXAMPLES +The following is a sample xpdfrc file. +.nf + +# 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)'" + +.fi +.SH FILES +.TP +.B /usr/local/etc/xpdfrc +This is the default location for the system-wide configuration file. +Depending on build options, it may be placed elsewhere. +.TP +.B $HOME/.xpdfrc +This is the user's configuration file. If it exists, it will be read +in place of the system-wide file. +.SH AUTHOR +The Xpdf software and documentation are copyright 1996-2007 Glyph & +Cog, LLC. +.SH "SEE ALSO" +.BR xpdf (1), +.BR pdftops (1), +.BR pdftotext (1), +.BR pdfinfo (1), +.BR pdftoppm (1), +.BR pdfimages (1) +.br +.B http://www.foolabs.com/xpdf/ 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) diff --git a/Build/source/libs/xpdf/xpdf-3.02/doc/xpdfrc.hlp b/Build/source/libs/xpdf/xpdf-3.02/doc/xpdfrc.hlp new file mode 100644 index 00000000000..deb9fb4e45a --- /dev/null +++ b/Build/source/libs/xpdf/xpdf-3.02/doc/xpdfrc.hlp @@ -0,0 +1,619 @@ +! Generated automatically by mantohlp +1 xpdfrc +2 NCLUDE_FILE + + xpdfrc - configuration file for Xpdf tools (version 3.02) + + 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. + + () + +2 HARACTER_MAPPIN + + 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. + + () + +2 ISPLAY_FONT + + 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. + + () + +2 OSTSCRIPT_CONTRO + + 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. + + () + +2 EXT_CONTRO + + 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". + + () + +2 ISCELLANEOUS_SETTING + + 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". + + () + +2 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)'" + + () + +2 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. + + () + +2 AUTHOR + + The Xpdf software and documentation are copyright + 1996-2007 Glyph & Cog, LLC. + + () + +2 SEE_ALSO + + xpdf(1), pdftops(1), pdftotext(1), pdfinfo(1), + pdftoppm(1), pdfimages(1) + http://www.foolabs.com/xpdf/ + + () + |