-
-
Notifications
You must be signed in to change notification settings - Fork 24
Home
As legend has it the initial implementation of the library came out of Italy and was originally named pdfGo. At the time there was a popular embedded web browser that had a plug-in API and a need to view PDF documents. One acquisition later pdfGo became ICEpdf and a couple of months afterwards the version 1.0.0 was released. The closed source version of ICEpdf slowly gained adoption but in 2009 a good portion of the library was made open source and a small community was built around it...
Give or take another 15 years and things changed again. The library found a new home on GitHub as just icepdf (all lowercase). A lot of things have changed, but the intent is still the same. Provide a pure Java solution to rendering and viewing PDF documents.
Issues are created to help identify and define a bug, improvement or a new feature. The issue tracking system is designed to track one specific subject, so please don’t overfill a single issue, create another one to keep the ratio 1:1. There is an old saying “you get more with honey than vinegar”, please be as friendly and constructive as possible when creating a new issue. I support and add to this library in my spare time because I like doing it, I'd hate for that to change.
Issues that are related to the rendering of a single PDF files almost always need a sample file to be submitted with the issue. There are a few exceptions were logging can shed light on the issue but to iterate we almost always need the file question to solve the issue. But if you have a nice logging exception make sure to include it too.
Please be careful when uploading a PDF file to the issue tracker with sensitive information. Many PDF files have financial or patient health information so please, pretty please, double pretty please, make sure you are not uploading anything the internet that cannot be remember forever.
Lastly make sure to search existing issues before creating a new issue and make sure to read to Wiki for more information on getting started and the many different ways to configure the library.
Officially we support OpenJDK 11 but the library can be compiled with most other JVM distributions. See comments in the Gradle build scripts if you need support for modules.
I sample file is generally needed for most issues but in some cases uploading the file to a public forum isn't possible. In such cases enable 'finest' level debugging and append the logs to the issue tracker. Keep in mind even logs can have sensitive data so make sure to scrub the logs for patient names or other sensitive data. Email me privately and I'm sure something can be worked out.
Yes and no, this library is based on the last published version of the open sourced version of icepdf from ICEsoft. I've spend the better part of 5 years making the library 100% open sourced and have added a bunch of new features to keep the library modern and rending PDF documents as accurately as possible. I was the principle developer on the original project and have always enjoyed working with the library and feel there is still lot of potential for the library.