← Back to branch summary

~ubuntu-branches/ubuntu/vivid/emscripten/vivid

« back to all changes in this revision

Viewing changes to tests/poppler/README-XPDF

  • Committer: Package Import Robot
  • Author(s): Sylvestre Ledru
  • Date: 2013-05-02 13:11:51 UTC
  • Revision ID: package-import@ubuntu.com-20130502131151-q8dvteqr1ef2x7xz
Tags: upstream-1.4.1~20130504~adb56cb
Import upstream version 1.4.1~20130504~adb56cb

Show diffs side-by-side

added added

removed removed

Lines of Context:
tests/poppler/README-XPDF
 
1
Xpdf
 
2
====
 
3
 
 
4
version 3.00
 
5
2004-jan-22
 
6
 
 
7
The Xpdf software and documentation are
 
8
copyright 1996-2004 Glyph & Cog, LLC.
 
9
 
 
10
Email: derekn@foolabs.com
 
11
WWW: http://www.foolabs.com/xpdf/
 
12
 
 
13
The PDF data structures, operators, and specification are
 
14
copyright 1985-2003 Adobe Systems Inc.
 
15
 
 
16
 
 
17
What is Xpdf?
 
18
-------------
 
19
 
 
20
Xpdf is an open source viewer for Portable Document Format (PDF)
 
21
files.  (These are also sometimes also called 'Acrobat' files, from
 
22
the name of Adobe's PDF software.)  The Xpdf project also includes a
 
23
PDF text extractor, PDF-to-PostScript converter, and various other
 
24
utilities.
 
25
 
 
26
Xpdf runs under the X Window System on UNIX, VMS, and OS/2.  The non-X
 
27
components (pdftops, pdftotext, etc.) also run on Win32 systems and
 
28
should run on pretty much any system with a decent C++ compiler.
 
29
 
 
30
Xpdf is designed to be small and efficient.  It can use Type 1 or
 
31
TrueType fonts.
 
32
 
 
33
 
 
34
Distribution
 
35
------------
 
36
 
 
37
Xpdf is licensed under the GNU General Public License (GPL), version
 
38
2.  In my opinion, the GPL is a convoluted, confusing, ambiguous mess.
 
39
But it's also pervasive, and I'm sick of arguing.  And even if it is
 
40
confusing, the basic idea is good.
 
41
 
 
42
In order to cut down on the confusion a little bit, here are some
 
43
informal clarifications:
 
44
 
 
45
- I don't mind if you redistribute Xpdf in source and/or binary form,
 
46
  as long as you include all of the documentation: README, man pages
 
47
  (or help files), and COPYING.  (Note that the README file contains a
 
48
  pointer to a web page with the source code.)
 
49
 
 
50
- Selling a CD-ROM that contains Xpdf is fine with me, as long as it
 
51
  includes the documentation.  I wouldn't mind receiving a sample
 
52
  copy, but it's not necessary.
 
53
 
 
54
- If you make useful changes to Xpdf, please make the source code
 
55
  available -- post it on a web site, email it to me, whatever.
 
56
 
 
57
If you're interested in commercial licensing, please see the Glyph &
 
58
Cog web site:
 
59
 
 
60
    http://www.glyphandcog.com/
 
61
 
 
62
 
 
63
Compatibility
 
64
-------------
 
65
 
 
66
Xpdf is developed and tested on a Linux 2.4 x86 system.
 
67
 
 
68
In addition, it has been compiled by others on Solaris, AIX, HP-UX,
 
69
Digital Unix, Irix, and numerous other Unix implementations, as well
 
70
as VMS and OS/2.  It should work on pretty much any system which runs
 
71
X11 and has Unix-like libraries.  You'll need ANSI C++ and C compilers
 
72
to compile it.
 
73
 
 
74
The non-X components of Xpdf (pdftops, pdftotext, pdfinfo, pdffonts,
 
75
pdftoppm, and pdfimages) can also be compiled on Win32 systems.  See
 
76
the Xpdf web page for details.
 
77
 
 
78
If you compile Xpdf for a system not listed on the web page, please
 
79
let me know.  If you're willing to make your binary available by ftp
 
80
or on the web, I'll be happy to add a link from the Xpdf web page.  I
 
81
have decided not to host any binaries I didn't compile myself (for
 
82
disk space and support reasons).
 
