Class PdfStamperImp

java.lang.Object

com.itextpdf.text.DocWriter

com.itextpdf.text.pdf.PdfWriter

com.itextpdf.text.pdf.PdfStamperImp

All Implemented Interfaces:

DocListener, ElementListener, PdfAnnotations, PdfDocumentActions, PdfEncryptionSettings, PdfPageActions, PdfRunDirection, PdfVersion, PdfViewerPreferences, EventListener

Direct Known Subclasses:

PdfAStamperImp

class PdfStamperImp
extends PdfWriter

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static class	PdfStamperImp.PageStamp

Nested classes/interfaces inherited from class PdfWriter

PdfWriter.PdfBody, PdfWriter.PdfTrailer

Field Summary

Fields

Modifier and Type	Field	Description
protected AcroFields	acroFields
protected boolean	append
private HashMap<String, PdfIndirectReference>	builtInAnnotationFonts
protected boolean	closed
protected Counter	COUNTER
private double[]	DEFAULT_MATRIX
protected boolean	fieldsAdded
protected HashSet<PdfTemplate>	fieldTemplates
protected RandomAccessFileOrArray	file
protected boolean	flat
protected boolean	flatannotations
protected boolean	flatFreeText
private static HashMap<String,String>	fromShortToFullAnnotationFontNames
protected int	initialXrefSize
private Logger	logger
protected IntHashtable	marked
(package private) IntHashtable	myXref
protected HashMap<Object, PdfObject>	namedDestinations
protected int[]	namePtr
protected PdfAction	openAction
private boolean	originalLayersAreRead
(package private) HashMap<PdfDictionary, PdfStamperImp.PageStamp>	pagesToContent	Integer(page number) -> PageStamp
protected HashSet<String>	partialFlattening
(package private) PdfReader	reader
(package private) HashMap<PdfReader, RandomAccessFileOrArray>	readers2file
(package private) HashMap<PdfReader, IntHashtable>	readers2intrefs
private boolean	rotateContents	Holds value of property rotateContents.
protected int	sigFlags
protected boolean	useVp
protected PdfViewerPreferencesImp	viewerPreferences

Fields inherited from class PdfWriter

ALLOW_ASSEMBLY, ALLOW_COPY, ALLOW_DEGRADED_PRINTING, ALLOW_FILL_IN, ALLOW_MODIFY_ANNOTATIONS, ALLOW_MODIFY_CONTENTS, ALLOW_PRINTING, ALLOW_SCREENREADERS, AllowAssembly, AllowCopy, AllowDegradedPrinting, AllowFillIn, AllowModifyAnnotations, AllowModifyContents, AllowPrinting, AllowScreenReaders, body, CenterWindow, colorNumber, colorProfile, compressionLevel, crypto, currentPageNumber, currentPdfReaderInstance, defaultColorspace, DID_PRINT, DID_SAVE, directContent, directContentUnder, DirectionL2R, DirectionR2L, DisplayDocTitle, DO_NOT_ENCRYPT_METADATA, DOCUMENT_CLOSE, documentColors, documentExtGState, documentFonts, documentOCG, documentOCGorder, documentPatterns, documentProperties, documentShadingPatterns, documentShadings, documentSpotPatterns, EMBEDDED_FILES_ONLY, ENCRYPTION_AES_128, ENCRYPTION_AES_256, ENCRYPTION_MASK, extraCatalog, FitWindow, fontNumber, formXObjects, formXObjectsCounter, fullCompression, GENERATION_MAX, group, HideMenubar, HideToolbar, HideWindowUI, imageDictionary, JBIG2Globals, markAll, markInlineElementsOnly, newBookmarks, NO_SPACE_CHAR_RATIO, NonFullScreenPageModeUseNone, NonFullScreenPageModeUseOC, NonFullScreenPageModeUseOutlines, NonFullScreenPageModeUseThumbs, OCGLocked, OCGRadioGroup, OCProperties, originalFileID, PAGE_CLOSE, PAGE_OPEN, pageDictEntries, PageLayoutOneColumn, PageLayoutSinglePage, PageLayoutTwoColumnLeft, PageLayoutTwoColumnRight, PageLayoutTwoPageLeft, PageLayoutTwoPageRight, PageModeFullScreen, PageModeUseAttachments, PageModeUseNone, PageModeUseOC, PageModeUseOutlines, PageModeUseThumbs, pageReferences, patternColorspaceCMYK, patternColorspaceGRAY, patternColorspaceRGB, patternNumber, pdf, pdf_version, PDF_VERSION_1_2, PDF_VERSION_1_3, PDF_VERSION_1_4, PDF_VERSION_1_5, PDF_VERSION_1_6, PDF_VERSION_1_7, pdfIsoConformance, PDFX1A2001, PDFX32002, PDFXNONE, prevxref, PrintScalingNone, readerInstances, root, RUN_DIRECTION_DEFAULT, RUN_DIRECTION_LTR, RUN_DIRECTION_NO_BIDI, RUN_DIRECTION_RTL, runDirection, SIGNATURE_APPEND_ONLY, SIGNATURE_EXISTS, SPACE_CHAR_RATIO_DEFAULT, STANDARD_ENCRYPTION_128, STANDARD_ENCRYPTION_40, STRENGTH128BITS, STRENGTH40BITS, structureTreeRoot, tabs, tagged, taggingMode, ttfUnicodeWriter, VERSION_1_2, VERSION_1_3, VERSION_1_4, VERSION_1_5, VERSION_1_6, VERSION_1_7, WILL_PRINT, WILL_SAVE, xmpMetadata, xmpWriter

