Configuring ICEpdf

This chapter contains instructions to help you get up and running quickly with ICEpdf. We start by outlining the prerequisites for a standard configuration using a Java Platform, Standard Edition, and Apache Maven or Gradle to help you build the product from source.

Next we outline runtime configuration settings to best meet the needs of your application requirements and deployment environments:

• Configuration of optional modules at runtime, such as support for the Acrobat Standard Security, optimized font substitution, embedded font support and enhanced Image support.

• Numerous configuration properties may be adjusted using pre-defined system properties to alter the behavior of ICEpdf for your application, such as cache sizes and behaviors, render quality, settings, etc.

• Viewer Reference Implementation
• ICEpdf Examples
  

Prerequisites

ICEpdf is a standard Java 2 application, and as such, the only prerequisite to working with ICEpdf is that you must be familiar with Java 2 development. For more information on the Java Platform, Standard Edition (J2SE), refer to http://www.oracle.com/technetwork/java/javase/overview/.

To run the ICEpdf example and reference applications, you will need to download and install the following:

• Java 2 Platform, Standard Edition, version 1.8 or higher
• Apache Ant

The following sections provide detailed instructions for downloading the software to set up an environment where you can run the ICEpdf example and reference applications.

Java 2 Platform, Standard Edition

To run ICEpdf, ICEpdf reference implementations or examples, you will need to install a version of the Java Platform JDK, Standard Edition, version 1.8 or higher.

If you already have Java installed on your system, verify your version by typing the following on the command line:

java -version

To upgrade or install the latest release of the J2SE, visit the Sun web site:

http://www.oracle.com/technetwork/java/javase/downloads/

Installers and instructions are provided for the various systems that Sun supports. The reference and example application can run on any version of Windows, Unix, Linux, and Mac OS X capable of running J2SE version 1.8 or higher.

Maven

The ICEpdf core, reference applications and examples rely on Apache Ant or Gradle to build the source code. You will need Maven version 3.0 or higher or Gradle 4.0 to run build files located in our SVN repository http://anonsvn.icesoft.org/repo/icepdf/trunk/icepdf/.

If you already have a version of Maven installed, you can verify that you have a recommended version by typing the following on the command line:

mvn -version

To upgrade your current version or install a new version of Maven, visit the following location:

https://maven.apache.org/download.cgi

Gradle

If you already have a version of Gradle installed, you can verify that you have a recommended version by typing the following on the command line:

gradle -version

To upgrade your current version or install a new version of Gradle, visit the following location:

https://gradle.org/install/

If you are not familiar with Maven or Gradle, instructions for building the ICEpdf libraries and examples can be found here:

http://www.icesoft.org/wiki/display/PDF/Building+From+Source