83
 
 
84
If you can't get Xpdf to compile on your system, send me email and
 
85
I'll try to help.
 
86
 
 
87
Xpdf has been ported to the Acorn, Amiga, BeOS, and EPOC.  See the
 
88
Xpdf web page for links.
 
89
 
 
90
 
 
91
Getting Xpdf
 
92
------------
 
93
 
 
94
The latest version is available from:
 
95
 
 
96
  http://www.foolabs.com/xpdf/
 
97
 
 
98
or:
 
99
 
 
100
  ftp://ftp.foolabs.com/pub/xpdf/
 
101
 
 
102
Source code and several precompiled executables are available.
 
103
 
 
104
Announcements of new versions are posted to several newsgroups
 
105
(comp.text.pdf, comp.os.linux.announce, and others) and emailed to a
 
106
list of people.  If you'd like to receive email notification of new
 
107
versions, just let me know.
 
108
 
 
109
 
 
110
Running Xpdf
 
111
------------
 
112
 
 
113
To run xpdf, simply type:
 
114
 
 
115
  xpdf file.pdf
 
116
 
 
117
To generate a PostScript file, hit the "print" button in xpdf, or run
 
118
pdftops:
 
119
 
 
120
  pdftops file.pdf
 
121
 
 
122
To generate a plain text file, run pdftotext:
 
123
 
 
124
  pdftotext file.pdf
 
125
 
 
126
There are four additional utilities (which are fully described in
 
127
their man pages):
 
128
 
 
129
  pdfinfo -- dumps a PDF file's Info dictionary (plus some other
 
130
             useful information)
 
131
  pdffonts -- lists the fonts used in a PDF file along with various
 
132
              information for each font
 
133
  pdftoppm -- converts a PDF file to a series of PPM/PGM/PBM-format
 
134
              bitmaps
 
135
  pdfimages -- extracts the images from a PDF file
 
136
 
 
137
Command line options and many other details are described in the man
 
138
pages (xpdf.1, etc.) and the VMS help files (xpdf.hlp, etc.).
 
139
 
 
140
 
 
141
Upgrading from Xpdf 2.xx
 
142
------------------------
 
143
 
 
144
WARNING: Xpdf 3.00 switched to a new PDF rasterizer, which no longer
 
145
uses X fonts.  You'll need a set of Base-14 fonts -- the URW fonts
 
146
distributed with ghostscript can be used for this.  Xpdf will search
 
147
for the URW fonts, but if you have them installed in a non-standard
 
148
directory, you'll need to set up an xpdfrc config file to point to
 
149
them.  For full details, please see the xpdfrc(5) man page.
 
150
 
 
151
 
 
152
Compiling Xpdf
 
153
--------------
 
154
 
 
155
See the separate file, INSTALL.
 
156
 
 
157
 
 
158
Bugs
 
159
----
 
160
 
 
161
If you find a bug in Xpdf, i.e., if it prints an error message,
 
162
crashes, or incorrectly displays a document, and you don't see that
 
163
bug listed here, please send me email, with a pointer (URL, ftp site,
 
164
etc.) to the PDF file.
 
165
 
 
166
 
 
167
Acknowledgments
 
168
---------------
 
169
 
 
170
Thanks to:
 
171
 
 
172
* Patrick Voigt for help with the remote server code.
 
173
* Patrick Moreau, Martin P.J. Zinser, and David Mathog for the VMS
 
174
  port.
 
175
* David Boldt and Rick Rodgers for sample man pages.
 
176
* Brendan Miller for the icon idea.
 
