=================================================== PDFreactor(R) by RealObjects Version 3.0.3311, 2008-07-07 =================================================== 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 libraries. 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 in every page and evaluation notice pages every few pages in 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 libraries. 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 libraries. /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 and make sure the ROClient.class.php resides in the same directory as the PDFreactor.class.php file. /jetty Java Application server required to run the PDFreactor webservice which is used by the .NET and PHP wrapper APIs Upgrading to PDFreactor 3 from PDFreactor 2 ------------------------------------------- Updating to PDFreactor 3 is easy. This new release is binary compatible with PDFreactor 2 releases. In general, it is not 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 2 license key is not compatible with PDFreactor 3 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 --------------- 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 2.0.1823b Second Maintenance Release of PDFreactor 2.0 The new features include: * Support for images improved: - Support for TIFF images incl. CMYK - TIFF and SVG supported in IMG tags, background and generated content - Improved image quality: direct embedding of images without JPEG recompression * Additional encoding UTF-16LE now supported The bug fixes include: * Improved layout of tables spanning multiple pages * Improved layout of nested tables * Fixed handling of the @page:first selector * Fixed page counter for merged documents * Fixed support for bottom property of absolutely positioned elements 2.0.1544.3 Maintenance Release of PDFreactor 2.0 The bug fixes include: * margin-left: auto; margin-right: auto did not work to center tables * Too much spacing between words in last line of paragraph whith text-align: justify; The new features include: * Initial support for CMYK images (TIFF, JPG, PNG) CMYK tiff images can be used by adding this to your style sheet: object[type="image/tiff"] { -ro-replacedelement: "com.realobjects.xml.formatters.PDFImageFormatter"; -ro-source: attr(data); } This is a sample HTML document, showing how to embedd TIFF images:
2.0.1544 Release of PDFreactor 2.0 The new features include: * New high-performance .NET and PHP APIs (require local Jetty server with PDFreactor webservice) * Complete support for HTML form elements * AcroForms support * Support for EAN-128, DataMatrix 2D and PDF417 2D barcodes * Support for XML namespace CSS selectors * DATA URIs supported for images * Tagged PDF support * Images in generated content (page margin boxes and in-flow) * Resizing of background images supported (based on CSS3 draft, property backround-size ) * CYMK color support (e.g. color: CMYK(65%,20%,0%,0%) ), CMYK images are not yet supported * Improved error reporting in CSS parser * Reduced memory footprint * Added "Save as" option to GUI demo Important: Java API Changes in PDFreactor version 2.0 You have to adjust your integration of PDFreactor, otherwise run-time errors will occur. The main change of the PDFreactor 2.0 API when compared to the PDFreactor 1.0 API is that the PDFreactorConfiguration class does not exist anymore. While you had to create a PDFreactorConfiguration object in version 1.0 to set specific PDFreactor settings, this is no longer necessary. All methods that were part of the PDFreactorConfiguration class can now directly be called within the PDFreactor class. To illustrate this difference, here is a code sample which shows how to set the PDF Author tag in PDFreactor 1.x and version 2.0. Old (Version 1.x): PDFreactor pdfReactor = new PDFreactor(); PDFreactorConfiguration pdfReactorConfiguration = new PDFreactorConfiguration(); // In version 1.x, configurations settings are still specified using methods of PDFreactorConfiguration. pdfReactorConfiguration.setAuthor("Peter Sampler"); InputSource is = new InputSource("http://www.realobjects.com/"); FileOutputStream fileOutputStream = new FileOutputStream("realobjects.pdf"); pdfReactor.renderDocument(is,pdfReactorConfiguration,fileOutputStream); fileOutputStream.close(); New (Version 2.0): PDFreactor pdfReactor = new PDFreactor(); // In version 2.0, configuration settings are specified directly using methods of PDFreactor. pdfReactor.setAuthor("Peter Sampler"); InputSource is = new InputSource("http://www.realobjects.com/"); FileOutputStream fileOutputStream = new FileOutputStream("realobjects.pdf"); pdfReactor.renderDocument(is,fileOutputStream); fileOutputStream.close(); As you can see, upgrading your integration to use the new API of PDFreactor version 2.0 is really simple. Just make sure all calls to PDFreactorConfiguration objects are replaced by calls to PDFreactor objects. Also remove the PDFreactorConfiguration parameter from the renderDocument call. Additional new API methods have been introduced with PDFreactor 2.0, but this should have no effect on your integration. Also, some API methods are now deprecated and should no longer be used. For details about the API changes, please refer to the PDFreactor API documentation. The bug fixes include: * setBaseURL did not work for external stylesheets * "page-break-inside-avoid" was ignored for tables * Layout error occured when splitting certain tables * min-height did not always work * Document resources with an absolute URL could not be loaded if no base URL is available * Empty links caused PDFreactor to abort 1.1.936.7 Second Maintenance Release of PDFreactor 1.1 The bug fixes include: * Exception when running PDFreactor in IBM JVM * Toolbar looked strange in Sun JRE Version 1.5.0_08 1.1.936.5 Maintenance Release of PDFreactor 1.1 * Significantly improved the performance with documents containing float elements 1.1.936 Release of PDFreactor 1.1 The new features include: * Added an API method to concatenate the newly rendered PDF content with an existing PDF * Added ASP and ASP.NET samples The bug fixes include: * Pagecounters sample code in manual is wrong * td height attribute does not work * Using the stdin option doesn't work in the CLI * The number of runs parameter has no effect in the CLI * Certain documents rendered too slowly * Bookmarks are not generated under certain circumstances * Pages containing log data are generated with a wrong dpi value * Improved support for the line-height property 1.0.882 Service release of PDFreactor 1.0 The changes include: * Added information in the manual about the defition of bitmap images * CLI version now returns error exit codes * Changes in the PDFreactorConfiguration class to improve API consistency: * The methods int getRestrictions(void) void setRestrictions(int) were removed. To set/get the PDF restrictions, please use the indivdual API methods. The methods String getUserStyleSheet(void) void setUserStyleSheet(String) ArrayList getUserStyleSheetUrls(void) void addUserStyleSheetUrl(String) void addUserStyleSheetUrl(ArrayList) void addUserStyleSheetUrl(String[]) void setUserStyleSheetUrl(ArrayList) were removed. They were replaced by void addUserStyleSheet(org.w3c.css.sac.InputSource) void removeAllUserStyleSheets(void) ArrayList getAllUserStyleSheets(void) which provide the same funcionality, but offer more flexibility. If you were using the removed API methods, please change your code to use the new methods. E.g. to add a user style sheet from a URL, the old code was: myConfig.addUserStyleSheetURL("http://test/mystyle.css"); The new code is: myConfig.addUserStyleSheet( new org.w3c.css.sac.InputSource( "http://test/mystyle.css" )); The bug fixes include: * Absolute positioning does not work in paged mode and for bottom position * The height and width properties should not apply to non-replaced inline-level elements * Width/height of replaced elements does not fall back to intrinsic size if the containing block's height is not set explicitly * Inline text containing surrounding area is sometimes positioned wrong if line breaks occur * Curly braces (" { } ") in path of xml-file crash SACParser * If inline text content extends over element borders no linebreaks should be inserted. * "%" in path causes exception * Local dtd files are not loaded using the catalog resolver * PDF encryption does not work * XSLT doesn't work in CLI 1.0.800 First public release of 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, esp. in Linux, it might be required to install additional fonts. Please see the Chapter "Fonts" within the PDFreactor manual. Operating Systems Supported --------------------------- * Windows XP * Windows 2003 Server * Windows Vista * Linux * Solaris * Mac OS X The latest updates and service packs should be installed. We have customers using the product in HP/UX and AIX, but we don't test on those platforms. Officially Recommended Java VM: ------------------------------- * Sun JRE 1.6.0 Other Supported Java VMs: ------------------------- * Sun JRE 1.4.2 (note: using MathML requires Java 1.5.0 or higher) * Sun JRE 1.5.0 The latest updates and servicepacks should be installed 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@realobects.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-2008, RealObjects GmbH. All rights reserved. info@realobjects.com http://www.realobjects.com