{section}
{column:width=100px}
\\
!icepdf-app-icon-64x64.png|align=left!
{column}
{column}
\\
h1. ICEpdf 5.0.4 Release Notes
*{_}September 30th, 2013{_}*
{column}
{section}
----
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]
{anchor:about}
h3. About This Release
ICEpdf v5.0.4 is a certified maintenance release. This release includes more than 30 bug fixes and enhancements.
\\
{anchor:notablechanges}
h3. Notable Changes and Enhancements
* *Rendering Core*
** Fixed a parser issue that was causing the incorrect layout of text using the single quote token.
** Improvements to CYMK to RGB colour conversion accuracy for gray scale values.
** Fixed an issue where a content stream containing large number of comments could cause a stack overflow.
** Improved the content parser to handle malformed content stream text blocks.
** Fixed an issue where an empty content stream caused content parsing to fail.
** Added support for parsing a font descriptor that had an incorrect type attribute value.
** Fixed a concurrency issue where the decoding of crypt filters would sometimes fail.
** Changed font width handling to exclude OpenType fonts.
** Fixed a Lexer issue which prevented a text array spanning multiple content streams from being correctly parsed.
** Updated smooth scrolling image reference mode to match the original image scaling found in ICEpdf 4.x
** Addition of support for write compressed cross references stream on incremental updates.
** Fixed an issue where Text annotations would not remove the supporting font resource when deleted.
* *Viewer Application*
** Fixed an issue where new annotations are not printable by default.
** Addition of annotations flag edit support for all annotations types.
** Addition of smart painting when scrolling through a page column view.
** Addition of PrintHelper API for toggling annotation printing.
** Fixed an issue where page Annotation would not be drawn if initialized from another thread.
** Annotation utility pane can now be hidden if an annotation tool is selected.
** Fixed an issue which prevent annotations from being reinitialized after garbage collection.
For a complete list of all changes in this release, see the related JIRA [Change Log|http://jira.icesoft.org/browse/PDF/fixforversion/11072].
\\
{anchor:knownissues}
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 ICEpdf.org JIRA issue tracker.
General
* 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 on which 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. Newer versions of the JAI installer program have fixed this issue.
* Language support for none English languages is limited to the main Viewer controls and is incomplete for the Utility pane or popup dialogs.
\\
{anchor:migrationnotes}
h3. Migration Notes
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|http://www.icesoft.org/wiki/display/PDF/Imaging+Options]
* Many system properties have been removed as they are no longer needed or irrelevant. Please review [System Properties|http://www.icesoft.org/wiki/display/PDF/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 | http://www.icesoft.org/wiki/display/PDF/Working+with+Annotations].
* Layer support has been added to the Viewer RI utility pane, for more information see [User Layers |http://www.icesoft.org/wiki/display/PDF/Changing+Visibility+of+Layered+Content].
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 org.icepdf.core.pobjects.graphics.text.PageText. See class document and the example _install_dir_/icepdf/examples/extraction/PageTextExtraction.java 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 [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 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 [http://java.sun.com/j2se/JM_White_Paper_R6A.pdf].
*Logging System*
* ICEpdf 4.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/].
\\
{anchor:support}
h3. Support
Please visit the [www.icepdf.org|http://www.icepdf.org/] community site for additional information, demos, and resources.
All questions, comments, or general discussion specific to ICEpdf 4.0 should be made in the [ICEpdf Forum|http://www.icefaces.org/JForum/forums/show/28.page] forum.
For information on commercial support, professional services, and training, please visit [http://support.icepdf.org].
{column:width=100px}
\\
!icepdf-app-icon-64x64.png|align=left!
{column}
{column}
\\
h1. ICEpdf 5.0.4 Release Notes
*{_}September 30th, 2013{_}*
{column}
{section}
----
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]
{anchor:about}
h3. About This Release
ICEpdf v5.0.4 is a certified maintenance release. This release includes more than 30 bug fixes and enhancements.
\\
{anchor:notablechanges}
h3. Notable Changes and Enhancements
* *Rendering Core*
** Fixed a parser issue that was causing the incorrect layout of text using the single quote token.
** Improvements to CYMK to RGB colour conversion accuracy for gray scale values.
** Fixed an issue where a content stream containing large number of comments could cause a stack overflow.
** Improved the content parser to handle malformed content stream text blocks.
** Fixed an issue where an empty content stream caused content parsing to fail.
** Added support for parsing a font descriptor that had an incorrect type attribute value.
** Fixed a concurrency issue where the decoding of crypt filters would sometimes fail.
** Changed font width handling to exclude OpenType fonts.
** Fixed a Lexer issue which prevented a text array spanning multiple content streams from being correctly parsed.
** Updated smooth scrolling image reference mode to match the original image scaling found in ICEpdf 4.x
** Addition of support for write compressed cross references stream on incremental updates.
** Fixed an issue where Text annotations would not remove the supporting font resource when deleted.
* *Viewer Application*
** Fixed an issue where new annotations are not printable by default.
** Addition of annotations flag edit support for all annotations types.
** Addition of smart painting when scrolling through a page column view.
** Addition of PrintHelper API for toggling annotation printing.
** Fixed an issue where page Annotation would not be drawn if initialized from another thread.
** Annotation utility pane can now be hidden if an annotation tool is selected.
** Fixed an issue which prevent annotations from being reinitialized after garbage collection.
For a complete list of all changes in this release, see the related JIRA [Change Log|http://jira.icesoft.org/browse/PDF/fixforversion/11072].
\\
{anchor:knownissues}
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 ICEpdf.org JIRA issue tracker.
General
* 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 on which 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. Newer versions of the JAI installer program have fixed this issue.
* Language support for none English languages is limited to the main Viewer controls and is incomplete for the Utility pane or popup dialogs.
\\
{anchor:migrationnotes}
h3. Migration Notes
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|http://www.icesoft.org/wiki/display/PDF/Imaging+Options]
* Many system properties have been removed as they are no longer needed or irrelevant. Please review [System Properties|http://www.icesoft.org/wiki/display/PDF/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 | http://www.icesoft.org/wiki/display/PDF/Working+with+Annotations].
* Layer support has been added to the Viewer RI utility pane, for more information see [User Layers |http://www.icesoft.org/wiki/display/PDF/Changing+Visibility+of+Layered+Content].
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 org.icepdf.core.pobjects.graphics.text.PageText. See class document and the example _install_dir_/icepdf/examples/extraction/PageTextExtraction.java 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 [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 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 [http://java.sun.com/j2se/JM_White_Paper_R6A.pdf].
*Logging System*
* ICEpdf 4.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/].
\\
{anchor:support}
h3. Support
Please visit the [www.icepdf.org|http://www.icepdf.org/] community site for additional information, demos, and resources.
All questions, comments, or general discussion specific to ICEpdf 4.0 should be made in the [ICEpdf Forum|http://www.icefaces.org/JForum/forums/show/28.page] forum.
For information on commercial support, professional services, and training, please visit [http://support.icepdf.org].