177
* Olly Betts for help testing pdftotext.
 
178
* Peter Ganten for the OS/2 port.
 
179
* Michael Richmond for the Win32 port of pdftops and pdftotext and the
 
180
  xpdf/cygwin/XFree86 build instructions.
 
181
* Frank M. Siegert for improvements in the PostScript code.
 
182
* Leo Smiers for the decryption patches.
 
183
* Rainer Menzner for creating t1lib, and for helping me adapt it to
 
184
  xpdf.
 
185
* Pine Tree Systems A/S for funding the OPI and EPS support in
 
186
  pdftops.
 
187
* Easy Software Products for funding the "sh" operator support.
 
188
* Tom Kacvinsky for help with FreeType and for being my interface to
 
189
  the FreeType team.
 
190
* Theppitak Karoonboonyanan for help with Thai support.
 
191
* Leonard Rosenthol for help and contributions on a bunch of things.
 
192
* Alexandros Diamantidis and Maria Adaloglou for help with Greek
 
193
  support.
 
194
* Lawrence Lai for help with the CJK Unicode maps.
 
195
 
 
196
Various people have contributed modifications made for use by the
 
197
pdftex project:
 
198
 
 
199
* Han The Thanh
 
200
* Martin Schr�der of ArtCom GmbH
 
201
 
 
202
 
 
203
References
 
204
----------
 
205
 
 
206
Adobe Systems Inc., _PDF Reference: Adobe Portable Document Format
 
207
Version 1.5_.
 
208
http://partners.adobe.com/asn/tech/pdf/specifications.jsp
 
209
[The manual for PDF version 1.5.]
 
210
 
 
211
Adobe Systems Inc., _PostScript Language Reference_, 3rd ed.
 
212
Addison-Wesley, 1999, ISBN 0-201-37922-8.
 
213
[The official PostScript manual.]
 
214
 
 
215
Adobe Systems, Inc., _The Type 42 Font Format Specification_,
 
216
Adobe Developer Support Technical Specification #5012.  1998.
 
217
http://partners.adobe.com/asn/developer/pdfs/tn/5012.Type42_Spec.pdf
 
218
[Type 42 is the format used to embed TrueType fonts in PostScript
 
219
files.]
 
220
 
 
221
Adobe Systems, Inc., _Adobe CMap and CIDFont Files Specification_,
 
222
Adobe Developer Support Technical Specification #5014.  1995.
 
223
http://www.adobe.com/supportservice/devrelations/PDFS/TN/5014.CIDFont_Spec.pdf
 
224
[CMap file format needed for Japanese and Chinese font support.]
 
225
 
 
226
Adobe Systems, Inc., _Adobe-Japan1-4 Character Collection for
 
227
CID-Keyed Fonts_, Adobe Developer Support Technical Note #5078.
 
228
2000.
 
229
http://partners.adobe.com/asn/developer/PDFS/TN/5078.CID_Glyph.pdf
 
230
[The Adobe Japanese character set.]
 
231
 
 
232
Adobe Systems, Inc., _Adobe-GB1-4 Character Collection for
 
233
CID-Keyed Fonts_, Adobe Developer Support Technical Note #5079.
 
234
2000.
 
235
http://partners.adobe.com/asn/developer/pdfs/tn/5079.Adobe-GB1-4.pdf
 
236
[The Adobe Chinese GB (simplified) character set.]
 
237
 
 
238
Adobe Systems, Inc., _Adobe-CNS1-3 Character Collection for
 
239
CID-Keyed Fonts_, Adobe Developer Support Technical Note #5080.
 
240
2000.
 
241
http://partners.adobe.com/asn/developer/PDFS/TN/5080.CNS_CharColl.pdf
 
242
[The Adobe Chinese CNS (traditional) character set.]
 
243
 
 
244
Adobe Systems Inc., _Supporting the DCT Filters in PostScript Level
 
245
2_, Adobe Developer Support Technical Note #5116.  1992.
 
