PDPage (veraPDF PDF Box PDF/A Validation Model Implementation 1.18.2 API)

java.lang.Object
- org.apache.pdfbox.pdmodel.PDPage

All Implemented Interfaces:

PDContentStream, COSObjectable
```
public class PDPage
extends Object
implements COSObjectable, PDContentStream
```
A page in a PDF document.

Author:

Ben Litchfield

Constructor Summary

Constructors
Constructor and Description
`PDPage()` Creates a new PDPage instance for embedding, with a size of U.S.
`PDPage(COSDictionary pageDictionary)` Creates a new instance of PDPage for reading.
`PDPage(PDRectangle mediaBox)` Creates a new instance of PDPage for embedding.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`equals(Object other)`
`PDPageAdditionalActions`	`getActions()` Get the page actions.
`List<PDAnnotation>`	`getAnnotations()` This will return a list of the Annotations for this page.
`PDRectangle`	`getArtBox()` A rectangle, expressed in default user space units, defining the extent of the page's meaningful content (including potential white space) as intended by the page's creator The default is the CropBox.
`PDRectangle`	`getBBox()` Returns the bounding box of the contents.
`PDRectangle`	`getBleedBox()` A rectangle, expressed in default user space units, defining the region to which the contents of the page should be clipped when output in a production environment.
`COSStream`	`getContentStream()` Returns the underlying COS stream.
`COSDictionary`	`getCOSObject()` Convert this standard java object to a COS object.
`PDRectangle`	`getCropBox()` A rectangle, expressed in default user space units, defining the visible region of default user space.
`PDResources`	`getInheritedResources()`
`Matrix`	`getMatrix()` Returns the matrix which transforms from the stream's space to user space.
`PDRectangle`	`getMediaBox()` A rectangle, expressed in default user space units, defining the boundaries of the physical medium on which the page is intended to be displayed or printed.
`PDMetadata`	`getMetadata()` Get the metadata that is part of the document catalog.
`PDResources`	`getPageResources()`
`PDNavigationNode`	`getPresSteps()`
`PDResources`	`getResources()` A dictionary containing any resources required by the page.
`int`	`getRotation()` Returns the rotation angle in degrees by which the page should be rotated clockwise when displayed or printed.
`PDStream`	`getStream()` This will get the contents of the PDF Page, in the case that the contents of the page is an array then then the entire array of streams will be be wrapped and appear as a single stream.
`int`	`getStructParents()` This will get the key of this Page in the structural parent tree.
`List<PDThreadBead>`	`getThreadBeads()` This will get a list of PDThreadBead objects, which are article threads in the document.
`PDTransition`	`getTransition()`
`PDRectangle`	`getTrimBox()` A rectangle, expressed in default user space units, defining the intended dimensions of the finished page after trimming.
`int`	`hashCode()`
`boolean`	`hasRotation()`
`void`	`setActions(PDPageAdditionalActions actions)` Set the page actions.
`void`	`setAnnotations(List<PDAnnotation> annotations)` This will set the list of annotations.
`void`	`setArtBox(PDRectangle artBox)` This will set the ArtBox for this page.
`void`	`setBleedBox(PDRectangle bleedBox)` This will set the BleedBox for this page.
`void`	`setContents(PDStream contents)` This will set the contents of this page.
`void`	`setCropBox(PDRectangle cropBox)` This will set the CropBox for this page.
`void`	`setMediaBox(PDRectangle mediaBox)` This will set the mediaBox for this page.
`void`	`setMetadata(PDMetadata meta)` Set the metadata for this object.
`void`	`setResources(PDResources resources)` This will set the resources for this page.
`void`	`setRotation(int rotation)` This will set the rotation for this page.
`void`	`setStructParents(int structParents)` This will set the key for this page in the structural parent tree.
`void`	`setThreadBeads(List<PDThreadBead> beads)` This will set the list of thread beads.
`void`	`setTransition(PDTransition transition)`
`void`	`setTransition(PDTransition transition, float duration)` Convenient method to set a transition and the display duration
`void`	`setTrimBox(PDRectangle trimBox)` This will set the TrimBox for this page.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - PDPage
```
public PDPage()
```
    Creates a new PDPage instance for embedding, with a size of U.S. Letter (8.5 x 11 inches).
  - PDPage
