ICEpdf ® v3.0 Release Notes May 1st, 2009

Overview

This document contains the following sections:

• Changes in v3.0 (This Release)
• 2.x to 3.x Migration Notes
• Known Issues
  
  • General
• Support
• About ICEpdf
• License Information

Changes in v3.0 (This Release)

ICEpdf v3.0 is a certified production release that introduces ICEpdf as an open source project. Please visit the community site at http://www.icepdf.org for additional information, demos, and resources.

Review the Known Issues prior to using this release. Review the Migration Notes if you plan to use an existing ICEpdf application with 3.0.0.

Please report any issues with this release to the ICEpdf forums or the ICEpdf JIRA issue tracker.

Notable Improvements & Enhancements

• Rendering Core

• Enabling Embedded Font Support
  • ICEpdf uses java.awt.Font when reading font files for substitution. By default java.awt.Font is disabled for reading embedded fonts and can be enable with the system property: org.icepdf.core.awtFontLoading=true.
  • ICEpdf Pro allows for unprecedented font reproduction and rendering speed. ICEpdf Pro is a commercial product and requires icepdf-pro.jar and icepdf-pro-intl.jar libraries.
• Java Logging API is now used for all logging operations.
• Ant build scripts are available in the source bundle to build both the icepdf-core.jar and icepdf-viewer.jar from source.
• Fixed an issue where a null pointer could be generated from the PageViewComponentImpl if an AnnotationCallback was not specified.

• Viewer Application

  • The viewer reference implementation printing code has been updated to use the Java Print Service API.

• Examples Applications

  • ICEfaces Example
  • New ICEfaces PDF viewing example application.
  • Allows users to upload PDF documents and view pages within a web browser.
  • Utilizes ICEfaces components and direct-to-DOM updates.

• Documentation

• ICEpdf Developer's Guide. The ICEpdf Developer's Guide has been revised. The following sections have been added/enhanced: 
• Product Contents, pg. 2.
• Prerequisites, pg. 7.
• Building ICEpdf from Source, pg. 8.
• Enabling Embedded Font Support, pg. 10.
• System Properties, pg. 11.
• ICEfaces Example, pg. 40.
• Appendix A - Supported PDF Features, pg. 42.

• 3rd Party Libraries

• The batik jars for SVG output are now included in the "../icepdf/lib/" directory and have been updated to v1.6.

• The Bouncy Castle jars for Adobe Standard Encryption support are now included in the "../icepdf/lib/" directory, and have been updated to v1.4.2

2.x to 3.x Migration Notes

The following changes may affect applications that were originally developed with a previous version of ICEpdf.

ICEpdf Jar File Changes

• The ICEpdf jar file names have been updated to better indicate their respective usage.
• Please update your applications to reflect the new jar names.
  • icepdf-core.jar - was icepdf.jar, contains core ICEpdf rendering classes.
  • icepdf-viewer.jar - was ri_pdf.jar, contains viewer reference implementation.
  • icepdf-pro.jar* - Professional font library available under commercial licensing.
  • icepdf-pro-int.jar* - Professional font library CMap files, available under commercial licensing.
  * Denotes JAR files that are only available in ICEpdf Pro commercial release.

API Packaging Changes

• ICEpdf 3.0 packaging has been updated to match the domain of the new communitiy site http://www.icepdf.org/.
• Please update your applications to reflect the new base package name.
  • Former package-name: com.icesoft.*
  • New package-name: org.icepdf.*
• The ICEpdf API rendering core is now rooted at org.icepdf.core.*.
• The ICEpdf API viewer reference implementation is now rooted at org.icepdf.ri.*.

System Properties

• ICEpdf system properties have been changed to match the domain name of the community site http://www.icepdf.org/.
• Please update your applications use of ICEpdf system properties to reflect the new base package name.
  • Former package-name: com.icesoft.*
  • New package-name: org.icepdf.*

JDK 1.5+ Now Required 

