Package org.apache.pdfbox.pdmodel
Class PDPageTree
java.lang.Object
org.apache.pdfbox.pdmodel.PDPageTree
- All Implemented Interfaces:
Iterable<PDPage>
,COSObjectable
The page tree, which defines the ordering of pages in the document in an efficient manner.
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionprivate final class
Iterator which walks all pages in the tree, in order.private static final class
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate final PDDocument
private static final org.apache.commons.logging.Log
private final Set<COSDictionary>
private final COSDictionary
-
Constructor Summary
ConstructorsConstructorDescriptionConstructor for embedding.PDPageTree
(COSDictionary root) Constructor for reading.PDPageTree
(COSDictionary root, PDDocument document) Constructor for reading. -
Method Summary
Modifier and TypeMethodDescriptionvoid
Adds the given page to this page tree.private boolean
findPage
(PDPageTree.SearchContext context, COSDictionary node) get
(int index) Returns the page at the given index.private COSDictionary
get
(int pageNum, COSDictionary node, int encountered) Returns the given COS page using a depth-first search.Convert this standard java object to a COS object.int
getCount()
Returns the number of leaf nodes (page objects) that are descendants of this root within the page tree.static COSBase
getInheritableAttribute
(COSDictionary node, COSName key) Returns the given attribute, inheriting from parent tree nodes if necessary.private List<COSDictionary>
getKids
(COSDictionary node) Helper to get kids from malformed PDFs.private void
increaseParents
(COSDictionary parentDict) int
Returns the index of the given page, or -1 if it does not exist.void
insertAfter
(PDPage newPage, PDPage prevPage) Insert a page after another page within a page tree.void
insertBefore
(PDPage newPage, PDPage nextPage) Insert a page before another page within a page tree.private boolean
isPageTreeNode
(COSDictionary node) Returns true if the node is a page tree node (i.e.iterator()
Returns an iterator which walks all pages in the tree, in order.void
remove
(int index) Removes the page with the given index from the page tree.private void
remove
(COSDictionary node) Removes the given COS page.void
Removes the given page from the page tree.private static void
sanitizeType
(COSDictionary dictionary) Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface java.lang.Iterable
forEach, spliterator
-
Field Details
-
LOG
private static final org.apache.commons.logging.Log LOG -
root
-
document
-
pageSet
-
-
Constructor Details
-
PDPageTree
public PDPageTree()Constructor for embedding. -
PDPageTree
Constructor for reading.- Parameters:
root
- A page tree root.
-
PDPageTree
PDPageTree(COSDictionary root, PDDocument document) Constructor for reading.- Parameters:
root
- A page tree root.document
- The document which contains "root".
-
-
Method Details
-
getInheritableAttribute
Returns the given attribute, inheriting from parent tree nodes if necessary.- Parameters:
node
- page objectkey
- the key to look up- Returns:
- COS value for the given key
-
iterator
Returns an iterator which walks all pages in the tree, in order. -
getKids
Helper to get kids from malformed PDFs.- Parameters:
node
- page tree node- Returns:
- list of kids
-
get
Returns the page at the given index.- Parameters:
index
- zero-based index- Throws:
IllegalStateException
- if the requested index isn't found or doesn't point to a valid page dictionaryIndexOutOfBoundsException
- if the requested index is higher than the page count
-
sanitizeType
-
get
Returns the given COS page using a depth-first search.- Parameters:
pageNum
- 1-based page numbernode
- page tree node to searchencountered
- number of pages encountered so far- Returns:
- COS dictionary of the Page object
- Throws:
IllegalStateException
- if the requested page number isn't foundIndexOutOfBoundsException
- if the requested page number is higher than the page count
-
isPageTreeNode
Returns true if the node is a page tree node (i.e. and intermediate). -
indexOf
Returns the index of the given page, or -1 if it does not exist.- Parameters:
page
- The page to search for.- Returns:
- the zero-based index of the given page, or -1 if the page is not found.
-
findPage
-
getCount
public int getCount()Returns the number of leaf nodes (page objects) that are descendants of this root within the page tree.- Returns:
- the number of leaf nodes.
-
getCOSObject
Description copied from interface:COSObjectable
Convert this standard java object to a COS object.- Specified by:
getCOSObject
in interfaceCOSObjectable
- Returns:
- The cos object that matches this Java object.
-
remove
public void remove(int index) Removes the page with the given index from the page tree.- Parameters:
index
- zero-based page index
-
remove
Removes the given page from the page tree.- Parameters:
page
- The page to remove.
-
remove
Removes the given COS page. -
add
Adds the given page to this page tree.- Parameters:
page
- The page to add.
-
insertBefore
Insert a page before another page within a page tree.- Parameters:
newPage
- the page to be inserted.nextPage
- the page that is to be after the new page.- Throws:
IllegalArgumentException
- if one attempts to insert a page that isn't part of a page tree.
-
insertAfter
Insert a page after another page within a page tree.- Parameters:
newPage
- the page to be inserted.prevPage
- the page that is to be before the new page.- Throws:
IllegalArgumentException
- if one attempts to insert a page that isn't part of a page tree.
-
increaseParents
-