Gnostice PDFOne (for Java™)

© 2002-2011 Gnostice Information Technologies Private Limited

Contents

  1. Introduction
  2. Getting Started
  3. Activate the PDFOne license
  4. Known Issues / Limitations / Changes
  5. Ordering the Professional version

Introduction

Gnostice PDFOne is a PDF document creation, transformation and management library for Java developers. PDFOne can create and manage PDF documents from within application programs and web services. PDFOne supports creating, filling and reading of PDF forms, compressing, securing, appending and merging of multiple PDF documents, stamping, managing bookmarks, creating tables, creating and reading PDF annotations and much more. PDFOne operates on existing PDF documents and can even create new ones from scratch. For detailed features please visit www.gnostice.com/PDFOne_Java.asp.

This README file contains late-breaking information that may not be contained anywhere else. The README file also contains information on where to start and get access to additional resources to get the best out of Gnostice PDFOne. We strongly recommend that you read this README file before you get started.

Getting Started

Extract the downloaded zip file (pdfonej_*.zip) to the desired location. The following files/folders should get extracted:

Content Type Description
bin Directory Contains PDFOne.jar and other executables
docs Directory Contains documentation
GettingStarted Directory Contains Getting Started Tutorials
Demos Directory Contains code samples, viewer application demo and viewer applet demo
license.html File Contains licensing information.
history.html File Contains release history
readme.html File Contains important and late-breaking information

NOTE: At present user system properties (e.g. CLASSPATH) are not updated automatically. Hence to start using PDFOne.jar follow one of these instructions based on the project need.

  1. For console based projects, to compile, set CLASSPATH manually to the location where PDFOne.jar is located.
  2. For IDE based projects, to compile, add a reference to PDFOne.jar in your project. This is an IDE dependent action. Please refer to IDE manual/help to know how to add external JAR.

Activate the PDFOne license

To activate PDFOne (PDFOne.jar) in your applications, include the following method from the class com.gnostice.pdfone.PDFOne in your main classes. By activating the product, you can remove trial marks in output documents, and viewing and printing components.

static {
 PDFOne.activate("your authorization key", "your product key");
}

Please use the license keys you received after ordering from the Gnostice online store.

Known Issues / Limitations / Changes

The following are a list of features or functionalities that were changed, not supported or have limitations in this release of PDFOne.

  1. Only TrueType fonts (.TTF) can be embedded in PDF file.
  2. Right-to-Left language texts are not supported.
  3. Annotations and Formfields may not appear on rotated pages.
  4. Opening and Printing document after saving (with setOpenAfterSave and setPrintAfterSave method call) may not work as expected on some Operating Systems.
  5. Call to extractPagesTo, appendPagesFrom and insertPagesFrom methods, removes all page level actions, link annotation actions and form fields actions.
  6. Addition of new actions, when reading a document, removes all existing page level actions.
  7. Named tree merging is not implemented.
  8. Addition of same instance of annotation list to multiple pages having inconsistent measurement units shows unexpected behavior.
  9. Viewer and printer do not support the following features:
  10. Viewer performance may become slow if a large number of pages are set to be viewed in a single screen.
  11. If you load a digitally signed document and make changes to it, the existing signature(s) will become invalid. This is because support for incrementally updating a document is not yet available. You may, if you wish, call the PdfDocument.removeAllSignature() method (which removes all existing signatures) and then sign the document to keep the modified document free of any invalidated signatures.
  12. Content assist in eclipse IDE does not show argument names for methods as source is not included. Follow this link for more info https://bugs.eclipse.org/bugs/show_bug.cgi?id=28426.

Ordering the Professional edition

To use advanced features of PDFOne, buy the Professional edition from our Secure Online Store (links available on our buy page.) Special pricing and volume discounts are available.

Gnostice PDFOne Professional is delivered electronically. As soon as your payment is authorized, you will receive an email with details on how to get access to the Professional edition. IMPORTANT: When you make your order, please make sure the email address you have provide is valid and active.

Gnostice PDFOne is also available for OEM Licensing. Please send your enquiries about OEM licensing to sales@gnostice.com.


Copyright © 2002-2011 Gnostice Information Technologies Private Limited. All rights reserved. All Gnostice brand and product names are trademarks or registered trademarks of Gnostice Information Technologies Private Limited. All other names and trademarks are the property of their respective owners.