svn commit: r969077 - in /websites/staging/pdfbox/trunk/content: ./ 2.0/migration.html

[bu...@apache.org]

Author: buildbot
Date: Thu Oct 15 20:13:11 2015
New Revision: 969077

Log:
Staging update by buildbot for pdfbox

Modified:
    websites/staging/pdfbox/trunk/content/   (props changed)
    websites/staging/pdfbox/trunk/content/2.0/migration.html

Propchange: websites/staging/pdfbox/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu Oct 15 20:13:11 2015
@@ -1 +1 @@
-1708875
+1708885

Modified: websites/staging/pdfbox/trunk/content/2.0/migration.html
==============================================================================
--- websites/staging/pdfbox/trunk/content/2.0/migration.html (original)
+++ websites/staging/pdfbox/trunk/content/2.0/migration.html Thu Oct 15 20:13:11 2015
@@ -186,15 +186,19 @@ h2:hover > .headerlink, h3:hover > .head
 <h3 id="deprecated-api-calls">Deprecated API calls<a class="headerlink" href="#deprecated-api-calls" title="Permanent link">&para;</a></h3>
 <p>Most deprecated API calls in PDFBox 1.8.x have been removed for PDFBox 2.0.0 </p>
 <h3 id="api-changes">API Changes<a class="headerlink" href="#api-changes" title="Permanent link">&para;</a></h3>
-<p>The API changes are reflected in the Javadoc for PDFBox 2.0.0. Most notably <code>getCOSDictionary()</code> is no longer used. Instead
-<code>getCOSObject</code> now returns the matching <code>COSBase</code> subtype. </p>
+<p>The API changes are reflected in the Javadoc for PDFBox 2.0.0. The most notable changes are:</p>
+<ul>
+<li><code>getCOSDictionary()</code> is no longer used. Instead <code>getCOSObject</code> now returns the matching <code>COSBase</code> subtype.</li>
+<li><code>PDXObjectForm</code> was renamed to <code>PDFormXObject</code>  </li>
+<li><code>PDXObjectImage</code> was renamed to <code>PDImageXObject</code></li>
+</ul>
 <h3 id="general-behaviour">General Behaviour<a class="headerlink" href="#general-behaviour" title="Permanent link">&para;</a></h3>
 <p>PDFBox 2.0.0 is now parsing PDF files following the Xref information in the PDF. This is similar to the functionality using
 <code>PDDocument.loadNonSeq</code> with PDFBox 1.8.x. Users still using <code>PDDocument.load</code> with PDFBox 1.8.x might experience different
 results when switching to PDFBox 2.0.0.</p>
 <h3 id="iterating-pages">Iterating Pages<a class="headerlink" href="#iterating-pages" title="Permanent link">&para;</a></h3>
 <p>With PDFBox 2.0.0 the prefered way to iterate through the pages of a document is</p>
-<div class="codehilite"><pre><span class="k">for</span><span class="p">(</span><span class="n">PDPage</span> <span class="n">page</span> <span class="p">:</span> <span class="n">doc</span><span class="p">.</span><span class="n">getPages</span><span class="p">())</span>
+<div class="codehilite"><pre><span class="k">for</span><span class="p">(</span><span class="n">PDPage</span> <span class="n">page</span> <span class="p">:</span> <span class="n">document</span><span class="p">.</span><span class="n">getPages</span><span class="p">())</span>
 <span class="p">{</span>
  <span class="p">...</span> <span class="p">(</span><span class="n">do</span> <span class="n">something</span><span class="p">)</span>
 <span class="p">}</span>
@@ -202,6 +206,21 @@ results when switching to PDFBox 2.0.0.<
 
 
 <h3 id="pdf-rendering">PDF Rendering<a class="headerlink" href="#pdf-rendering" title="Permanent link">&para;</a></h3>
+<p>With PDFBox 2.0.0 <code>PDPage.convertToImage</code>has been removed. Instead the new <code>PDFRenderer</code> class shall be used.</p>
+<div class="codehilite"><pre><span class="n">PDDocument</span> <span class="n">document</span> <span class="p">=</span> <span class="n">PDDocument</span><span class="p">.</span><span class="n">load</span><span class="p">(</span><span class="n">new</span> <span class="n">File</span><span class="p">(</span><span class="n">pdfFilename</span><span class="p">));</span>
+<span class="n">PDFRenderer</span> <span class="n">pdfRenderer</span> <span class="p">=</span> <span class="n">new</span> <span class="n">PDFRenderer</span><span class="p">(</span><span class="n">document</span><span class="p">);</span>
+<span class="n">int</span> <span class="n">pageCounter</span> <span class="p">=</span> 0<span class="p">;</span>
+<span class="k">for</span> <span class="p">(</span><span class="n">PDPage</span> <span class="n">page</span> <span class="p">:</span> <span class="n">document</span><span class="p">.</span><span class="n">getPages</span><span class="p">())</span>
+<span class="p">{</span> 
+    <span class="n">pdfRenderer</span><span class="p">.</span><span class="n">renderImageWithDPI</span><span class="p">(</span><span class="n">page</span><span class="p">,</span> 300<span class="p">,</span> <span class="n">ImageType</span><span class="p">.</span><span class="n">RGB</span><span class="p">);</span>
+
+    <span class="o">//</span> <span class="n">suffix</span> <span class="n">in</span> <span class="n">filename</span> <span class="n">will</span> <span class="n">be</span> <span class="n">used</span> <span class="n">as</span> <span class="n">the</span> <span class="n">file</span> <span class="n">format</span>
+    <span class="n">ImageIOUtil</span><span class="p">.</span><span class="n">writeImage</span><span class="p">(</span><span class="n">bim</span><span class="p">,</span> <span class="n">pdfFilename</span> <span class="o">+</span> &quot;<span class="o">-</span>&quot; <span class="o">+</span> <span class="p">(</span><span class="n">pageCounter</span><span class="o">++</span><span class="p">)</span> <span class="o">+</span> &quot;<span class="p">.</span><span class="n">png</span>&quot;<span class="p">,</span> 300<span class="p">);</span>
+<span class="p">}</span>
+<span class="n">document</span><span class="p">.</span><span class="n">close</span><span class="p">();</span>
+</pre></div>
+
+
 <h3 id="pdf-printing">PDF Printing<a class="headerlink" href="#pdf-printing" title="Permanent link">&para;</a></h3>
 <p>With PDFBox 2.0.0 <code>PDFPrinter</code> has been removed.</p>
 <p>Users of <code>PDFPrinter.silentPrint()</code> should now use this code:</p>