```
public PDPage(PDRectangle mediaBox)
```
    Creates a new instance of PDPage for embedding.
    
    Parameters:
    
    mediaBox - The MediaBox of the page.
  - PDPage
```
public PDPage(COSDictionary pageDictionary)
```
    Creates a new instance of PDPage for reading.
    
    Parameters:
    
    pageDictionary - A page dictionary in a PDF document.
- Method Detail
  - getCOSObject
```
public COSDictionary getCOSObject()
```
    Convert this standard java object to a COS object.
    
    Specified by:
    
    getCOSObject in interface COSObjectable
    
    Returns:
    
    The cos object that matches this Java object.
  - getContentStream
```
public COSStream getContentStream()
```
    Description copied from interface: PDContentStream
    
    Returns the underlying COS stream.
    
    Specified by:
    
    getContentStream in interface PDContentStream
  - getResources
```
public PDResources getResources()
```
    A dictionary containing any resources required by the page.
    
    Specified by:
    
    getResources in interface PDContentStream
  - setResources
```
public void setResources(PDResources resources)
```
    This will set the resources for this page.
    
    Parameters:
    
    resources - The new resources for this page.
  - getPageResources
```
public PDResources getPageResources()
```
  - getInheritedResources
```
public PDResources getInheritedResources()
```
  - getStructParents
```
public int getStructParents()
```
    This will get the key of this Page in the structural parent tree.
    
    Returns:
    
    the integer key of the page's entry in the structural parent tree
  - setStructParents
```
public void setStructParents(int structParents)
```
    This will set the key for this page in the structural parent tree.
    
    Parameters:
    
    structParents - The new key for this page.
  - getBBox
```
public PDRectangle getBBox()
```
    Description copied from interface: PDContentStream
    
    Returns the bounding box of the contents.
    
    Specified by:
    
    getBBox in interface PDContentStream
  - getMatrix
```
public Matrix getMatrix()
```
    Description copied from interface: PDContentStream
    
    Returns the matrix which transforms from the stream's space to user space.
    
    Specified by:
    
    getMatrix in interface PDContentStream
  - getMediaBox
```
public PDRectangle getMediaBox()
```
    A rectangle, expressed in default user space units, defining the boundaries of the physical medium on which the page is intended to be displayed or printed.
  - setMediaBox
```
public void setMediaBox(PDRectangle mediaBox)
```
    This will set the mediaBox for this page.
    
    Parameters:
    
    mediaBox - The new mediaBox for this page.
  - getCropBox
```
public PDRectangle getCropBox()
```
    A rectangle, expressed in default user space units, defining the visible region of default user space. When the page is displayed or printed, its contents are to be clipped (cropped) to this rectangle.
  - setCropBox
```
public void setCropBox(PDRectangle cropBox)
```
    This will set the CropBox for this page.
    
    Parameters:
    
    cropBox - The new CropBox for this page.
  - getBleedBox
```
public PDRectangle getBleedBox()
```
    A rectangle, expressed in default user space units, defining the region to which the contents of the page should be clipped when output in a production environment. The default is the CropBox.
    
    Returns:
    
    The BleedBox attribute.
  - setBleedBox
```
public void setBleedBox(PDRectangle bleedBox)
```
    This will set the BleedBox for this page.
    
    Parameters:
    
    bleedBox - The new BleedBox for this page.
  - getTrimBox
```
public PDRectangle getTrimBox()
```
    A rectangle, expressed in default user space units, defining the intended dimensions of the finished page after trimming. The default is the CropBox.
    
    Returns:
    
    The TrimBox attribute.
  - setTrimBox
```
public void setTrimBox(PDRectangle trimBox)
```
    This will set the TrimBox for this page.
    
    Parameters:
    
    trimBox - The new TrimBox for this page.
  - getArtBox
```
public PDRectangle getArtBox()
```
    A rectangle, expressed in default user space units, defining the extent of the page's meaningful content (including potential white space) as intended by the page's creator The default is the CropBox.
    
    Returns:
    
    The ArtBox attribute.
  - setArtBox
