summaryrefslogtreecommitdiff
path: root/Build/source/libs/xpdf/xpdf-src/doc
diff options
context:
space:
mode:
Diffstat (limited to 'Build/source/libs/xpdf/xpdf-src/doc')
-rw-r--r--Build/source/libs/xpdf/xpdf-src/doc/pdfdetach.110
-rw-r--r--Build/source/libs/xpdf/xpdf-src/doc/pdfdetach.cat10
-rw-r--r--Build/source/libs/xpdf/xpdf-src/doc/pdffonts.114
-rw-r--r--Build/source/libs/xpdf/xpdf-src/doc/pdffonts.cat33
-rw-r--r--Build/source/libs/xpdf/xpdf-src/doc/pdfimages.138
-rw-r--r--Build/source/libs/xpdf/xpdf-src/doc/pdfimages.cat55
-rw-r--r--Build/source/libs/xpdf/xpdf-src/doc/pdfinfo.112
-rw-r--r--Build/source/libs/xpdf/xpdf-src/doc/pdfinfo.cat12
-rw-r--r--Build/source/libs/xpdf/xpdf-src/doc/pdftohtml.136
-rw-r--r--Build/source/libs/xpdf/xpdf-src/doc/pdftohtml.cat41
-rw-r--r--Build/source/libs/xpdf/xpdf-src/doc/pdftopng.115
-rw-r--r--Build/source/libs/xpdf/xpdf-src/doc/pdftopng.cat14
-rw-r--r--Build/source/libs/xpdf/xpdf-src/doc/pdftoppm.117
-rw-r--r--Build/source/libs/xpdf/xpdf-src/doc/pdftoppm.cat16
-rw-r--r--Build/source/libs/xpdf/xpdf-src/doc/pdftops.124
-rw-r--r--Build/source/libs/xpdf/xpdf-src/doc/pdftops.cat36
-rw-r--r--Build/source/libs/xpdf/xpdf-src/doc/pdftotext.126
-rw-r--r--Build/source/libs/xpdf/xpdf-src/doc/pdftotext.cat60
-rw-r--r--Build/source/libs/xpdf/xpdf-src/doc/sample-xpdfrc2
-rw-r--r--Build/source/libs/xpdf/xpdf-src/doc/xpdf.11005
-rw-r--r--Build/source/libs/xpdf/xpdf-src/doc/xpdf.cat884
-rw-r--r--Build/source/libs/xpdf/xpdf-src/doc/xpdfrc.5409
-rw-r--r--Build/source/libs/xpdf/xpdf-src/doc/xpdfrc.cat467
23 files changed, 1633 insertions, 1603 deletions
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdfdetach.1 b/Build/source/libs/xpdf/xpdf-src/doc/pdfdetach.1
index b0d9dd31186..0ef891d6bc2 100644
--- a/Build/source/libs/xpdf/xpdf-src/doc/pdfdetach.1
+++ b/Build/source/libs/xpdf/xpdf-src/doc/pdfdetach.1
@@ -1,8 +1,8 @@
-.\" Copyright 2013-2014 Glyph & Cog, LLC
-.TH pdfdetach 1 "28 May 2014"
+.\" Copyright 2013-2017 Glyph & Cog, LLC
+.TH pdfdetach 1 "10 Aug 2017"
.SH NAME
pdfdetach \- Portable Document Format (PDF) document embedded file
-extractor (version 3.04)
+extractor (version 4.00)
.SH SYNOPSIS
.B pdfdetach
[options]
@@ -90,7 +90,7 @@ Error related to PDF permissions.
99
Other error.
.SH AUTHOR
-The pdfinfo software and documentation are copyright 1996-2014 Glyph &
+The pdfinfo software and documentation are copyright 1996-2017 Glyph &
Cog, LLC.
.SH "SEE ALSO"
.BR xpdf (1),
@@ -104,4 +104,4 @@ Cog, LLC.
.BR pdfimages (1),
.BR xpdfrc (5)
.br
-.B http://www.foolabs.com/xpdf/
+.B http://www.xpdfreader.com/
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdfdetach.cat b/Build/source/libs/xpdf/xpdf-src/doc/pdfdetach.cat
index 8b052e26c55..66c812df6a4 100644
--- a/Build/source/libs/xpdf/xpdf-src/doc/pdfdetach.cat
+++ b/Build/source/libs/xpdf/xpdf-src/doc/pdfdetach.cat
@@ -1,10 +1,10 @@
-pdfdetach(1) pdfdetach(1)
+pdfdetach(1) General Commands Manual pdfdetach(1)
NAME
pdfdetach - Portable Document Format (PDF) document embedded file
- extractor (version 3.04)
+ extractor (version 4.00)
SYNOPSIS
pdfdetach [options] [PDF-file]
@@ -79,14 +79,14 @@ EXIT CODES
99 Other error.
AUTHOR
- The pdfinfo software and documentation are copyright 1996-2014 Glyph &
+ The pdfinfo software and documentation are copyright 1996-2017 Glyph &
Cog, LLC.
SEE ALSO
xpdf(1), pdftops(1), pdftotext(1), pdftohtml(1), pdfinfo(1), pdf-
fonts(1), pdftoppm(1), pdftopng(1), pdfimages(1), xpdfrc(5)
- http://www.foolabs.com/xpdf/
+ http://www.xpdfreader.com/
- 28 May 2014 pdfdetach(1)
+ 10 Aug 2017 pdfdetach(1)
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdffonts.1 b/Build/source/libs/xpdf/xpdf-src/doc/pdffonts.1
index 70e1f45fd8a..3812c6b50b7 100644
--- a/Build/source/libs/xpdf/xpdf-src/doc/pdffonts.1
+++ b/Build/source/libs/xpdf/xpdf-src/doc/pdffonts.1
@@ -1,8 +1,8 @@
-.\" Copyright 1999-2014 Glyph & Cog, LLC
-.TH pdffonts 1 "28 May 2014"
+.\" Copyright 1999-2017 Glyph & Cog, LLC
+.TH pdffonts 1 "10 Aug 2017"
.SH NAME
pdffonts \- Portable Document Format (PDF) font analyzer (version
-3.04)
+4.00)
.SH SYNOPSIS
.B pdffonts
[options]
@@ -32,6 +32,10 @@ the font type -- see below for details
absence of a ToUnicode map doesn't necessarily mean that the text
can't be converted to Unicode)
.TP
+.B prob
+"X" if this font is likely to be problematic when converting text to
+Unicode
+.TP
.B object ID
the font dictionary object ID (number and generation)
.TP
@@ -143,7 +147,7 @@ Error related to PDF permissions.
99
Other error.
.SH AUTHOR
-The pdffonts software and documentation are copyright 1996-2014 Glyph
+The pdffonts software and documentation are copyright 1996-2017 Glyph
& Cog, LLC.
.SH "SEE ALSO"
.BR xpdf (1),
@@ -157,4 +161,4 @@ The pdffonts software and documentation are copyright 1996-2014 Glyph
.BR pdfimages (1),
.BR xpdfrc (5)
.br
-.B http://www.foolabs.com/xpdf/
+.B http://www.xpdfreader.com/
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdffonts.cat b/Build/source/libs/xpdf/xpdf-src/doc/pdffonts.cat
index 0c10b25253a..c11910b977c 100644
--- a/Build/source/libs/xpdf/xpdf-src/doc/pdffonts.cat
+++ b/Build/source/libs/xpdf/xpdf-src/doc/pdffonts.cat
@@ -1,9 +1,9 @@
-pdffonts(1) pdffonts(1)
+pdffonts(1) General Commands Manual pdffonts(1)
NAME
- pdffonts - Portable Document Format (PDF) font analyzer (version 3.04)
+ pdffonts - Portable Document Format (PDF) font analyzer (version 4.00)
SYNOPSIS
pdffonts [options] [PDF-file]
@@ -27,6 +27,9 @@ DESCRIPTION
(the absence of a ToUnicode map doesn't necessarily mean that
the text can't be converted to Unicode)
+ prob "X" if this font is likely to be problematic when converting
+ text to Unicode
+
object ID
the font dictionary object ID (number and generation)
@@ -49,32 +52,32 @@ DESCRIPTION
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
+ 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 configuration file com-
+ Many of the following options can be set with configuration file com-
mands. These are listed in square brackets with the description of the
corresponding command line option.
-f number
Specifies the first page to analyze.
- -loc Shows additional information on the location of the font that
- will be used when the PDF file is rasterized (with xpdf,
+ -loc Shows additional information on the location of the font that
+ will be used when the PDF file is rasterized (with xpdf,
pdftoppm, etc.).
- -locPS Shows additional information on the location of the font that
- will be used when the PDF file is converted to PostScript (with
+ -locPS Shows additional information on the location of the font that
+ will be used when the PDF file is converted to PostScript (with
pdftops).
-l number
Specifies the last page to analyze.
-opw password
- Specify the owner password for the PDF file. Providing this
+ Specify the owner password for the PDF file. Providing this
will bypass all security restrictions.
-upw password
@@ -102,14 +105,14 @@ EXIT CODES
99 Other error.
AUTHOR
- The pdffonts software and documentation are copyright 1996-2014 Glyph &
+ The pdffonts software and documentation are copyright 1996-2017 Glyph &
Cog, LLC.
SEE ALSO
- xpdf(1), pdftops(1), pdftotext(1), pdftohtml(1), pdfinfo(1), pdfde-
+ xpdf(1), pdftops(1), pdftotext(1), pdftohtml(1), pdfinfo(1), pdfde-
tach(1), pdftoppm(1), pdftopng(1), pdfimages(1), xpdfrc(5)
- http://www.foolabs.com/xpdf/
+ http://www.xpdfreader.com/
- 28 May 2014 pdffonts(1)
+ 10 Aug 2017 pdffonts(1)
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdfimages.1 b/Build/source/libs/xpdf/xpdf-src/doc/pdfimages.1
index 0953ced5636..a220d30b151 100644
--- a/Build/source/libs/xpdf/xpdf-src/doc/pdfimages.1
+++ b/Build/source/libs/xpdf/xpdf-src/doc/pdfimages.1
@@ -1,8 +1,8 @@
-.\" Copyright 1998-2014 Glyph & Cog, LLC
-.TH pdfimages 1 "28 May 2014"
+.\" Copyright 1998-2017 Glyph & Cog, LLC
+.TH pdfimages 1 "10 Aug 2017"
.SH NAME
pdfimages \- Portable Document Format (PDF) image extractor
-(version 3.04)
+(version 4.00)
.SH SYNOPSIS
.B pdfimages
[options]
@@ -10,17 +10,18 @@ pdfimages \- Portable Document Format (PDF) image extractor
.SH DESCRIPTION
.B Pdfimages
saves images from a Portable Document Format (PDF) file as Portable
-Pixmap (PPM), Portable Bitmap (PBM), or JPEG files.
+Pixmap (PPM), Portable Graymap (PGM), 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,
+and writes one PPM, PGM, PBM, or JPEG file for each image,
.IR image-root - nnnn . xxx ,
where
.I nnnn
is the image number and
.I xxx
-is the image type (.ppm, .pbm, .jpg).
+is the image type (.ppm, .pgm, .pbm, .jpg).
.PP
NB: pdfimages extracts the raw image data from the PDF file, without
performing any additional transforms. Any rotation, clipping,
@@ -45,10 +46,23 @@ Specifies the first page to scan.
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.
+Normally, all images are written as PBM (for monochrome images), PGM
+(for grayscale images), or PPM (for color images) files. With this
+option, images in DCT format are saved as JPEG files. All non-DCT
+images are saved in PBM/PGM/PPM format as usual. (Inline images are
+always saved in PBM/PGM/PPM format.)
+.TP
+.B \-raw
+Write all images in PDF-native formats. Most of the formats are not
+standard image formats, so this option is primarily useful as input to
+a tool that generates PDF files. (Inline images are always saved in
+PBM/PGM/PPM format.)
+.TP
+.B \-list
+Write a one-line summary to stdout for each image. The summary
+provides the image file name, the page number, the image width and
+height, the horizontal and vertical resolution (DPI) as drawn, the
+color space type, and the number of bits per component (BPC).
.TP
.BI \-opw " password"
Specify the owner password for the PDF file. Providing this will
@@ -88,7 +102,7 @@ Error related to PDF permissions.
99
Other error.
.SH AUTHOR
-The pdfimages software and documentation are copyright 1998-2014 Glyph
+The pdfimages software and documentation are copyright 1998-2017 Glyph
& Cog, LLC.
.SH "SEE ALSO"
.BR xpdf (1),
@@ -102,4 +116,4 @@ The pdfimages software and documentation are copyright 1998-2014 Glyph
.BR pdftopng (1),
.BR xpdfrc (5)
.br
-.B http://www.foolabs.com/xpdf/
+.B http://www.xpdfreader.com/
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdfimages.cat b/Build/source/libs/xpdf/xpdf-src/doc/pdfimages.cat
index a152e789b64..5f9397b06f2 100644
--- a/Build/source/libs/xpdf/xpdf-src/doc/pdfimages.cat
+++ b/Build/source/libs/xpdf/xpdf-src/doc/pdfimages.cat
@@ -1,36 +1,37 @@
-pdfimages(1) pdfimages(1)
+pdfimages(1) General Commands Manual pdfimages(1)
NAME
pdfimages - Portable Document Format (PDF) image extractor (version
- 3.04)
+ 4.00)
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.
+ Portable Pixmap (PPM), Portable Graymap (PGM), 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-nnnn.xxx,
- where nnnn is the image number and xxx is the image type (.ppm, .pbm,
- .jpg).
+ Pdfimages reads the PDF file, scans one or more pages, PDF-file, and
+ writes one PPM, PGM, PBM, or JPEG file for each image, image-root-
+ nnnn.xxx, where nnnn is the image number and xxx is the image type
+ (.ppm, .pgm, .pbm, .jpg).
- NB: pdfimages extracts the raw image data from the PDF file, without
- performing any additional transforms. Any rotation, clipping, color
+ 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
+ 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
+ (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 configuration file com-
+ Many of the following options can be set with configuration file com-
mands. These are listed in square brackets with the description of the
corresponding command line option.
@@ -40,13 +41,25 @@ OPTIONS
-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.
+ -j Normally, all images are written as PBM (for monochrome images),
+ PGM (for grayscale images), or PPM (for color images) files.
+ With this option, images in DCT format are saved as JPEG files.
+ All non-DCT images are saved in PBM/PGM/PPM format as usual.
+ (Inline images are always saved in PBM/PGM/PPM format.)
+
+ -raw Write all images in PDF-native formats. Most of the formats are
+ not standard image formats, so this option is primarily useful
+ as input to a tool that generates PDF files. (Inline images are
+ always saved in PBM/PGM/PPM format.)
+
+ -list Write a one-line summary to stdout for each image. The summary
+ provides the image file name, the page number, the image width
+ and height, the horizontal and vertical resolution (DPI) as
+ drawn, the color space type, and the number of bits per compo-
+ nent (BPC).
-opw password
- Specify the owner password for the PDF file. Providing this
+ Specify the owner password for the PDF file. Providing this
will bypass all security restrictions.
-upw password
@@ -72,14 +85,14 @@ EXIT CODES
99 Other error.
AUTHOR
- The pdfimages software and documentation are copyright 1998-2014 Glyph
+ The pdfimages software and documentation are copyright 1998-2017 Glyph
& Cog, LLC.
SEE ALSO
- xpdf(1), pdftops(1), pdftotext(1), pdftohtml(1), pdfinfo(1), pdf-
+ xpdf(1), pdftops(1), pdftotext(1), pdftohtml(1), pdfinfo(1), pdf-
fonts(1), pdfdetach(1), pdftoppm(1), pdftopng(1), xpdfrc(5)
- http://www.foolabs.com/xpdf/
+ http://www.xpdfreader.com/
- 28 May 2014 pdfimages(1)
+ 10 Aug 2017 pdfimages(1)
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdfinfo.1 b/Build/source/libs/xpdf/xpdf-src/doc/pdfinfo.1
index 5a02353744f..2a3a1d9f645 100644
--- a/Build/source/libs/xpdf/xpdf-src/doc/pdfinfo.1
+++ b/Build/source/libs/xpdf/xpdf-src/doc/pdfinfo.1
@@ -1,8 +1,8 @@
-.\" Copyright 1999-2014 Glyph & Cog, LLC
-.TH pdfinfo 1 "28 May 2014"
+.\" Copyright 1999-2017 Glyph & Cog, LLC
+.TH pdfinfo 1 "10 Aug 2017"
.SH NAME
pdfinfo \- Portable Document Format (PDF) document information
-extractor (version 3.04)
+extractor (version 4.00)
.SH SYNOPSIS
.B pdfinfo
[options]
@@ -45,7 +45,7 @@ In addition, the following information is printed:
tagged (yes/no)
.RE
.RS
-form (AcroForm / XFA / none)
+form (AcroForm / static XFA / dynamic XFA / none)
.RE
.RS
page count
@@ -150,7 +150,7 @@ Error related to PDF permissions.
99
Other error.
.SH AUTHOR
-The pdfinfo software and documentation are copyright 1996-2014 Glyph &
+The pdfinfo software and documentation are copyright 1996-2017 Glyph &
Cog, LLC.
.SH "SEE ALSO"
.BR xpdf (1),
@@ -164,4 +164,4 @@ Cog, LLC.
.BR pdfimages (1),
.BR xpdfrc (5)
.br
-.B http://www.foolabs.com/xpdf/
+.B http://www.xpdfreader.com/
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdfinfo.cat b/Build/source/libs/xpdf/xpdf-src/doc/pdfinfo.cat
index 8ef2bb21317..4c001beb789 100644
--- a/Build/source/libs/xpdf/xpdf-src/doc/pdfinfo.cat
+++ b/Build/source/libs/xpdf/xpdf-src/doc/pdfinfo.cat
@@ -1,10 +1,10 @@
-pdfinfo(1) pdfinfo(1)
+pdfinfo(1) General Commands Manual pdfinfo(1)
NAME
pdfinfo - Portable Document Format (PDF) document information extractor
- (version 3.04)
+ (version 4.00)
SYNOPSIS
pdfinfo [options] [PDF-file]
@@ -27,7 +27,7 @@ DESCRIPTION
In addition, the following information is printed:
tagged (yes/no)
- form (AcroForm / XFA / none)
+ form (AcroForm / static XFA / dynamic XFA / none)
page count
encrypted flag (yes/no)
print and copy permissions (if encrypted)
@@ -104,14 +104,14 @@ EXIT CODES
99 Other error.
AUTHOR
- The pdfinfo software and documentation are copyright 1996-2014 Glyph &
+ The pdfinfo software and documentation are copyright 1996-2017 Glyph &
Cog, LLC.
SEE ALSO
xpdf(1), pdftops(1), pdftotext(1), pdftohtml(1), pdffonts(1), pdfde-
tach(1), pdftoppm(1), pdftopng(1), pdfimages(1), xpdfrc(5)
- http://www.foolabs.com/xpdf/
+ http://www.xpdfreader.com/
- 28 May 2014 pdfinfo(1)
+ 10 Aug 2017 pdfinfo(1)
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdftohtml.1 b/Build/source/libs/xpdf/xpdf-src/doc/pdftohtml.1
index a74df55c75a..a6c56177fe6 100644
--- a/Build/source/libs/xpdf/xpdf-src/doc/pdftohtml.1
+++ b/Build/source/libs/xpdf/xpdf-src/doc/pdftohtml.1
@@ -1,8 +1,8 @@
-.\" Copyright 1997-2014 Glyph & Cog, LLC
-.TH pdftohtml 1 "28 May 2014"
+.\" Copyright 1997-2017 Glyph & Cog, LLC
+.TH pdftohtml 1 "10 Aug 2017"
.SH NAME
pdftohtml \- Portable Document Format (PDF) to HTML converter
-(version 3.04)
+(version 4.00)
.SH SYNOPSIS
.B pdftohtml
[options]
@@ -38,9 +38,29 @@ Specifies the first page to convert.
.BI \-l " number"
Specifies the last page to convert.
.TP
-.B \-r
-Specifies the resolution, in DPI, for background images. The default
-is 150 DPI.
+.BI \-z " number"
+Specifies the initial zoom level. The default is 1.0, which means
+72dpi, i.e., 1 point in the PDF file will be 1 pixel in the HTML.
+Using \'-z 1.5', for example, will make the initial view 50% larger.
+.TP
+.BI \-r " number"
+Specifies the resolution, in DPI, for background images. This
+controls the pixel size of the background image files. The initial
+zoom level is controlled by the \'-z' option. Specifying a larger
+\'-r' value will allow the viewer to zoom in farther without upscaling
+artifacts in the background.
+.TP
+.B \-skipinvisible
+Don't draw invisible text. By default, invisible text (commonly used
+in OCR'ed PDF files) is drawn as transparent (alpha=0) HTML text.
+This option tells pdftohtml to discard invisible text entirely.
+.TP
+.B \-allinvisible
+Treat all text as invisible. By default, regular (non-invisible) text
+is not drawn in the background image, and is instead drawn with HTML
+on top of the image. This option tells pdftohtml to include the
+regular text in the background image, and then draw it as transparent
+(alpha=0) HTML text.
.TP
.BI \-opw " password"
Specify the owner password for the PDF file. Providing this will
@@ -89,7 +109,7 @@ Error related to PDF permissions.
99
Other error.
.SH AUTHOR
-The pdftohtml software and documentation are copyright 1996-2014 Glyph
+The pdftohtml software and documentation are copyright 1996-2017 Glyph
& Cog, LLC.
.SH "SEE ALSO"
.BR xpdf (1),
@@ -103,4 +123,4 @@ The pdftohtml software and documentation are copyright 1996-2014 Glyph
.BR pdfimages (1),
.BR xpdfrc (5)
.br
-.B http://www.foolabs.com/xpdf/
+.B http://www.xpdfreader.com/
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdftohtml.cat b/Build/source/libs/xpdf/xpdf-src/doc/pdftohtml.cat
index ed46c1a4c43..4999a589631 100644
--- a/Build/source/libs/xpdf/xpdf-src/doc/pdftohtml.cat
+++ b/Build/source/libs/xpdf/xpdf-src/doc/pdftohtml.cat
@@ -1,10 +1,10 @@
-pdftohtml(1) pdftohtml(1)
+pdftohtml(1) General Commands Manual pdftohtml(1)
NAME
pdftohtml - Portable Document Format (PDF) to HTML converter (version
- 3.04)
+ 4.00)
SYNOPSIS
pdftohtml [options] PDF-file HTML-dir
@@ -35,11 +35,34 @@ OPTIONS
-l number
Specifies the last page to convert.
- -r Specifies the resolution, in DPI, for background images. The
- default is 150 DPI.
+ -z number
+ Specifies the initial zoom level. The default is 1.0, which
+ means 72dpi, i.e., 1 point in the PDF file will be 1 pixel in
+ the HTML. Using '-z 1.5', for example, will make the initial
+ view 50% larger.
+
+ -r number
+ Specifies the resolution, in DPI, for background images. This
+ controls the pixel size of the background image files. The ini-
+ tial zoom level is controlled by the '-z' option. Specifying a
+ larger '-r' value will allow the viewer to zoom in farther with-
+ out upscaling artifacts in the background.
+
+ -skipinvisible
+ Don't draw invisible text. By default, invisible text (commonly
+ used in OCR'ed PDF files) is drawn as transparent (alpha=0) HTML
+ text. This option tells pdftohtml to discard invisible text
+ entirely.
+
+ -allinvisible
+ Treat all text as invisible. By default, regular (non-invisi-
+ ble) text is not drawn in the background image, and is instead
+ drawn with HTML on top of the image. This option tells pdfto-
+ html to include the regular text in the background image, and
+ then draw it as transparent (alpha=0) HTML text.
-opw password
- Specify the owner password for the PDF file. Providing this
+ Specify the owner password for the PDF file. Providing this
will bypass all security restrictions.
-upw password
@@ -56,7 +79,7 @@ OPTIONS
-h Print usage information. (-help and --help are equivalent.)
BUGS
- Some PDF files contain fonts whose encodings have been mangled beyond
+ 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.
@@ -74,14 +97,14 @@ EXIT CODES
99 Other error.
AUTHOR
- The pdftohtml software and documentation are copyright 1996-2014 Glyph
+ The pdftohtml software and documentation are copyright 1996-2017 Glyph
& Cog, LLC.
SEE ALSO
xpdf(1), pdftops(1), pdftotext(1), pdfinfo(1), pdffonts(1), pdfde-
tach(1), pdftoppm(1), pdftopng(1), pdfimages(1), xpdfrc(5)
- http://www.foolabs.com/xpdf/
+ http://www.xpdfreader.com/
- 28 May 2014 pdftohtml(1)
+ 10 Aug 2017 pdftohtml(1)
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdftopng.1 b/Build/source/libs/xpdf/xpdf-src/doc/pdftopng.1
index 6d936537bf8..a75704f0ae7 100644
--- a/Build/source/libs/xpdf/xpdf-src/doc/pdftopng.1
+++ b/Build/source/libs/xpdf/xpdf-src/doc/pdftopng.1
@@ -1,8 +1,8 @@
-.\" Copyright 2014 Glyph & Cog, LLC
-.TH pdftopng 1 "28 May 2014"
+.\" Copyright 2017 Glyph & Cog, LLC
+.TH pdftopng 1 "10 Aug 2017"
.SH NAME
pdftopng \- Portable Document Format (PDF) to Portable Network Graphics
-(PNG) converter (version 3.04)
+(PNG) converter (version 4.00)
.SH SYNOPSIS
.B pdftopng
[options]
@@ -51,6 +51,11 @@ Generate a monochrome image (instead of a color image).
.B \-gray
Generate a grayscale image (instead of a color image).
.TP
+.B \-alpha
+Generate an alpha channel in the PNG file. This is only useful with
+PDF files that have been constructed with a transparent background.
+The \-alpha flag cannot be used with \-mono.
+.TP
.BI \-freetype " yes | no"
Enable or disable FreeType (a TrueType / Type 1 font rasterizer).
This defaults to "yes".
@@ -102,7 +107,7 @@ Error related to PDF permissions.
99
Other error.
.SH AUTHOR
-The pdftopng software and documentation are copyright 1996-2014 Glyph
+The pdftopng software and documentation are copyright 1996-2017 Glyph
& Cog, LLC.
.SH "SEE ALSO"
.BR xpdf (1),
@@ -116,4 +121,4 @@ The pdftopng software and documentation are copyright 1996-2014 Glyph
.BR pdfimages (1),
.BR xpdfrc (5)
.br
-.B http://www.foolabs.com/xpdf/
+.B http://www.xpdfreader.com/
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdftopng.cat b/Build/source/libs/xpdf/xpdf-src/doc/pdftopng.cat
index ca1c5ed27bb..c403c7b8926 100644
--- a/Build/source/libs/xpdf/xpdf-src/doc/pdftopng.cat
+++ b/Build/source/libs/xpdf/xpdf-src/doc/pdftopng.cat
@@ -1,10 +1,10 @@
-pdftopng(1) pdftopng(1)
+pdftopng(1) General Commands Manual pdftopng(1)
NAME
pdftopng - Portable Document Format (PDF) to Portable Network Graphics
- (PNG) converter (version 3.04)
+ (PNG) converter (version 4.00)
SYNOPSIS
pdftopng [options] PDF-file PNG-root
@@ -44,6 +44,10 @@ OPTIONS
-gray Generate a grayscale image (instead of a color image).
+ -alpha Generate an alpha channel in the PNG file. This is only useful
+ with PDF files that have been constructed with a transparent
+ background. The -alpha flag cannot be used with -mono.
+
-freetype yes | no
Enable or disable FreeType (a TrueType / Type 1 font raster-
izer). This defaults to "yes". [config file: enableFreeType]
@@ -83,14 +87,14 @@ EXIT CODES
99 Other error.
AUTHOR
- The pdftopng software and documentation are copyright 1996-2014 Glyph &
+ The pdftopng software and documentation are copyright 1996-2017 Glyph &
Cog, LLC.
SEE ALSO
xpdf(1), pdftops(1), pdftotext(1), pdftohtml(1), pdfinfo(1), pdf-
fonts(1), pdfdetach(1), pdftoppm(1), pdfimages(1), xpdfrc(5)
- http://www.foolabs.com/xpdf/
+ http://www.xpdfreader.com/
- 28 May 2014 pdftopng(1)
+ 10 Aug 2017 pdftopng(1)
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdftoppm.1 b/Build/source/libs/xpdf/xpdf-src/doc/pdftoppm.1
index 4255937ab2a..6eb614024d7 100644
--- a/Build/source/libs/xpdf/xpdf-src/doc/pdftoppm.1
+++ b/Build/source/libs/xpdf/xpdf-src/doc/pdftoppm.1
@@ -1,8 +1,8 @@
-.\" Copyright 2005-2014 Glyph & Cog, LLC
-.TH pdftoppm 1 "28 May 2014"
+.\" Copyright 2005-2017 Glyph & Cog, LLC
+.TH pdftoppm 1 "10 Aug 2017"
.SH NAME
pdftoppm \- Portable Document Format (PDF) to Portable Pixmap (PPM)
-converter (version 3.04)
+converter (version 4.00)
.SH SYNOPSIS
.B pdftoppm
[options]
@@ -48,10 +48,13 @@ Specifies the last page to convert.
Specifies the resolution, in DPI. The default is 150 DPI.
.TP
.B \-mono
-Generate a monochrome PBM file (instead of a color PPM file).
+Generate a monochrome PBM file (instead of an RGB PPM file).
.TP
.B \-gray
-Generate a grayscale PGM file (instead of a color PPM file).
+Generate a grayscale PGM file (instead of an RGB PPM file).
+.TP
+.B \-cmyk
+Generate a CMYK PAM file (instead of an RGB PPM file).
.TP
.BI \-freetype " yes | no"
Enable or disable FreeType (a TrueType / Type 1 font rasterizer).
@@ -104,7 +107,7 @@ Error related to PDF permissions.
99
Other error.
.SH AUTHOR
-The pdftoppm software and documentation are copyright 1996-2014 Glyph
+The pdftoppm software and documentation are copyright 1996-2017 Glyph
& Cog, LLC.
.SH "SEE ALSO"
.BR xpdf (1),
@@ -118,4 +121,4 @@ The pdftoppm software and documentation are copyright 1996-2014 Glyph
.BR pdfimages (1),
.BR xpdfrc (5)
.br
-.B http://www.foolabs.com/xpdf/
+.B http://www.xpdfreader.com/
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdftoppm.cat b/Build/source/libs/xpdf/xpdf-src/doc/pdftoppm.cat
index bfa37c738b1..86d2e4b0165 100644
--- a/Build/source/libs/xpdf/xpdf-src/doc/pdftoppm.cat
+++ b/Build/source/libs/xpdf/xpdf-src/doc/pdftoppm.cat
@@ -1,10 +1,10 @@
-pdftoppm(1) pdftoppm(1)
+pdftoppm(1) General Commands Manual pdftoppm(1)
NAME
pdftoppm - Portable Document Format (PDF) to Portable Pixmap (PPM) con-
- verter (version 3.04)
+ verter (version 4.00)
SYNOPSIS
pdftoppm [options] PDF-file PPM-root
@@ -41,9 +41,11 @@ OPTIONS
-r number
Specifies the resolution, in DPI. The default is 150 DPI.
- -mono Generate a monochrome PBM file (instead of a color PPM file).
+ -mono Generate a monochrome PBM file (instead of an RGB PPM file).
- -gray Generate a grayscale PGM file (instead of a color PPM file).
+ -gray Generate a grayscale PGM file (instead of an RGB PPM file).
+
+ -cmyk Generate a CMYK PAM file (instead of an RGB PPM file).
-freetype yes | no
Enable or disable FreeType (a TrueType / Type 1 font raster-
@@ -84,14 +86,14 @@ EXIT CODES
99 Other error.
AUTHOR
- The pdftoppm software and documentation are copyright 1996-2014 Glyph &
+ The pdftoppm software and documentation are copyright 1996-2017 Glyph &
Cog, LLC.
SEE ALSO
xpdf(1), pdftops(1), pdftotext(1), pdftohtml(1), pdfinfo(1), pdf-
fonts(1), pdfdetach(1), pdftopng(1), pdfimages(1), xpdfrc(5)
- http://www.foolabs.com/xpdf/
+ http://www.xpdfreader.com/
- 28 May 2014 pdftoppm(1)
+ 10 Aug 2017 pdftoppm(1)
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdftops.1 b/Build/source/libs/xpdf/xpdf-src/doc/pdftops.1
index d9daf492390..59fb3af9da5 100644
--- a/Build/source/libs/xpdf/xpdf-src/doc/pdftops.1
+++ b/Build/source/libs/xpdf/xpdf-src/doc/pdftops.1
@@ -1,8 +1,8 @@
-.\" Copyright 1996-2014 Glyph & Cog, LLC
-.TH pdftops 1 "28 May 2014"
+.\" Copyright 1996-2017 Glyph & Cog, LLC
+.TH pdftops 1 "10 Aug 2017"
.SH NAME
pdftops \- Portable Document Format (PDF) to PostScript converter
-(version 3.04)
+(version 4.00)
.SH SYNOPSIS
.B pdftops
[options]
@@ -65,6 +65,11 @@ Generate Level 2 PostScript. Level 2 supports color images and image
compression. This is the default setting.
.RB "[config file: " psLevel ]
.TP
+.B \-level2gray
+Generate grayscale Level 2 PostScript. All colors, including images,
+are converted to grayscale.
+.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
@@ -76,6 +81,11 @@ Generate Level 3 PostScript. This enables all Level 2 features plus
CID font embedding and masked image generation.
.RB "[config file: " psLevel ]
.TP
+.B \-level3gray
+Generate grayscale Level 3 PostScript. All colors, including images,
+are converted to grayscale.
+.RB "[config file: " psLevel ]
+.TP
.B \-level3Sep
Generate Level 3 separable PostScript. The separation handling is the
same as for \-level2Sep.
@@ -174,6 +184,10 @@ Treat the CropBox as the PDF page size. By default, the MediaBox is
used as the page size.
.RB "[config file: " psUseCropBoxAsPage ]
.TP
+.B \-userunit
+Honor the UserUnit settings on PDF pages when computing page/paper
+size. By default, pdftops ignores UserUnit.
+.TP
.B \-duplex
Set the Duplex pagedevice entry in the PostScript file. This tells
duplex-capable printers to enable duplexing.
@@ -222,7 +236,7 @@ Error related to PDF permissions.
99
Other error.
.SH AUTHOR
-The pdftops software and documentation are copyright 1996-2014 Glyph &
+The pdftops software and documentation are copyright 1996-2017 Glyph &
Cog, LLC.
.SH "SEE ALSO"
.BR xpdf (1),
@@ -236,4 +250,4 @@ Cog, LLC.
.BR pdfimages (1),
.BR xpdfrc (5)
.br
-.B http://www.foolabs.com/xpdf/
+.B http://www.xpdfreader.com/
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdftops.cat b/Build/source/libs/xpdf/xpdf-src/doc/pdftops.cat
index 9e119ac30d9..de656d5f8da 100644
--- a/Build/source/libs/xpdf/xpdf-src/doc/pdftops.cat
+++ b/Build/source/libs/xpdf/xpdf-src/doc/pdftops.cat
@@ -1,10 +1,10 @@
-pdftops(1) pdftops(1)
+pdftops(1) General Commands Manual pdftops(1)
NAME
pdftops - Portable Document Format (PDF) to PostScript converter (ver-
- sion 3.04)
+ sion 4.00)
SYNOPSIS
pdftops [options] [PDF-file [PS-file]]
@@ -54,16 +54,24 @@ OPTIONS
image compression. This is the default setting. [config file:
psLevel]
+ -level2gray
+ Generate grayscale Level 2 PostScript. All colors, including
+ images, are converted to grayscale. [config file: psLevel]
+
-level2sep
Generate Level 2 separable PostScript. All colors are converted
- to CMYK. The PostScript separation convention operators are
+ 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
+ Generate Level 3 PostScript. This enables all Level 2 features
+ plus CID font embedding and masked image generation. [config
file: psLevel]
+ -level3gray
+ Generate grayscale Level 3 PostScript. All colors, including
+ images, are converted to grayscale. [config file: psLevel]
+
-level3Sep
Generate Level 3 separable PostScript. The separation handling
is the same as for -level2Sep. [config file: psLevel]
@@ -153,13 +161,17 @@ OPTIONS
Treat the CropBox as the PDF page size. By default, the Media-
Box is used as the page size. [config file: psUseCropBoxAsPage]
+ -userunit
+ Honor the UserUnit settings on PDF pages when computing
+ page/paper size. By default, pdftops ignores UserUnit.
+
-duplex
- Set the Duplex pagedevice entry in the PostScript file. This
- tells duplex-capable printers to enable duplexing. [config
+ 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. Providing this
+ Specify the owner password for the PDF file. Providing this
will bypass all security restrictions.
-upw password
@@ -189,14 +201,14 @@ EXIT CODES
99 Other error.
AUTHOR
- The pdftops software and documentation are copyright 1996-2014 Glyph &
+ The pdftops software and documentation are copyright 1996-2017 Glyph &
Cog, LLC.
SEE ALSO
- xpdf(1), pdftotext(1), pdftohtml(1), pdfinfo(1), pdffonts(1), pdfde-
+ xpdf(1), pdftotext(1), pdftohtml(1), pdfinfo(1), pdffonts(1), pdfde-
tach(1), pdftoppm(1), pdftopng(1), pdfimages(1), xpdfrc(5)
- http://www.foolabs.com/xpdf/
+ http://www.xpdfreader.com/
- 28 May 2014 pdftops(1)
+ 10 Aug 2017 pdftops(1)
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdftotext.1 b/Build/source/libs/xpdf/xpdf-src/doc/pdftotext.1
index 12d75006702..7fef78e742a 100644
--- a/Build/source/libs/xpdf/xpdf-src/doc/pdftotext.1
+++ b/Build/source/libs/xpdf/xpdf-src/doc/pdftotext.1
@@ -1,8 +1,8 @@
-.\" Copyright 1997-2014 Glyph & Cog, LLC
-.TH pdftotext 1 "28 May 2014"
+.\" Copyright 1997-2017 Glyph & Cog, LLC
+.TH pdftotext 1 "10 Aug 2017"
.SH NAME
pdftotext \- Portable Document Format (PDF) to text converter
-(version 3.04)
+(version 4.00)
.SH SYNOPSIS
.B pdftotext
[options]
@@ -52,6 +52,13 @@ hyphenation, etc.) and output the text in reading order. If the
option is given, character spacing within each line will be determined
by the specified character pitch.
.TP
+.B \-simple
+Similar to
+.BR \-layout ,
+but optimized for simple one-column pages. This mode will do a better
+job of maintaining horizontal spacing, but it will only work properly
+with a single column of text.
+.TP
.B \-table
Table mode is similar to physical layout mode, but optimized for
tabular data, with the goal of keeping rows and columns aligned (at
@@ -92,6 +99,11 @@ Text which is hidden because of clipping is removed before doing
layout, and then added back in. This can be helpful for tables where
clipped (invisible) text would overlap the next column.
.TP
+.B \-nodiag
+Diagonal text, i.e., text that is not close to one of the 0, 90, 180,
+or 270 degree axes, is discarded. This is useful to skip watermarks
+drawn on top of body text, etc.
+.TP
.BI \-enc " encoding-name"
Sets the encoding to use for text output. The
.I encoding\-name
@@ -109,6 +121,10 @@ Sets the end-of-line convention to use for text output.
Don't insert page breaks (form feed characters) between pages.
.RB "[config file: " textPageBreaks ]
.TP
+.B \-bom
+Insert a Unicode byte order marker (BOM) at the start of the text
+output.
+.TP
.BI \-opw " password"
Specify the owner password for the PDF file. Providing this will
bypass all security restrictions.
@@ -156,7 +172,7 @@ Error related to PDF permissions.
99
Other error.
.SH AUTHOR
-The pdftotext software and documentation are copyright 1996-2014 Glyph
+The pdftotext software and documentation are copyright 1996-2017 Glyph
& Cog, LLC.
.SH "SEE ALSO"
.BR xpdf (1),
@@ -170,4 +186,4 @@ The pdftotext software and documentation are copyright 1996-2014 Glyph
.BR pdfimages (1),
.BR xpdfrc (5)
.br
-.B http://www.foolabs.com/xpdf/
+.B http://www.xpdfreader.com/
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/pdftotext.cat b/Build/source/libs/xpdf/xpdf-src/doc/pdftotext.cat
index 8217743e28d..ffe7ebc08b1 100644
--- a/Build/source/libs/xpdf/xpdf-src/doc/pdftotext.cat
+++ b/Build/source/libs/xpdf/xpdf-src/doc/pdftotext.cat
@@ -1,10 +1,10 @@
-pdftotext(1) pdftotext(1)
+pdftotext(1) General Commands Manual pdftotext(1)
NAME
pdftotext - Portable Document Format (PDF) to text converter (version
- 3.04)
+ 4.00)
SYNOPSIS
pdftotext [options] [PDF-file [text-file]]
@@ -41,43 +41,54 @@ OPTIONS
-fixed option is given, character spacing within each line will
be determined by the specified character pitch.
+ -simple
+ Similar to -layout, but optimized for simple one-column pages.
+ This mode will do a better job of maintaining horizontal spac-
+ ing, but it will only work properly with a single column of
+ text.
+
-table Table mode is similar to physical layout mode, but optimized for
- tabular data, with the goal of keeping rows and columns aligned
- (at the expense of inserting extra whitespace). If the -fixed
- option is given, character spacing within each line will be
+ tabular data, with the goal of keeping rows and columns aligned
+ (at the expense of inserting extra whitespace). If the -fixed
+ option is given, character spacing within each line will be
determined by the specified character pitch.
-lineprinter
Line printer mode uses a strict fixed-character-pitch and
- -height layout. That is, the page is broken into a grid, and
- characters are placed into that grid. If the grid spacing is
- too small for the actual characters, the result is extra white-
- space. If the grid spacing is too large, the result is missing
- whitespace. The grid spacing can be specified using the -fixed
- and -linespacing options. If one or both are not given on the
- command line, pdftotext will attempt to compute appropriate
+ -height layout. That is, the page is broken into a grid, and
+ characters are placed into that grid. If the grid spacing is
+ too small for the actual characters, the result is extra white-
+ space. If the grid spacing is too large, the result is missing
+ whitespace. The grid spacing can be specified using the -fixed
+ and -linespacing options. If one or both are not given on the
+ command line, pdftotext will attempt to compute appropriate
value(s).
-raw Keep the text in content stream order. Depending on how the PDF
file was generated, this may or may not be useful.
-fixed number
- Specify the character pitch (character width), in points, for
- physical layout, table, or line printer mode. This is ignored
+ Specify the character pitch (character width), in points, for
+ physical layout, table, or line printer mode. This is ignored
in all other modes.
-linespacing number
- Specify the line spacing, in points, for line printer mode.
+ Specify the line spacing, in points, for line printer mode.
This is ignored in all other modes.
-clip Text which is hidden because of clipping is removed before doing
- layout, and then added back in. This can be helpful for tables
+ layout, and then added back in. This can be helpful for tables
where clipped (invisible) text would overlap the next column.
+ -nodiag
+ Diagonal text, i.e., text that is not close to one of the 0, 90,
+ 180, or 270 degree axes, is discarded. This is useful to skip
+ watermarks drawn on top of body text, etc.
+
-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"
+ 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: textEncoding]
-eol unix | dos | mac
@@ -85,9 +96,12 @@ OPTIONS
file: textEOL]
-nopgbrk
- Don't insert page breaks (form feed characters) between pages.
+ Don't insert page breaks (form feed characters) between pages.
[config file: textPageBreaks]
+ -bom Insert a Unicode byte order marker (BOM) at the start of the
+ text output.
+
-opw password
Specify the owner password for the PDF file. Providing this
will bypass all security restrictions.
@@ -124,14 +138,14 @@ EXIT CODES
99 Other error.
AUTHOR
- The pdftotext software and documentation are copyright 1996-2014 Glyph
+ The pdftotext software and documentation are copyright 1996-2017 Glyph
& Cog, LLC.
SEE ALSO
xpdf(1), pdftops(1), pdftohtml(1), pdfinfo(1), pdffonts(1), pdfde-
tach(1), pdftoppm(1), pdftopng(1), pdfimages(1), xpdfrc(5)
- http://www.foolabs.com/xpdf/
+ http://www.xpdfreader.com/
- 28 May 2014 pdftotext(1)
+ 10 Aug 2017 pdftotext(1)
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/sample-xpdfrc b/Build/source/libs/xpdf/xpdf-src/doc/sample-xpdfrc
index 0a4234fdf9b..21e6c995b6a 100644
--- a/Build/source/libs/xpdf/xpdf-src/doc/sample-xpdfrc
+++ b/Build/source/libs/xpdf/xpdf-src/doc/sample-xpdfrc
@@ -16,7 +16,7 @@
# Also, the Xpdf language support packages each include a set of
# options to be added to the xpdfrc file.
#
-# http://www.foolabs.com/xpdf/
+# http://www.xpdfreader.com/
#
#========================================================================
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/xpdf.1 b/Build/source/libs/xpdf/xpdf-src/doc/xpdf.1
index c34ad7fb787..b463d0fab43 100644
--- a/Build/source/libs/xpdf/xpdf-src/doc/xpdf.1
+++ b/Build/source/libs/xpdf/xpdf-src/doc/xpdf.1
@@ -1,20 +1,20 @@
-.\" Copyright 1996-2014 Glyph & Cog, LLC
-.TH xpdf 1 "28 May 2014"
+.\" Copyright 1996-2017 Glyph & Cog, LLC
+.TH xpdf 1 "10 Aug 2017"
.SH NAME
-xpdf \- Portable Document Format (PDF) file viewer for X (version 3.04)
+xpdf \- Portable Document Format (PDF) file viewer (version 4.00)
.SH SYNOPSIS
.B xpdf
[options]
.RI [ PDF-file
-.RI [ page " | +" dest ]]
+.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.
+software.) Xpdf uses the Qt GUI toolkit and runs on Unix, OS X, and
+Windows.
.PP
-To run xpdf, simply type:
+To run xpdf, type:
.PP
.RS
xpdf file.pdf
@@ -22,16 +22,26 @@ xpdf file.pdf
.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.:
+is your PDF file. The file name can be followed by a page number to
+be displayed, prefixed with a colon:
.PP
.RS
-xpdf file.pdf 18
+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.)
+or by a named destination, prefixed with \'+' (this is only useful
+with PDF files that provide named destination targets):
+.PP
+.RS
+xpdf file.pdf +destinationA
+.RE
+.PP
+If you specify multiple files, they will each be opened in a separate
+tab:
+.PP
+.RS
+xpdf file1.pdf file2.pdf :18 file3.pdf
+.RE
.PP
You can also start xpdf without opening any files:
.PP
@@ -46,66 +56,49 @@ looks for a system-wide config file, typically /usr/local/etc/xpdfrc
.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.
+The following command line options are available. All command line
+options must come before any PDF files to be opened.
+.PP
+Many of the 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 \-g " geometry"
+.BI \-geometry " 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 ]
+Set the "paper color", i.e., the background of the page display. The
+color can be #RRGGBB (hexadecimal) or a named color. This option will
+not work well with PDF files that do things like filling in white
+behind the text.
+.RB "[config file: " 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 ]
+actual page area. The color can be #RRGGBB (hexadecimal) or a named
+color.
+.RB "[config file: " matteColor ]
+.TP
+.BI \-fsmattecolor " color"
+Set the matte color for full-screen mode. The color can be #RRGGBB
+(hexadecimal) or a named color.
+.RB "[config file: " fullScreenMatteColor ]
.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 \-freetype " yes | no"
-Enable or disable FreeType (a TrueType / Type 1 font rasterizer).
-This defaults to "yes".
-.RB "[config file: " enableFreeType ]
+.RB "[config file: " initialZoom ]
.TP
.BI \-aa " yes | no"
Enable or disable font anti-aliasing. This defaults to "yes".
@@ -115,32 +108,6 @@ Enable or disable font anti-aliasing. This defaults to "yes".
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
@@ -149,47 +116,21 @@ must be defined with the unicodeMap command (see
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.
+.BI \-pw " password"
+Specify the password for the PDF file. This can be either the owner
+password (which will bypass all security restrictions) or the user
+password.
.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).
+.BI \-display " display"
+Set the X display (only available with X11).
.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
@@ -205,439 +146,403 @@ 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
+.SS Tool bar
.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"
+.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.
+.B "left/right arrow buttons"
+Go backward or forward along the history path.
.TP
-.B "Open in new window..."
-Create a new window and open a new PDF file via a file requester.
+.B "zoom out/in buttons"
+Zoom out or in (i.e., change magnification) incrementally.
.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.
+.B "zoom popup menu"
+Change the zoom factor (see the description of the \-z option above).
.TP
-.B "Save as..."
-Save the current file via a file requester.
+.B "fit width button"
+Change the zoom factor to fit the page width to the window width.
.TP
-.B "Continuous view"
-Toggles between single page and continuous view modes.
+.B "fit page button"
+Change the zoom factor to fit the page to the window size.
.TP
-.B "Rotate counterclockwise"
-Rotate the page 90 degrees counterclockwise.
+.B "working/error indicator"
+This icon is animated while Xpdf is rendering a page. It turns red
+when an error or warning has been issued. Clicking on it opens the
+error dialog.
.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.
+.B "\'find' box"
+Find a text string. Click in the box to activate it, type a search
+string, then hit return.
.TP
-.B "Zoom to selection"
-Zoom in to the currently selected rectangle.
+.B "find next button"
+Find the next occurrence of the search string.
.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).
+.B "find previous button"
+Find the previous occurrence of the search string.
.TP
-.B "Quit"
-Quit xpdf.
+.B "find settings button"
+Display the current find settings: case sensitive (on/off), find whole
+words (on/off).
+.PP
+.SS Menu bar
+The menu bar is above the tool bar. The menu items should be
+self-explanatory.
+.PP
+.SS Tab list
+The tab list is on the left, just below the tool bar. It lists all
+open tabs.
+.PP
+.SS Outline/layers/attachments pane
+This pane is on the left, below the tab list. The popup allows you to
+select from outline, layers, or attachments.
+.PP
+The outline is a tree-like structure of bookmarks that allows moving
+within the PDF file. Not all PDF files have outlines.
.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.
+Layers (a.k.a. optional content) allow parts of the PDF content to be
+shown or hidden. Not all PDF files have layers.
+.PP
+Attachments are other files embedded within the PDF file. There is
+a 'save' button for each attached file. Not all PDF files have
+attachments.
.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.
+arbitrary rectangle. Selected text can be copied to the clipboard
+(with the edit/copy menu item). On X11, selected text will be
+available in the X selection buffer.
.PP
.SS Links
+When the mouse is over a hyperlink, the link target will be shown in a
+popup near the bottom of the window.
+.PP
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).
+you click \'ok', execute the program. URL links are opened in a
+system-dependent way. (On UNIX, Qt uses the $BROWSER environment
+variable.)
+.PP
+.SS Mouse bindings
+The left mouse button is used to select text (see above).
+.PP
+Clicking on a link with the middle button opens the link in a new tab.
.PP
-.SS Panning
Dragging the mouse with the middle button held down pans the window.
.PP
+The right mouse button opens a popup menu (see
+.BR popupMenuCmd " in " xpdfrc (5)).
+.PP
.SS Key bindings
+This section lists the default key bindings. Bindings can be changed
+using the config file (see
+.BR xpdfrc (5)).
.TP
-.B o
+.B control-o
Open a new PDF file via a file requester.
.TP
-.B r
+.B control-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.
+.B control-f
+Find a text string. This sets keyboard focus to the \'find' box.
.TP
.B control-G
Find next occurrence.
.TP
+.B control-C
+Copy selected text to the clipboard.
+.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.
+.BR control-0 " (control-zero)"
+Set the zoom factor to 125%.
.TP
-.B p
-Move to the previous page. Scrolls to the top of the page, unless
-scroll lock is turned on.
+.BR control-+ " (control-plus)"
+Zoom in (increment the zoom factor by 1).
.TP
-.BR <Space> " or " <PageDown> " or " <Next>
-Scroll down on the current page; if already at bottom, move to next
-page.
+.BR control-- " (control-minus)"
+Zoom out (decrement the zoom factor by 1).
.TP
-.BR <Backspace> " or " <Delete> " or " <PageUp> " or " <Previous>
-Scroll up on the current page; if already at top, move to previous
-page.
+.B control-s
+Save PDF via a file requester.
.TP
-.B v
-Move forward along the history path.
+.B control-t
+Open a new tab.
.TP
-.B b
-Move backward along the history path.
+.B control-n
+Open a new window.
.TP
-.B <Home>
-Scroll to top of current page.
+.B control-w
+Close the current tab. Closes the window if this was the last open
+tab. Quits the application if this was the last open window.
.TP
-.B <End>
-Scroll to bottom of current page.
+.B control-q
+Quit.
.TP
-.B control-<Home>
-Scroll to first page of document.
+.B control-<tab>
+Next tab.
.TP
-.B control-<End>
-Scroll to last page of document.
+.B control-shift-<tab>
+Previous tab.
.TP
-.B arrows
-Scroll the current page.
+.B control-?
+Help.
.TP
-.B g
-Activate the page number text field ("goto page").
+.B alt-<left-arrow>
+Go backward along the history path.
.TP
-.B 0
-Set the zoom factor to 125%.
+.B alt-<right-arrow>
+Go forward along the history path.
.TP
-.B +
-Zoom in (increment the zoom factor by 1).
+.B home
+Go to the top left of current page.
.TP
-.B -
-Zoom out (decrement the zoom factor by 1).
+.B control-<home>
+Go to the first page.
+.TP
+.B end
+Go to the bottom right of current page.
+.TP
+.B control-<end>
+Go to the last page.
+.TP
+.BR <space> " or " <PageDown>
+Scroll down on the current page; if already at bottom, move to next
+page.
+.TP
+.BR control-<PageDown> " or " control-<down-arrow>
+Go to the next page. If <ScrollLock> is active, this maintains the
+relative position on the page.
+.TP
+.B <PageUp>
+Scroll up on the current page; if already at top, move to previous
+page.
+.TP
+.BR control-<PageUp> " or " control-<up-arrow>
+Go to the previous page. If <ScrollLock> is active, this maintains
+the relative position on the page.
+.TP
+.B <esc>
+Exit full-screen mode.
+.TP
+.B arrows
+Scroll the current page.
+.TP
+.B g
+Set keyboard focus to the page number entry box.
.TP
.B z
-Set the zoom factor to 'page' (fit page to window).
+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.
+Set the zoom factor to \'width' (fit page width to window).
+.SH Full-screen mode
+Xpdf can be placed into full-screen mode via the
+.B \-fullscreen
+command line option, the \'full screen' menu item, or a binding to the
+.B fullScreenMode
+or
+.BR toggleFullScreenMode command .
.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:
+Entering full-screen mode automatically switches to single-page view
+mode and to the fit-page zoom factor.
.PP
-.RS
-urlCommand "netscape \-remote 'openURL(%s)'"
-.RE
+Full-screen mode can be exited via the default <esc> key binding,
+or via a binding to the
+.B windowMode
+or
+.BR toggleFullScreenMode command .
.SH COMMANDS
-Xpdf's key and mouse bindings are user-configurable, using the bind and
-unbind options in the config file (see
+Xpdf's key and mouse bindings are user-configurable, using the bind
+and unbind commands 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
+.PP
The following commands are supported:
.TP
-.BI gotoPage( page )
-Go to the specified page.
+.B about
+Open the \'about' dialog.
.TP
-.BI gotoPageNoScroll( page )
-Go to the specified page, with the current relative scroll position.
+.B blockSelectMode
+Set block selection mode. In this mode, the selection is a simple
+rectangle. Any part of the page can be selected, regardless of the
+content on the page.
.TP
-.BI gotoDest( dest )
-Go to a named destination.
+.B closeSidebar
+Close the sidebar.
.TP
-.B gotoLastPage
-Go to the last page in the PDF file.
+.B closeSidebarMoveResizeWin
+Close the sidebar, resizing the window so that the document size
+doesn't change, and moving the window so that the document stays in
+the same place on the screen.
.TP
-.B gotoLastPageNoScroll
-Go to the last page in the PDF file, with the current relative scroll
-position.
+.B closeSidebarResizeWin
+Close the sidebar, resizing the window so that the document size
+doesn't change.
.TP
-.B nextPage
-Go to the next page.
+.B closeTabOrQuit
+Close the tab. If this was the last open tab, close the window. If
+this was the last window open, quit.
.TP
-.B nextPageNoScroll
-Go to the next page, with the current relative scroll position.
+.B closeWindowOrQuit
+Close the window. If this was the last open window, quit.
.TP
-.B prevPage
-Go to the previous page.
+.B continuousMode
+Switch to continuous view mode.
.TP
-.B prevPageNoScroll
-Go to the previous page, with the current relative scroll position.
+.B copy
+Copy selected text to the clipboard.
.TP
-.B pageUp
-Scroll up by one screenful.
+.B endPan
+End a pan operation.
.TP
-.B pageDown
-Scroll down by one screenful.
+.B endSelection
+End a selection.
.TP
-.BI scrollLeft( n )
-Scroll left by
-.I n
-pixels.
+.B find
+Set keyboard focus to the \'find' box.
.TP
-.BI scrollRight( n )
-Scroll right by
-.I n
-pixels.
+.B findFirst
+Find the first occurrence of the search string.
.TP
-.BI scrollUp( n )
-Scroll up by
-.I n
-pixels.
+.B findNext
+Find the next occurrence of the search string.
.TP
-.BI scrollDown( n )
-Scroll down by
-.I n
-pixels.
+.B findPrevious
+Find the previous occurrence of the search string.
.TP
-.BI scrollUpPrevPage( n )
-Scroll up by
-.I n
-pixels, moving to the previous page if appropriate.
+.B focusToDocWin
+Set keyboard focus to the main document window.
.TP
-.BI scrollDownPrevPage( n )
-Scroll down by
-.I n
-pixels, moving to the next page if appropriate.
+.B focusToPageNum
+Set keyboard focus to the page number text box.
.TP
-.B scrollToTopEdge
-Scroll to the top edge of the current page, with no horizontal
-movement.
+.B followLink
+Follow a hyperlink (does nothing if the mouse is not over a link).
.TP
-.B scrollToBottomEdge
-Scroll to the bottom edge of the current page, with no horizontal
-movement.
+.B followLinkInNewTab
+Follow a hyperlink, opening PDF files in a new tab (does nothing if
+the mouse is not over a link). For links to non-PDF files, this
+command is identical to followLink.
.TP
-.B scrollToLeftEdge
-Scroll to the left edge of the current page, with no vertical
-movement.
+.B followLinkInNewTabNoSel
+Same as followLinkInNewTab, but does nothing if there is a non-empty
+selection. (This is useful as a mouse button binding.)
.TP
-.B scrollToRightEdge
-Scroll to the right edge of the current page, with no vertical
-movement.
+.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 scrollToTopLeft
-Scroll to the top-left corner of the current page.
+.B followLinkInNewWinNoSel
+Same as followLinkInNewWin, but does nothing if there is a non-empty
+selection. (This is useful as a mouse button binding.)
.TP
-.B scrollToBottomRight
-Scroll to the bottom-right corner of the current page.
+.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 goForward
-Move forward along the history path.
+.B fullScreenMode
+Go to full-screen mode.
.TP
.B goBackward
Move backward along the history path.
.TP
-.BI zoomPercent( z )
-Set the zoom factor to
-.IR z %.
+.B goForward
+Move forward along the history path.
.TP
-.B zoomFitPage
-Set the zoom factor to fit-page.
+.BI gotoDest( dest )
+Go to a named destination.
.TP
-.B zoomFitWidth
-Set the zoom factor to fit-width.
+.B gotoLastPage
+Go to the last page in the PDF file.
.TP
-.B zoomIn
-Zoom in - go to the next higher zoom factor.
+.BI gotoPage( page )
+Go to the specified page.
.TP
-.B zoomOut
-Zoom out - go the next lower zoom factor.
+.BI help
+Open the help URL.
.TP
-.B rotateCW
-Rotate the page 90 degrees clockwise.
+.B horizontalContinuousMode
+Switch to horizontal continuous view mode.
.TP
-.B rotateCCW
-Rotate the page 90 degrees counterclockwise.
+.B linearSelectMode
+Set linear selection mode. In this mode, the selection follows text.
+Non-text regions cannot be selected.
.TP
-.BI setSelection( pg , ulx , uly , lrx , lry )
-Set the selection to the specified coordinates on the specified page.
+.B newTab
+Open an empty new tab.
.TP
-.B continuousMode
-Go to continuous view mode.
+.B newWindow
+Open an empty new window.
.TP
-.B singlePageMode
-Go to single-page view mode.
+.B nextPage
+Go to the next page.
.TP
-.B toggleContinuousMode
-Toggle between continuous and single page view modes.
+.B nextPageNoScroll
+Go to the next page, with the current relative scroll position.
.TP
-.B fullScreenMode
-Go to full-screen mode.
+.B nextTab
+Switch to the next tab.
.TP
-.B windowMode
-Go to window (non-full-screen) mode.
+.B open
+Open a PDF file in this tab, using the open dialog.
.TP
-.B toggleFullScreenMode
-Toggle between full-screen and window modes.
+.B openErrorWindow
+Open the error window.
.TP
-.B open
-Open a PDF file in this window, using the open dialog.
+.B openSidebar
+Open the sidebar.
.TP
-.B openInNewWin
-Open a PDF file in a new window, using the open dialog.
+.B openSidebarMoveResizeWin
+Open the sidebar, resizing the window so that the document size
+doesn't change, and moving the window so that the document stays in
+the same place on the screen.
.TP
-.BI openFile( file )
-Open a specified PDF file in this window.
+.B openSidebarResizeWin
+Open the sidebar, resizing the window so that the document size
+doesn't change.
.TP
-.BI openFileInNewWin( file )
-Open a specified PDF file in a new window.
+.B pageDown
+Scroll down by one screenful.
.TP
-.BI openFileAtDest( file , dest )
-Open a specified PDF file in this window and go to a named
-destination.
+.B pageUp
+Scroll up by one screenful.
.TP
-.BI openFileAtDestInNewWin( file , dest )
-Open a specified PDF file in a new window and go to a named
-destination.
+.B postPopupMenu
+Display the popup menu.
.TP
-.B reload
-Reload the current PDF file.
+.B prevPage
+Go to the previous page.
.TP
-.B redraw
-Redraw the window.
+.B prevPageNoScroll
+Go to the previous page, with the current relative scroll position.
.TP
-.B raise
-Raise the window to the front.
+.B prevTab
+Switch to the previous tab.
.TP
-.B closeWindow
-Close the window. If this was the last open window, clear the window,
-but don't quit from Xpdf.
+.B print
+Open the \'print' dialog.
.TP
-.B closeWindowOrQuit
-Close the window. If this was the last open window, quit from Xpdf.
+.B quit
+Quit from xpdf.
+.TP
+.B reload
+Reload the current PDF file.
+.TP
+.B rotateCCW
+Rotate the page 90 degrees counterclockwise.
+.TP
+.B rotateCW
+Rotate the page 90 degrees clockwise.
.TP
.BI run( external-command-string )
Run an external command. The following escapes are allowed in the
@@ -675,14 +580,26 @@ command must be quoted in the xpdfrc file:
.fi
.TP
-.B openOutline
-Open the outline pane.
+.B saveAs
+Save PDF via a file requester.
.TP
-.B closeOutline
-Close the outline pane.
+.B saveImage
+Open the \'save image' dialog.
.TP
-.B toggleOutline
-Toggle the outline pane between open and closed.
+.BI scrollDown( n )
+Scroll down by
+.I n
+pixels.
+.TP
+.BI scrollDownPrevPage( n )
+Scroll down by
+.I n
+pixels, moving to the next page if appropriate.
+.TP
+.BI scrollLeft( n )
+Scroll left by
+.I n
+pixels.
.TP
.BI scrollOutlineDown( n )
Scroll the outline down by
@@ -694,163 +611,105 @@ Scroll the outline up by
.I n
increments.
.TP
-.B focusToDocWin
-Set the keyboard focus to the main document window.
+.BI scrollRight( n )
+Scroll right by
+.I n
+pixels.
.TP
-.B focusToPageNum
-Set the keyboard focus to the page number text box.
+.B scrollToBottomEdge
+Scroll to the bottom edge of the current page, with no horizontal
+movement.
.TP
-.B find
-Open the 'find' dialog.
+.B scrollToBottomRight
+Scroll to the bottom-right corner of the current page.
.TP
-.B findNext
-Finds the next occurrence of the search string (no dialog).
+.B scrollToLeftEdge
+Scroll to the left edge of the current page, with no vertical
+movement.
.TP
-.B print
-Open the 'print' dialog.
+.B scrollToRightEdge
+Scroll to the right edge of the current page, with no vertical
+movement.
.TP
-.B about
-Open the 'about' dialog.
+.B scrollToTopEdge
+Scroll to the top edge of the current page, with no horizontal
+movement.
.TP
-.B quit
-Quit from xpdf.
-.PP
-The following commands depend on the current mouse position:
+.B scrollToTopLeft
+Scroll to the top-left corner of the current page.
.TP
-.B startSelection
-Start a selection, which will be extended as the mouse moves.
+.BI scrollUp( n )
+Scroll up by
+.I n
+pixels.
.TP
-.B endSelection
-End a selection.
+.BI scrollUpPrevPage( n )
+Scroll up by
+.I n
+pixels, moving to the previous page if appropriate.
+.TP
+.BI setSelection( pg , ulx , uly , lrx , lry )
+Set the selection to the specified coordinates on the specified page.
+.TP
+.B sideBySideContinuousMode
+Switch to side-by-side continuous view mode.
+.TP
+.B sideBySideSingleMode
+Switch to side-by-side two-page view mode.
+.TP
+.B singlePageMode
+Switch to single-page view mode.
.TP
.B startPan
-Start a pan, which will scroll the document as the mouse moves
+Start a pan operation at the current mouse position, which will scroll
+the document as the mouse moves.
.TP
-.B endPan
-End a pan.
+.B startSelection
+Start a selection at the current mouse position, which will be
+extended as the mouse moves.
.TP
-.B postPopupMenu
-Display the popup menu.
+.B toggleContinuousMode
+Toggle between continuous and single page view modes.
.TP
-.B followLink
-Follow a hyperlink (does nothing if the mouse is not over a link).
+.B toggleFullScreenMode
+Toggle between full-screen and window modes.
.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.
+.B toggleSelectMode
+Toggle between block and linear selection mode.
.TP
-.B followLinkNoSel
-Same as followLink, but does nothing if there is a non-empty selection.
-(This is useful as a mouse button binding.)
+.B toggleSidebar
+Toggle the sidebar between open and closed.
.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 closeWindowOrQuit
- 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.
+.B toggleSidebarMoveResizeWin
+Toggle the sidebar between open and closed, resizing the window so
+that the document size doesn't change, and moving the window so that
+the document stays in the same place on the screen.
+.TP
+.B toggleSidebarResizeWin
+Toggle the sidebar between open and closed, resizing the window so
+that the document size doesn't change.
+.TP
+.B windowMode
+Go to window (non-full-screen) mode.
+.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
+.BI zoomPercent( z )
+Set the zoom factor to
+.IR z %.
+.TP
+.B zoomToSelection
+Zoom to the current selection.
.SH EXIT CODES
The Xpdf tools use the following exit codes:
.TP
@@ -869,7 +728,7 @@ Error related to PDF permissions.
99
Other error.
.SH AUTHOR
-The xpdf software and documentation are copyright 1996-2014 Glyph &
+The xpdf software and documentation are copyright 1996-2017 Glyph &
Cog, LLC.
.SH "SEE ALSO"
.BR pdftops (1),
@@ -883,4 +742,4 @@ Cog, LLC.
.BR pdfimages (1),
.BR xpdfrc (5)
.br
-.B http://www.foolabs.com/xpdf/
+.B http://www.xpdfreader.com/
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/xpdf.cat b/Build/source/libs/xpdf/xpdf-src/doc/xpdf.cat
index 965b3106ed1..cf76e2490a5 100644
--- a/Build/source/libs/xpdf/xpdf-src/doc/xpdf.cat
+++ b/Build/source/libs/xpdf/xpdf-src/doc/xpdf.cat
@@ -1,31 +1,37 @@
-xpdf(1) xpdf(1)
+xpdf(1) General Commands Manual xpdf(1)
NAME
- xpdf - Portable Document Format (PDF) file viewer for X (version 3.04)
+ xpdf - Portable Document Format (PDF) file viewer (version 4.00)
SYNOPSIS
- xpdf [options] [PDF-file [page | +dest]]
+ 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.
+ PDF software.) Xpdf uses the Qt GUI toolkit and runs on Unix, OS X,
+ and Windows.
- To run xpdf, simply type:
+ To run xpdf, 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.:
+ page number to be displayed, prefixed with a colon:
- xpdf file.pdf 18
+ 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.)
+ or by a named destination, prefixed with '+' (this is only useful with
+ PDF files that provide named destination targets):
+
+ xpdf file.pdf +destinationA
+
+ If you specify multiple files, they will each be opened in a separate
+ tab:
+
+ xpdf file1.pdf file2.pdf :18 file3.pdf
You can also start xpdf without opening any files:
@@ -39,57 +45,46 @@ CONFIGURATION FILE
man page for details.
OPTIONS
- Many of the following options can be set with configuration file com-
- mands or X resources. These are listed in square brackets with the
- description of the corresponding command line option.
+ The following command line options are available. All command line
+ options must come before any PDF files to be opened.
- -g geometry
- Set the initial window geometry. (-geometry is equivalent.) [X
- resource: xpdf.geometry]
+ Many of the options can be set with configuration file commands. These
+ are listed in square brackets with the description of the corresponding
+ command line option.
+
+ -geometry geometry
+ Set the initial window 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 visu-
- als. [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 con-
- serve color table entries. This is ignored with private col-
- ormaps and on TrueColor visuals. [X resource: xpdf.rgbCubeSize]
+ foo.pdf".
-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.reverseV-
- ideo]
+ paper color to default to black.
-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]
+ The color can be #RRGGBB (hexadecimal) or a named color. This
+ option will not work well with PDF files that do things like
+ filling in white behind the text. [config file: paperColor]
-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.) [X resource:
- xpdf.matteColor]
+ the actual page area. The color can be #RRGGBB (hexadecimal) or
+ a named color. [config file: matteColor]
+
+ -fsmattecolor color
+ Set the matte color for full-screen mode. The color can be
+ #RRGGBB (hexadecimal) or a named color. [config file:
+ fullScreenMatteColor]
-z zoom
Set the initial zoom factor. A number specifies a zoom percent-
- age, 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. [config file: initialZoom; or X
- resource: xpdf.initialZoom]
-
- -cont Start in continuous view mode, i.e., with one vertical scroll
- bar for the whole document. [config file: continuousView]
-
- -freetype yes | no
- Enable or disable FreeType (a TrueType / Type 1 font raster-
- izer). This defaults to "yes". [config file: enableFreeType]
+ age, 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. [config file: initialZoom]
-aa yes | no
Enable or disable font anti-aliasing. This defaults to "yes".
@@ -99,70 +94,26 @@ OPTIONS
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 dialog). This can also be of the
- form '|command' to pipe the PostScript through a command. [con-
- fig 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:
- psPaperSize]
-
- -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)).
+ 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). [con-
fig file: textEncoding]
- -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. Providing this
- will bypass all security restrictions.
-
- -upw password
- Specify the user password for the PDF file.
+ -pw password
+ Specify the password for the PDF file. This can be either the
+ owner password (which will bypass all security restrictions) or
+ the user password.
-fullscreen
Open xpdf in full-screen mode, useful for presentations.
- -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).
+ -display display
+ Set the X display (only available with X11).
- -cmd Print commands as they're executed (useful for debugging).
+ -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 system-wide config
file.
@@ -171,388 +122,385 @@ OPTIONS
-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
+ Tool bar
+ 'page' entry box
Move to a specific page number. Click in the box to activate
it, type the page number, then hit return.
+ left/right arrow buttons
+ Go backward or forward along the history path.
+
+ zoom out/in buttons
+ Zoom out or in (i.e., change magnification) incrementally.
+
zoom popup menu
Change the zoom factor (see the description of the -z option
above).
- binoculars button
- Find a text string.
+ fit width button
+ Change the zoom factor to fit the page width to the window
+ width.
- 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'.
+ fit page button
+ Change the zoom factor to fit the page to the window size.
- '?' button
- Bring up the 'about xpdf' window.
+ working/error indicator
+ This icon is animated while Xpdf is rendering a page. It turns
+ red when an error or warning has been issued. Clicking on it
+ opens the error dialog.
- 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.
+ 'find' box
+ Find a text string. Click in the box to activate it, type a
+ search string, then hit return.
- 'Quit' button
- Quit xpdf.
+ find next button
+ Find the next occurrence of the search string.
- Menu
- Pressing the right mouse button will post a popup menu with the follow-
- ing commands:
+ find previous button
+ Find the previous occurrence of the search string.
- Open...
- Open a new PDF file via a file requester.
+ find settings button
+ Display the current find settings: case sensitive (on/off), find
+ whole words (on/off).
- Open in new window...
- Create a new window and open a new PDF file via a file
- requester.
+ Menu bar
+ The menu bar is above the tool bar. The menu items should be self-
+ explanatory.
- 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.
+ Tab list
+ The tab list is on the left, just below the tool bar. It lists all
+ open tabs.
- Save as...
- Save the current file via a file requester.
+ Outline/layers/attachments pane
+ This pane is on the left, below the tab list. The popup allows you to
+ select from outline, layers, or attachments.
- Continuous view
- Toggles between single page and continuous view modes.
-
- Rotate counterclockwise
- Rotate the page 90 degrees counterclockwise.
+ The outline is a tree-like structure of bookmarks that allows moving
+ within the PDF file. Not all PDF files have outlines.
- 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.
+ Layers (a.k.a. optional content) allow parts of the PDF content to be
+ shown or hidden. Not all PDF files have layers.
- 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 vertical split bar via the knob near its bot-
- tom end.
+ Attachments are other files embedded within the PDF file. There is a
+ 'save' button for each attached file. Not all PDF files have attach-
+ ments.
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.
+ Dragging the mouse with the left button held down will highlight an
+ arbitrary rectangle. Selected text can be copied to the clipboard
+ (with the edit/copy menu item). On X11, selected text will be avail-
+ able in the X selection buffer.
Links
+ When the mouse is over a hyperlink, the link target will be shown in a
+ popup near the bottom of the window.
+
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
- WEB BROWSERS section below).
+ 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 are opened in a system-dependent
+ way. (On UNIX, Qt uses the $BROWSER environment variable.)
+
+ Mouse bindings
+ The left mouse button is used to select text (see above).
+
+ Clicking on a link with the middle button opens the link in a new tab.
- 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.
+ The right mouse button opens a popup menu (see popupMenuCmd in
+ xpdfrc(5)).
- 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.
+ Key bindings
+ This section lists the default key bindings. Bindings can be changed
+ using the config file (see xpdfrc(5)).
- control-L
- Redraw the current page.
+ control-o
+ Open a new PDF file via a file requester.
- control-W
- Close the current window.
+ control-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.
- f or control-F
- Find a text string.
+ control-f
+ Find a text string. This sets keyboard focus to the 'find' box.
control-G
Find next occurrence.
+ control-C
+ Copy selected text to the clipboard.
+
control-P
Print.
- n Move to the next page. Scrolls to the top of the page, unless
- scroll lock is turned on.
+ control-0 (control-zero)
+ Set the zoom factor to 125%.
- p Move to the previous page. Scrolls to the top of the page,
- unless scroll lock is turned on.
+ control-+ (control-plus)
+ Zoom in (increment the zoom factor by 1).
- <Space> or <PageDown> or <Next>
- Scroll down on the current page; if already at bottom, move to
- next page.
+ control-- (control-minus)
+ Zoom out (decrement the zoom factor by 1).
- <Backspace> or <Delete> or <PageUp> or <Previous>
- Scroll up on the current page; if already at top, move to previ-
- ous page.
+ control-s
+ Save PDF via a file requester.
- v Move forward along the history path.
+ control-t
+ Open a new tab.
- b Move backward along the history path.
+ control-n
+ Open a new window.
- <Home> Scroll to top of current page.
+ control-w
+ Close the current tab. Closes the window if this was the last
+ open tab. Quits the application if this was the last open win-
+ dow.
- <End> Scroll to bottom of current page.
+ control-q
+ Quit.
- control-<Home>
- Scroll to first page of document.
+ control-<tab>
+ Next tab.
- control-<End>
- Scroll to last page of document.
+ control-shift-<tab>
+ Previous tab.
- arrows Scroll the current page.
+ control-?
+ Help.
- g Activate the page number text field ("goto page").
+ alt-<left-arrow>
+ Go backward along the history path.
- 0 Set the zoom factor to 125%.
+ alt-<right-arrow>
+ Go forward along the history path.
- + Zoom in (increment the zoom factor by 1).
+ home Go to the top left of current page.
- - Zoom out (decrement the zoom factor by 1).
+ control-<home>
+ Go to the first page.
- z Set the zoom factor to 'page' (fit page to window).
+ end Go to the bottom right of current page.
- w Set the zoom factor to 'width' (fit page width to window).
+ control-<end>
+ Go to the last page.
- alt-F Toggle full-screen mode.
+ <space> or <PageDown>
+ Scroll down on the current page; if already at bottom, move to
+ next page.
- q Quit xpdf.
+ control-<PageDown> or control-<down-arrow>
+ Go to the next page. If <ScrollLock> is active, this maintains
+ the relative position on the page.
-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:
+ <PageUp>
+ Scroll up on the current page; if already at top, move to previ-
+ ous page.
- application/pdf pdf
+ control-<PageUp> or control-<up-arrow>
+ Go to the previous page. If <ScrollLock> is active, this main-
+ tains the relative position on the page.
- In .mailcap add the lines:
+ <esc> Exit full-screen mode.
- # Use xpdf to view PDF files.
- application/pdf; xpdf -q %s
+ arrows Scroll the current page.
- Make sure that xpdf is on your executable search path.
+ g Set keyboard focus to the page number entry box.
- When you click on a URL link in a PDF file, xpdf will execute the com-
- mand 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:
+ z Set the zoom factor to 'page' (fit page to window).
- urlCommand "netscape -remote 'openURL(%s)'"
+ w Set the zoom factor to 'width' (fit page width to window).
+
+Full-screen mode
+ Xpdf can be placed into full-screen mode via the -fullscreen command
+ line option, the 'full screen' menu item, or a binding to the
+ fullScreenMode or toggleFullScreenModecommand.
+
+ Entering full-screen mode automatically switches to single-page view
+ mode and to the fit-page zoom factor.
+
+ Full-screen mode can be exited via the default <esc> key binding, or
+ via a binding to the windowMode or toggleFullScreenModecommand.
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
+ unbind commands 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.
+ about Open the 'about' dialog.
- gotoPageNoScroll(page)
- Go to the specified page, with the current relative scroll posi-
- tion.
+ blockSelectMode
+ Set block selection mode. In this mode, the selection is a sim-
+ ple rectangle. Any part of the page can be selected, regardless
+ of the content on the page.
- gotoDest(dest)
- Go to a named destination.
+ closeSidebar
+ Close the sidebar.
- gotoLastPage
- Go to the last page in the PDF file.
+ closeSidebarMoveResizeWin
+ Close the sidebar, resizing the window so that the document size
+ doesn't change, and moving the window so that the document stays
+ in the same place on the screen.
- gotoLastPageNoScroll
- Go to the last page in the PDF file, with the current relative
- scroll position.
+ closeSidebarResizeWin
+ Close the sidebar, resizing the window so that the document size
+ doesn't change.
- nextPage
- Go to the next page.
+ closeTabOrQuit
+ Close the tab. If this was the last open tab, close the window.
+ If this was the last window open, quit.
- nextPageNoScroll
- Go to the next page, with the current relative scroll position.
+ closeWindowOrQuit
+ Close the window. If this was the last open window, quit.
- prevPage
- Go to the previous page.
+ continuousMode
+ Switch to continuous view mode.
- prevPageNoScroll
- Go to the previous page, with the current relative scroll posi-
- tion.
+ copy Copy selected text to the clipboard.
- pageUp Scroll up by one screenful.
+ endPan End a pan operation.
- pageDown
- Scroll down by one screenful.
+ endSelection
+ End a selection.
- scrollLeft(n)
- Scroll left by n pixels.
+ find Set keyboard focus to the 'find' box.
- scrollRight(n)
- Scroll right by n pixels.
+ findFirst
+ Find the first occurrence of the search string.
- scrollUp(n)
- Scroll up by n pixels.
+ findNext
+ Find the next occurrence of the search string.
- scrollDown(n)
- Scroll down by n pixels.
+ findPrevious
+ Find the previous occurrence of the search string.
- scrollUpPrevPage(n)
- Scroll up by n pixels, moving to the previous page if appropri-
- ate.
+ focusToDocWin
+ Set keyboard focus to the main document window.
- scrollDownPrevPage(n)
- Scroll down by n pixels, moving to the next page if appropriate.
+ focusToPageNum
+ Set keyboard focus to the page number text box.
- scrollToTopEdge
- Scroll to the top edge of the current page, with no horizontal
- movement.
+ followLink
+ Follow a hyperlink (does nothing if the mouse is not over a
+ link).
- scrollToBottomEdge
- Scroll to the bottom edge of the current page, with no horizon-
- tal movement.
+ followLinkInNewTab
+ Follow a hyperlink, opening PDF files in a new tab (does nothing
+ if the mouse is not over a link). For links to non-PDF files,
+ this command is identical to followLink.
- scrollToLeftEdge
- Scroll to the left edge of the current page, with no vertical
- movement.
+ followLinkInNewTabNoSel
+ Same as followLinkInNewTab, but does nothing if there is a non-
+ empty selection. (This is useful as a mouse button binding.)
- scrollToRightEdge
- Scroll to the right edge of the current page, with no vertical
- movement.
+ 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.
- scrollToTopLeft
- Scroll to the top-left corner of the current page.
+ followLinkInNewWinNoSel
+ Same as followLinkInNewWin, but does nothing if there is a non-
+ empty selection. (This is useful as a mouse button binding.)
- scrollToBottomRight
- Scroll to the bottom-right corner of the current page.
+ followLinkNoSel
+ Same as followLink, but does nothing if there is a non-empty
+ selection. (This is useful as a mouse button binding.)
- goForward
- Move forward along the history path.
+ fullScreenMode
+ Go to full-screen mode.
goBackward
Move backward along the history path.
- zoomPercent(z)
- Set the zoom factor to z%.
+ goForward
+ Move forward along the history path.
- zoomFitPage
- Set the zoom factor to fit-page.
+ gotoDest(dest)
+ Go to a named destination.
- zoomFitWidth
- Set the zoom factor to fit-width.
+ gotoLastPage
+ Go to the last page in the PDF file.
- zoomIn Zoom in - go to the next higher zoom factor.
+ gotoPage(page)
+ Go to the specified page.
- zoomOut
- Zoom out - go the next lower zoom factor.
+ help Open the help URL.
- rotateCW
- Rotate the page 90 degrees clockwise.
+ horizontalContinuousMode
+ Switch to horizontal continuous view mode.
- rotateCCW
- Rotate the page 90 degrees counterclockwise.
+ linearSelectMode
+ Set linear selection mode. In this mode, the selection follows
+ text. Non-text regions cannot be selected.
- setSelection(pg,ulx,uly,lrx,lry)
- Set the selection to the specified coordinates on the specified
- page.
+ newTab Open an empty new tab.
- continuousMode
- Go to continuous view mode.
+ newWindow
+ Open an empty new window.
- singlePageMode
- Go to single-page view mode.
+ nextPage
+ Go to the next page.
- toggleContinuousMode
- Toggle between continuous and single page view modes.
+ nextPageNoScroll
+ Go to the next page, with the current relative scroll position.
- fullScreenMode
- Go to full-screen mode.
+ nextTab
+ Switch to the next tab.
- windowMode
- Go to window (non-full-screen) mode.
+ open Open a PDF file in this tab, using the open dialog.
- toggleFullScreenMode
- Toggle between full-screen and window modes.
+ openErrorWindow
+ Open the error window.
- open Open a PDF file in this window, using the open dialog.
+ openSidebar
+ Open the sidebar.
- openInNewWin
- Open a PDF file in a new window, using the open dialog.
+ openSidebarMoveResizeWin
+ Open the sidebar, resizing the window so that the document size
+ doesn't change, and moving the window so that the document stays
+ in the same place on the screen.
- openFile(file)
- Open a specified PDF file in this window.
+ openSidebarResizeWin
+ Open the sidebar, resizing the window so that the document size
+ doesn't change.
- openFileInNewWin(file)
- Open a specified PDF file in a new window.
+ pageDown
+ Scroll down by one screenful.
- openFileAtDest(file,dest)
- Open a specified PDF file in this window and go to a named des-
- tination.
+ pageUp Scroll up by one screenful.
- openFileAtDestInNewWin(file,dest)
- Open a specified PDF file in a new window and go to a named des-
- tination.
+ postPopupMenu
+ Display the popup menu.
- reload Reload the current PDF file.
+ prevPage
+ Go to the previous page.
- redraw Redraw the window.
+ prevPageNoScroll
+ Go to the previous page, with the current relative scroll posi-
+ tion.
- raise Raise the window to the front.
+ prevTab
+ Switch to the previous tab.
- closeWindow
- Close the window. If this was the last open window, clear the
- window, but don't quit from Xpdf.
+ print Open the 'print' dialog.
- closeWindowOrQuit
- Close the window. If this was the last open window, quit from
- Xpdf.
+ quit Quit from xpdf.
+
+ reload Reload the current PDF file.
+
+ rotateCCW
+ Rotate the page 90 degrees counterclockwise.
+
+ rotateCW
+ Rotate the page 90 degrees clockwise.
run(external-command-string)
- Run an external command. The following escapes are allowed in
+ Run an external command. The following escapes are allowed in
the command string:
%f => PDF file name (or an empty string if no
@@ -577,20 +525,25 @@ COMMANDS
%k => y coordinate of the mouse pointer
%% => %
- The external command string will often contain spaces, so the
+ The external command string will often contain spaces, so the
whole command must be quoted in the xpdfrc file:
bind x "run(ls -l)"
- openOutline
- Open the outline pane.
+ saveAs Save PDF via a file requester.
- closeOutline
- Close the outline pane.
+ saveImage
+ Open the 'save image' dialog.
- toggleOutline
- Toggle the outline pane between open and closed.
+ scrollDown(n)
+ Scroll down by n pixels.
+
+ scrollDownPrevPage(n)
+ Scroll down by n pixels, moving to the next page if appropriate.
+
+ scrollLeft(n)
+ Scroll left by n pixels.
scrollOutlineDown(n)
Scroll the outline down by n increments.
@@ -598,148 +551,99 @@ COMMANDS
scrollOutlineUp(n)
Scroll the outline up by n increments.
- focusToDocWin
- Set the keyboard focus to the main document window.
+ scrollRight(n)
+ Scroll right by n pixels.
- focusToPageNum
- Set the keyboard focus to the page number text box.
+ scrollToBottomEdge
+ Scroll to the bottom edge of the current page, with no horizon-
+ tal movement.
- find Open the 'find' dialog.
+ scrollToBottomRight
+ Scroll to the bottom-right corner of the current page.
- findNext
- Finds the next occurrence of the search string (no dialog).
+ scrollToLeftEdge
+ Scroll to the left edge of the current page, with no vertical
+ movement.
- print Open the 'print' dialog.
+ scrollToRightEdge
+ Scroll to the right edge of the current page, with no vertical
+ movement.
- about Open the 'about' dialog.
+ scrollToTopEdge
+ Scroll to the top edge of the current page, with no horizontal
+ movement.
- quit Quit from xpdf.
+ scrollToTopLeft
+ Scroll to the top-left corner of the current page.
- The following commands depend on the current mouse position:
+ scrollUp(n)
+ Scroll up by n pixels.
- startSelection
- Start a selection, which will be extended as the mouse moves.
+ scrollUpPrevPage(n)
+ Scroll up by n pixels, moving to the previous page if appropri-
+ ate.
- endSelection
- End a selection.
+ setSelection(pg,ulx,uly,lrx,lry)
+ Set the selection to the specified coordinates on the specified
+ page.
+
+ sideBySideContinuousMode
+ Switch to side-by-side continuous view mode.
+
+ sideBySideSingleMode
+ Switch to side-by-side two-page view mode.
+
+ singlePageMode
+ Switch to single-page view mode.
startPan
- Start a pan, which will scroll the document as the mouse moves
+ Start a pan operation at the current mouse position, which will
+ scroll the document as the mouse moves.
- endPan End a pan.
+ startSelection
+ Start a selection at the current mouse position, which will be
+ extended as the mouse moves.
- postPopupMenu
- Display the popup menu.
+ toggleContinuousMode
+ Toggle between continuous and single page view modes.
- followLink
- Follow a hyperlink (does nothing if the mouse is not over a
- link).
+ toggleFullScreenMode
+ Toggle between full-screen and window modes.
- 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.
+ toggleSelectMode
+ Toggle between block and linear selection mode.
- followLinkNoSel
- Same as followLink, but does nothing if there is a non-empty
- selection. (This is useful as a mouse button binding.)
+ toggleSidebar
+ Toggle the sidebar between open and closed.
- followLinkInNewWinNoSel
- Same as followLinkInNewWin, but does nothing if there is a non-
- empty selection. (This is useful as a mouse button binding.)
+ toggleSidebarMoveResizeWin
+ Toggle the sidebar between open and closed, resizing the window
+ so that the document size doesn't change, and moving the window
+ so that the document stays in the same place on the screen.
+
+ toggleSidebarResizeWin
+ Toggle the sidebar between open and closed, resizing the window
+ so that the document size doesn't change.
+
+ windowMode
+ Go to window (non-full-screen) mode.
+
+ 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.
+
+ zoomPercent(z)
+ Set the zoom factor to z%.
- 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 closeWindowOrQuit
- 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 number). 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 spec-
- ified with or without a file name and page number.
-
- The -quit option tells the server to close its window and exit.
+ zoomToSelection
+ Zoom to the current selection.
EXIT CODES
The Xpdf tools use the following exit codes:
@@ -755,14 +659,14 @@ EXIT CODES
99 Other error.
AUTHOR
- The xpdf software and documentation are copyright 1996-2014 Glyph &
+ The xpdf software and documentation are copyright 1996-2017 Glyph &
Cog, LLC.
SEE ALSO
pdftops(1), pdftotext(1), pdftohtml(1), pdfinfo(1), pdffonts(1), pdfde-
tach(1), pdftoppm(1), pdftopng(1), pdfimages(1), xpdfrc(5)
- http://www.foolabs.com/xpdf/
+ http://www.xpdfreader.com/
- 28 May 2014 xpdf(1)
+ 10 Aug 2017 xpdf(1)
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/xpdfrc.5 b/Build/source/libs/xpdf/xpdf-src/doc/xpdfrc.5
index afb8d950795..8ae83f410a5 100644
--- a/Build/source/libs/xpdf/xpdf-src/doc/xpdfrc.5
+++ b/Build/source/libs/xpdf/xpdf-src/doc/xpdfrc.5
@@ -1,7 +1,7 @@
-.\" Copyright 2002-2014 Glyph & Cog, LLC
-.TH xpdfrc 5 "28 May 2014"
+.\" Copyright 2002-2017 Glyph & Cog, LLC
+.TH xpdfrc 5 "10 Aug 2017"
.SH NAME
-xpdfrc \- configuration file for Xpdf tools (version 3.04)
+xpdfrc \- configuration file for Xpdf tools (version 4.00)
.SH DESCRIPTION
All of the Xpdf tools read a single configuration file. If you have a
.I .xpdfrc
@@ -31,114 +31,6 @@ to inserting the contents of
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 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 GENERAL FONT CONFIGURATION
.TP
.BI fontFile " PDF\-font\-name font\-file"
@@ -195,7 +87,7 @@ with writing mode
is used (without embedding) in a PDF file, it will be translated to
the PostScript font
.IR PS\-font\-name ,
-which is assumbed to be resident in the printer. The writing mode
+which is assumed to be resident in the printer. The writing mode
must be either \'H' for horizontal or \'V' for vertical. The resident
font is assumed to use the specified encoding (which must have been
defined with the unicodeMap command).
@@ -208,7 +100,7 @@ character collection and
writing mode is used (without embedding) in a PDF file, the PostScript
font,
.IR PS\-font\-name ,
-is substituted for it. The substituted font is assumbed to be
+is substituted for it. The substituted font is assumed to be
resident in the printer. The writing mode must be either \'H' for
horizontal or \'V' for vertical. The resident font is assumed to use
the specified encoding (which must have been defined with the
@@ -268,7 +160,7 @@ By default, this is "no", and the MediaBox is used as the page size.
.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
+are expanded to fill the imageable area. Otherwise, no scaling is
done on smaller pages. This defaults to "no".
.TP
.BR psShrinkLarger " yes | no"
@@ -287,7 +179,7 @@ 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"
+.BR psLevel " level1 | level1sep | level2 | level2gray | level2sep | level3 | level3gray | level3Sep"
Sets the PostScript level to generate. This defaults to "level2".
.TP
.BR psPreload " yes | no"
@@ -341,6 +233,12 @@ size, in pixels. This defaults to 20000000 (20 million).
If set to "yes", all PostScript output will be rasterized. This
defaults to "no".
.TP
+.BR psNeverRasterize " yes | no"
+If set to "yes", PostScript output will never be rasterized. This
+will likely result in incorrect output for PDF files that use
+transparency. (If both psAlwaysRasterize and psNeverRasterize are set
+to "yes", the psAlwaysRasterize setting wins.) 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
@@ -350,7 +248,7 @@ PDF file <file>.pdf.
.TP
.BI fontDir " dir"
See the description above, in the DISPLAY FONTS section.
-.SH TEXT CONTROL
+.SH TEXT CONTROL AND CHARACTER MAPPING
.TP
.BI textEncoding " encoding\-name"
Sets the encoding to use for text output. (This can be overridden
@@ -383,24 +281,138 @@ If set to "yes", text extraction will keep all characters. If set to
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 "yes".
-.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.
+.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
-.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".
+.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
-.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".
+.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 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.
+.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. (For CID fonts,
+setting mapNumericCharNames to "no" is unnecessary.) 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 mapExtTrueTypeFontsViaUnicode " yes | no"
+When rasterizing text using an external TrueType font, there are two
+options for handling character codes. If
+mapExtTrueTypeFontsViaUnicode is set to "yes", Xpdf will use the font
+encoding/ToUnicode info to map character codes to Unicode, and then
+use the font's Unicode cmap to map Unicode to GIDs. If
+mapExtTrueTypeFontsViaUnicode is set to "no", Xpdf will assume the
+character codes are GIDs (i.e., use an identity mapping). This
+defaults to "yes".
+.SH RASTERIZER SETTINGS
.TP
.BR enableFreeType " yes | no"
Enables or disables use of FreeType (a TrueType / Type 1 font
@@ -428,11 +440,15 @@ If this is "yes", bitmaps sent to the printer will be antialiased
this is "no", printed bitmaps will not be antialiased. This defaults
to "no".
.TP
-.BR strokeAdjust " yes | no"
-Enables or disables stroke adjustment. Stroke adjustment moves
-horizontal and vertical lines by up to half a pixel to make them look
-"cleaner" when vector anti-aliasing is enabled. This defaults to
-"yes".
+.BR strokeAdjust " yes | no | cad"
+Sets the stroke adjustment mode. If set to "no", no stroke adjustment
+will be done. If set to "yes", normal stroke adjustment will be done:
+horizontal and vertical lines will be moved by up to half a pixel to
+make them look cleaner when vector anti-aliasing is enabled. If set
+to "cad", a slightly different stroke adjustment algorithm will be
+used to ensure that lines of the same original width will always have
+the same adjusted width (at the expense of allowing gaps and overlaps
+between adjacent lines). This defaults to "yes".
.TP
.BR screenType " dispersed | clustered | stochasticClustered"
Sets the halftone screen type, which will be used when generating a
@@ -474,14 +490,75 @@ rasterizer only, not the PostScript converter (except when it uses
rasterization to handle transparency). The default value is 0 (no
minimum).
.TP
-.BI drawAnnotations " yes | no"
-If set to "no", annotations will not be drawn or printed. The default
-value is "yes".
+.BI enablePathSimplification " yes | no"
+If set to "yes", simplify paths by removing points where it won't make
+a significant difference to the shape. The default value is "no".
.TP
.BI overprintPreview " yes | no"
If set to "yes", generate overprint preview output, honoring the
OP/op/OPM settings in the PDF file. Ignored for non-CMYK output. The
default value is "no".
+.SH VIEWER SETTINGS
+These settings only apply to the Xpdf GUI PDF viewer.
+.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
+.BI defaultFitZoom " percentage"
+If xpdf is started with fit-page or fit-width zoom and no window
+geometry, it will calculate a desired window size based on the PDF
+page size and this defaultFitZoom value. I.e., the window size will
+be chosen such that exactly one page will fit in the window at this
+zoom factor (which must be a percentage). The default value is
+based on the screen resolution.
+.TP
+.BI initialSidebarState " yes | no"
+If set to "yes", xpdf opens with the sidebar (tabs, outline, etc.)
+visible. If set to "no", xpdf opens with the sidebar collapsed. The
+default is "no".
+.TP
+.BI paperColor " color"
+Set the "paper color", i.e., the background of the page display. The
+color can be #RRGGBB (hexadecimal) or a named color. This option will
+not work well with PDF files that do things like filling in white
+behind the text.
+.TP
+.BI matteColor " color"
+Set the matte color, i.e., the color used for background outside the
+actual page area. The color can be #RRGGBB (hexadecimal) or a named
+color.
+.TP
+.BI fullScreenMatteColor " color"
+Set the matte color for full-screen mode. The color can be #RRGGBB
+(hexadecimal) or a named color.
+.TP
+.BI popupMenuCmd " title command ..."
+Add a command to the popup menu.
+.I Title
+is the text to be displayed in the menu.
+.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.
+.TP
+.BI maxTileWidth " pixels"
+Set the maximum width of tiles to be used by xpdf when rasterizing
+pages. This defaults to 1500.
+.TP
+.BI maxTileHeight " pixels"
+Set the maximum height of tiles to be used by xpdf when rasterizing
+pages. This defaults to 1500.
+.TP
+.BI tileCacheSize " tiles"
+Set the maximum number of tiles to be cached by xpdf when rasterizing
+pages. This defaults to 10.
+.TP
+.BI workerThreads " numThreads"
+Set the number of worker threads to be used by xpdf when rasterizing
+pages. This defaults to 1.
.TP
.BI launchCommand " command"
Sets the command executed when you click on a "launch"-type link. The
@@ -492,45 +569,11 @@ specified with the link. Do not use "%s" in "command". By default,
this is unset, and Xpdf will simply try to execute the file (after
prompting the user).
.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. (For CID fonts,
-setting mapNumericCharNames to "no" is unnecessary.) 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 mapExtTrueTypeFontsViaUnicode " yes | no"
-When rasterizing text using an external TrueType font, there are two
-options for handling character codes. If
-mapExtTrueTypeFontsViaUnicode is set to "yes", Xpdf will use the font
-encoding/ToUnicode info to map character codes to Unicode, and then
-use the font's Unicode cmap to map Unicode to GIDs. If
-mapExtTrueTypeFontsViaUnicode is set to "no", Xpdf will assume the
-character codes are GIDs (i.e., use an identity mapping). This
-defaults to "yes".
-.TP
-.BI enableXFA " yes | no"
-If set to "yes", an XFA form (if present) will be rendered in place of
-an AcroForm. If "no", an XFA form will never be rendered. This
-defaults to "yes".
-.TP
.BI bind " modifiers-key context command ..."
Add a key or mouse button binding.
.I Modifiers
@@ -551,6 +594,7 @@ can be a regular ASCII character, or any one of:
return
enter
backspace
+ esc
insert
delete
home
@@ -561,6 +605,7 @@ can be a regular ASCII character, or any one of:
f1 .. f35 (function keys)
mousePress1 .. mousePress7 (mouse buttons)
mouseRelease1 .. mouseRelease7 (mouse buttons)
+ mouseClick1 .. mouseClick7 (mouse buttons)
.fi
.I Context
@@ -607,6 +652,20 @@ 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).
+.SH MISCELLANEOUS SETTINGS
+.TP
+.BI drawAnnotations " yes | no"
+If set to "no", annotations will not be drawn or printed. The default
+value is "yes".
+.TP
+.BI drawFormFields " yes | no"
+If set to "no", form fields will not be drawn or printed. The default
+value is "yes".
+.TP
+.BI enableXFA " yes | no"
+If set to "yes", an XFA form (if present) will be rendered in place of
+an AcroForm. If "no", an XFA form will never be rendered. This
+defaults to "yes".
.TP
.BI printCommands " yes | no"
If set to "yes", drawing commands are printed as they're executed
@@ -680,7 +739,7 @@ Depending on build options, it may be placed elsewhere.
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-2014 Glyph &
+The Xpdf software and documentation are copyright 1996-2017 Glyph &
Cog, LLC.
.SH "SEE ALSO"
.BR xpdf (1),
@@ -694,4 +753,4 @@ Cog, LLC.
.BR pdftopng (1),
.BR pdfimages (1)
.br
-.B http://www.foolabs.com/xpdf/
+.B http://www.xpdfreader.com/
diff --git a/Build/source/libs/xpdf/xpdf-src/doc/xpdfrc.cat b/Build/source/libs/xpdf/xpdf-src/doc/xpdfrc.cat
index b8faf8a37b8..213dde746d4 100644
--- a/Build/source/libs/xpdf/xpdf-src/doc/xpdfrc.cat
+++ b/Build/source/libs/xpdf/xpdf-src/doc/xpdfrc.cat
@@ -1,9 +1,9 @@
-xpdfrc(5) xpdfrc(5)
+xpdfrc(5) File Formats Manual xpdfrc(5)
NAME
- xpdfrc - configuration file for Xpdf tools (version 3.04)
+ xpdfrc - configuration file for Xpdf tools (version 4.00)
DESCRIPTION
All of the Xpdf tools read a single configuration file. If you have a
@@ -30,85 +30,6 @@ INCLUDE FILES
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 Uni-
- code. This is used to handle PDF fonts that have valid encod-
- ings 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 char-
- acter:
-
- hex-string
-
- The hex-string is the Unicode (UCS-2) index for that character.
- The first line maps CID 0, the second line CID 1, etc. File
- size is determined by size of the character collection. Only
- one file is allowed per character collection; the last specified
- file is used. There are no built-in cidToUnicode mappings.
-
- unicodeToUnicode font-name-substring map-file
- This is used to work around PDF fonts which have incorrect Uni-
- code 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-sub-
- string. Each line of a unicodeToUnicode 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 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 encod-
- ing:
-
- in-start-hex in-end-hex out-start-hex
-
- Entries for single characters can be abbreviated to:
-
- in-hex out-hex
-
- The in-start-hex and in-end-hex fields (or the single in-hex
- field) specify the Unicode range. The out-start-hex field (or
- the out-hex field) specifies the start of the output encoding
- range. The length of the out-start-hex (or out-hex) string
- determines the length of the output characters (e.g., UTF-8 uses
- different numbers of bytes to represent characters in different
- ranges). Entries must be given in increasing Unicode order.
- Only one file is allowed per encoding; the last specified file
- is used. The Latin1, ASCII7, Symbol, ZapfDingbats, UTF-8, and
- UCS-2 encodings are predefined.
-
- cMapDir registry-ordering dir
- Specifies a search directory, dir, for CMaps for the reg-
- istry-ordering character collection. There can be multiple
- directories for a particular collection. There are no default
- CMap directories.
-
- toUnicodeDir dir
- Specifies a search directory, dir, for ToUnicode CMaps. There
- can be multiple ToUnicode directories. There are no default
- ToUnicode directories.
-
GENERAL FONT CONFIGURATION
fontFile PDF-font-name font-file
Maps a PDF font, PDF-font-name, to a font for display or Post-
@@ -149,17 +70,17 @@ POSTSCRIPT FONT CONFIGURATION
psResidentFont16 PDF-font-name wMode PS-font-name encoding
When the 16-bit (CID) font PDF-font-name with writing mode wMode
is used (without embedding) in a PDF file, it will be translated
- to the PostScript font PS-font-name, which is assumbed to be
- resident in the printer. The writing mode must be either 'H'
- for horizontal or 'V' for vertical. The resident font is
- assumed to use the specified encoding (which must have been
- defined with the unicodeMap command).
+ to the PostScript font PS-font-name, which is assumed to be res-
+ ident in the printer. The writing mode must be either 'H' for
+ horizontal or 'V' for vertical. The resident font is assumed to
+ use the specified encoding (which must have been defined with
+ the unicodeMap command).
psResidentFontCC registry-ordering wMode PS-font-name encoding
When a 16-bit (CID) font using the registry-ordering character
collection and wMode writing mode is used (without embedding) in
a PDF file, the PostScript font, PS-font-name, is substituted
- for it. The substituted font is assumbed to be resident in the
+ for it. The substituted font is assumed to be resident in the
printer. The writing mode must be either 'H' for horizontal or
'V' for vertical. The resident font is assumed to use the spec-
ified encoding (which must have been defined with the unicodeMap
@@ -219,7 +140,7 @@ POSTSCRIPT CONTROL
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".
+ scaling is done on smaller pages. This defaults to "no".
psShrinkLarger yes | no
If set to yes, PDF pages larger than the PostScript imageable
@@ -237,47 +158,48 @@ POSTSCRIPT CONTROL
pagedevice entry. This tells duplex-capable printers to enable
duplexing. This defaults to "no".
- psLevel level1 | level1sep | level2 | level2sep | level3 | level3Sep
+ psLevel level1 | level1sep | level2 | level2gray | level2sep | level3 |
+ level3gray | level3Sep
Sets the PostScript level to generate. This defaults to
"level2".
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 Post-
+ If set to "yes", PDF forms are converted to PS procedures, and
+ image data is preloaded. This uses more memory in the Post-
Script 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".
psOPI yes | no
- If set to "yes", generates PostScript OPI comments for all
- images and forms which have OPI information. This option is
+ 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".
psASCIIHex yes | no
- If set to "yes", the ASCIIHexEncode filter will be used instead
+ If set to "yes", the ASCIIHexEncode filter will be used instead
of ASCII85Encode for binary data. This defaults to "no".
psLZW yes | no
- If set to "yes", the LZWEncode filter will be used for lossless
+ If set to "yes", the LZWEncode filter will be used for lossless
compression in PostScript output; if set to "no", the RunLength-
- Encode filter will be used instead. LZW generates better com-
- pression (smaller PS files), but may not be supported by some
+ Encode filter will be used instead. LZW generates better com-
+ pression (smaller PS files), but may not be supported by some
printers. This defaults to "yes".
psUncompressPreloadedImages yes | no
- If set to "yes", all preloaded images in PS files will uncom-
+ If set to "yes", all preloaded images in PS files will uncom-
pressed. If set to "no", the original compressed images will be
- used when possible. The "yes" setting is useful to work around
+ used when possible. The "yes" setting is useful to work around
certain buggy PostScript interpreters. This defaults to "no".
psMinLineWidth float
- Set the minimum line width, in points, for PostScript output.
+ Set the minimum line width, in points, for PostScript output.
The default value is 0 (no minimum).
psRasterResolution float
- Set the resolution (in dpi) for rasterized pages in PostScript
- output. (Pdftops will rasterize pages which use transparency.)
+ Set the resolution (in dpi) for rasterized pages in PostScript
+ output. (Pdftops will rasterize pages which use transparency.)
This defaults to 300.
psRasterMono yes | no
@@ -285,72 +207,166 @@ POSTSCRIPT CONTROL
(8-bit gray) instead of color. This defaults to "no".
psRasterSliceSize pixels
- When rasterizing pages, pdftops splits the page into horizontal
- "slices", to limit memory usage. This option sets the maximum
+ When rasterizing pages, pdftops splits the page into horizontal
+ "slices", to limit memory usage. This option sets the maximum
slice size, in pixels. This defaults to 20000000 (20 million).
psAlwaysRasterize yes | no
If set to "yes", all PostScript output will be rasterized. This
defaults to "no".
+ psNeverRasterize yes | no
+ If set to "yes", PostScript output will never be rasterized.
+ This will likely result in incorrect output for PDF files that
+ use transparency. (If both psAlwaysRasterize and psNeverRaster-
+ ize are set to "yes", the psAlwaysRasterize setting wins.) This
+ defaults to "no".
+
psFile file-or-command
- Sets the default PostScript file or print command for xpdf.
- Commands start with a '|' character; anything else is a file.
- If the file name or command contains spaces it must be quoted.
- This defaults to unset, which tells xpdf to generate a name of
+ 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.
fontDir dir
See the description above, in the DISPLAY FONTS section.
-TEXT CONTROL
+TEXT CONTROL AND CHARACTER MAPPING
textEncoding encoding-name
Sets the encoding to use for text output. (This can be overrid-
- den with the "-enc" switch on the command line.) The encod-
- ing-name must be defined with the unicodeMap command (see
+ den with the "-enc" switch on the command line.) The encod-
+ ing-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
+ 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
+ (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
+ 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
+ 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 "yes".
-MISCELLANEOUS SETTINGS
- initialZoom percentage | page | width
- Sets the initial zoom factor. A number specifies a zoom per-
- centage, 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.
+ nameToUnicode map-file
+ Specifies a file with the mapping from character names to Uni-
+ code. This is used to handle PDF fonts that have valid encod-
+ ings 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 char-
+ acter:
+
+ hex-string
+
+ The hex-string is the Unicode (UCS-2) index for that character.
+ The first line maps CID 0, the second line CID 1, etc. File
+ size is determined by size of the character collection. Only
+ one file is allowed per character collection; the last specified
+ file is used. There are no built-in cidToUnicode mappings.
+
+ unicodeToUnicode font-name-substring map-file
+ This is used to work around PDF fonts which have incorrect Uni-
+ code 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-sub-
+ string. Each line of a unicodeToUnicode 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 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 encod-
+ ing:
+
+ in-start-hex in-end-hex out-start-hex
- 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
+ Entries for single characters can be abbreviated to:
+
+ in-hex out-hex
+
+ The in-start-hex and in-end-hex fields (or the single in-hex
+ field) specify the Unicode range. The out-start-hex field (or
+ the out-hex field) specifies the start of the output encoding
+ range. The length of the out-start-hex (or out-hex) string
+ determines the length of the output characters (e.g., UTF-8 uses
+ different numbers of bytes to represent characters in different
+ ranges). Entries must be given in increasing Unicode order.
+ Only one file is allowed per encoding; the last specified file
+ is used. The Latin1, ASCII7, Symbol, ZapfDingbats, UTF-8, and
+ UCS-2 encodings are predefined.
+
+ cMapDir registry-ordering dir
+ Specifies a search directory, dir, for CMaps for the reg-
+ istry-ordering character collection. There can be multiple
+ directories for a particular collection. There are no default
+ CMap directories.
+
+ toUnicodeDir dir
+ Specifies a search directory, dir, for ToUnicode CMaps. There
+ can be multiple ToUnicode directories. There are no default
+ ToUnicode directories.
+
+ 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. (For
+ CID fonts, setting mapNumericCharNames to "no" is unnecessary.)
+ 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".
- 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".
+ mapExtTrueTypeFontsViaUnicode yes | no
+ When rasterizing text using an external TrueType font, there are
+ two options for handling character codes. If mapExtTrueType-
+ FontsViaUnicode is set to "yes", Xpdf will use the font encod-
+ ing/ToUnicode info to map character codes to Unicode, and then
+ use the font's Unicode cmap to map Unicode to GIDs. If mapExt-
+ TrueTypeFontsViaUnicode is set to "no", Xpdf will assume the
+ character codes are GIDs (i.e., use an identity mapping). This
+ defaults to "yes".
+RASTERIZER SETTINGS
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
@@ -377,113 +393,142 @@ MISCELLANEOUS SETTINGS
settings). If this is "no", printed bitmaps will not be
antialiased. This defaults to "no".
- strokeAdjust yes | no
- Enables or disables stroke adjustment. Stroke adjustment moves
- horizontal and vertical lines by up to half a pixel to make them
- look "cleaner" when vector anti-aliasing is enabled. This
- defaults to "yes".
+ strokeAdjust yes | no | cad
+ Sets the stroke adjustment mode. If set to "no", no stroke
+ adjustment will be done. If set to "yes", normal stroke adjust-
+ ment will be done: horizontal and vertical lines will be moved
+ by up to half a pixel to make them look cleaner when vector
+ anti-aliasing is enabled. If set to "cad", a slightly different
+ stroke adjustment algorithm will be used to ensure that lines of
+ the same original width will always have the same adjusted width
+ (at the expense of allowing gaps and overlaps between adjacent
+ lines). This defaults to "yes".
screenType dispersed | clustered | stochasticClustered
- Sets the halftone screen type, which will be used when generat-
- ing a monochrome (1-bit) bitmap. The three options are dis-
- persed-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 reso-
+ Sets the halftone screen type, which will be used when generat-
+ ing a monochrome (1-bit) bitmap. The three options are dis-
+ persed-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 reso-
lutions of 300 dpi and higher, and "dispersed" is used for reso-
lutions lower then 300 dpi.
screenSize integer
- Sets the size of the (square) halftone screen threshold matrix.
- By default, this is 4 for dispersed-dot dithering, 10 for clus-
- tered-dot dithering, and 100 for stochastic clustered-dot
+ Sets the size of the (square) halftone screen threshold matrix.
+ By default, this is 4 for dispersed-dot dithering, 10 for clus-
+ tered-dot dithering, and 100 for stochastic clustered-dot
dithering.
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
+ 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 parameter. Gamma val-
- ues greater than 1 make the output brighter; gamma values less
+ ues 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
+ 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
+ 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.
minLineWidth float
- Set the minimum line width, in device pixels. This affects the
- rasterizer only, not the PostScript converter (except when it
- uses rasterization to handle transparency). The default value
+ Set the minimum line width, in device pixels. This affects the
+ rasterizer only, not the PostScript converter (except when it
+ uses rasterization to handle transparency). The default value
is 0 (no minimum).
- drawAnnotations yes | no
- If set to "no", annotations will not be drawn or printed. The
- default value is "yes".
+ enablePathSimplification yes | no
+ If set to "yes", simplify paths by removing points where it
+ won't make a significant difference to the shape. The default
+ value is "no".
overprintPreview yes | no
If set to "yes", generate overprint preview output, honoring the
OP/op/OPM settings in the PDF file. Ignored for non-CMYK out-
put. The default value is "no".
+VIEWER SETTINGS
+ These settings only apply to the Xpdf GUI PDF viewer.
+
+ initialZoom percentage | page | width
+ Sets the initial zoom factor. A number specifies a zoom per-
+ centage, 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.
+
+ defaultFitZoom percentage
+ If xpdf is started with fit-page or fit-width zoom and no window
+ geometry, it will calculate a desired window size based on the
+ PDF page size and this defaultFitZoom value. I.e., the window
+ size will be chosen such that exactly one page will fit in the
+ window at this zoom factor (which must be a percentage). The
+ default value is based on the screen resolution.
+
+ initialSidebarState yes | no
+ If set to "yes", xpdf opens with the sidebar (tabs, outline,
+ etc.) visible. If set to "no", xpdf opens with the sidebar
+ collapsed. The default is "no".
+
+ paperColor color
+ Set the "paper color", i.e., the background of the page display.
+ The color can be #RRGGBB (hexadecimal) or a named color. This
+ option will not work well with PDF files that do things like
+ filling in white behind the text.
+
+ matteColor color
+ Set the matte color, i.e., the color used for background outside
+ the actual page area. The color can be #RRGGBB (hexadecimal) or
+ a named color.
+
+ fullScreenMatteColor color
+ Set the matte color for full-screen mode. The color can be
+ #RRGGBB (hexadecimal) or a named color.
+
+ popupMenuCmd title command ...
+ Add a command to the popup menu. Title is the text to be dis-
+ played in the menu. Command is an Xpdf command (see the COM-
+ MANDS section of the xpdf(1) man page for details). Multiple
+ commands are separated by whitespace.
+
+ maxTileWidth pixels
+ Set the maximum width of tiles to be used by xpdf when rasteriz-
+ ing pages. This defaults to 1500.
+
+ maxTileHeight pixels
+ Set the maximum height of tiles to be used by xpdf when raster-
+ izing pages. This defaults to 1500.
+
+ tileCacheSize tiles
+ Set the maximum number of tiles to be cached by xpdf when ras-
+ terizing pages. This defaults to 10.
+
+ workerThreads numThreads
+ Set the number of worker threads to be used by xpdf when raster-
+ izing pages. This defaults to 1.
+
launchCommand command
- Sets the command executed when you click on a "launch"-type
- link. The intent is for the command to be a program/script
- which determines the file type and runs the appropriate viewer.
- The command line will consist of the file to be launched, fol-
- lowed by any parameters specified with the link. Do not use
- "%s" in "command". By default, this is unset, and Xpdf will
+ Sets the command executed when you click on a "launch"-type
+ link. The intent is for the command to be a program/script
+ which determines the file type and runs the appropriate viewer.
+ The command line will consist of the file to be launched, fol-
+ lowed by any parameters specified with the link. Do not use
+ "%s" in "command". By default, this is unset, and Xpdf will
simply try to execute the file (after prompting the user).
- urlCommand command
- Sets the command executed when you click on a URL link. The
- string "%s" will be replaced with the URL. (See the example
- below.) This has no default value.
-
movieCommand command
- Sets the command executed when you click on a movie annotation.
+ 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. (For
- CID fonts, setting mapNumericCharNames to "no" is unnecessary.)
- 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".
-
- mapExtTrueTypeFontsViaUnicode yes | no
- When rasterizing text using an external TrueType font, there are
- two options for handling character codes. If mapExtTrueType-
- FontsViaUnicode is set to "yes", Xpdf will use the font encod-
- ing/ToUnicode info to map character codes to Unicode, and then
- use the font's Unicode cmap to map Unicode to GIDs. If mapExt-
- TrueTypeFontsViaUnicode is set to "no", Xpdf will assume the
- character codes are GIDs (i.e., use an identity mapping). This
- defaults to "yes".
-
- enableXFA yes | no
- If set to "yes", an XFA form (if present) will be rendered in
- place of an AcroForm. If "no", an XFA form will never be ren-
- dered. This defaults to "yes".
-
bind modifiers-key context command ...
Add a key or mouse button binding. Modifiers can be zero or
more of:
@@ -499,6 +544,7 @@ MISCELLANEOUS SETTINGS
return
enter
backspace
+ esc
insert
delete
home
@@ -509,6 +555,7 @@ MISCELLANEOUS SETTINGS
f1 .. f35 (function keys)
mousePress1 .. mousePress7 (mouse buttons)
mouseRelease1 .. mouseRelease7 (mouse buttons)
+ mouseClick1 .. mouseClick7 (mouse buttons)
Context is either "any" or a comma-separated combination of:
@@ -548,6 +595,20 @@ MISCELLANEOUS SETTINGS
"any" context, and you want to create new key bindings for mul-
tiple contexts).
+MISCELLANEOUS SETTINGS
+ drawAnnotations yes | no
+ If set to "no", annotations will not be drawn or printed. The
+ default value is "yes".
+
+ drawFormFields yes | no
+ If set to "no", form fields will not be drawn or printed. The
+ default value is "yes".
+
+ enableXFA yes | no
+ If set to "yes", an XFA form (if present) will be rendered in
+ place of an AcroForm. If "no", an XFA form will never be ren-
+ dered. This defaults to "yes".
+
printCommands yes | no
If set to "yes", drawing commands are printed as they're exe-
cuted (useful for debugging). This defaults to "no".
@@ -620,14 +681,14 @@ FILES
read in place of the system-wide file.
AUTHOR
- The Xpdf software and documentation are copyright 1996-2014 Glyph &
+ The Xpdf software and documentation are copyright 1996-2017 Glyph &
Cog, LLC.
SEE ALSO
xpdf(1), pdftops(1), pdftotext(1), pdftohtml(1), pdfinfo(1), pdf-
fonts(1), pdfdetach(1), pdftoppm(1), pdftopng(1), pdfimages(1)
- http://www.foolabs.com/xpdf/
+ http://www.xpdfreader.com/
- 28 May 2014 xpdfrc(5)
+ 10 Aug 2017 xpdfrc(5)