Fields inherited from class DocWriter

closeStream, document, EQUALS, FORWARD, GT, LT, NEWLINE, open, os, pageSize, pause, QUOTE, SPACE, TAB

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	PdfStamperImp(PdfReader reader, OutputStream os, char pdfVersion, boolean append)	Creates new PdfStamperImp.

Method Summary

Modifier and Type	Method	Description
void	addAnnotation(PdfAnnotation annot)	Use this methods to add a PdfAnnotation or a PdfFormField to the document.
(package private) void	addAnnotation(PdfAnnotation annot, int page)
(package private) void	addAnnotation(PdfAnnotation annot, PdfDictionary pageN)
void	addComments(FdfReader fdf)
(package private) void	addDocumentField(PdfIndirectReference ref)
protected void	addFieldResources()
protected void	addFileAttachments()
private void	addOrder(PdfLayer parent, PdfArray arr, Map<String,PdfLayer> ocgmap)	Recursive method to reconstruct the documentOCGorder variable in the writer.
void	addViewerPreference(PdfName key, PdfObject value)	Adds a viewer preference
protected void	alterContents()
(package private) void	alterResources(PdfStamperImp.PageStamp ps)
(package private) void	applyRotation(PdfDictionary pageN, ByteBuffer out)
private AffineTransform	calculateTemplateTransformationMatrix(AffineTransform currentMatrix, double fieldRotation, Rectangle box)
protected void	close(PdfIndirectReference info, int skipInfo)
protected void	close(Map<String,String> moreInfo)
(package private) void	correctAcroFieldPages(int page)
void	createXmpMetadata()	Use this method to creates XMP Metadata based on the metadata in the PdfDocument.
(package private) void	deleteOutlines()
(package private) void	eliminateAcroformObjects()
(package private) void	expandFields(PdfFormField field, ArrayList<PdfAnnotation> allAnnots)
(package private) static void	findAllObjects(PdfReader reader, PdfObject obj, IntHashtable hits)
protected void	flatFields()
protected void	flatFreeTextFields()
protected void	flattenAnnotations()	If setFlatAnnotations is set to true, iText will flatten all annotations with an appearance stream
private void	flattenAnnotations(boolean flattenFreeTextAnnotations)
(package private) AcroFields	getAcroFields()
protected Counter	getCounter()
PdfContentByte	getDirectContent()	Use this method to get the direct content for this document.
PdfContentByte	getDirectContentUnder()	Use this method to get the direct content under for this document.
private PdfArray	getLastChildInNameTree(PdfDictionary dic)
protected HashMap<Object, PdfObject>	getNamedDestinations()
protected int	getNewObjectNumber(PdfReader reader, int number, int generation)
(package private) PdfContentByte	getOverContent(int pageNum)
PdfIndirectReference	getPageReference(int page)	Use this method to get a reference to a page existing or not.
(package private) PdfStamperImp.PageStamp	getPageStamp(int pageNum)
Map<String,PdfLayer>	getPdfLayers()	Gets the PdfLayer objects in an existing document as a Map with the names/titles of the layers as keys.
PdfReader	getPdfReader()
(package private) RandomAccessFileOrArray	getReaderFile(PdfReader reader)
(package private) PdfContentByte	getUnderContent(int pageNum)
(package private) void	insertPage(int pageNumber, Rectangle mediabox)
(package private) boolean	isAppend()	Getter for property append.
(package private) boolean	isContentWritten()
(package private) boolean	isRotateContents()	Getter for property rotateContents.
(package private) void	makePackage(PdfCollection collection)	Adds or replaces the Collection Dictionary in the Catalog.
protected void	markUsed(int num)
protected void	markUsed(PdfObject obj)
private static void	moveRectangle(PdfDictionary dic2, PdfReader r, int pageImported, PdfName key, String name)
private void	outlineTravel(PRIndirectReference outline)
(package private) boolean	partialFormFlattening(String name)
protected void	readColorProfile()
protected void	readOCProperties()	Reads the OCProperties dictionary from the catalog of the existing document and fills the documentOCG, documentOCGorder and OCGRadioGroup variables in PdfWriter.
(package private) void	registerLayer(PdfOCG layer)
void	registerReader(PdfReader reader, boolean openFile)
(package private) void	replacePage(PdfReader r, int pageImported, int pageReplaced)
void	setAdditionalAction(PdfName actionType, PdfAction action)	Additional-actions defining the actions to be taken in response to various trigger events affecting the document as a whole.
void	setDuration(int seconds)	Always throws an UnsupportedOperationException.
(package private) void	setDuration(int seconds, int page)	Sets the display duration for the page (for presentations)
void	setFlatAnnotations(boolean flatAnnotations)	If true, annotations with an appearance stream will be flattened.
(package private) void	setFormFlattening(boolean flat)
(package private) void	setFreeTextFlattening(boolean flat)
protected void	setJavaScript()
void	setOpenAction(PdfAction action)	When the document opens this action will be invoked.
void	setOpenAction(String name)	When the document opens it will jump to the destination with this name.
protected void	setOutlines()
void	setPageAction(PdfName actionType, PdfAction action)	Always throws an UnsupportedOperationException.
(package private) void	setPageAction(PdfName actionType, PdfAction action, int page)	Sets the open and close page additional action.
(package private) void	setRotateContents(boolean rotateContents)	Setter for property rotateContents.
void	setSigFlags(int f)	Set the signature flags.
void	setThumbnail(Image image)	Use this method to set the thumbnail image for the current page.
(package private) void	setThumbnail(Image image, int page)
void	setTransition(PdfTransition transition)	Always throws an UnsupportedOperationException.
(package private) void	setTransition(PdfTransition transition, int page)	Sets the transition for the page
protected void	setViewerPreferences()
void	setViewerPreferences(int preferences)	Sets the viewer preferences.
(package private) void	sweepKids(PdfObject obj)
private Rectangle	transformBBoxByMatrix(Rectangle bBox, double[] matrix)
private Point	transformPoint(double x, double y, double[] matrix)
void	unRegisterReader(PdfReader reader)
protected void	updateNamedDestinations()

