You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@pdfbox.apache.org by ms...@apache.org on 2016/07/18 05:38:50 UTC
pdfbox-docs git commit: PDFBOX-3330: add information about changes in
2.0 to retrieve PDResources
Repository: pdfbox-docs
Updated Branches:
refs/heads/master ef2a0975a -> 9431766e1
PDFBOX-3330: add information about changes in 2.0 to retrieve PDResources
Project: http://git-wip-us.apache.org/repos/asf/pdfbox-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/pdfbox-docs/commit/9431766e
Tree: http://git-wip-us.apache.org/repos/asf/pdfbox-docs/tree/9431766e
Diff: http://git-wip-us.apache.org/repos/asf/pdfbox-docs/diff/9431766e
Branch: refs/heads/master
Commit: 9431766e17de3154eb470ca68bbcd799d4085b2f
Parents: ef2a097
Author: Maruan Sahyoun <sa...@fileaffairs.de>
Authored: Mon Jul 18 07:36:42 2016 +0200
Committer: Maruan Sahyoun <sa...@fileaffairs.de>
Committed: Mon Jul 18 07:36:42 2016 +0200
----------------------------------------------------------------------
content/2.0/migration.md | 25 ++++++++++++++-----------
1 file changed, 14 insertions(+), 11 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/9431766e/content/2.0/migration.md
----------------------------------------------------------------------
diff --git a/content/2.0/migration.md b/content/2.0/migration.md
index d379ba7..ab78005 100644
--- a/content/2.0/migration.md
+++ b/content/2.0/migration.md
@@ -17,14 +17,14 @@ license: Licensed to the Apache Software Foundation (ASF) under one
under the License.
layout: default
-title: PDFBox 2.0.0 Migration Guide
+title: PDFBox 2.0.0 Migration Guide
---
# Migration to PDFBox 2.0.0
## Environment
PDFBox 2.0.0 requires at least Java 6
-
+
## Packages
There are some significant changes to the package structure of PDFBox:
@@ -54,7 +54,7 @@ For PDFBox Preflight
## Breaking Changes to the Library
### Deprecated API calls
-Most deprecated API calls in PDFBox 1.8.x have been removed for PDFBox 2.0.0
+Most deprecated API calls in PDFBox 1.8.x have been removed for PDFBox 2.0.0
### API Changes
The API changes are reflected in the Javadoc for PDFBox 2.0.0. The most notable changes are:
@@ -78,13 +78,16 @@ TrueType fonts shall now be loaded using
PDType0Font.load
~~~
-to leverage that.
+to leverage that.
### PDF Resources Handling
-The individual calls to add resources such as `PDResource.addFont(PDFont font)` and `PDResource.addXObject(PDXObject xobject, String prefix)`
-have been replaced with `PDResource.add(resource type)` where `resource type` represents the different resource classes such as `PDFont`, `PDAbstractPattern`
+The individual calls to add resources such as `PDResources.addFont(PDFont font)` and `PDResources.addXObject(PDXObject xobject, String prefix)`
+have been replaced with `PDResources.add(resource type)` where `resource type` represents the different resource classes such as `PDFont`, `PDAbstractPattern`
and so on. The `add` method now supports all the different type of resources available.
+Instead of returning a `Map` like with `PDResources.getFonts()` or `PDResources.getXObjects()` in 2.0 an `Iterable<COSName>` of references shall be retrieved with `PDResources.getFontNames()` or
+`PDResources.getXObjectNames()`. The individual item can be retrieved with `PDResources.getFont(COSName fontName)` or `PDResources.getXObject(COSName xObjectName)`.
+
### Working with Images
The individual classes `PDJpeg()`, `PDPixelMap()` and `PDCCitt()` to import images have been replaced with `PDImageXObject.createFromFile` which works for JPG, TIFF (only G4 compression), PNG, BMP and GIF.
@@ -106,7 +109,7 @@ parser.parse();
List<Object> tokens = parser.getTokens();
~~~
-With PDFBox 2.0 the code is reduced to
+With PDFBox 2.0 the code is reduced to
~~~java
PDFStreamParser parser = new PDFStreamParser(page);
@@ -134,7 +137,7 @@ PDDocument document = PDDocument.load(new File(pdfFilename));
PDFRenderer pdfRenderer = new PDFRenderer(document);
int pageCounter = 0;
for (PDPage page : document.getPages())
-{
+{
// note that the page number parameter is zero based
BufferedImage bim = pdfRenderer.renderImageWithDPI(pageCounter, 300, ImageType.RGB);
@@ -182,7 +185,7 @@ if (job.printDialog()) {
Advanced use case examples can be found in th examples package under org/apache/pdfbox/examples/printing/Printing.java
### Text Extraction
-In 1.8, to get the text colors, one method was to pass an expanded .properties file to the PDFStripper constructor. To achieve the same
+In 1.8, to get the text colors, one method was to pass an expanded .properties file to the PDFStripper constructor. To achieve the same
in PDFBox 2.0 you can extend ``PDFTextStripper``and add the following ``Operators`` to the constructor:
~~~java
@@ -202,7 +205,7 @@ addOperator(new SetNonStrokingColorN());
### Interactive Forms
Large parts of the support for interactive forms (AcroForms) have been rewritten. The most notable change from 1.8.x is that
-there is a clear distinction between fields and the annotations representing them visually. Intermediate nodes in a field
+there is a clear distinction between fields and the annotations representing them visually. Intermediate nodes in a field
tree are now represented by the `PDNonTerminalField` class.
With PDFBox 2.0.0 the prefered way to iterate through the fields is now
@@ -242,4 +245,4 @@ these would be encoded as hex 0, 1 and 2, so you won't find "abc". Additionally,
You could also have problems with ligatures, e.g. "ff", "fl", "fi", "ffi", "ffl", which can be represented by a single code in many fonts.
To understand this yourself, view any file with PDFDebugger and have a look at the "Contents" entry of a page.
-See also https://stackoverflow.com/questions/35420609/pdfbox-2-0-rc3-find-and-replace-text
\ No newline at end of file
+See also https://stackoverflow.com/questions/35420609/pdfbox-2-0-rc3-find-and-replace-text