```
public void setArtBox(PDRectangle artBox)
```
    This will set the ArtBox for this page.
    
    Parameters:
    
    artBox - The new ArtBox for this page.
  - getRotation
```
public int getRotation()
```
    Returns the rotation angle in degrees by which the page should be rotated clockwise when displayed or printed. Valid values in a PDF must be a multiple of 90.
    
    Returns:
    
    The rotation angle in degrees in normalized form (0, 90, 180 or 270) or 0 if invalid or not set at this level.
  - hasRotation
```
public boolean hasRotation()
```
    Returns:
    
    true if this page has inheritable attribute rotation set.
  - setRotation
```
public void setRotation(int rotation)
```
    This will set the rotation for this page.
    
    Parameters:
    
    rotation - The new rotation for this page in degrees.
  - getStream
```
public PDStream getStream()
                   throws IOException
```
    This will get the contents of the PDF Page, in the case that the contents of the page is an array then then the entire array of streams will be be wrapped and appear as a single stream.
    
    Returns:
    
    The page content stream.
    
    Throws:
    
    IOException - If there is an error obtaining the stream.
  - setContents
```
public void setContents(PDStream contents)
```
    This will set the contents of this page.
    
    Parameters:
    
    contents - The new contents of the page.
  - getThreadBeads
```
public List<PDThreadBead> getThreadBeads()
```
    This will get a list of PDThreadBead objects, which are article threads in the document. This will return an empty list of there are no thread beads.
    
    Returns:
    
    A list of article threads on this page.
  - setThreadBeads
```
public void setThreadBeads(List<PDThreadBead> beads)
```
    This will set the list of thread beads.
    
    Parameters:
    
    beads - A list of PDThreadBead objects or null.
  - getMetadata
```
public PDMetadata getMetadata()
```
    Get the metadata that is part of the document catalog. This will return null if there is no meta data for this object.
    
    Returns:
    
    The metadata for this object.
  - setMetadata
```
public void setMetadata(PDMetadata meta)
```
    Set the metadata for this object. This can be null.
    
    Parameters:
    
    meta - The meta data for this object.
  - getActions
```
public PDPageAdditionalActions getActions()
```
    Get the page actions.
    
    Returns:
    
    The Actions for this Page
  - getPresSteps
```
public PDNavigationNode getPresSteps()
```
  - setActions
```
public void setActions(PDPageAdditionalActions actions)
```
    Set the page actions.
    
    Parameters:
    
    actions - The actions for the page.
  - getTransition
```
public PDTransition getTransition()
```
    Returns:
    
    The page transition associated with this page or null if no transition is defined
  - setTransition
```
public void setTransition(PDTransition transition)
```
    Parameters:
    
    transition - The new transition to set on this page.
  - setTransition
```
public void setTransition(PDTransition transition,
                          float duration)
```
    Convenient method to set a transition and the display duration
    
    Parameters:
    
    transition - The new transition to set on this page.
    
    duration - The maximum length of time, in seconds, that the page shall be displayed during presentations before the viewer application shall automatically advance to the next page.
  - getAnnotations
```
public List<PDAnnotation> getAnnotations()
                                  throws IOException
```
    This will return a list of the Annotations for this page.
    
    Returns:
    
    List of the PDAnnotation objects, never null.
    
    Throws:
    
    IOException - If there is an error while creating the annotation list.
  - setAnnotations
```
public void setAnnotations(List<PDAnnotation> annotations)
```
    This will set the list of annotations.
    
    Parameters:
    
    annotations - The new list of annotations.
  - equals
```
public boolean equals(Object other)
```
    Overrides:
    
    equals in class Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object

Class PDPage

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

PDPage

PDPage

PDPage

Method Detail

getCOSObject

getContentStream

getResources

setResources

getPageResources

getInheritedResources

getStructParents

setStructParents

getBBox

getMatrix

getMediaBox

setMediaBox

getCropBox

setCropBox

getBleedBox

setBleedBox

getTrimBox

setTrimBox

getArtBox

setArtBox

getRotation

hasRotation

setRotation

getStream

setContents

getThreadBeads

setThreadBeads

getMetadata

setMetadata

getActions

getPresSteps

setActions

getTransition

setTransition

setTransition

getAnnotations

setAnnotations

equals

hashCode