Methods inherited from class PdfWriter

add, add, add, addCalculationOrder, addDeveloperExtension, addDirectImageSimple, addDirectImageSimple, addDirectTemplateSimple, addFileAttachment, addFileAttachment, addFileAttachment, addJavaScript, addJavaScript, addJavaScript, addJavaScript, addJavaScript, addJavaScript, addLocalDestinations, addNamedDestination, addNamedDestinations, addOCGRadioGroup, addPageDictEntry, addSharedObjectsToBody, addSimple, addSimple, addSimpleExtGState, addSimplePattern, addSimplePatternColorspace, addSimpleProperty, addSimpleShading, addSimpleShadingPattern, addToBody, addToBody, addToBody, addToBody, addToBody, addToBody, addXFormsToBody, buildStructTreeRootForTagged, cacheObject, checkElementRole, checkPdfIsoConformance, checkPdfIsoConformance, clearTextWrap, close, createAnnotation, createAnnotation, createAnnotation, createXmpWriter, createXmpWriter, eliminateFontSubset, fillOCProperties, flushAcroFields, flushTaggedObjects, freeReader, getAcroForm, getBoxSize, getBoxSize, getCatalog, getColorProfile, getColorspaceName, getCompressionLevel, getCurrentDocumentSize, getCurrentPage, getCurrentPageNumber, getDefaultColorspace, getEncryption, getExtraCatalog, getGroup, getImageReference, getImportedPage, getIndirectReferenceNumber, getInfo, getInstance, getInstance, getNameString, getOCProperties, getOs, getPageDictEntries, getPageEvent, getPageNumber, getPageSize, getPdfDocument, getPdfIndirectReference, getPdfReaderInstance, getPdfVersion, getPDFXConformance, getReferenceJBIG2Globals, getRootOutline, getRunDirection, getSpaceCharRatio, getStandardStructElems, getStructureTreeRoot, getTabs, getTtfUnicodeWriter, getVerticalPosition, getXmpWriter, initPdfIsoConformance, isFullCompression, isPageEmpty, isPdfIso, isPdfX, isRgbTransparencyBlending, isStrictImageSequence, isTagged, isUserProperties, lockLayer, needToBeMarkedInContent, open, propertyExists, releaseTemplate, reorderPages, resetContent, resetPageDictEntries, setAtLeastPdfVersion, setBoxSize, setCollection, setCompressionLevel, setCropBoxSize, setDefaultColorspace, setEncryption, setEncryption, setEncryption, setEncryption, setEncryption, setFullCompression, setGroup, setInitialLeading, setLanguage, setLinearPageMode, setOutlines, setOutputIntents, setOutputIntents, setOutputIntents, setPageEmpty, setPageEvent, setPageLabels, setPageViewport, setPageXmpMetadata, setPdfVersion, setPdfVersion, setPDFXConformance, setRgbTransparencyBlending, setRunDirection, setSpaceCharRatio, setStrictImageSequence, setTabs, setTagged, setTagged, setUserProperties, setUserunit, setXmpMetadata, useExternalCacheForTagStructure, writeKeyInfo, writeOutlines

