This is an automated email from the ASF dual-hosted git repository.
msahyoun pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/pdfbox-docs.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 3c720740 Site checkin for project Apache PDFBox Website
3c720740 is described below
commit 3c72074061e47655950b6da754c8a0ad988fbf3e
Author: Maruan Sahyoun <[email protected]>
AuthorDate: Wed Jun 18 10:32:39 2025 +0200
Site checkin for project Apache PDFBox Website
---
content/2.0/commandline.html | 2 +-
content/2.0/faq.html | 2 +-
content/2.0/migration.html | 2 +-
content/3.0/commandline.html | 2 +-
content/3.0/faq.html | 2 +-
content/3.0/migration.html | 6 ++++++
content/download.html | 10 +++++-----
7 files changed, 16 insertions(+), 10 deletions(-)
diff --git a/content/2.0/commandline.html b/content/2.0/commandline.html
index b2723362..d5895c6b 100644
--- a/content/2.0/commandline.html
+++ b/content/2.0/commandline.html
@@ -590,7 +590,7 @@ To override the filename use the <code>outputPrefix</code>
option.</p>
<td>Print to specified printer.</td>
</tr>
<tr>
-<td>-orientation [auto | portrait | landscape]</td>
+<td>-orientation [auto | portrait | landscape | reverse_landscape]</td>
<td>auto</td>
<td>Print using orientation.</td>
</tr>
diff --git a/content/2.0/faq.html b/content/2.0/faq.html
index 8a20ab46..ccd71f73 100644
--- a/content/2.0/faq.html
+++ b/content/2.0/faq.html
@@ -254,7 +254,7 @@ the word "Hello" is drawn.</li>
<p>The memory footprint depends on the PDF itself and on the resolution you
use for rendering. Some possible options:</p>
<ul>
<li>increase the <code>-Xmx</code> value when starting java</li>
-<li>use a scratch file by loading files with this code
<code>PDDocument.load(file, MemoryUsageSetting.setupTempFileOnly())</code></li>
+<li>use a scratch file by loading files with this code
<code>PDDocument.load(file, MemoryUsageSetting.setupTempFileOnly())</code> or
with <code>PDDocument.load(file,
MemoryUsageSetting.setupMixed(...))</code>.</li>
<li>activate subsampling by calling <code>setSubsamplingAllowed(true)</code>
on your <code>PDFRenderer</code> object</li>
<li>be careful not to hold your images after rendering them, e.g. avoid
putting all images of a PDF into a <code>List</code></li>
<li>don't forgot to close your <code>PDDocument</code> objects</li>
diff --git a/content/2.0/migration.html b/content/2.0/migration.html
index 262e39ae..a0df9952 100644
--- a/content/2.0/migration.html
+++ b/content/2.0/migration.html
@@ -204,7 +204,7 @@ and so on. The <code>add</code> method now supports all the
different type of re
<pre class="language-java"><code class="language-java"><span class="token
keyword">for</span><span class="token punctuation">(</span><span class="token
class-name">PDPage</span> page <span class="token operator">:</span>
document<span class="token punctuation">.</span><span class="token
function">getPages</span><span class="token punctuation">(</span><span
class="token punctuation">)</span><span class="token
punctuation">)</span><br><span class="token punctuation">{</span><br> <span
c [...]
<h3 id="pdf-rendering" tabindex="-1">PDF Rendering</h3>
<p>With PDFBox 2.0.0 <code>PDPage.convertToImage</code> and
<code>PDFImageWriter</code> have been removed. Instead the new
<code>PDFRenderer</code> class shall be used.</p>
-<pre class="language-java"><code class="language-java"><span class="token
class-name">PDDocument</span> document <span class="token operator">=</span>
<span class="token class-name">PDDocument</span><span class="token
punctuation">.</span><span class="token function">load</span><span class="token
punctuation">(</span><span class="token keyword">new</span> <span class="token
class-name">File</span><span class="token punctuation">(</span>pdfFilename<span
class="token punctuation">)</span>< [...]
+<pre class="language-java"><code class="language-java"><span class="token
class-name">PDDocument</span> document <span class="token operator">=</span>
<span class="token class-name">PDDocument</span><span class="token
punctuation">.</span><span class="token function">load</span><span class="token
punctuation">(</span><span class="token keyword">new</span> <span class="token
class-name">File</span><span class="token punctuation">(</span>pdfFilename<span
class="token punctuation">)</span>< [...]
<p><code>ImageIOUtil</code> has been moved into the
<code>org.apache.pdfbox.tools.imageio</code> package. This is in the
<code>pdfbox-tools</code> download. If you are using maven, the
<code>artifactId</code> has the same name.</p>
<p class="alert alert-warning">Important notice when using PDFBox with Java 8
</p>
diff --git a/content/3.0/commandline.html b/content/3.0/commandline.html
index d82233bf..d7c3923d 100644
--- a/content/3.0/commandline.html
+++ b/content/3.0/commandline.html
@@ -730,7 +730,7 @@ To override the filename use the <code>outputPrefix</code>
option.</p>
<tr>
<td>-orientation</td>
<td>AUTO</td>
-<td>print using orientation (AUTO, LANDSCAPE, PORTRAIT).</td>
+<td>print using orientation (AUTO, LANDSCAPE, REVERSE_LANDSCAPE,
PORTRAIT).</td>
</tr>
<tr>
<td>-password=[<password>]</td>
diff --git a/content/3.0/faq.html b/content/3.0/faq.html
index 114c8381..84e68fc6 100644
--- a/content/3.0/faq.html
+++ b/content/3.0/faq.html
@@ -251,7 +251,7 @@ the word "Hello" is drawn.</li>
<p>The memory footprint depends on the PDF itself and on the resolution you
use for rendering. Some possible options:</p>
<ul>
<li>increase the <code>-Xmx</code> value when starting java</li>
-<li>use a scratch file by loading files with this code
<code>Loader.loadPDF(file, IOUtils.createTempFileOnlyStreamCache())</code></li>
+<li>use a scratch file by loading files with this code
<code>Loader.loadPDF(file, IOUtils.createTempFileOnlyStreamCache())</code> or
with <code>Loader.loadPDF(file, () -> new
ScratchFile(MemoryUsageSetting.setupMixed(...)))</code>.</li>
<li>activate subsampling by calling <code>setSubsamplingAllowed(true)</code>
on your <code>PDFRenderer</code> object</li>
<li>be careful not to hold your images after rendering them, e.g. avoid
putting all images of a PDF into a <code>List</code></li>
<li>don't forgot to close your <code>PDDocument</code> objects</li>
diff --git a/content/3.0/migration.html b/content/3.0/migration.html
index 1138c884..fd021544 100644
--- a/content/3.0/migration.html
+++ b/content/3.0/migration.html
@@ -248,6 +248,9 @@ range and define using <code>float</code> triples
instead.</p>
<p>Instead of using the <code>PDAnnotationTextMarkup</code>,
<code>PDAnnotationSquareCircle</code> or the <code>PDAnnotationMarkup</code>
classes when creating certain annotations, use their subclasses
<code>PDAnnotationCaret</code>, <code>PDAnnotationFreeText</code>,
<code>PDAnnotationInk</code>, <code>PDAnnotationPolygon</code>,
<code>PDAnnotationPolyline</code>, <code>PDAnnotationSound</code>,
<code>PDAnnotationCircle</code>, <code>PDAnnotationSquare</code>,
<code>PDAnnotationHighlig [...]
<h3 id="changes-with-charsets" tabindex="-1">Changes with charsets</h3>
<p>The convenience class <code>org.apache.pdfbox.util.Charsets</code> has been
removed. Please use the java class
<code>java.nio.charset.StandardCharsets</code> instead.</p>
+<h3 id="changes-when-needing-all-objects" tabindex="-1">Changes when needing
all objects</h3>
+<p>Instead of using the <code>COSDocument.getObjects()</code> to get all
objects, use <code>COSDocument.getXrefTable().keySet()</code>
+to get all the object keys, and then call
<code>COSDocument.getObjectFromPool()</code> with these keys.</p>
<h2 id="changes-in-common-functions" tabindex="-1">Changes in Common
Functions</h2>
<h3 id="interactive-forms" tabindex="-1">Interactive Forms</h3>
<p>When accessing <code>AcroForms</code> using
<code>PDDocumentCatalog.getAcroForm()</code> a number of fix ups are applied
aligning PDFBox with most of the default behaviour
@@ -329,6 +332,9 @@ of Adobe Reader. If you'd like to bypass this use
<code>PDDocumentCatalog.getAcr
<li><a href="#changes-with-charsets">Changes with
charsets</a>
</li>
+
+ <li><a href="#changes-when-needing-all-objects">Changes
when needing all objects</a>
+ </li>
</ol>
</li>
diff --git a/content/download.html b/content/download.html
index 4f9e447c..a64b8717 100644
--- a/content/download.html
+++ b/content/download.html
@@ -164,7 +164,7 @@
<ul>
<li>Feature release for PDFBox 3.0.x — <a
href="https://downloads.apache.org/pdfbox/3.0.5/RELEASE-NOTES.txt";>3.0.5</a>
(requires Java 8)</li>
<li>Feature release for PDFBox 2.0.x — <a
href="https://downloads.apache.org/pdfbox/2.0.34/RELEASE-NOTES.txt";>2.0.34</a>
(requires Java 6)</li>
- <li>Feature release of JBIG2 ImageIO plugin 3.0.x — <a
href="https://downloads.apache.org/pdfbox/jbig2-imageio/3.0.5/RELEASE-NOTES.txt";>3.0.5</a>
(requires Java 6)</li>
+ <li>Feature release of JBIG2 ImageIO plugin 3.0.x — <a
href="https://downloads.apache.org/pdfbox/jbig2-imageio/3.0.4/RELEASE-NOTES.txt";>3.0.4</a>
(requires Java 6)</li>
<li><a href="#oldreleases">Previous releases</a></li>
</ul>
@@ -318,11 +318,11 @@
</tbody>
<tbody>
<tr>
- <td
rowspan="1"><strong>JBIG2<br>3.0.5</strong><br><small>feature</small></td>
+ <td
rowspan="1"><strong>JBIG2<br>3.0.4</strong><br><small>feature</small></td>
<td>JBIG2 ImageIO plugin</td>
- <td><a
href="https://www.apache.org/dyn/closer.lua/pdfbox/jbig2-imageio/3.0.5/jbig2-imageio-3.0.5.jar";>jbig2-imageio-3.0.5.jar</a></td>
- <td><a
href="https://downloads.apache.org/pdfbox/jbig2-imageio/3.0.5/jbig2-imageio-3.0.5.jar.asc";>ASC</a></td>
- <td><a
href="https://downloads.apache.org/pdfbox/jbig2-imageio/3.0.5/jbig2-imageio-3.0.5.jar.sha512";>SHA512</a></td>
+ <td><a
href="https://www.apache.org/dyn/closer.lua/pdfbox/jbig2-imageio/3.0.4/jbig2-imageio-3.0.4.jar";>jbig2-imageio-3.0.4.jar</a></td>
+ <td><a
href="https://downloads.apache.org/pdfbox/jbig2-imageio/3.0.4/jbig2-imageio-3.0.4.jar.asc";>ASC</a></td>
+ <td><a
href="https://downloads.apache.org/pdfbox/jbig2-imageio/3.0.4/jbig2-imageio-3.0.4.jar.sha512";>SHA512</a></td>
</tr>
</tbody>
</table>