246
http://www.adobe.com/supportservice/devrelations/PDFS/TN/5116.PS2_DCT.PDF
 
247
[Description of the DCTDecode filter parameters.]
 
248
 
 
249
Adobe Systems Inc., _Open Prepress Interface (OPI) Specification -
 
250
Version 2.0_, Adobe Developer Support Technical Note #5660.  2000.
 
251
http://partners.adobe.com/asn/developer/PDFS/TN/5660.OPI_2.0.pdf
 
252
 
 
253
Adobe Systems Inc., CMap files.
 
254
ftp://ftp.oreilly.com/pub/examples/nutshell/cjkv/adobe/
 
255
[The actual CMap files for the 16-bit CJK encodings.]
 
256
 
 
257
Adobe Systems Inc., Unicode glyph lists.
 
258
http://partners.adobe.com/asn/developer/type/unicodegn.html
 
259
http://partners.adobe.com/asn/developer/type/glyphlist.txt
 
260
http://partners.adobe.com/asn/developer/type/corporateuse.txt
 
261
http://partners.adobe.com/asn/developer/type/zapfdingbats.txt
 
262
[Mappings between character names to Unicode.]
 
263
 
 
264
Aldus Corp., _OPI: Open Prepress Interface Specification 1.3_.  1993.
 
265
http://partners.adobe.com/asn/developer/PDFS/TN/OPI_13.pdf
 
266
 
 
267
Anonymous, RC4 source code.
 
268
ftp://ftp.ox.ac.uk/pub/crypto/misc/rc4.tar.gz
 
269
ftp://idea.sec.dsi.unimi.it/pub/crypt/code/rc4.tar.gz
 
270
[This is the algorithm used to encrypt PDF files.]
 
271
 
 
272
T. Boutell, et al., "PNG (Portable Network Graphics) Specification,
 
273
Version 1.0.  RFC 2083.
 
274
[PDF uses the PNG filter algorithms.]
 
275
 
 
276
CCITT, "Information Technology - Digital Compression and Coding of
 
277
Continuous-tone Still Images - Requirements and Guidelines", CCITT
 
278
Recommendation T.81.
 
279
http://www.w3.org/Graphics/JPEG/
 
280
[The official JPEG spec.]
 
281
 
 
282
A. Chernov, "Registration of a Cyrillic Character Set".  RFC 1489.
 
283
[Documentation for the KOI8-R Cyrillic encoding.]
 
284
 
 
285
Roman Czyborra, "The ISO 8859 Alphabet Soup".
 
286
http://czyborra.com/charsets/iso8859.html
 
287
[Documentation on the various ISO 859 encodings.]
 
288
 
 
289
L. Peter Deutsch, "ZLIB Compressed Data Format Specification version
 
290
3.3".  RFC 1950.
 
291
[Information on the general format used in FlateDecode streams.]
 
292
 
 
293
L. Peter Deutsch, "DEFLATE Compressed Data Format Specification
 
294
version 1.3".  RFC 1951.
 
295
[The definition of the compression algorithm used in FlateDecode
 
296
streams.]
 
297
 
 
298
Jim Flowers, "X Logical Font Description Conventions", Version 1.5, X
 
299
Consortium Standard, X Version 11, Release 6.1.
 
300
ftp://ftp.x.org/pub/R6.1/xc/doc/hardcopy/XLFD/xlfd.PS.Z
 
301
[The official specification of X font descriptors, including font
 
302
transformation matrices.]
 
303
 
 
304
Foley, van Dam, Feiner, and Hughes, _Computer Graphics: Principles and
 
305
Practice_, 2nd ed.  Addison-Wesley, 1990, ISBN 0-201-12110-7.
 
306
[Colorspace conversion functions, Bezier spline math.]
 
307
 
 
308
Robert L. Hummel, _Programmer's Technical Reference: Data and Fax
 
309
Communications_.  Ziff-Davis Press, 1993, ISBN 1-56276-077-7.
 