Methods inherited from class DocWriter

add, addTabs, flush, getISOBytes, isCloseStream, isPaused, newPage, pause, resetPageCount, resume, setCloseStream, setMarginMirroring, setMarginMirroringTopBottom, setMargins, setPageCount, setPageSize, write, write, writeEnd, writeEnd, writeMarkupAttributes, writeStart

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

readers2intrefs

HashMap<PdfReader, IntHashtable> readers2intrefs

readers2file

HashMap<PdfReader, RandomAccessFileOrArray> readers2file

file

protected RandomAccessFileOrArray file

reader

PdfReader reader

myXref

IntHashtable myXref

pagesToContent

HashMap<PdfDictionary, PdfStamperImp.PageStamp> pagesToContent

Integer(page number) -> PageStamp

closed

protected boolean closed

rotateContents

private boolean rotateContents

Holds value of property rotateContents.

acroFields

protected AcroFields acroFields

flat

protected boolean flat

flatFreeText

protected boolean flatFreeText

flatannotations

protected boolean flatannotations

namePtr

protected int[] namePtr

partialFlattening

protected HashSet<String> partialFlattening

useVp

protected boolean useVp

viewerPreferences

protected PdfViewerPreferencesImp viewerPreferences

fieldTemplates

protected HashSet<PdfTemplate> fieldTemplates

fieldsAdded

protected boolean fieldsAdded

sigFlags

protected int sigFlags

append

protected boolean append

marked

protected IntHashtable marked

initialXrefSize

protected int initialXrefSize

openAction

protected PdfAction openAction

namedDestinations

protected HashMap<Object, PdfObject> namedDestinations

COUNTER

protected Counter COUNTER

logger

private Logger logger

originalLayersAreRead

private boolean originalLayersAreRead

builtInAnnotationFonts

private HashMap<String, PdfIndirectReference> builtInAnnotationFonts

fromShortToFullAnnotationFontNames

private static HashMap<String,String> fromShortToFullAnnotationFontNames

DEFAULT_MATRIX

private double[] DEFAULT_MATRIX

Constructor Details

PdfStamperImp

protected PdfStamperImp(PdfReader reader,
 OutputStream os,
 char pdfVersion,
 boolean append)
                 throws DocumentException,
IOException

Creates new PdfStamperImp.

Parameters:

reader - the read PDF

os - the output destination

pdfVersion - the new pdf version or '\0' to keep the same version as the original document

append -

Throws:

DocumentException - on error

IOException

