addPageContents

git-svn-id: svn+q:///qpdf/trunk@995 71b93d88-0707-0410-a8cf-f5a4172ac649

1 files changed, 13 insertions, 5 deletions

diff --git a/include/qpdf/QPDFObjectHandle.hh b/include/qpdf/QPDFObjectHandle.hh
index 298e480b..b7df3750 100644
--- a/include/qpdf/QPDFObjectHandle.hh
+++ b/include/qpdf/QPDFObjectHandle.hh
@@ -288,14 +288,22 @@ class QPDFObjectHandle
     QPDF_DLL
     std::map<std::string, QPDFObjectHandle> getPageImages();
 
-    // Throws an exception if this is not a Page object.  Returns a
-    // vector of stream objects representing the content streams for
-    // the given page.  This routine allows the caller to not care
-    // whether there are one or more than one content streams for a
-    // page.
+    // Returns a vector of stream objects representing the content
+    // streams for the given page.  This routine allows the caller to
+    // not care whether there are one or more than one content streams
+    // for a page.  Throws an exception if this is not a Page object.
     QPDF_DLL
     std::vector<QPDFObjectHandle> getPageContents();
 
+    // Add the given object as a new content stream for this page.  If
+    // parameter 'first' is true, add to the beginning.  Otherwise,
+    // add to the end.  This routine automatically converts the page
+    // contents to an array if it is a scalar, allowing the caller not
+    // to care what the initial structure is.  Throws an exception if
+    // this is not a Page object.
+    QPDF_DLL
+    void addPageContents(QPDFObjectHandle contents, bool first);
+
     // Initializers for objects.  This Factory class gives the QPDF
     // class specific permission to call factory methods without
     // making it a friend of the whole QPDFObjectHandle class.