ICEpdf is a pure Java PDF document rendering and viewing solution. ICEpdf can parse and render documents based on the latest PDF standards (Portable Document Format v1.6/Adobe® Acrobat® 7).
ICEpdf is a community-driven project with the goal of supporting and enhancing the ICEpdf library.
ICEpdf is an open source project and is always looking for more contributors. To get involved, visit:
Whether you are long time user of the API or a new user, there ton of information on the Wiki pages. Create a pull requests and use the issue tracker, the more help and feedback we get the better we can make the project.
<dependency>
<groupId>com.github.pcorless.icepdf</groupId>
<artifactId>icepdf-core</artifactId>
<version>7.1.3</version>
</dependency>
<dependency>
<groupId>com.github.pcorless.icepdf</groupId>
<artifactId>icepdf-viewer</artifactId>
<version>7.1.3</version>
</dependency>
To get a local copy of the current code, clone it using git:
$ git clone https://github.com/pcorless/icepdf.git
$ cd icepdf
In order to use the library you need to build at least the Core library and if you intend you use the Viewer component you'll also need to build the Viewer library. The project can be built with Gradle or Maven, we have no preference, pick one that makes you happier.
Builds as they are currently configured to target Java 11.
# core module
~$ mvn -pl :icepdf-core package
# viewer module, -am insures dependencies are build
~$ mvn -pl :icepdf-viewer -am package
# Viewer jar with all dependences in one self executing jar
~$ mvn -pl :icepdf-viewer -am package -P assembly
# examples module, -am insures dependencies are build
~$ mvn -pl :png-capture -am package
# or with full group id.
~$ mvn -pl org.icepdf.examples:png-capture -am package
~$ java -jar icepdf-viewer-7.0.0-SNAPSHOT-jar-with-dependencies.jar
# Whole project hierarchy can be built with or with full group id.
~$ mvn package
Build the core jar using the following Gradle command
~$ gradle :core:core-awt:assemble
Build the viewer jar using the following Gradle command
~$ gradle :viewer:viewer-awt:assemble
Build the annotation creation example using the following Gradle command
~$ gradle :examples:annotation:creation:assemble
Build the distribution zip and tar archives
# defaultTasks allows for a call to just gradle
~$ gradle
# or one can use the full task list
~$ gradle projectReport, sourcesJar, genPomFileForCoreJarPub, genPomFileForViewerJarPub, osDistZip, osDistTar
The org.icepdf.core.ri.common.SwingController
class provides convenience methods for the most common UI actions,
such as rotating the document, setting the zoom level, etc. The org.icepdf.core.ri.common.SwingViewBuilder
class is
responsible for creating the PDF Viewer component panel populated with Swing components configured to work with the
SwingController.
When using the SwingViewBuilder and SwingController classes, it is usually not necessary to use the Document object directly. The SwingController class does this for you.
The following code snippet illustrates how to build a PDF Viewer component:
String filePath = "somefilepath/myfile.pdf";
// build a controller
SwingController controller = new SwingController();
// Build a SwingViewFactory configured with the controller
SwingViewBuilder factory = new SwingViewBuilder(controller);
// Use the factory to build a JPanel that is pre-configured
//with a complete, active Viewer UI.
JPanel viewerComponentPanel = factory.buildViewerPanel();
// add copy keyboard command
ComponentKeyBinding.install(controller, viewerComponentPanel);
// add interactive mouse link annotation support via callback
controller.getDocumentViewController().setAnnotationCallback(
new org.icepdf.ri.common.MyAnnotationCallback(
controller.getDocumentViewController()));
// Create a JFrame to display the panel in
JFrame window = new JFrame("Using the Viewer Component");
window.getContentPane().add(viewerComponentPanel);
window.pack();
window.setVisible(true);
// Open a PDF document to view
controller.openDocument(filePath);
The Document class provides functionality for rendering PDF content into other formats via a Java2D graphics context. As a result, rendering PDF content to other formats is a relatively simple process with very powerful results. ICEpdf also supports Java headless mode when rending PDF content, which can be useful for server side solutions.
Examples of extraction techniques like png, svg, and tiff can be found examples/capture folder. The following is an example of how to save page captures in an SVG format
String filePath = "somefilepath/myfile.pdf";
Document document = new Document();
document.setFile(filePath);
// Get a DOMImplementation
DOMImplementation domImpl = GenericDOMImplementation.getDOMImplementation();
// Create an instance of org.w3c.dom.Document
org.w3c.dom.Document svgDocument = domImpl.createDocument(null,"svg",null);
// Create an instance of the SVG Generator
SVGGraphics2D svgGenerator = new SVGGraphics2D(svgDocument);
float userRotation = 0;
float userZoom = 1;
int pageNumber = 0;
PDimension pdfDimension=document.getPageDimension(pageNumber,userRotation,userZoom);
svgGenerator.setSVGCanvasSize(pdfDimension.toDimension());
// paint the page to the Batik svgGenerator graphics context.
document.paintPage(pageNumber,svgGenerator,
GraphicsRenderingHints.PRINT,
Page.BOUNDARY_CROPBOX,
userRotation,
userZoom);
File file = new File("svgCapture_"+pageNumber+".svg");
// Finally, stream the SVG using UTF-8character byte encoding
Writer fileWriter = new OutputStreamWriter(new FileOutputStream(file),StandardCharsets.UTF_8);
// Enable SVG CSS style attribute
boolean SVG_CSS = true;
svgGenerator.stream(fileWriter,SVG_CSS);
Make sure to take a look at the Wiki for more examples of extracting content.
There are a bunch of examples located in the root of the project grouped by common usage scenarios. Similarly, the Wiki contains example information.
Both the Gradle and Maven builds will generate the API documentation for the Core and Viewer libraries.