310
[CCITT Group 3 and 4 fax decoding.]
 
311
 
 
312
ISO/IEC, _Information technology -- Lossy/lossless coding of bi-level
 
313
images_.  ISO/IEC 14492, First edition (2001-12-15).
 
314
http://webstore.ansi.org/
 
315
[The official JBIG2 standard.  The final draft of this spec is
 
316
available from http://www.jpeg.org/jbighomepage.html.]
 
317
 
 
318
ISO/IEC, _Information technology -- JPEG 2000 image coding system --
 
319
Part 1: Core coding system_.  ISO/IEC 15444-1, First edition
 
320
(2000-12-15).
 
321
http://webstore.ansi.org/
 
322
[The official JPEG 2000 standard.  The final committee draft of this
 
323
spec is available from http://www.jpeg.org/JPEG2000.html, but there
 
324
were changes made to the bitstream format between that draft and the
 
325
published spec.]
 
326
 
 
327
ITU, "Standardization of Group 3 facsimile terminals for document
 
328
transmission", ITU-T Recommendation T.4, 1999.
 
329
ITU, "Facsimile coding schemes and coding control functions for Group 4
 
330
facsimile apparatus", ITU-T Recommendation T.6, 1993.
 
331
http://www.itu.int/
 
332
[The official Group 3 and 4 fax standards - used by the CCITTFaxDecode
 
333
stream, as well as the JBIG2Decode stream.]
 
334
 
 
335
Christoph Loeffler, Adriaan Ligtenberg, George S. Moschytz, "Practical
 
336
Fast 1-D DCT Algorithms with 11 Multiplications".  IEEE Intl. Conf. on
 
337
Acoustics, Speech & Signal Processing, 1989, 988-991.
 
338
[The fast IDCT algorithm used in the DCTDecode filter.]
 
339
 
 
340
Microsoft, _TrueType 1.0 Font Files_, rev. 1.66.  1995.
 
341
http://www.microsoft.com/typography/tt/tt.htm
 
342
[The TrueType font spec (in MS Word format, naturally).]
 
343
 
 
344
Thai Industrial Standard, "Standard for Thai Character Codes for
 
345
Computers", TIS-620-2533 (1990).
 
346
http://www.nectec.or.th/it-standards/std620/std620.htm
 
347
[The TIS-620 Thai encoding.]
 
348
 
 
349
P. Peterlin, "ISO 8859-2 (Latin 2) Resources".
 
350
http://sizif.mf.uni-lj.si/linux/cee/iso8859-2.html
 
351
[This is a web page with all sorts of useful Latin-2 character set and
 
352
font information.]
 
353
 
 
354
Charles Poynton, "Color FAQ".
 
355
http://www.inforamp.net/~poynton/ColorFAQ.html
 
356
[The mapping from the CIE 1931 (XYZ) color space to RGB.]
 
357
 
 
358
R. Rivest, "The MD5 Message-Digest Algorithm".  RFC 1321.
 
359
[MD5 is used in PDF document encryption.]
 
360
 
 
361
Unicode Consortium, "Unicode Home Page".
 
362
http://www.unicode.org/
 
363
[Online copy of the Unicode spec.]
 
364
 
 
365
W3C Recommendation, "PNG (Portable Network Graphics) Specification
 
366
Version 1.0".
 
367
http://www.w3.org/Graphics/PNG/
 
368
[Defines the PNG image predictor.]
 
369
 
 
370
Gregory K. Wallace, "The JPEG Still Picture Compression Standard".
 
371
ftp://ftp.uu.net/graphics/jpeg/wallace.ps.gz
 
372
[Good description of the JPEG standard.  Also published in CACM, April
 
373
1991, and submitted to IEEE Transactions on Consumer Electronics.]
 
374
 
 
375
F. Yergeau, "UTF-8, a transformation format of ISO 10646".  RFC 2279.
 
376
[A commonly used Unicode encoding.]