mirror of
https://invent.kde.org/graphics/okular
synced 2024-09-12 20:51:17 +00:00
3abd57ea99
- Remove not used files of xpdf (images, etc) that we don't need to distribute Please test if your kpdf behaves equally that older versions (it should only have somewhat better support to PDF 1.5) svn path=/trunk/kdegraphics/kpdf/; revision=339928
377 lines
13 KiB
Plaintext
377 lines
13 KiB
Plaintext
Xpdf
|
||
====
|
||
|
||
version 3.00
|
||
2004-jan-22
|
||
|
||
The Xpdf software and documentation are
|
||
copyright 1996-2004 Glyph & Cog, LLC.
|
||
|
||
Email: derekn@foolabs.com
|
||
WWW: http://www.foolabs.com/xpdf/
|
||
|
||
The PDF data structures, operators, and specification are
|
||
copyright 1985-2003 Adobe Systems Inc.
|
||
|
||
|
||
What is Xpdf?
|
||
-------------
|
||
|
||
Xpdf is an open source viewer for Portable Document Format (PDF)
|
||
files. (These are also sometimes also called 'Acrobat' files, from
|
||
the name of Adobe's PDF software.) The Xpdf project also includes a
|
||
PDF text extractor, PDF-to-PostScript converter, and various other
|
||
utilities.
|
||
|
||
Xpdf runs under the X Window System on UNIX, VMS, and OS/2. The non-X
|
||
components (pdftops, pdftotext, etc.) also run on Win32 systems and
|
||
should run on pretty much any system with a decent C++ compiler.
|
||
|
||
Xpdf is designed to be small and efficient. It can use Type 1 or
|
||
TrueType fonts.
|
||
|
||
|
||
Distribution
|
||
------------
|
||
|
||
Xpdf is licensed under the GNU General Public License (GPL), version
|
||
2. In my opinion, the GPL is a convoluted, confusing, ambiguous mess.
|
||
But it's also pervasive, and I'm sick of arguing. And even if it is
|
||
confusing, the basic idea is good.
|
||
|
||
In order to cut down on the confusion a little bit, here are some
|
||
informal clarifications:
|
||
|
||
- I don't mind if you redistribute Xpdf in source and/or binary form,
|
||
as long as you include all of the documentation: README, man pages
|
||
(or help files), and COPYING. (Note that the README file contains a
|
||
pointer to a web page with the source code.)
|
||
|
||
- Selling a CD-ROM that contains Xpdf is fine with me, as long as it
|
||
includes the documentation. I wouldn't mind receiving a sample
|
||
copy, but it's not necessary.
|
||
|
||
- If you make useful changes to Xpdf, please make the source code
|
||
available -- post it on a web site, email it to me, whatever.
|
||
|
||
If you're interested in commercial licensing, please see the Glyph &
|
||
Cog web site:
|
||
|
||
http://www.glyphandcog.com/
|
||
|
||
|
||
Compatibility
|
||
-------------
|
||
|
||
Xpdf is developed and tested on a Linux 2.4 x86 system.
|
||
|
||
In addition, it has been compiled by others on Solaris, AIX, HP-UX,
|
||
Digital Unix, Irix, and numerous other Unix implementations, as well
|
||
as VMS and OS/2. It should work on pretty much any system which runs
|
||
X11 and has Unix-like libraries. You'll need ANSI C++ and C compilers
|
||
to compile it.
|
||
|
||
The non-X components of Xpdf (pdftops, pdftotext, pdfinfo, pdffonts,
|
||
pdftoppm, and pdfimages) can also be compiled on Win32 systems. See
|
||
the Xpdf web page for details.
|
||
|
||
If you compile Xpdf for a system not listed on the web page, please
|
||
let me know. If you're willing to make your binary available by ftp
|
||
or on the web, I'll be happy to add a link from the Xpdf web page. I
|
||
have decided not to host any binaries I didn't compile myself (for
|
||
disk space and support reasons).
|
||
|
||
If you can't get Xpdf to compile on your system, send me email and
|
||
I'll try to help.
|
||
|
||
Xpdf has been ported to the Acorn, Amiga, BeOS, and EPOC. See the
|
||
Xpdf web page for links.
|
||
|
||
|
||
Getting Xpdf
|
||
------------
|
||
|
||
The latest version is available from:
|
||
|
||
http://www.foolabs.com/xpdf/
|
||
|
||
or:
|
||
|
||
ftp://ftp.foolabs.com/pub/xpdf/
|
||
|
||
Source code and several precompiled executables are available.
|
||
|
||
Announcements of new versions are posted to several newsgroups
|
||
(comp.text.pdf, comp.os.linux.announce, and others) and emailed to a
|
||
list of people. If you'd like to receive email notification of new
|
||
versions, just let me know.
|
||
|
||
|
||
Running Xpdf
|
||
------------
|
||
|
||
To run xpdf, simply type:
|
||
|
||
xpdf file.pdf
|
||
|
||
To generate a PostScript file, hit the "print" button in xpdf, or run
|
||
pdftops:
|
||
|
||
pdftops file.pdf
|
||
|
||
To generate a plain text file, run pdftotext:
|
||
|
||
pdftotext file.pdf
|
||
|
||
There are four additional utilities (which are fully described in
|
||
their man pages):
|
||
|
||
pdfinfo -- dumps a PDF file's Info dictionary (plus some other
|
||
useful information)
|
||
pdffonts -- lists the fonts used in a PDF file along with various
|
||
information for each font
|
||
pdftoppm -- converts a PDF file to a series of PPM/PGM/PBM-format
|
||
bitmaps
|
||
pdfimages -- extracts the images from a PDF file
|
||
|
||
Command line options and many other details are described in the man
|
||
pages (xpdf.1, etc.) and the VMS help files (xpdf.hlp, etc.).
|
||
|
||
|
||
Upgrading from Xpdf 2.xx
|
||
------------------------
|
||
|
||
WARNING: Xpdf 3.00 switched to a new PDF rasterizer, which no longer
|
||
uses X fonts. You'll need a set of Base-14 fonts -- the URW fonts
|
||
distributed with ghostscript can be used for this. Xpdf will search
|
||
for the URW fonts, but if you have them installed in a non-standard
|
||
directory, you'll need to set up an xpdfrc config file to point to
|
||
them. For full details, please see the xpdfrc(5) man page.
|
||
|
||
|
||
Compiling Xpdf
|
||
--------------
|
||
|
||
See the separate file, INSTALL.
|
||
|
||
|
||
Bugs
|
||
----
|
||
|
||
If you find a bug in Xpdf, i.e., if it prints an error message,
|
||
crashes, or incorrectly displays a document, and you don't see that
|
||
bug listed here, please send me email, with a pointer (URL, ftp site,
|
||
etc.) to the PDF file.
|
||
|
||
|
||
Acknowledgments
|
||
---------------
|
||
|
||
Thanks to:
|
||
|
||
* Patrick Voigt for help with the remote server code.
|
||
* Patrick Moreau, Martin P.J. Zinser, and David Mathog for the VMS
|
||
port.
|
||
* David Boldt and Rick Rodgers for sample man pages.
|
||
* Brendan Miller for the icon idea.
|
||
* Olly Betts for help testing pdftotext.
|
||
* Peter Ganten for the OS/2 port.
|
||
* Michael Richmond for the Win32 port of pdftops and pdftotext and the
|
||
xpdf/cygwin/XFree86 build instructions.
|
||
* Frank M. Siegert for improvements in the PostScript code.
|
||
* Leo Smiers for the decryption patches.
|
||
* Rainer Menzner for creating t1lib, and for helping me adapt it to
|
||
xpdf.
|
||
* Pine Tree Systems A/S for funding the OPI and EPS support in
|
||
pdftops.
|
||
* Easy Software Products for funding the "sh" operator support.
|
||
* Tom Kacvinsky for help with FreeType and for being my interface to
|
||
the FreeType team.
|
||
* Theppitak Karoonboonyanan for help with Thai support.
|
||
* Leonard Rosenthol for help and contributions on a bunch of things.
|
||
* Alexandros Diamantidis and Maria Adaloglou for help with Greek
|
||
support.
|
||
* Lawrence Lai for help with the CJK Unicode maps.
|
||
|
||
Various people have contributed modifications made for use by the
|
||
pdftex project:
|
||
|
||
* Han The Thanh
|
||
* Martin Schr<68>der of ArtCom GmbH
|
||
|
||
|
||
References
|
||
----------
|
||
|
||
Adobe Systems Inc., _PDF Reference: Adobe Portable Document Format
|
||
Version 1.5_.
|
||
http://partners.adobe.com/asn/tech/pdf/specifications.jsp
|
||
[The manual for PDF version 1.5.]
|
||
|
||
Adobe Systems Inc., _PostScript Language Reference_, 3rd ed.
|
||
Addison-Wesley, 1999, ISBN 0-201-37922-8.
|
||
[The official PostScript manual.]
|
||
|
||
Adobe Systems, Inc., _The Type 42 Font Format Specification_,
|
||
Adobe Developer Support Technical Specification #5012. 1998.
|
||
http://partners.adobe.com/asn/developer/pdfs/tn/5012.Type42_Spec.pdf
|
||
[Type 42 is the format used to embed TrueType fonts in PostScript
|
||
files.]
|
||
|
||
Adobe Systems, Inc., _Adobe CMap and CIDFont Files Specification_,
|
||
Adobe Developer Support Technical Specification #5014. 1995.
|
||
http://www.adobe.com/supportservice/devrelations/PDFS/TN/5014.CIDFont_Spec.pdf
|
||
[CMap file format needed for Japanese and Chinese font support.]
|
||
|
||
Adobe Systems, Inc., _Adobe-Japan1-4 Character Collection for
|
||
CID-Keyed Fonts_, Adobe Developer Support Technical Note #5078.
|
||
2000.
|
||
http://partners.adobe.com/asn/developer/PDFS/TN/5078.CID_Glyph.pdf
|
||
[The Adobe Japanese character set.]
|
||
|
||
Adobe Systems, Inc., _Adobe-GB1-4 Character Collection for
|
||
CID-Keyed Fonts_, Adobe Developer Support Technical Note #5079.
|
||
2000.
|
||
http://partners.adobe.com/asn/developer/pdfs/tn/5079.Adobe-GB1-4.pdf
|
||
[The Adobe Chinese GB (simplified) character set.]
|
||
|
||
Adobe Systems, Inc., _Adobe-CNS1-3 Character Collection for
|
||
CID-Keyed Fonts_, Adobe Developer Support Technical Note #5080.
|
||
2000.
|
||
http://partners.adobe.com/asn/developer/PDFS/TN/5080.CNS_CharColl.pdf
|
||
[The Adobe Chinese CNS (traditional) character set.]
|
||
|
||
Adobe Systems Inc., _Supporting the DCT Filters in PostScript Level
|
||
2_, Adobe Developer Support Technical Note #5116. 1992.
|
||
http://www.adobe.com/supportservice/devrelations/PDFS/TN/5116.PS2_DCT.PDF
|
||
[Description of the DCTDecode filter parameters.]
|
||
|
||
Adobe Systems Inc., _Open Prepress Interface (OPI) Specification -
|
||
Version 2.0_, Adobe Developer Support Technical Note #5660. 2000.
|
||
http://partners.adobe.com/asn/developer/PDFS/TN/5660.OPI_2.0.pdf
|
||
|
||
Adobe Systems Inc., CMap files.
|
||
ftp://ftp.oreilly.com/pub/examples/nutshell/cjkv/adobe/
|
||
[The actual CMap files for the 16-bit CJK encodings.]
|
||
|
||
Adobe Systems Inc., Unicode glyph lists.
|
||
http://partners.adobe.com/asn/developer/type/unicodegn.html
|
||
http://partners.adobe.com/asn/developer/type/glyphlist.txt
|
||
http://partners.adobe.com/asn/developer/type/corporateuse.txt
|
||
http://partners.adobe.com/asn/developer/type/zapfdingbats.txt
|
||
[Mappings between character names to Unicode.]
|
||
|
||
Aldus Corp., _OPI: Open Prepress Interface Specification 1.3_. 1993.
|
||
http://partners.adobe.com/asn/developer/PDFS/TN/OPI_13.pdf
|
||
|
||
Anonymous, RC4 source code.
|
||
ftp://ftp.ox.ac.uk/pub/crypto/misc/rc4.tar.gz
|
||
ftp://idea.sec.dsi.unimi.it/pub/crypt/code/rc4.tar.gz
|
||
[This is the algorithm used to encrypt PDF files.]
|
||
|
||
T. Boutell, et al., "PNG (Portable Network Graphics) Specification,
|
||
Version 1.0. RFC 2083.
|
||
[PDF uses the PNG filter algorithms.]
|
||
|
||
CCITT, "Information Technology - Digital Compression and Coding of
|
||
Continuous-tone Still Images - Requirements and Guidelines", CCITT
|
||
Recommendation T.81.
|
||
http://www.w3.org/Graphics/JPEG/
|
||
[The official JPEG spec.]
|
||
|
||
A. Chernov, "Registration of a Cyrillic Character Set". RFC 1489.
|
||
[Documentation for the KOI8-R Cyrillic encoding.]
|
||
|
||
Roman Czyborra, "The ISO 8859 Alphabet Soup".
|
||
http://czyborra.com/charsets/iso8859.html
|
||
[Documentation on the various ISO 859 encodings.]
|
||
|
||
L. Peter Deutsch, "ZLIB Compressed Data Format Specification version
|
||
3.3". RFC 1950.
|
||
[Information on the general format used in FlateDecode streams.]
|
||
|
||
L. Peter Deutsch, "DEFLATE Compressed Data Format Specification
|
||
version 1.3". RFC 1951.
|
||
[The definition of the compression algorithm used in FlateDecode
|
||
streams.]
|
||
|
||
Jim Flowers, "X Logical Font Description Conventions", Version 1.5, X
|
||
Consortium Standard, X Version 11, Release 6.1.
|
||
ftp://ftp.x.org/pub/R6.1/xc/doc/hardcopy/XLFD/xlfd.PS.Z
|
||
[The official specification of X font descriptors, including font
|
||
transformation matrices.]
|
||
|
||
Foley, van Dam, Feiner, and Hughes, _Computer Graphics: Principles and
|
||
Practice_, 2nd ed. Addison-Wesley, 1990, ISBN 0-201-12110-7.
|
||
[Colorspace conversion functions, Bezier spline math.]
|
||
|
||
Robert L. Hummel, _Programmer's Technical Reference: Data and Fax
|
||
Communications_. Ziff-Davis Press, 1993, ISBN 1-56276-077-7.
|
||
[CCITT Group 3 and 4 fax decoding.]
|
||
|
||
ISO/IEC, _Information technology -- Lossy/lossless coding of bi-level
|
||
images_. ISO/IEC 14492, First edition (2001-12-15).
|
||
http://webstore.ansi.org/
|
||
[The official JBIG2 standard. The final draft of this spec is
|
||
available from http://www.jpeg.org/jbighomepage.html.]
|
||
|
||
ISO/IEC, _Information technology -- JPEG 2000 image coding system --
|
||
Part 1: Core coding system_. ISO/IEC 15444-1, First edition
|
||
(2000-12-15).
|
||
http://webstore.ansi.org/
|
||
[The official JPEG 2000 standard. The final committee draft of this
|
||
spec is available from http://www.jpeg.org/JPEG2000.html, but there
|
||
were changes made to the bitstream format between that draft and the
|
||
published spec.]
|
||
|
||
ITU, "Standardization of Group 3 facsimile terminals for document
|
||
transmission", ITU-T Recommendation T.4, 1999.
|
||
ITU, "Facsimile coding schemes and coding control functions for Group 4
|
||
facsimile apparatus", ITU-T Recommendation T.6, 1993.
|
||
http://www.itu.int/
|
||
[The official Group 3 and 4 fax standards - used by the CCITTFaxDecode
|
||
stream, as well as the JBIG2Decode stream.]
|
||
|
||
Christoph Loeffler, Adriaan Ligtenberg, George S. Moschytz, "Practical
|
||
Fast 1-D DCT Algorithms with 11 Multiplications". IEEE Intl. Conf. on
|
||
Acoustics, Speech & Signal Processing, 1989, 988-991.
|
||
[The fast IDCT algorithm used in the DCTDecode filter.]
|
||
|
||
Microsoft, _TrueType 1.0 Font Files_, rev. 1.66. 1995.
|
||
http://www.microsoft.com/typography/tt/tt.htm
|
||
[The TrueType font spec (in MS Word format, naturally).]
|
||
|
||
Thai Industrial Standard, "Standard for Thai Character Codes for
|
||
Computers", TIS-620-2533 (1990).
|
||
http://www.nectec.or.th/it-standards/std620/std620.htm
|
||
[The TIS-620 Thai encoding.]
|
||
|
||
P. Peterlin, "ISO 8859-2 (Latin 2) Resources".
|
||
http://sizif.mf.uni-lj.si/linux/cee/iso8859-2.html
|
||
[This is a web page with all sorts of useful Latin-2 character set and
|
||
font information.]
|
||
|
||
Charles Poynton, "Color FAQ".
|
||
http://www.inforamp.net/~poynton/ColorFAQ.html
|
||
[The mapping from the CIE 1931 (XYZ) color space to RGB.]
|
||
|
||
R. Rivest, "The MD5 Message-Digest Algorithm". RFC 1321.
|
||
[MD5 is used in PDF document encryption.]
|
||
|
||
Unicode Consortium, "Unicode Home Page".
|
||
http://www.unicode.org/
|
||
[Online copy of the Unicode spec.]
|
||
|
||
W3C Recommendation, "PNG (Portable Network Graphics) Specification
|
||
Version 1.0".
|
||
http://www.w3.org/Graphics/PNG/
|
||
[Defines the PNG image predictor.]
|
||
|
||
Gregory K. Wallace, "The JPEG Still Picture Compression Standard".
|
||
ftp://ftp.uu.net/graphics/jpeg/wallace.ps.gz
|
||
[Good description of the JPEG standard. Also published in CACM, April
|
||
1991, and submitted to IEEE Transactions on Consumer Electronics.]
|
||
|
||
F. Yergeau, "UTF-8, a transformation format of ISO 10646". RFC 2279.
|
||
[A commonly used Unicode encoding.]
|