source: main/trunk/greenstone2/bin/linux/xpdf-tools/README@ 32261

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

Committing the static linux binaries of xpdf-tools that we compiled up ourselves. Ours don't have bin32 vs bin64 subfolders, but are just 32 bit binaries (compiled on the 32 bit linux LSB) in a bin subfolder.

File size: 13.8 KB
Line 
1
2Xpdf
3====
4
5version 4.00
62017-aug-10
7
8The Xpdf software and documentation are
9copyright 1996-2017 Glyph & Cog, LLC.
10
11Email: [email protected]
12WWW: http://www.xpdfreader.com/
13
14The PDF data structures, operators, and specification are
15documented in ISO 32000-1:2008.
16
17
18What is Xpdf?
19-------------
20
21Xpdf is an open source viewer for Portable Document Format (PDF)
22files. (These are also sometimes also called 'Acrobat' files, from
23the name of Adobe's PDF software.) The Xpdf project also includes a
24PDF text extractor, PDF-to-PostScript converter, and various other
25utilities.
26
27The Xpdf viewer uses the Qt cross-platform GUI toolkit. The other
28command line utilties do not require Qt.
29
30
31License & Distribution
32----------------------
33
34Xpdf is licensed under the GNU General Public License (GPL), version 2
35or 3. This means that you can distribute derivatives of Xpdf under
36any of the following:
37 - GPL v2 only
38 - GPL v3 only
39 - GPL v2 or v3
40
41The Xpdf source package includes the text of both GPL versions:
42COPYING for GPL v2, COPYING3 for GPL v3.
43
44Please note that Xpdf is NOT licensed under "any later version" of the
45GPL, as I have no idea what those versions will look like.
46
47If you are redistributing unmodified copies of Xpdf (or any of the
48Xpdf tools) in binary form, you need to include all of the
49documentation: README, man pages (or help files), COPYING, and
50COPYING3.
51
52If you want to incorporate the Xpdf source code into another program
53(or create a modified version of Xpdf), and you are distributing that
54program, you have two options: release your program under the GPL (v2
55and/or v3), or purchase a commercial Xpdf source license.
56
57If you're interested in commercial licensing, please see the Glyph &
58Cog web site:
59
60 http://www.glyphandcog.com/
61
62
63Compatibility
64-------------
65
66Xpdf uses the Qt toolkit and runs on Linux, Windows, and OS X -- and
67probably other systems that have a Qt port.
68
69The non-GUI command line utilities (pdftops, pdftotext, pdftohtml,
70pdfinfo, pdffonts, pdfdetach, pdftoppm, pdftopng, and pdfimages) run
71on Linux, Windows, and OS X -- and should run on pretty much any
72system with a decent C++ compiler.
73
74If you compile Xpdf for a system not listed on the web page, please
75let me know. If you're willing to make your binary available by ftp
76or on the web, I'll be happy to add a link from the Xpdf web page. I
77have decided not to host any binaries I didn't compile myself (for
78disk space and support reasons).
79
80If you can't get Xpdf to compile on your system, send me email and
81I'll try to help.
82
83
84Getting Xpdf
85------------
86
87The latest version is available from:
88
89 http://www.xpdfreader.com/
90
91Source code and several precompiled executables are available.
92
93Announcements of new versions are posted to comp.text.pdf and emailed
94to a list of people. If you'd like to receive email notification of
95new versions, just let me know.
96
97
98Running Xpdf
99------------
100
101To run xpdf, simply type:
102
103 xpdf file.pdf
104
105To generate a PostScript file, run pdftops:
106
107 pdftops file.pdf
108
109To generate a plain text file, run pdftotext:
110
111 pdftotext file.pdf
112
113There are several additional utilities (which are fully described in
114their man pages):
115
116 pdftohtml -- converts a PDF file to HTML
117 pdfinfo -- dumps a PDF file's Info dictionary (plus some other
118 useful information)
119 pdffonts -- lists the fonts used in a PDF file along with various
120 information for each font
121 pdfdetach -- lists or extracts embedded files (attachments) from a
122 PDF file
123 pdftoppm -- converts a PDF file to a series of PPM/PGM/PBM-format
124 bitmaps
125 pdftopng -- converts a PDF file to a series of PNG image files
126 pdfimages -- extracts the images from a PDF file
127
128Command line options and many other details are described in the man
129pages: xpdf(1), etc.
130
131All of these utilities read an optional configuration file: see the
132xpdfrc(5) man page.
133
134
135Compiling Xpdf
136--------------
137
138See the separate file, INSTALL.
139
140
141Bugs
142----
143
144If you find a bug in Xpdf, i.e., if it prints an error message,
145crashes, or incorrectly displays a document, and you don't see that
146bug listed here, please send me email, with a pointer (URL, ftp site,
147etc.) to the PDF file.
148
149
150Third-Party Libraries
151---------------------
152
153Xpdf uses the following libraries:
154* FreeType [http://www.freetype.org/]
155* libpng [http://www.libpng.com/pub/png/libpng.html] (used by pdftohtml
156 and pdftopng)
157* zlib [http://zlib.net/] (used by pdftohtml)
158
159
160Acknowledgments
161---------------
162
163Thanks to:
164
165* Patrick Voigt for help with the remote server code.
166* Patrick Moreau, Martin P.J. Zinser, and David Mathog for the VMS
167 port.
168* David Boldt and Rick Rodgers for sample man pages.
169* Brendan Miller for the icon idea.
170* Olly Betts for help testing pdftotext.
171* Peter Ganten for the OS/2 port.
172* Michael Richmond for the Win32 port of pdftops and pdftotext and the
173 xpdf/cygwin/XFree86 build instructions.
174* Frank M. Siegert for improvements in the PostScript code.
175* Leo Smiers for the decryption patches.
176* Rainer Menzner for creating t1lib, and for helping me adapt it to
177 xpdf.
178* Pine Tree Systems A/S for funding the OPI and EPS support in
179 pdftops.
180* Easy Software Products for funding several improvements to the
181 PostScript output code.
182* Tom Kacvinsky for help with FreeType and for being my interface to
183 the FreeType team.
184* Theppitak Karoonboonyanan for help with Thai support.
185* Leonard Rosenthol for help and contributions on a bunch of things.
186* Alexandros Diamantidis and Maria Adaloglou for help with Greek
187 support.
188* Lawrence Lai for help with the CJK Unicode maps.
189
190Various people have contributed modifications made for use by the
191pdftex project:
192
193* Han The Thanh
194* Martin Schröder of ArtCom GmbH
195
196
197References
198----------
199
200Adobe Systems Inc., ISO 32000-1:2008, Document Management - Portable
201document format - Part 1: PDF 1.7.
202http://www.adobe.com/devnet/pdf/pdf_reference.html
203[The manual for PDF version 1.7.]
204
205Adobe Systems Inc., Adobe Supplement to the ISO 32000, BaseVersion
2061.7, ExtensionLevel 3, June 2008.
207http://www.adobe.com/devnet/pdf/pdf_reference.html
208[Additions to the PDF 1.7 spec.]
209
210Adobe Systems Inc., Adobe Supplement to ISO 32000-1, BaseVersion 1.7,
211ExtensionLevel 5, June 2009.
212http://www.adobe.com/devnet/pdf/pdf_reference.html
213[Additions to the PDF 1.7 spec.]
214
215Adobe Systems Inc., _PostScript Language Reference_, 3rd ed.
216Addison-Wesley, 1999, ISBN 0-201-37922-8.
217[The official PostScript manual.]
218
219Adobe Systems, Inc., _The Type 42 Font Format Specification_,
220Adobe Developer Support Technical Specification #5012. 1998.
221http://partners.adobe.com/asn/developer/pdfs/tn/5012.Type42_Spec.pdf
222[Type 42 is the format used to embed TrueType fonts in PostScript
223files.]
224
225Adobe Systems, Inc., _Adobe CMap and CIDFont Files Specification_,
226Adobe Developer Support Technical Specification #5014. 1995.
227http://www.adobe.com/supportservice/devrelations/PDFS/TN/5014.CIDFont_Spec.pdf
228[CMap file format needed for Japanese and Chinese font support.]
229
230Adobe Systems, Inc., _Adobe-Japan1-4 Character Collection for
231CID-Keyed Fonts_, Adobe Developer Support Technical Note #5078.
2322000.
233http://partners.adobe.com/asn/developer/PDFS/TN/5078.CID_Glyph.pdf
234[The Adobe Japanese character set.]
235
236Adobe Systems, Inc., _Adobe-GB1-4 Character Collection for
237CID-Keyed Fonts_, Adobe Developer Support Technical Note #5079.
2382000.
239http://partners.adobe.com/asn/developer/pdfs/tn/5079.Adobe-GB1-4.pdf
240[The Adobe Chinese GB (simplified) character set.]
241
242Adobe Systems, Inc., _Adobe-CNS1-3 Character Collection for
243CID-Keyed Fonts_, Adobe Developer Support Technical Note #5080.
2442000.
245http://partners.adobe.com/asn/developer/PDFS/TN/5080.CNS_CharColl.pdf
246[The Adobe Chinese CNS (traditional) character set.]
247
248Adobe Systems Inc., _Supporting the DCT Filters in PostScript Level
2492_, Adobe Developer Support Technical Note #5116. 1992.
250http://www.adobe.com/supportservice/devrelations/PDFS/TN/5116.PS2_DCT.PDF
251[Description of the DCTDecode filter parameters.]
252
253Adobe Systems Inc., _Open Prepress Interface (OPI) Specification -
254Version 2.0_, Adobe Developer Support Technical Note #5660. 2000.
255http://partners.adobe.com/asn/developer/PDFS/TN/5660.OPI_2.0.pdf
256
257Adobe Systems Inc., CMap files.
258ftp://ftp.oreilly.com/pub/examples/nutshell/cjkv/adobe/
259[The actual CMap files for the 16-bit CJK encodings.]
260
261Adobe Systems Inc., Unicode glyph lists.
262http://partners.adobe.com/asn/developer/type/unicodegn.html
263http://partners.adobe.com/asn/developer/type/glyphlist.txt
264http://partners.adobe.com/asn/developer/type/corporateuse.txt
265http://partners.adobe.com/asn/developer/type/zapfdingbats.txt
266[Mappings between character names to Unicode.]
267
268Adobe Systems Inc., OpenType Specification v. 1.4.
269http://partners.adobe.com/public/developer/opentype/index_spec.html
270[The OpenType font format spec.]
271
272Aldus Corp., _OPI: Open Prepress Interface Specification 1.3_. 1993.
273http://partners.adobe.com/asn/developer/PDFS/TN/OPI_13.pdf
274
275Anonymous, RC4 source code.
276ftp://ftp.ox.ac.uk/pub/crypto/misc/rc4.tar.gz
277ftp://idea.sec.dsi.unimi.it/pub/crypt/code/rc4.tar.gz
278[This is the algorithm used to encrypt PDF files.]
279
280T. Boutell, et al., "PNG (Portable Network Graphics) Specification,
281Version 1.0". RFC 2083.
282[PDF uses the PNG filter algorithms.]
283
284CCITT, "Information Technology - Digital Compression and Coding of
285Continuous-tone Still Images - Requirements and Guidelines", CCITT
286Recommendation T.81.
287http://www.w3.org/Graphics/JPEG/
288[The official JPEG spec.]
289
290A. Chernov, "Registration of a Cyrillic Character Set". RFC 1489.
291[Documentation for the KOI8-R Cyrillic encoding.]
292
293Roman Czyborra, "The ISO 8859 Alphabet Soup".
294http://czyborra.com/charsets/iso8859.html
295[Documentation on the various ISO 859 encodings.]
296
297L. Peter Deutsch, "ZLIB Compressed Data Format Specification version
2983.3". RFC 1950.
299[Information on the general format used in FlateDecode streams.]
300
301L. Peter Deutsch, "DEFLATE Compressed Data Format Specification
302version 1.3". RFC 1951.
303[The definition of the compression algorithm used in FlateDecode
304streams.]
305
306Morris Dworkin, "Recommendation for Block Cipher Modes of Operation",
307National Institute of Standards, NIST Special Publication 800-38A,
3082001.
309[The cipher block chaining (CBC) mode used with AES in PDF files.]
310
311Federal Information Processing Standards Publication 197 (FIPS PUBS
312197), "Advanced Encryption Standard (AES)", November 26, 2001.
313[AES encryption, used in PDF 1.6.]
314
315Jim Flowers, "X Logical Font Description Conventions", Version 1.5, X
316Consortium Standard, X Version 11, Release 6.1.
317ftp://ftp.x.org/pub/R6.1/xc/doc/hardcopy/XLFD/xlfd.PS.Z
318[The official specification of X font descriptors, including font
319transformation matrices.]
320
321Foley, van Dam, Feiner, and Hughes, _Computer Graphics: Principles and
322Practice_, 2nd ed. Addison-Wesley, 1990, ISBN 0-201-12110-7.
323[Colorspace conversion functions, Bezier spline math.]
324
325Robert L. Hummel, _Programmer's Technical Reference: Data and Fax
326Communications_. Ziff-Davis Press, 1993, ISBN 1-56276-077-7.
327[CCITT Group 3 and 4 fax decoding.]
328
329ISO/IEC, _Information technology -- Lossy/lossless coding of bi-level
330images_. ISO/IEC 14492, First edition (2001-12-15).
331http://webstore.ansi.org/
332[The official JBIG2 standard. The final draft of this spec is
333available from http://www.jpeg.org/jbighomepage.html.]
334
335ISO/IEC, _Information technology -- JPEG 2000 image coding system --
336Part 1: Core coding system_. ISO/IEC 15444-1, First edition
337(2000-12-15).
338http://webstore.ansi.org/
339[The official JPEG 2000 standard. The final committee draft of this
340spec is available from http://www.jpeg.org/JPEG2000.html, but there
341were changes made to the bitstream format between that draft and the
342published spec.]
343
344ITU, "Standardization of Group 3 facsimile terminals for document
345transmission", ITU-T Recommendation T.4, 1999.
346ITU, "Facsimile coding schemes and coding control functions for Group 4
347facsimile apparatus", ITU-T Recommendation T.6, 1993.
348http://www.itu.int/
349[The official Group 3 and 4 fax standards - used by the CCITTFaxDecode
350stream, as well as the JBIG2Decode stream.]
351
352B. Kaliski, "PKCS #5: Password-Based Cryptography Specification,
353Version 2.0". RFC 2898.
354[Defines the padding scheme used with AES encryption in PDF files.]
355
356Christoph Loeffler, Adriaan Ligtenberg, George S. Moschytz, "Practical
357Fast 1-D DCT Algorithms with 11 Multiplications". IEEE Intl. Conf. on
358Acoustics, Speech & Signal Processing, 1989, 988-991.
359[The fast IDCT algorithm used in the DCTDecode filter.]
360
361Microsoft, _TrueType 1.0 Font Files_, rev. 1.66. 1995.
362http://www.microsoft.com/typography/tt/tt.htm
363[The TrueType font spec (in MS Word format, naturally).]
364
365V. Ostromoukhov, R.D. Hersch, "Stochastic Clustered-Dot Dithering",
366Conf. Color Imaging: Device-Independent Color, Color Hardcopy, and
367Graphic Arts IV, 1999, SPIE Vol. 3648, 496-505.
368http://diwww.epfl.ch/w3lsp/publications/colour/scd.html
369[The stochastic dithering algorithm used in Xpdf.]
370
371P. Peterlin, "ISO 8859-2 (Latin 2) Resources".
372http://sizif.mf.uni-lj.si/linux/cee/iso8859-2.html
373[This is a web page with all sorts of useful Latin-2 character set and
374font information.]
375
376Charles Poynton, "Color FAQ".
377http://www.inforamp.net/~poynton/ColorFAQ.html
378[The mapping from the CIE 1931 (XYZ) color space to RGB.]
379
380R. Rivest, "The MD5 Message-Digest Algorithm". RFC 1321.
381[MD5 is used in PDF document encryption.]
382
383Thai Industrial Standard, "Standard for Thai Character Codes for
384Computers", TIS-620-2533 (1990).
385http://www.nectec.or.th/it-standards/std620/std620.htm
386[The TIS-620 Thai encoding.]
387
388Unicode Consortium, "Unicode Home Page".
389http://www.unicode.org/
390[Online copy of the Unicode spec.]
391
392W3C Recommendation, "PNG (Portable Network Graphics) Specification
393Version 1.0".
394http://www.w3.org/Graphics/PNG/
395[Defines the PNG image predictor.]
396
397Gregory K. Wallace, "The JPEG Still Picture Compression Standard".
398ftp://ftp.uu.net/graphics/jpeg/wallace.ps.gz
399[Good description of the JPEG standard. Also published in CACM, April
4001991, and submitted to IEEE Transactions on Consumer Electronics.]
401
402F. Yergeau, "UTF-8, a transformation format of ISO 10646". RFC 2279.
403[A commonly used Unicode encoding.]
Note: See TracBrowser for help on using the repository browser.