Method Details

getCounter

protected Counter getCounter()

Overrides:

getCounter in class PdfWriter

readColorProfile

protected void readColorProfile()

setViewerPreferences

protected void setViewerPreferences()

close

protected void close(Map<String,String> moreInfo)
              throws IOException

Throws:

IOException

close

protected void close(PdfIndirectReference info,
 int skipInfo)
              throws IOException

Throws:

IOException

applyRotation

void applyRotation(PdfDictionary pageN,
 ByteBuffer out)

alterContents

protected void alterContents()
                      throws IOException

Throws:

IOException

alterResources

void alterResources(PdfStamperImp.PageStamp ps)

getNewObjectNumber

protected int getNewObjectNumber(PdfReader reader,
 int number,
 int generation)

Overrides:

getNewObjectNumber in class PdfWriter

getReaderFile

RandomAccessFileOrArray getReaderFile(PdfReader reader)

Overrides:

getReaderFile in class PdfWriter

registerReader

public void registerReader(PdfReader reader,
 boolean openFile)
                    throws IOException

Parameters:

reader -

openFile -

Throws:

IOException

unRegisterReader

public void unRegisterReader(PdfReader reader)

Parameters:

reader -

findAllObjects

static void findAllObjects(PdfReader reader,
 PdfObject obj,
 IntHashtable hits)

addComments

public void addComments(FdfReader fdf)
                 throws IOException

Parameters:

fdf -

Throws:

IOException

getPageStamp

PdfStamperImp.PageStamp getPageStamp(int pageNum)

getUnderContent

PdfContentByte getUnderContent(int pageNum)

getOverContent

PdfContentByte getOverContent(int pageNum)

correctAcroFieldPages

void correctAcroFieldPages(int page)

moveRectangle

private static void moveRectangle(PdfDictionary dic2,
 PdfReader r,
 int pageImported,
 PdfName key,
 String name)

replacePage

void replacePage(PdfReader r,
 int pageImported,
 int pageReplaced)

insertPage

void insertPage(int pageNumber,
 Rectangle mediabox)

isRotateContents

boolean isRotateContents()

Getter for property rotateContents.

Returns:

Value of property rotateContents.

setRotateContents

void setRotateContents(boolean rotateContents)

Setter for property rotateContents.

Parameters:

rotateContents - New value of property rotateContents.

isContentWritten

boolean isContentWritten()

getAcroFields

AcroFields getAcroFields()

setFormFlattening

void setFormFlattening(boolean flat)

setFreeTextFlattening

void setFreeTextFlattening(boolean flat)

partialFormFlattening

boolean partialFormFlattening(String name)

flatFields

protected void flatFields()

eliminateAcroformObjects

void eliminateAcroformObjects()

calculateTemplateTransformationMatrix

private AffineTransform calculateTemplateTransformationMatrix(AffineTransform currentMatrix,
 double fieldRotation,
 Rectangle box)

sweepKids

void sweepKids(PdfObject obj)

setFlatAnnotations

public void setFlatAnnotations(boolean flatAnnotations)

If true, annotations with an appearance stream will be flattened.

Parameters:

flatAnnotations - boolean

Since:

5.5.3

flattenAnnotations

protected void flattenAnnotations()

If setFlatAnnotations is set to true, iText will flatten all annotations with an appearance stream

Since:

5.5.3

flattenAnnotations

private void flattenAnnotations(boolean flattenFreeTextAnnotations)

transformBBoxByMatrix

private Rectangle transformBBoxByMatrix(Rectangle bBox,
 double[] matrix)

transformPoint

private Point transformPoint(double x,
 double y,
 double[] matrix)

flatFreeTextFields

protected void flatFreeTextFields()

getPageReference

public PdfIndirectReference getPageReference(int page)

Description copied from class: PdfWriter

Use this method to get a reference to a page existing or not. If the page does not exist yet the reference will be created in advance. If on closing the document, a page number greater than the total number of pages was requested, an exception is thrown.

Overrides:

getPageReference in class PdfWriter

Parameters:

page - the page number. The first page is 1

Returns:

the reference to the page

See Also:

• PdfWriter.getPageReference(int)

addAnnotation

public void addAnnotation(PdfAnnotation annot)

Description copied from interface: PdfAnnotations

Use this methods to add a PdfAnnotation or a PdfFormField to the document. Only the top parent of a PdfFormField needs to be added.

