=================================================== PDFreactor(R) by RealObjects Version 5.1.5812.2, 2011-12-21 =================================================== 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 http://www.realobjects.com Folder Contents --------------- /doc PDFreactor Manual (PDF and Docbook XML format) Please make sure that you read the manual! /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 GUI Demo Application and the command line version of PDFreactor. The GUI Demo Application allows you to easily browse various sample documents, check out their source codes, get an instant paged mode preview and create PDFs. /lib Codebase directory, containing the pdfreactor.jar library archive. Important: The license key file (licensekey.xml) you received, must be placed in this folder, if not set by the API during runtime. /samples Various sample documents in several formats demonstrating the capabilites 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 webservice which is used by the .NET, PHP, Perl, Python and Ruby wrapper APIs Upgrading to PDFreactor 5 from PDFreactor 4 ------------------------------------------- Updating to PDFreactor 5 is easy. This new release is binary compatible with PDFreactor 4 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. The PDFreactor 4 license key is not compatible with PDFreactor 5 and vice-versa. If you are upgrading from an older version of PDFreactor, 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 visit http://www.realobjects.com to purchase an upgrade. Release History --------------- 5.1.5812.2 First Release of PDFreactor 5.1 The new features and improvements include: * Improved PDF tagging, which provides improved accessibility and better exportability for resulting tagged PDF (incl. PDF/A) documents * Added functionality to easily add QR codes to documents The bug fixes include: * Text content in tagged PDF documents was sometimes added multiple times. * .Net API did not allow generation of PDF/A documents and always returned an empty log * Under rare circumstances CPU count could not be determined properly 5.0.5812.1 First Hotfix Release of PDFreactor 5 The bug fixes include: * TrueType collections (TTC) could not be used in PDFreactor 5. (#4506) * Version of .NET wrapper DLL was not updated to 5. (#4521) 5.0.5812 First Release of PDFreactor 5 The new features and improvements include: * Request headers and cookies can be specified for all outgoing HTTP connections (allows to pass session IDs to PDFreactor). * Support for HTTP basic and digest authentication. * Automatic font fallback for characters missing in the specified font. * Enhanced PDF merging, allowing PDF overlay and merging of multiple PDF documents. * Rearrange the order of pages and N-up functionality (multiple pages per sheet) allow easy business card and booklet printing. * PDF documents can be digitally signed. * Improved shrink-to-fit and the option to set the pixels per inch. * Log and programmatically process content exceeding its page or parent. * Additional version of PDFreactor that does not have all libraries packaged into one jar. * Option to throw exceptions on license issues. * Option not to embed fonts in generated PDF documents. * Method to retrieve the number of pages of a created document. * Table row page splitting is done correctly when cells span multiple rows. * Support for numerous international numbering systems for lists and counters, including all specified by CSS 2.1 * Support for CSS3 color keywords. * Default styles for HTML5 elements. * Support for "z-index" property for page margin boxes. * Illegal base URL are logged as warnings. * Successfully tested with Java 7 RC. * Improved performance. The changes include: * Included Jetty application server updated to version 7.4.4 The bug fixes include: * Fonts do no longer have to be named in certain ways. (#4438) * Non-embeddable fonts are now ignored. (#3389) * GUI Demo uses fonts identical to PDF conversion process. (#4388) * Page breaks set by "page-break-after" also work for elements enclosed in containers. (#4340) * Perl API wrapper can handle documents including special characters. (#4356) * Page breaks caused by the CSS values "left" and "right" are laid out correctly. (#4337) * "text-indent" is no longer applied to the first line of a page if it is not the first line of a paragraph. (#4148) * Named pages are applied more reliably. (#4379) * Language or keywords no longer missing in some cases. (#4391, #4437) * Running table headers are no longer missing in some cases. (#4145) * The first run inside Weblogic is no longer disproportionately slow. (#4331) 4.1.5102 First Release of PDFreactor 4.1 The new features include: * The CSS 3 property 'word-wrap' is supported. The improvements include: * Layouts are more accurate and space efficient. * Clickable links in inner XHTML are supported. * The CSS property "target-text" works with ":before" and ":after" pseudo elements. The changes include: * License error notices are added as first page. * The available languages for automatic hyphenation have changed (see manual for a complete list of languages including their matching language codes). The bug fixes include: * White spaces directly succeeding footnote calls are handled correctly. * Widths or heights of tables with the style "table-layout: fixed" are computed correctly. * List bullets are no longer placed incorrectly when near a floated box. * Missing resources or illegal names for form fields are logged correctly. * Default host and port are set in Perl API. * The cleanup Tagsoup no longer adds unnecessary attributes to elements. 4.0.4491.1 First Release of PDFreactor 4.0 The new features include: * Creation of ISO 19005-1 Level a (PDF/A-1a) conformant files * Multi-column layouts according to CSS 3 "Multi-column layout" * Footnotes according to CSS 3 "Generated Content for Paged Media" * Setting the PDF page boxes: trim, bleed, media, crop and art * Adding printer marks including trim marks, bleed marks, registration marks and color bars * Support for oversize page formats of the DIN RA and SRA series * Option to save memory when documents reference many or large images * Ability to set colors via the CSS function hsl() The improvements include: * Significantly improved performance of conversion processes, especially for large input documents * Support for styling HTML forms including interactive PDF forms * Form elements adopt their names from the input document * Option to convert color key words to CMYK colors * Improved PDF tagging * Advanced "Create PDF" dialog in GUI Demo The changes include: * CSS cmyk() function changed to accept float values from 0.0 to 1.0 (CSS 3 compliant) * Removed deprecated logging API The bug fixes include: * Improved support for non-Latin characters in non-UTF-8 encoded input documents * Improved support for mixed left-to-right and right-to-left language content * Transparent images are rendered correctly and no longer influence the other colors * Styles for named pages are now prioritized over left and right-hand pages * The property "background-size" with 2 percentage values no longer breaks images in GUI Demo 3.1.3956.2 Maintenance Release of PDFreactor 3.1 The new features include: * Missing font variants (bold, italic) are simulated The improvements include: * Improved compatibility with IBM Java VMs and IBM WebSphere The bug fixes include: * The cleanup "TagSoup" could not be selected in PDFreactor 3.1 * An empty table row group at a page break could cause an exception under rare circumstances 3.1.3956 First Release of PDFreactor 3.1 The new features include: * Further improved support for non-Latin content, i.e. right-to-left and bidirectional layouts and texts (e.g. Hebrew and Arabic), including shaping of Arabic characters. (This feature is experimental) * APIs for direct integration into Perl, Python and Ruby scripts. * The property -ro-counter-set which allows resetting counters from within the content, e.g. resetting the page counter at certain headings. * Support for the last-child pseudo class. * Support for table captions. The improvements include: * Repeated background images have been optimized. * Better naming of PDF bookmarks. * Reduced memory footprint. The bug fixes include: * Owner and user passwords work correctly. * Removed PHP 5 dependent code from PHP wrapper. * Multi-byte characters can be used inside the XHTML() CSS function. * The white-space property also works for inline elements. * Height values expressed in percent are computed correctly and the right fallback mechanisms are used. * The target-counter property also works when no base URL is set. * Removed dependencies that are not available in IBM Java 1.4.2. 3.0.3311 First Maintenance Release of PDFreactor 3.0 The new features include: * Added the SetTimeout method to the .NET API. This method allows to set the timeout in ms for the SOAP web service to answer. Infinite waiting is also possible by setting the timeout to -1. * The PDFreactor WAR file can now be used as-is in any servlet container. * Support for additional list-style-types: box, check, diamond and hyphen. * Added support for the style "font-variant: small-caps". * Added support for the "before" and "after" keywords of the "string-set" property. The improvements include: * Improved vertical alignment, fragment positioning and line height computation. * Improved font detection on Unix-like systems. * Removed dependency to newer versions of the LSSerializer interface. This should solve problems with VMs that have their own (older) versions of the LSSerializer interface in the classpath (such as the IBM JVM 1.4.2). * Functionality enhancement: improved error handling for the PHP API. * Nested counters now function as specified by the CSS 2.1 standard. The bug fixes include: * When two documents containing AcroForms are merged, all form fields are now preserved. * The .NET wrapper is now an assembly with a strong name. * Fixed abort when using JTidy in the IBM JVM. Changes compared to previous versions: * Deprecated PDFreactor 1 LogEvent classes * The "center" element now has the style "text-align: center". 3.0.2995 Release of PDFreactor 3.0 The new features include: * Support for MathML (this feature requires Java 1.5 or higher) * It is now possible to use XHTML in headers and footers * Added SOAP connection interface for the PHP API free of any dependencies to external libraries * All line breaks are now Unicode compliant (incl. multibyte character sets such as Chinese and Japanese) * Added ability to embed flash and other object * Support for named strings * It is now possible to generate cross references using the CSS properties target-counter, target-counters and target-text * Leaders can now be added to your document via the CSS function leader() * It is now possible to dynamically add a table of contents to a document using an XSLT style sheet * Hyphenation support for several languages * Automatic scaling of content to the page size or using a specified scale * Support for setting Viewer Preferences The bug fixes include: * Improved handling of floats: - Floated images were not moved to the next page when they are to high - Text sometimes did not flowed correctly around floating boxes * Incorrect rendering of generated block content upon images *   entities in bookmarks were converted to euro symbols * "overflow: hidden" was applied to inline elements, causing invisible text * Image maps caused problems in layout * @charset entries sometimes caused style sheets to be ignored * Width and height of SVG images were not always correct * In HTML lists, uppercase alphanumeric numbering (ol[type="A"]) was not possible * Invalid characters in attributes aborted PDFreactor Release Notes and Known Issues ------------------------------ * After adding new fonts to your system, you may have to refresh the PDFreactor font cache. See the manual for more information. * After refreshing the font cache from the "Build Font Cache" menu action in the PDFreactor GUI Demo, you have to restart the application so that the changes have an effect. * To get full WYSIWYP on Linux and Mac OS X it might be required to install additional fonts. Please see the Chapter "Fonts" within the PDFreactor manual. * On Mac OS X a bug in the Java VM affection subpixel antialiasing can cause artifacts in the GUI Demo. This does not affect the creation of PDF documents. * The IBM Java VM 1.4.2 has known issues which can lead to the following: - Font variants (bold, italic) cannot be found and have to be simulated. - A sun.io.MalformedInputException is displayed by a system class. (It has no adverse effect on the resulting PDF) Operating Systems Supported --------------------------- * Windows XP/Vista/7 * 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 and AIX, but we don't test on those platforms. Officially Recommended Java VM: ------------------------------- * Sun/Oracle JRE 1.6.0 (provides best performance and supports all features) Other Supported Java VMs: ------------------------- * Sun JRE 1.5.0 * Sun JRE 1.4.2 (note: using MathML requires Java 1.5.0 or higher) The latest updates and service packs should be installed. We have customers using the product in JRockit and IBM JVMs, but we don't test on those platforms. General Requirements & Notes ---------------------------- * Java VM with Java SDK 1.4.2 support or better 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. Software Requirements for the Samples ------------------------------------- To view the PDF documents created by PDFreactor you need a PDF Viewer application. Support ------- For information about technical support please visit http://www.realobjects.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 Copyright (c) 2000-2011, RealObjects GmbH. All rights reserved. info@realobjects.com http://www.realobjects.com