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
/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
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.
3.0.2994 Release of PDFreactor 3.0
The new features include:
The bug fixes include:
2.0.1823b Second Maintenance Release of PDFreactor 2.0
The new features include:
The bug fixes include:
2.0.1544.3 Maintenance Release of PDFreactor 2.0
The bug fixes include:
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:
<html>
<head>
<style>
object[type="image/tiff"] {
-ro-replacedelement: "com.realobjects.xml.formatters.PDFImageFormatter";
-ro-source: attr(data);
}
</style>
</head>
<body>
<object alt="PDFreactor logo CMYK"
data="PRlogoCMYK.tif"
type="image/tiff"
style="height: 3cm;
border: 1px dashed red" />
<br />
<object alt="PDFreactor logo CMYK"
data="PRlogoCMYK.tif"
type="image/tiff"
style="border: 1px dashed green" />
</body>
</html>
2.0.1544 Release of PDFreactor 2.0
The new features include:
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:
1.1.936.7 Second Maintenance Release of PDFreactor 1.1
The bug fixes include:
1.1.936.5 Maintenance Release of PDFreactor 1.1
1.1.936 Release of PDFreactor 1.1
The new features include:
The bug fixes include:
1.0.882 Service release of PDFreactor 1.0
The changes include:
The methods
int getRestrictions(void)were removed. To set/get the PDF restrictions, please use the indivdual API methods.
void setRestrictions(int)
The methods
String getUserStyleSheet(void)were removed. They were replaced by
void setUserStyleSheet(String)
ArrayList getUserStyleSheetUrls(void)
void addUserStyleSheetUrl(String)
void addUserStyleSheetUrl(ArrayList)
void addUserStyleSheetUrl(String[])
void setUserStyleSheetUrl(ArrayList)
void addUserStyleSheet(org.w3c.css.sac.InputSource)which provide the same funcionality, but offer more flexibility.
void removeAllUserStyleSheets(void)
ArrayList getAllUserStyleSheets(void)
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:
1.0.800 First public release of PDFreactor
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.
The latest updates and servicepacks should be installed
The hardware requirements depend on the complexity and size of the processed documents.
To view the PDF documents created by PDFreactor you need a PDF Viewer application.
For information about technical support please visit http://www.realobjects.com/support or contact support@realobects.com
PDFreactor is a registered trademark of RealObjects GmbH, Saarbruecken.
Please see the NOTICE.txt file in the /license subdirectory
Copyright (c) 2000-2008, RealObjects GmbH.
All rights reserved.