View Source

{section}









{column:width=100px}



!icepdf-logo-release-notes.gif|align=left!
{column}

{column}




\\

h1. ICEpdf 4.4.0 Release Notes

*{_}March 8th, 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 v4.4 is a certified production release that introduces TrueType font hinting as an important new feature. This release also includes more than ten bug-fixes and enhancements.

{anchor:notablechanges}

h3. Notable Changes and Enhancements

* *Rendering Core*
** Support for TrueType font hinting which significantly improves the rendered quality of many none Latin font programs.
** Improved text selection accuracy of Type3 fonts.
** Fixed an image banding regression introduce in 4.3.4.
** Updated tiling support to better handle small tile sizes and step values.

* *Viewer RI*
** Addition of SwingController utility method for setting the default print media size.


{tip:title=Change Log}
For a complete list of all changes in this release, see the related JIRA [Change Log|http://jira.icesoft.org/secure/IssueNavigator.jspa?reset=true&jqlQuery=project+%3D+PDF+AND+fixVersion+%3D+%224.4%22+ORDER+BY+status+DESC%2C+priority+DESC&mode=hide].
{tip}

\\

{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.

\\

{anchor:migrationnotes}

h3. Migration Notes

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.icesoft.org|http://www.icesoft.org/] community site for additional information, demos, and resources.

All questions, comments, or general discussion specific to ICEpdf 4.x should be made in the [ICEpdf Forum|http://jforum.icesoft.org/JForum/forums/show/28.page] forum.

For information on commercial support, professional services, and training, please visit the [ICEpdf Support Options Page|http://www.icesoft.org/support/icepdf-pro-support-options.jsf]. !icepdf-logo-release-notes.gif!