Specified by:

addAnnotation in interface PdfAnnotations

Overrides:

addAnnotation in class PdfWriter

Parameters:

annot - the PdfAnnotation or the PdfFormField to add

See Also:

• PdfWriter.addAnnotation(com.itextpdf.text.pdf.PdfAnnotation)

addDocumentField

void addDocumentField(PdfIndirectReference ref)

addFieldResources

protected void addFieldResources()
                          throws IOException

Throws:

IOException

expandFields

void expandFields(PdfFormField field,
 ArrayList<PdfAnnotation> allAnnots)

addAnnotation

void addAnnotation(PdfAnnotation annot,
 PdfDictionary pageN)

addAnnotation

void addAnnotation(PdfAnnotation annot,
 int page)

Overrides:

addAnnotation in class PdfWriter

outlineTravel

private void outlineTravel(PRIndirectReference outline)

deleteOutlines

void deleteOutlines()

setJavaScript

protected void setJavaScript()
                      throws IOException

Throws:

IOException

addFileAttachments

protected void addFileAttachments()
                           throws IOException

Throws:

IOException

makePackage

void makePackage(PdfCollection collection)

Adds or replaces the Collection Dictionary in the Catalog.

Parameters:

collection - the new collection dictionary.

setOutlines

protected void setOutlines()
                    throws IOException

Throws:

IOException

setViewerPreferences

public void setViewerPreferences(int preferences)

Sets the viewer preferences.

Specified by:

setViewerPreferences in interface PdfViewerPreferences

Overrides:

setViewerPreferences in class PdfWriter

Parameters:

preferences - the viewer preferences

See Also:

• PdfWriter.setViewerPreferences(int)

addViewerPreference

public void addViewerPreference(PdfName key,
 PdfObject value)

Adds a viewer preference

Specified by:

addViewerPreference in interface PdfViewerPreferences

Overrides:

addViewerPreference in class PdfWriter

Parameters:

key - a key for a viewer preference

value - the value for the viewer preference

See Also:

• PdfViewerPreferences.addViewerPreference(PdfName, PdfObject)

setSigFlags

public void setSigFlags(int f)

Set the signature flags.

Specified by:

setSigFlags in interface PdfAnnotations

Overrides:

setSigFlags in class PdfWriter

Parameters:

f - the flags. This flags are ORed with current ones

See Also:

• PdfAnnotations.setSigFlags(int)

setPageAction

public void setPageAction(PdfName actionType,
 PdfAction action)
                   throws PdfException

Always throws an UnsupportedOperationException.

Specified by:

setPageAction in interface PdfPageActions

Overrides:

setPageAction in class PdfWriter

Parameters:

actionType - ignore

action - ignore

Throws:

PdfException - ignore

See Also:

• PdfStamper.setPageAction(PdfName, PdfAction, int)

setPageAction

void setPageAction(PdfName actionType,
 PdfAction action,
 int page)
            throws PdfException

Sets the open and close page additional action.

Parameters:

actionType - the action type. It can be PdfWriter.PAGE_OPEN or PdfWriter.PAGE_CLOSE

action - the action to perform

page - the page where the action will be applied. The first page is 1

Throws:

PdfException - if the action type is invalid

setDuration

public void setDuration(int seconds)

Always throws an UnsupportedOperationException.

Specified by:

setDuration in interface PdfPageActions

Overrides:

setDuration in class PdfWriter

Parameters:

seconds - ignore

See Also:

• PdfPageActions.setDuration(int)

setTransition

public void setTransition(PdfTransition transition)

Always throws an UnsupportedOperationException.

Specified by:

setTransition in interface PdfPageActions

Overrides:

setTransition in class PdfWriter

Parameters:

transition - ignore

See Also:

• PdfPageActions.setTransition(com.itextpdf.text.pdf.PdfTransition)

setDuration

void setDuration(int seconds,
 int page)

Sets the display duration for the page (for presentations)

Parameters:

seconds - the number of seconds to display the page. A negative value removes the entry

page - the page where the duration will be applied. The first page is 1

setTransition

void setTransition(PdfTransition transition,
 int page)

Sets the transition for the page

Parameters:

transition - the transition object. A null removes the transition

page - the page where the transition will be applied. The first page is 1

markUsed

protected void markUsed(PdfObject obj)

