View Source



h1. ICEpdf 6.1.3 Release Notes

*{_}November 4th, 2016{_}*
h3. Contents

This document includes the following sections:

* [About This Release|#about]
* [Notable Changes and Enhancements|#notablechanges]
* [Known Issues|#knownissues]
* [Migration Notes|#migrationnotes]
* [Support|#support]


h3. About This Release

ICEpdf 6.1.3 is a certified maintenance release including improved support for form edits, AES encryption support, blending modes and many other fixes and enhancements. It should also be noted the ICEpdf jars can not be found on the central Maven repository.


h3. Notable Changes and Enhancements

* *Rendering Core*
** FontManager class has been improved to more reliably find system fonts on Linux and Unix systems.
** Fixed an issue which prevented some indexed color model JPEG images from being rendered correctly.
** Improvements for detecting and handling malformed content streams.
** Corrected an issue where some large image and xform object could cause the JVM to exceed the allocated VM memory limit.
** Improvements to text selection algorithms for smoother word and line detection.
** Several enhancement to image smask and blending support.

* *Font Engine*
** Fixed an issue which prevented some text extraction operations to give incorrect character data.

* *Viewer RI*
** Addition of new font properties dialog which shows font data for all fonts in a document.
** Added a reset font cache button to the font properties dialog.
** Several new PropertyManager properties have been added to allow users to hide individual annotation creation tools.
** Fixed several issues which prevented the proper encryption of documents that use AES encryption filters.
** Addition of new PropertyManager properties for hiding the various page modes.
** Fixed an issue which prevented the setting of a custom SecurityCallback.

* *Build & Bundles*
** Update jar file manifest to have the correct section information.

For a complete list of all changes in this release, see the related JIRA [Change Log|].


h3. 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 JIRA issue tracker.
* Choice Button may persist in thew viewer even after focus is lost but data will be written as expected on OSX.
* Language support for none English languages is limited to the main Viewer controls and may be incomplete for the Utility pane or popup dialogs.

h3. Migration Notes

h4. 5.x to 6.x Migration Notes

*API Behavior Changes*
* In memory file loading is now the default behavior for files under 200 MB. The system property org.icepdf.core.filecache.enabled=false to override this behavior.
* API access is now possible for a Page's Shapes.

*Viewer RI*
* The Viewer RI has been updated with new annotation components to represent each form field type. Manipulating this components will change the underling data model for the respective field type.
* A new interactive form toolbar has been added the main tool bar. The interactive form toolbar currently only contains one button to control form field highlight visibility. The toolbar can be hidden using the PropertiesManager and the property

h4. 4.x to 5.x Migration Notes

*API Packaging Changes*
* The memory manager has been updated and it is no longer required to lock a Page object when accessing it through the PageTree API.
* PagePainter object is no long passed into a call to Page.paint() method. If long running Page paint method needs to be interrupted then a call to page.requestInterrupt() should be made.
* The use of Hashtable in the Dictionary class has been replaced with HashMap object.

*System Properties*
* Image scaling is now off by default and there two new scaling options, more information can be referenced found here, [imaging options|]
* Many system properties have been removed as they are no longer needed or irrelevant. Please review [System Properties|] for a complete list of supported system properties.

*Viewer RI*
* The Viewer RI has been updated to support annotation editing tools, for more information on these see [Working with Annotations |].
* Layer support has been added to the Viewer RI utility pane, for more information see [User Layers |].

h4. 3.x to 4.x Migration Notes

The following changes may affect applications that were originally developed with a previous version of ICEpdf.
ICEpdf Core API
* When extracting text using the org.icepdf.core.pobjects.Page Object the method not longer turns a Vector of Strings. Instead it now returns the data structure See class document and the example _install_dir_/icepdf/examples/extraction/ for correct usage.

h4. 2.x to 4.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 4.0 packaging has been updated to match the domain of the new community site [].
* 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 [].
* 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 v4.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 [].

*Logging System*
* ICEpdf 4.0 now uses Java logging API for all logging tasks.
* A sample file is included in the directory .../install_dir/icepdf/lib/.
* The custom logging properties file can be specified with the following system property:
** \
* Further information on java.util.logging can be found at [].



h3. Support

Please visit the [|] community site for additional information, demos, and resources.

All questions, comments, or general discussion specific to ICEpdf 5.0 should be made in the [ICEpdf Forum|] forum.

For information on commercial support, professional services, and training, please visit [].