aboutsummaryrefslogtreecommitdiffstats
path: root/manual
diff options
context:
space:
mode:
authorJay Berkenbilt <ejb@ql.org>2021-01-01 13:31:54 +0100
committerJay Berkenbilt <ejb@ql.org>2021-01-02 18:29:31 +0100
commita139d2b36da39fbfb018ef6973e9316a64a4ca6c (patch)
tree6e7ea711324e717fba197d031550dfe7ae0f2f94 /manual
parentafb48d23a984ab1fe27a57ecbb3d56ac2e3a2099 (diff)
downloadqpdf-a139d2b36da39fbfb018ef6973e9316a64a4ca6c.tar.zst
Add several methods for working with form XObjects (fixes #436)
Make some more methods in QPDFPageObjectHelper work with form XObjects, provide forEach methods to walk through nested form XObjects, possibly recursively. This should make it easier to work with form XObjects from user code.
Diffstat (limited to 'manual')
-rw-r--r--manual/qpdf-manual.xml54
1 files changed, 54 insertions, 0 deletions
diff --git a/manual/qpdf-manual.xml b/manual/qpdf-manual.xml
index 0b7156b2..bae87536 100644
--- a/manual/qpdf-manual.xml
+++ b/manual/qpdf-manual.xml
@@ -4859,6 +4859,60 @@ print "\n";
</listitem>
<listitem>
<para>
+ Add methods to <classname>QPDFPageObjectHelper</classname>
+ to iterate through XObjects on a page or form XObjects,
+ possibly recursing into nested form XObjects:
+ <function>forEachXObject</function>,
+ <function>ForEachImage</function>,
+ <function>forEachFormXObject</function>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Enhance several methods in
+ <classname>QPDFPageObjectHelper</classname> to work with
+ form XObjects as well as pages, as noted in comments. See
+ <filename>ChangeLog</filename> for a full list.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Rename some functions in
+ <classname>QPDFPageObjectHelper</classname>, while keeping
+ old names for compatibility:
+ <itemizedlist>
+ <listitem>
+ <para>
+ <function>getPageImages</function> to
+ <function>getImages</function>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <function>filterPageContents</function> to
+ <function>filterContents</function>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Add method
+ <function>QPDFPageObjectHelper::getFormXObjects</function>
+ to return a map of form XObjects directly on a page or form
+ XObject
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Add new helper methods to
+ <classname>QPDFObjectHandle</classname>:
+ <function>isFormXObject</function>, <function>isImage</function>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
Add the optional <function>allow_streams</function>
parameter <function>QPDFObjectHandle::makeDirect</function>.
When <function>QPDFObjectHandle::makeDirect</function> is