markUsed

protected void markUsed(int num)

isAppend

boolean isAppend()

Getter for property append.

Returns:

Value of property append.

getPdfReader

public PdfReader getPdfReader()

setAdditionalAction

public void setAdditionalAction(PdfName actionType,
 PdfAction action)
                         throws PdfException

Additional-actions defining the actions to be taken in response to various trigger events affecting the document as a whole. The actions types allowed are: DOCUMENT_CLOSE, WILL_SAVE, DID_SAVE, WILL_PRINT and DID_PRINT.

Specified by:

setAdditionalAction in interface PdfDocumentActions

Overrides:

setAdditionalAction in class PdfWriter

Parameters:

actionType - the action type

action - the action to execute in response to the trigger

Throws:

PdfException - on invalid action type

See Also:

• PdfDocumentActions.setAdditionalAction(com.itextpdf.text.pdf.PdfName, com.itextpdf.text.pdf.PdfAction)

setOpenAction

public void setOpenAction(PdfAction action)

Description copied from interface: PdfDocumentActions

When the document opens this action will be invoked.

Specified by:

setOpenAction in interface PdfDocumentActions

Overrides:

setOpenAction in class PdfWriter

Parameters:

action - the action to be invoked

See Also:

• PdfWriter.setOpenAction(com.itextpdf.text.pdf.PdfAction)

setOpenAction

public void setOpenAction(String name)

Description copied from interface: PdfDocumentActions

When the document opens it will jump to the destination with this name.

Specified by:

setOpenAction in interface PdfDocumentActions

Overrides:

setOpenAction in class PdfWriter

Parameters:

name - the name of the destination to jump to

See Also:

• PdfWriter.setOpenAction(java.lang.String)

setThumbnail

public void setThumbnail(Image image)

Description copied from class: PdfWriter

Use this method to set the thumbnail image for the current page.

Overrides:

setThumbnail in class PdfWriter

Parameters:

image - the image

See Also:

• PdfWriter.setThumbnail(com.itextpdf.text.Image)

setThumbnail

void setThumbnail(Image image,
 int page)
           throws PdfException,
DocumentException

Throws:

PdfException

DocumentException

getDirectContentUnder

public PdfContentByte getDirectContentUnder()

Description copied from class: PdfWriter

Use this method to get the direct content under for this document. There is only one direct content, multiple calls to this method will always retrieve the same object.

Overrides:

getDirectContentUnder in class PdfWriter

Returns:

the direct content

getDirectContent

public PdfContentByte getDirectContent()

Description copied from class: PdfWriter

Use this method to get the direct content for this document. There is only one direct content, multiple calls to this method will allways retrieve the same object.

Overrides:

getDirectContent in class PdfWriter

Returns:

the direct content

readOCProperties

protected void readOCProperties()

Reads the OCProperties dictionary from the catalog of the existing document and fills the documentOCG, documentOCGorder and OCGRadioGroup variables in PdfWriter. Note that the original OCProperties of the existing document can contain more information.

Since:

2.1.2

addOrder

private void addOrder(PdfLayer parent,
 PdfArray arr,
 Map<String,PdfLayer> ocgmap)

Recursive method to reconstruct the documentOCGorder variable in the writer.

Parameters:

parent - a parent PdfLayer (can be null)

arr - an array possibly containing children for the parent PdfLayer

ocgmap - a HashMap with indirect reference Strings as keys and PdfLayer objects as values.

Since:

2.1.2

getPdfLayers

public Map<String,PdfLayer> getPdfLayers()

Gets the PdfLayer objects in an existing document as a Map with the names/titles of the layers as keys.

Returns:

a Map with all the PdfLayers in the document (and the name/title of the layer as key)

Since:

2.1.2

registerLayer

void registerLayer(PdfOCG layer)

Overrides:

registerLayer in class PdfWriter

createXmpMetadata

public void createXmpMetadata()

Description copied from class: PdfWriter

Use this method to creates XMP Metadata based on the metadata in the PdfDocument.

Overrides:

createXmpMetadata in class PdfWriter

getNamedDestinations

protected HashMap<Object, PdfObject> getNamedDestinations()

updateNamedDestinations

protected void updateNamedDestinations()
                                throws IOException

Throws:

IOException

getLastChildInNameTree

private PdfArray getLastChildInNameTree(PdfDictionary dic)