Additional Jars
JPedal may require some additional jars on your classpath to handle some PDF files. As these can increase the size of download substantially but are needed on only a small number of PDF files, we do not include them all.
If they are required, JPedal will generate an error or tell you.
You can either add the jars into the ext directory of Java or add them to the classpath using the -cp option (in which case you can not use the -jar option and will need to specify the class you are running).
Getting hold of the Jars
The PDF Viewer actually has a configuration option to download any jars required to run JPedal. It will detect which jars are present on your machine and open the downloads page. This is the recommended way to obtain the jars.
Javascript support (js.jar)
JPedal includes Javascript support for PDF Forms and PDF Layers. Javascript uses the excellent Rhino library. This will be automatically used if the Rhino jar is on classpath.
We currently support Rhino versions 1.4, 1.5, 1.6, and 1.7 up to R2.
CIDFont0/CIDFont2 Foreign language support (cid.jar)
There are additional CMAP files which can be downloaded as part of the PDF file specification.
This is required by some foreign fonts and available from the downloads page. An exception will be thrown if it is needed and not present.
JAI
The Java Advanced Imaging library adds better Tiff support and hardware acceleration to some image operations. It can be enabled using a JVM option but will not be automatically used if on classpath. The JAI libraries may come as a single jar which needs to be unpacked into jai_core and jai_codec. We have included a flag to enable it because some customers want to have JAI on the classpath but avoid its usage in JPedal for technical reasons.
Java Advanced Imaging (JAI) can be used to enhance image handling, especially for Tiffs. These files need jai_core.jar
Files with JPEG2000 encoded images will also need imageio.jar, which is part of JAI
We found a problem in imageio.jar and built our modified version.
JAI jar files can be downloaded from here
Security jars
If the file is encrypted, the JCE library from The Legion Of The Bouncy Castle (http://www.bouncycastle.org).
mailbc.jar is also required along with the main jar to compile or open a PDF with a certificate.
Java3D
If you have Java3D installed a more advanced version of the PDF PageFlow viewing mode will be used. You can install Java3D from java.net.
IText
IText is a great free library for creating and editing PDF files so very much complements JPedal. We are big fans of Itext and have added some hooks to access IText functions in JPedal.
JPedal contains a dummy class called ItextFunctions. If you are building JPedal from source and you would like to use iText you can replace the ITextFunctions dummy class with the version here which will enable the iText functionality in the viewer.
Important note IText is uder an AGPL license so if you do not distribute the source code, you will need a license from Itext if you wish to use it.
L2prod
The PDF Viewers use the excellent 2fprod-common-buttonbar.jar component which can be downloaded from here. You would only need this if compiling from source.
Freetts
The PDF Viewers make use of the freetts speech synthesis libraries to allow selected text to be read back. The required libraries can be downloaded here. All files from the lib directory must be present yet only freetts.jar need be added to the classpath.
Links to related articles
JVM options available on startup to customise library and examples.
Return to main PDF support section
Click here for the main PDF support area with lots of java examples, PDF tutorials and useful information to get the most out of the JPedal PDF library
