RealObjects PDFreactor 7.0.7447.1 readme

RealObjects PDFreactor^®

Version 7.0.7447.1, 2015-03-24

Important

This software and support material is copyrighted, it may only be used with a legally acquired and fully paid license and in accordance with the PDFreactor Software License Agreement. By installing and using this software, you accept the terms and conditions of the RealObjects PDFreactor Software License Agreement notices and the additional license agreements for third-party software and/or open source software. For details, see the license.txt file.
If you have not purchased a license, you are only allowed to test and evaluate this software to find out how it fits your requirements during an evaluation period of 30 days. If PDFreactor runs in evaluation mode, it will insert watermarks on every page and an evaluation notice on the second page of the PDF documents it creates.

For more information or to purchase a PDFreactor license, please visit our website at www.pdfreactor.com

Folder Contents

/doc

Contains the PDFreactor Manual (PDF and Docbook XML format).

/doc/apidocs

Contains the PDFreactor Java API documentation.

/license

Contains the PDFreactor Software License Agreement and additional notices and license agreements for third-party software and/or open source software.
By installing and using this software, you accept the terms and conditions of the RealObjects PDFreactor Software License Agreement notices and the additional license agreements for third-party software and/or open source software.

/bin

Executables to launch the PDFreactor Preview and the command line version of PDFreactor.
The PDFreactor Preview allows you to easily browse various sample documents, check out their source codes, get an instant paged mode preview and create PDFs.

/lib

Contains the self-contained library pdfreactor.jar.

/lib/modular

Contains the non-self-contained version pdfreactorcore.jar, as well as the required and optional 3rd party libraries. Please see the README.txt in the lib folder for details.

/samples

Various sample documents in several formats demonstrating the capabilities of PDFreactor

/wrappers/dotnet

.NET wrapper API for PDFreactor (DLL, API docs, ASP.NET sample). To use the .NET API, copy the assembly PDFreactor.dll from the /wrappers/dotnet/bin to the /bin directory of your IIS application.

/wrappers/php

PHP wrapper API for PDFreactor (PHP include, API docs, PHP sample). To use the PHP API, include the PDFreactor.class.php file from your PHP file.

/wrappers/perl

Perl wrapper API for PDFreactor (Perl module, API docs, Perl sample). To use the Perl API, include the PDFreactor.pl file from your Perl file.

/wrappers/python

Python wrapper API for PDFreactor (Python module, API docs, Python sample). To use the Python API, include the PDFreactor.py file from your Python file.

/wrappers/ruby

Ruby wrapper API for PDFreactor (Ruby module, API docs, Ruby sample). To use the Ruby API, include the PDFreactor.rb file from your Ruby file.

/jetty

Java Application server required to run the PDFreactor web service which is used by the .NET, PHP, Perl, Python and Ruby wrapper APIs

Upgrading to PDFreactor 7

Updating to PDFreactor 7 is easy. This new release is binary compatible with PDFreactor 6 releases. In general, it should not be necessary to change anything in your integration code.

If you are updating an existing copy, be careful if you have customized any files. Be sure to make a backup copy of your previous installation folder. In general you should overwrite all old files with the newer version and then manually reintroduce any changes afterwards.

If you are upgrading from a previous major version, you need a new license key. Please contact support@realobjects.com to upgrade your license key to the new version if you have a valid maintenance and upgrade subscription or to purchase an upgrade.

Release History

7.0.7447.1 First Hotfix Release of PDFreactor 7.0.7447

The bug fixes include:

Performance issues when viewing the resulting PDFs in Chrome

7.0.7447 Seventh Bugfix Release of PDFreactor 7.0

The new features and improvements include:

