PDF Clown for Java

PDF Clown Project >

Project version: 0.1.2 - README revision: 0 (2013-02-04)

Table of Contents

Introduction
Copyright
License
Disclaimer
Dependencies
Getting started
Eclipse IDE
Resources

Introduction

This is the Java source code distribution of PDF Clown, a general-purpose library for the manipulation of PDF files.

Copyright

Copyright © 2006-2013 Stefano Chizzolini

Contacts:

License

This program is free software; you can redistribute it and/or modify it under the terms of version 3 of the GNU Lesser General Public License as published by the Free Software Foundation.

References:

Disclaimer

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

IN NO EVENT SHALL THE COPYRIGHT HOLDER AND CONTRIBUTORS BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE, EVEN IF THE COPYRIGHT HOLDER AND CONTRIBUTORS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

THE SOFTWARE PROVIDED HEREIN IS ON AN "AS IS" BASIS, AND THE COPYRIGHT HOLDER AND CONTRIBUTORS HAVE NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS. THE COPYRIGHT HOLDER AND CONTRIBUTORS MAKE NO REPRESENTATIONS AND EXTEND NO WARRANTIES OF ANY KIND, EITHER IMPLIED OR EXPRESS, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, OR THAT THE USE OF THE SOFTWARE WILL NOT INFRINGE ANY PATENT, TRADEMARK OR OTHER RIGHTS.

Dependencies

PDF Clown for Java currently depends on:

Getting started

Eclipse IDE

The code projects of PDF Clown for Java have been configured to run for debugging under the Eclipse IDE. They have been tested under Helios (3.6) on both GNU/Linux (Ubuntu) 2.6.32+ and MS Windows NT 5.1+ systems.

In order to work under the Eclipse IDE, you have simply to follow these steps:

  1. launch Eclipse;
  2. select the workspace: on "Select a workspace" dialog, browse to "java" subdirectory and click "OK";
  3. import the projects:
    1. on workbench window, select "File" > "Import..." menu to open the "Import" wizard;
    2. in the "Select" page, select the import source "General" > "Existing Projects into Workspace", then click "Next";
    3. in the "Import Projects" page, browse for "Select root directory" and confirm "java" subdirectory (it should be proposed as default by the folder browser dialog). Now all the available projects should have appeared (and been checked) in the "Projects" list;
    4. click "Finish";
  4. verify Eclipse configuration:
    • text editor encoding MUST be set to "UTF-8" in order to properly deal with Unicode text: open the "Preferences" window (select "Window" > "Preferences" menu), select "General" > "Workspace", then choose "UTF-8" ("Other" option) for "Text file encoding".

When the import completes, all the projects will be available in your workbench (switch to the "Java" perspective to see them represented within the "Project Explorer" view). The following resources have been configured to ease your compiling and debugging activities:

  • Ant build files: each project features an Ant build file that has already been integrated into Eclipse's automatic building workflow;
  • launchers: each sample project (specifically: pdfclown.samples.cli, pdfclown.samples.gui) features also a ready-to-use launcher you can run for debugging this way:
    1. open the "Debug Configurations" window: right-click on a sample project's node (e.g. "pdfclown.samples.cli") in "Project Explorer" view, then select the contextual menu "Debug As" > "Debug Configurations...";
    2. select a sample project's launcher: select "Java Application" > one of the available sample project launchers (e.g. "PDF Clown CLI Samples");
    3. run the selected launcher: click "Debug".

Resources