• ICEpdf source code has been updated to the JDK 1.5 Java language specification to take advantage of numerous features and improvements to the Java programming language. As a result ICEpdf v3.0 is not deployable to Java JRE versions older than 1.5.
• Older versions of the Java JDK and JRE have been added to Sun's end of life and are no longer publicly supported.
• JDK 1.3.1 reached the end of its service life (EOSL), December 11th, 2006.
• JDK 1.4.2 reached the end of its service life (EOSL), October 11th, 2008.
• For more information on Java Platform Migration please see http://java.sun.com/j2se/JM_White_Paper_R6A.pdf.

Logging System

• ICEpdf 3.0 now uses Java logging API for all logging tasks.
• A sample logging.properties file is included in the directory .../install_dir/icepdf/lib/.
• The custom logging properties file can be specified with the following system property:
  • -Djava.util.logging.config.file=logging.properties
• Further information on java.util.logging can be found at http://java.sun.com/j2se/1.5.0/docs/guide/logging/.

Supported Platforms

The ICEpdf product is 100% Java and capable of running on the following JVMs:

Windows	Linux	Solaris	Mac OSX
Sun J2SE 1.5	Sun J2SE 1.5	Sun J2SE 1.5	Apple J2SE 1.5
Sun J2SE 1.6	Sun J2SE 1.6	Sun J2SE 1.6	Apple J2SE 1.6
Sun J2SE 1.7 EA	Sun J2SE 1.7 EA	Sun J2SE 1.7 EA	N/A

Known Issues

The following section describes the most commonly encountered known issues with this release. For a complete reference of all outstanding issues please refer to the ICEpdf.org JIRA issue tracker.

General

• JDK 1.6.0_10 introduced a regression which affects the performance of the XOR draw operation. This issue can be resolved with the system property -Dsun.java2d.d3d=false. More information on this issue can be found at Bug ID 6792551.

• Batik libraries version 1.7 for SVG export has a known issue which will cause a null pointer when using the class SVGGraphics2D. Please use Batik version 1.6 or earlier (included in this release bundle), http://xmlgraphics.apache.org/batik/.

• Depending what version of the Java Advanced Imaging (JAI) library you are using, the installer program may assume you are installing it on a J2SE JDK installation. If you install the JAI into a J2SE JRE installation, you may need to move the installed files from the /jre subdirectory that the installer creates to the jre directory above.

Support

Open source community support is available at http://www.icepdf.org.

For information on commercial support, professional services, and training, please visit http://support.icepdf.org.

About ICEpdf

ICEpdf is an open source Java PDF library ideal for displaying and printing PDF documents within any Java application. The ICEpdf API is lightweight, fast, efficient and very easy to use. ICEpdf is 100% Java-based. ICEpdf is capable of rendering PDFs up to version 1.6 (Acrobat 7.0) and provides the following features:

• Seamless integration within Java clients (Swing, AWT, etc.), allowing complete control over the configuration, functionality, and user interface.
• A lightweight static and dynamic memory footprint.
• Easy deployment to any Java platform without the hassles of Java-to-native integration issues.
• Embeddable as Java PDF viewer component and stand-alone application.
• Render PDFs to image file (PNG, JPEG, GIF) in a server-side web application.
• Robust, efficient, mature PDF parser.
• Supports all PDF embedded font types (Types 0-3, OpenType, TrueType) using the Font Engine included in ICEpdf Pro¹.
• Font substitution optimized per platform.
• Supports incremental document loading, reducing time to view first page.
• Supports Adobe Standard Security for password-protected documents (40 and 128 bit RC4 or AES).
• Protects users against security vunerabilities that can be introduced by use of the native Adobe Acrobat PDF viewer application.
• Support for interactive link annotation actions; uri, launch and resource.
• View all markup annotations.

¹ ICEpdf is available in two versions; ICEpdf, the open source version, and ICEpdf Pro, a commercial version which includes an advanced Font Engine for improved document rendering quality.

Learn More

This ICEpdf release comes with extensive documentation that will help you understand the product thoroughly. Documentation for this release is located in your installation directory at .../install_dir/icepdf/docs/. The following documents are provided in PDF format:

1. ICEpdf Developers Guide: This guide takes you through product introduction, configuration, usage scenarios and reference implementations and examples.

ICEpdf documentation is also available on-line at http://documentation.icepdf.org/.

License Notice

License agreements can be found in the .../install_dir/icepdf/docs/license directory.

© Copyright 2005-2009 ICEsoft Technologies, Inc.