The CSS color function "rgba" is now available in SVGs. This is used by various charting libraries, primarily for 3D charts (#5549)
The CSS color function "cmyk" is now available in SVGs, making "RO-CMYK" ICC colors obsolete (still supported for compatibility)
SVG elements are now properly affected by styles set in the containing HTML document (#5543)
Improved BiDi and Arabic shaping in SVGs (#5588)
Script tags with an unknown type are now skipped (#5550)

The bug fixes include:

Prefixed CSS properties in SVG elements caused the following properties to be ignored (#5603)
SVGs referenced via "embed" elements were not loaded (#5591)
Converting SVGs including links could in rare cases lead to exceptions (#5633)
Listeners for the "load" event added via "window.addEventListener" were not triggered (#5621)
URLs containing legal line breaks could not be processed (#5582)
In some cases the max-width property of images inside tables was not taken into consideration when determining the width of the table cell and table (#5609)
"bottom" positioned elements with no fixed height had wrong vertical positioning if they had vertical margins, paddings or borders (#5623)

7.0.7290 Sixth Bugfix Release of PDFreactor 7.0

The new features and improvements include:

Vastly improved support for JavaScript libraries, including "AngularJS" and "Leaflet", due to numerous JavaScript, SVG and DOM related improvements.
Lines and shapes are now handled in a different way that avoids issues displaying thin lines in certain PDF viewers.
Debug mode no longer disables logging to the attached logger or the console. The log attached to the PDF now properly shows HTML and XML content as source.
The "applyAdaptivePageBreaks" method of the "Awesomizr" JavaScript library is now more robust.

The bug fixes include:

Tables with the "table-layout" CSS property set to "fixed" and containing rows with varying amount of columns could cause non-terminating layouts.
Tables with the "table-layout" CSS property set to "fixed" and "border-collapse: collapse" or containing cells with borders or padding could be laid out too wide. (#5595)
Rasterization of complex SVG graphics at "-ro-rasterization-supersampling" values larger than "2" could fail in certain JREs. (#5556)

7.0.7290 Fifth Bugfix Release of PDFreactor 7.0

The bug fixes include:

Text of floated elements inside positioned elements was added to the PDF twice at the same location (#5528)

7.0.7279 Fourth Bugfix Release of PDFreactor 7.0

The new features and improvements include:

Updated Unicode support to Unicode 7.0

The bug fixes include:

In some cases the widths of thin lines, incl. underlines of small text, were to small
The library awesomizr.js contained a superfluous log output

7.0.7270 Third Bugfix Release of PDFreactor 7.0

The bug fixes include:

PDF merging could cause exceptions

7.0.7267 Second Bugfix Release of PDFreactor 7.0

The new features and improvements include:

The JavaScript library Awesomizr can now be used to create multiple tables of contents
When creating a table of contents with Awesomizr, you can now specify a function which determines the text of the given entry for the table of contents or skips the entry entirely
Now setting the document URL as "referer" header for HTTP requests which improves compatibility with external resource providers like Typekit

The bug fixes include:

PDF merging in conjunction with encryption caused exceptions (#5510)
Images in table headers caused exceptions when the table was spanning multiple pages (#5481)
When the subset of a font cannot be created, an exception was thrown instead of embedding the entire font

7.0.7243 First Bugfix Release of PDFreactor 7.0

The new features and improvements include:

HTMLAnchorElement and Location now implement URLUtils (read-only), which drastically improves compatibility to AngularJS (#5467)
Tables spanning a large amount of pages are now converted significantly faster
Improved caching of web fonts, reducing the amount of temporary font files (#5444)
The Python API now also supports Python 3 (#5473)
Official support for Oracle JRE 8

The bug fixes include:

Images embedded in SVGs as data URIs could not be converted (#5432)
AFM fonts in the system font directory could lead to missing fonts in the resulting PDFs (#5425)
Some methods where missing in the wrapper APIs or did not work properly (#5422, #5423)
Clipping for "overflow: hidden" was not determined correctly
Setting "font-weight: lighter" in an @font-face rule caused exceptions (#5417)
html(string) method of jQuery 2 caused exceptions (#5415)
When CMYK was set as default color space and an error page was created an exception was thrown
Command line parameter "defaultlanguage" was misspelled as "defualtlanguage" (#5455)
Minor fixes to stacking contexts and related properties

7.0.7174 First Release of PDFreactor 7.0

The new features and improvements include:

Support for CSS3 Regions (#5122)
Support for CSS3 Running Elements (#5056)
Support for PDF/A-3a (#5095)
Support for PDF annotations, incl. comments, notes and tooltips (#4763, #5067)
Support for custom JavaScript functionality to retrieve the page number, coordinates and sizes of elements in the layout
Support for high quality HTML5 Canvas rendering without rasterization
Support for first-letter, including drop caps
Support for the CSS3 property "text-align-last" as "-ro-text-align-last"
Introduced properties "break-before", "break-after" and "break-inside" and improved page breaking, especially in multi-column (#5335, #5302)
Gradients, transforms and multi-column properties no longer require the prefix "-ro-"
The properties "width" and "height" of "img" elements now work according to the HTML5 specification, also the properties "naturalWidth" and "naturalHeight" have been added
The property "-ro-title" now cleans the content, e.g removing line breaks, and can be disabled via the value none (#5263, #5264)
SVG links are now converted to PDF links, similar to HTML links
List bullets not available in the current font are now drawn independently from fonts, also the property "list-style-image" now supports CSS gradients
JavaScript environment now handles attributes case-insensitively (#5260) and provides a "window.plugins" object of the correct type
Improved compatibility to JavaScript libraries that rely on DOM-object-prototypes
Improved quality of bidi text layout, especially for mixed content containing parenthesis
Improved font handling and added option to disable system fonts
Optimized JavaScript performance in large documents
The "CleanerThread" of the library "Batik" is now terminated appropriately in Servlet 3.0+ environments (#5332)
The included JavaScript library Tableizr has been replaced by its successor Awesomizr which includes additional functionality like automatic creation of tables of contents

The changes include:

Generated content can now be created with a "content" value of empty string
The pdfreactor.war no longer contains the pdfreactor.jar, so when using the pdfreactor.war in a different application server the pdfreactor.jar has to be added to the class path

The bug fixes include:

Empty inline elements could offset the bidi runs in mixed content (#5272)
Canvas did not scale stroke widths (#5256) and produced unexpected results for some uncommon parameter values for paint primitives
In rare cases PDF Documents could not be printed via PCL
"not" selectors containing pseudo classes could cause exceptions (#5269)
"a" elements with uncommon values caused exceptions when tagging was enabled
Media queries in style sheets caused errors
First word of line could not be hyphenated and hyphenation did not affect minimal width as expected

6.3.6828.3 Third Hotfix Release of PDFreactor 6.3

The bug fixes include:

Certain combinations of CSS "not"-selectors could cause exceptions.

6.3.6828.2 Second Hotfix Release of PDFreactor 6.3

The bug fixes include:

The function "addUserScript" of the PHP wrapper caused conversions to fail
The Java API documentation did not contain descriptions

6.3.6828.1 First Hotfix Release of PDFreactor 6.3

The new features and improvements include:

The JavaScript "XMLHttpRequest" now supports the "onload" and "onerror" callbacks required for jQuery 2 ajax.

The bug fixes include:

Documents containing multi-column layouts could not be printed in some environments.
Illegal font files, containing an empty font family name, caused IndexOutOfBoundsException, terminating the conversion.
Accessing the JavaScript "document" object was slow for complex documents.

6.3.6828 First Release of PDFreactor 6.3

The new features and improvements include:

Support for SVG-based JavaScript libraries, like Highcharts (highcharts.com) and amCharts (amcharts.com) (#5189)
New JavaScript modes: JAVASCRIPT_MODE_ENABLED_TIME_LAPSE (simulates faster progression of time to skip fade in animations) and JAVASCRIPT_MODE_ENABLED_REAL_TIME (disables optimizations)
For Highcharts use JAVASCRIPT_MODE_ENABLED_TIME_LAPSE
For amCharts use JAVASCRIPT_MODE_ENABLED_REAL_TIME
Support for the CSS properties "letter-spacing" and "z-index" (#4903)
Support for SVG elements with no width and height attributes, in addition SVGs with certain illegal structures will now be rendered
SVG images now have to be rasterized in fewer cases, also there are new CSS properties to adjust the rasterization process: "-ro-rasterization" and "-ro-rasterization-supersampling"
Reduced memory footprint for documents containing a large amount of elements
Improved accessibility for form elements
Documents loaded via the CSS function "xhtml()" are now parsed using the HTML5 parser
Optimized default configuration of PDFreactor web service
Various improvements to document parsing as well as font and JavaScript handling (#5142)

The bug fixes include:

Fonts added via the API were not available in documents loaded via the CSS function "xhtml()" (#5213)
The CSS property border-radius did not handle complex shorthands correctly (#5184)
"setPrintDialogPrompt" had no effect when the merge mode "overlay" was used
PDF/A-1a mode did not prohibit attachments
JavaScript could not be used from pdfreactorcore.jar because of missing library (#5194)

For a complete version history please see the change log

Operating Systems Supported

Windows Vista/7/8
Windows 2003/2008 Server
Linux
Mac OS X

The latest updates and service packs should be installed.

We have customers using the product in HP/UX, Solaris, AIX and FreeBSD, but we don't test on those platforms.

Officially Recommended Java VM:

Oracle JRE 7

Other Supported Java VMs:

Oracle JRE 8
Sun/Oracle JRE 6
Apple JRE 6

The latest updates and service packs should be installed.

We have customers using the product in JRockit, IBM JVMs and OpenJDK, but we don't test on those platforms.

General Requirements & Notes

Sun/Oracle JRE 6 compatible Java VM

Minimum Hardware Requirements

1 GHz Pentium CPU or equivalent
512 MB RAM

The hardware requirements depend on the complexity and size of the processed documents.

Support

For information about technical support please visit www.pdfreactor.com/support or contact support@realobjects.com

Registered Trademark

PDFreactor is a registered trademark of RealObjects GmbH, Saarbruecken.

Additional Important Notices and Copyrights

Please see the NOTICE.txt file in the /license subdirectory

info@realobjects.com
www.pdfreactor.com