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:39:20 UTC
pdfbox-docs git commit: Site checkin for project Apache PDFBox Website
Repository: pdfbox-docs
Updated Branches:
refs/heads/asf-site 3aa32c870 -> f74750dc2
Site checkin for project Apache PDFBox Website
Project: http://git-wip-us.apache.org/repos/asf/pdfbox-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/pdfbox-docs/commit/f74750dc
Tree: http://git-wip-us.apache.org/repos/asf/pdfbox-docs/tree/f74750dc
Diff: http://git-wip-us.apache.org/repos/asf/pdfbox-docs/diff/f74750dc
Branch: refs/heads/asf-site
Commit: f74750dc2578fec03837f575dca8ae946d5d5779
Parents: 3aa32c8
Author: Maruan Sahyoun <sa...@fileaffairs.de>
Authored: Mon Jul 18 07:39:15 2016 +0200
Committer: Maruan Sahyoun <sa...@fileaffairs.de>
Committed: Mon Jul 18 07:39:15 2016 +0200
----------------------------------------------------------------------
content/2.0/migration.html | 13 ++++++++-----
1 file changed, 8 insertions(+), 5 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/f74750dc/content/2.0/migration.html
----------------------------------------------------------------------
diff --git a/content/2.0/migration.html b/content/2.0/migration.html
index 2645b33..c2a7b86 100644
--- a/content/2.0/migration.html
+++ b/content/2.0/migration.html
@@ -201,10 +201,13 @@ results when switching to PDFBox 2.0.0.</p>
<p>to leverage that.</p>
<h3 id="pdf-resources-handling">PDF Resources Handling</h3>
-<p>The individual calls to add resources such as <code class="highlighter-rouge">PDResource.addFont(PDFont font)</code> and <code class="highlighter-rouge">PDResource.addXObject(PDXObject xobject, String prefix)</code>
-have been replaced with <code class="highlighter-rouge">PDResource.add(resource type)</code> where <code class="highlighter-rouge">resource type</code> represents the different resource classes such as <code class="highlighter-rouge">PDFont</code>, <code class="highlighter-rouge">PDAbstractPattern</code>
+<p>The individual calls to add resources such as <code class="highlighter-rouge">PDResources.addFont(PDFont font)</code> and <code class="highlighter-rouge">PDResources.addXObject(PDXObject xobject, String prefix)</code>
+have been replaced with <code class="highlighter-rouge">PDResources.add(resource type)</code> where <code class="highlighter-rouge">resource type</code> represents the different resource classes such as <code class="highlighter-rouge">PDFont</code>, <code class="highlighter-rouge">PDAbstractPattern</code>
and so on. The <code class="highlighter-rouge">add</code> method now supports all the different type of resources available.</p>
+<p>Instead of returning a <code class="highlighter-rouge">Map</code> like with <code class="highlighter-rouge">PDResources.getFonts()</code> or <code class="highlighter-rouge">PDResources.getXObjects()</code> in 2.0 an <code class="highlighter-rouge">Iterable<COSName></code> of references shall be retrieved with <code class="highlighter-rouge">PDResources.getFontNames()</code> or
+<code class="highlighter-rouge">PDResources.getXObjectNames()</code>. The individual item can be retrieved with <code class="highlighter-rouge">PDResources.getFont(COSName fontName)</code> or <code class="highlighter-rouge">PDResources.getXObject(COSName xObjectName)</code>.</p>
+
<h3 id="working-with-images">Working with Images</h3>
<p>The individual classes <code class="highlighter-rouge">PDJpeg()</code>, <code class="highlighter-rouge">PDPixelMap()</code> and <code class="highlighter-rouge">PDCCitt()</code> to import images have been replaced with <code class="highlighter-rouge">PDImageXObject.createFromFile</code> which works for JPG, TIFF (only G4 compression), PNG, BMP and GIF.</p>
@@ -255,7 +258,7 @@ and so on. The <code class="highlighter-rouge">add</code> method now supports al
<span class="n">PDFRenderer</span> <span class="n">pdfRenderer</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PDFRenderer</span><span class="o">(</span><span class="n">document</span><span class="o">);</span>
<span class="kt">int</span> <span class="n">pageCounter</span> <span class="o">=</span> <span class="mi">0</span><span class="o">;</span>
<span class="k">for</span> <span class="o">(</span><span class="n">PDPage</span> <span class="n">page</span> <span class="o">:</span> <span class="n">document</span><span class="o">.</span><span class="na">getPages</span><span class="o">())</span>
-<span class="o">{</span>
+<span class="o">{</span>
<span class="c1">// note that the page number parameter is zero based</span>
<span class="n">BufferedImage</span> <span class="n">bim</span> <span class="o">=</span> <span class="n">pdfRenderer</span><span class="o">.</span><span class="na">renderImageWithDPI</span><span class="o">(</span><span class="n">pageCounter</span><span class="o">,</span> <span class="mi">300</span><span class="o">,</span> <span class="n">ImageType</span><span class="o">.</span><span class="na">RGB</span><span class="o">);</span>
@@ -306,7 +309,7 @@ https://bugs.openjdk.java.net/browse/JDK-8041125</p>
<p>Advanced use case examples can be found in th examples package under org/apache/pdfbox/examples/printing/Printing.java</p>
<h3 id="text-extraction">Text Extraction</h3>
-<p>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
+<p>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 <code class="highlighter-rouge">PDFTextStripper</code>and add the following <code class="highlighter-rouge">Operators</code> to the constructor:</p>
<div class="highlighter-rouge"><pre class="highlight"><code><span class="n">addOperator</span><span class="o">(</span><span class="k">new</span> <span class="n">SetStrokingColorSpace</span><span class="o">());</span>
@@ -326,7 +329,7 @@ in PDFBox 2.0 you can extend <code class="highlighter-rouge">PDFTextStripper</co
<h3 id="interactive-forms">Interactive Forms</h3>
<p>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 <code class="highlighter-rouge">PDNonTerminalField</code> class.</p>
<p>With PDFBox 2.0.0 the prefered way to iterate through the fields is now</p>