Go to file
Fabian Lange 970c048d50 fixes caching of inline images during parsing.
As described in #5444, the evaluator will perform identity checking of
paintImageMaskXObjects to decide if it can use
paintImageMaskXObjectRepeat instead of paintImageMaskXObjectGroup.

This can only ever work if the entry is a cache hit. However the
previous caching implementation was doing a lazy caching, which would
only consider a image cache worthy if it is repeated.
Only then the repeated instance would be cached.
As a result of this the sequence of identical images A1 A2 A3 A4 would
be seen as A1 A2 A2 A2 by the evaluator, which prevents using the
"repeat" optimization. Also only the last encountered image is cached,
so A1 B1 A2 B2, would stay A1 B1 A2 B2.

The new implementation drops the "lazy" init of the cache. The threshold
for enabling an image to be cached is rather small, so the potential waste
in storage and adler32 calculation is rather low. It also caches any
eligible image by its adler32.

The two example from above would now be A1 A1 A1 A1 and A1 B1 A1 B1
which not only saves temporary storage, but also prevents computing
identical masks over and over again (which is the main performance impact
of #2618)
2014-10-28 15:39:41 +01:00
docs Creates make.js code to build jsdoc. 2014-04-13 15:54:24 -05:00
examples Minor node/pdf2svg.js fixes. 2014-10-22 09:59:20 -05:00
extensions Merge pull request #5402 from yurydelendik/streammem 2014-10-13 14:26:50 -07:00
external Adds css import preprocessing 2014-09-30 08:11:43 -05:00
l10n Update l10n files (October 2014) 2014-10-17 13:49:22 +02:00
src fixes caching of inline images during parsing. 2014-10-28 15:39:41 +01:00
test Merge pull request #5426 from fkaelberer/fixJpxOutOfPackets 2014-10-22 09:40:29 -05:00
web Disable zooming in Presentation Mode 2014-10-15 22:25:31 +02:00
.gitattributes Force Unix line endings for all files in new commits 2014-04-24 22:52:34 +02:00
.gitignore Added svg export tool 2014-08-14 23:18:19 +05:30
.gitmodules Migrating test.py to test.js 2014-03-25 14:07:08 -05:00
.jshintignore Exclude B2G stubs from linting 2014-04-12 10:45:16 +02:00
.jshintrc Enforce strict equalities with JSHint 2014-08-02 13:57:20 +02:00
.travis.yml Attempt to fix Travis 2014-07-31 15:14:08 +02:00
AUTHORS Add fkaelberer to the list of authors 2014-10-23 16:09:56 +02:00
CONTRIBUTING.md Implements importl10n command 2014-03-26 23:48:02 +01:00
LICENSE Change to the Apache v2 license. 2012-08-31 15:48:21 -07:00
make.js Packages PDFViewer as a UI component. 2014-09-30 12:41:53 -05:00
package.json Use the tilde (~) consistently in package.json 2014-10-14 14:02:30 +02:00
pdfjs.config Version 1.0.907 2014-10-22 08:29:52 -05:00
README.md Fixes milestones link in README.md 2014-09-20 10:22:14 +02:00

PDF.js

PDF.js is a Portable Document Format (PDF) viewer that is built with HTML5.

PDF.js is community-driven and supported by Mozilla Labs. Our goal is to create a general-purpose, web standards-based platform for parsing and rendering PDFs.

Contributing

PDF.js is an open source project and always looking for more contributors. To get involved checkout:

For further questions or guidance feel free to stop by #pdfjs on irc.mozilla.org.

Getting Started

Online demo

Browser Extensions

Firefox

PDF.js is built into version 19+ of Firefox, however two extensions are still available that are updated at a different rate:

  • Development Version - This version is updated every time new code is merged into the PDF.js codebase. This should be quite stable but still might break from time to time.
  • Stable Version - After version 24 of Firefox is released we no longer plan to support the stable extension. The stable version will then be considered whatever is built into Firefox.

Chrome and Opera

The Chromium extension is still somewhat experimental but it can be installed two ways:

  • Unofficial Version - This extension is maintained by a PDF.js contributor.
  • Build Your Own - Get the code as explained below and issue node make chromium. Then open Chrome, go to Tools > Extension and load the (unpackaged) extension from the directory build/chromium.

The version of the extension for the Opera browser can be found at the Opera add-ons catalog.

Getting the Code

To get a local copy of the current code, clone it using git:

$ git clone git://github.com/mozilla/pdf.js.git pdfjs
$ cd pdfjs

Next, you need to start a local web server as some browsers don't allow opening PDF files for a file:// url:

$ node make server

You can install Node via nvm or the official package. If everything worked out, you can now serve

You can also view all the test pdf files on the right side serving

Building PDF.js

In order to bundle all src/ files into two productions scripts and build the generic viewer, issue:

$ node make generic

This will generate pdf.js and pdf.worker.js in the build/generic/build/ directory. Both scripts are needed but only pdf.js needs to be included since pdf.worker.js will be loaded by pdf.js. If you want to support more browsers than Firefox you'll also need to include compatibility.js from build/generic/web/. The PDF.js files are large and should be minified for production.

Learning

You can play with the PDF.js API directly from your browser through the live demos below:

The repo contains a hello world example that you can run locally:

For an introduction to the PDF.js code, check out the presentation by our contributor Julian Viereck:

You can read more about PDF.js here:

Even more learning resources can be found at:

Questions

Check out our FAQs and get answers to common questions:

Talk to us on IRC:

  • #pdfjs on irc.mozilla.org

Join our mailing list:

Subscribe either using lists.mozilla.org or Google Groups:

Follow us on twitter: @pdfjs

Weekly Public Meetings