source: main/trunk/greenstone2/bin/linux/xpdf-tools/doc/pdffonts.1@ 32205

Last change on this file since 32205 was 32205, checked in by ak19, 6 years ago

First set of commits to do with implementing the new 'paged_html' output option of PDFPlugin that uses using xpdftools' new pdftohtml. So far tested only on Linux (64 bit), but things work there so I'm optimistically committing the changes since they work. 2. Committing the pre-built Linux binaries of XPDFtools for both 32 and 64 bit built by the XPDF group. 2. To use the correct bitness variant of xpdftools, setup.bash now exports the BITNESS env var, consulted by gsConvert.pl. 3. All the perl code changes to do with using xpdf tools' pdftohtml to generate paged_html and feed it in the desired form into GS(3): gsConvert.pl, PDFPlugin.pm and its parent ConvertBinaryPFile.pm have been modified to make it all work. xpdftools' pdftohtml generates a folder containing an html file and a screenshot for each page in a PDF (as well as an index.html linking to each page's html). However, we want a single html file that contains each individual 'page' html's content in a div, and need to do some further HTML style, attribute and structure modifications to massage the xpdftool output to what we want for GS. In order to parse and manipulate the HTML 'DOM' to do this, we're using the Mojo::DOM package that Dr Bainbridge found and which he's compiled up. Mojo::DOM is therefore also committed in this revision. Some further changes and some display fixes are required, but need to check with the others about that.
File size: 3.4 KB
Line 
1.\" Copyright 1999-2017 Glyph & Cog, LLC
2.TH pdffonts 1 "10 Aug 2017"
3.SH NAME
4pdffonts \- Portable Document Format (PDF) font analyzer (version
54.00)
6.SH SYNOPSIS
7.B pdffonts
8[options]
9.RI [ PDF-file ]
10.SH DESCRIPTION
11.B Pdffonts
12lists the fonts used in a Portable Document Format (PDF) file along
13with various information for each font.
14.PP
15The following information is listed for each font:
16.TP
17.B name
18the font name, exactly as given in the PDF file (potentially including
19a subset prefix)
20.TP
21.B type
22the font type -- see below for details
23.TP
24.B emb
25"yes" if the font is embedded in the PDF file
26.TP
27.B sub
28"yes" if the font is a subset
29.TP
30.B uni
31"yes" if there is an explicit "ToUnicode" map in the PDF file (the
32absence of a ToUnicode map doesn't necessarily mean that the text
33can't be converted to Unicode)
34.TP
35.B prob
36"X" if this font is likely to be problematic when converting text to
37Unicode
38.TP
39.B object ID
40the font dictionary object ID (number and generation)
41.TP
42.B location
43the font location (see the
44.B \-loc
45and
46.B \-locPS
47options).
48.PP
49PDF files can contain the following types of fonts:
50.PP
51.RS
52Type 1
53.RE
54.RS
55Type 1C -- aka Compact Font Format (CFF)
56.RE
57.RS
58Type 1C (OT) -- OpenType with 8-bit CFF data
59.RE
60.RS
61Type 3
62.RE
63.RS
64TrueType
65.RE
66.RS
67TrueType (OT) -- OpenType with 8-bit TrueType data
68.RE
69.RS
70CID Type 0 -- 16-bit font with no specified type
71.RE
72.RS
73CID Type 0C -- 16-bit PostScript CFF font
74.RE
75.RS
76CID Type 0C (OT) -- OpenType with CID CFF data
77.RE
78.RS
79CID TrueType -- 16-bit TrueType font
80.RE
81.RS
82CID TrueType (OT) -- OpenType with CID TrueType data
83.RE
84.SH CONFIGURATION FILE
85Pdffonts reads a configuration file at startup. It first tries to
86find the user's private config file, ~/.xpdfrc. If that doesn't
87exist, it looks for a system-wide config file, typically
88/usr/local/etc/xpdfrc (but this location can be changed when pdffonts
89is built). See the
90.BR xpdfrc (5)
91man page for details.
92.SH OPTIONS
93Many of the following options can be set with configuration file
94commands. These are listed in square brackets with the description of
95the corresponding command line option.
96.TP
97.BI \-f " number"
98Specifies the first page to analyze.
99.TP
100.B \-loc
101Shows additional information on the location of the font that will be
102used when the PDF file is rasterized (with xpdf, pdftoppm, etc.).
103.TP
104.B \-locPS
105Shows additional information on the location of the font that will be
106used when the PDF file is converted to PostScript (with pdftops).
107.TP
108.BI \-l " number"
109Specifies the last page to analyze.
110.TP
111.BI \-opw " password"
112Specify the owner password for the PDF file. Providing this will
113bypass all security restrictions.
114.TP
115.BI \-upw " password"
116Specify the user password for the PDF file.
117.TP
118.BI \-cfg " config-file"
119Read
120.I config-file
121in place of ~/.xpdfrc or the system-wide config file.
122.TP
123.B \-v
124Print copyright and version information.
125.TP
126.B \-h
127Print usage information.
128.RB ( \-help
129and
130.B \-\-help
131are equivalent.)
132.SH EXIT CODES
133The Xpdf tools use the following exit codes:
134.TP
1350
136No error.
137.TP
1381
139Error opening a PDF file.
140.TP
1412
142Error opening an output file.
143.TP
1443
145Error related to PDF permissions.
146.TP
14799
148Other error.
149.SH AUTHOR
150The pdffonts software and documentation are copyright 1996-2017 Glyph
151& Cog, LLC.
152.SH "SEE ALSO"
153.BR xpdf (1),
154.BR pdftops (1),
155.BR pdftotext (1),
156.BR pdftohtml (1),
157.BR pdfinfo (1),
158.BR pdfdetach (1),
159.BR pdftoppm (1),
160.BR pdftopng (1),
161.BR pdfimages (1),
162.BR xpdfrc (5)
163.br
164.B http://www.xpdfreader.com/
Note: See TracBrowser for help on using the repository browser.