Package com.itextpdf.text.pdf
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
-
Nested Class Summary
Nested ClassesNested classes/interfaces inherited from class com.itextpdf.text.pdf.PdfWriter
PdfWriter.PdfBody, PdfWriter.PdfTrailer
-
Field Summary
FieldsModifier and TypeFieldDescriptionprotected AcroFields
protected boolean
private HashMap<String,
PdfIndirectReference> protected boolean
protected Counter
private double[]
protected boolean
protected HashSet<PdfTemplate>
protected RandomAccessFileOrArray
protected boolean
protected boolean
protected boolean
protected int
private Logger
protected IntHashtable
(package private) IntHashtable
protected int[]
protected PdfAction
private boolean
(package private) HashMap<PdfDictionary,
PdfStamperImp.PageStamp> Integer(page number) -> PageStamp(package private) PdfReader
(package private) HashMap<PdfReader,
RandomAccessFileOrArray> (package private) HashMap<PdfReader,
IntHashtable> private boolean
Holds value of property rotateContents.protected int
protected boolean
protected PdfViewerPreferencesImp
Fields inherited from class com.itextpdf.text.pdf.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
-
Constructor Summary
ConstructorsModifierConstructorDescriptionprotected
PdfStamperImp
(PdfReader reader, OutputStream os, char pdfVersion, boolean append) Creates new PdfStamperImp. -
Method Summary
Modifier and TypeMethodDescriptionvoid
addAnnotation
(PdfAnnotation annot) Use this methods to add aPdfAnnotation
or aPdfFormField
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
protected void
protected void
private void
Recursive method to reconstruct the documentOCGorder variable in the writer.void
addViewerPreference
(PdfName key, PdfObject value) Adds a viewer preferenceprotected void
(package private) void
(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
(package private) void
correctAcroFieldPages
(int page) void
Use this method to creates XMP Metadata based on the metadata in the PdfDocument.(package private) void
(package private) void
(package private) void
expandFields
(PdfFormField field, ArrayList<PdfAnnotation> allAnnots) (package private) static void
findAllObjects
(PdfReader reader, PdfObject obj, IntHashtable hits) protected void
protected void
protected void
If setFlatAnnotations is set to true, iText will flatten all annotations with an appearance streamprivate void
flattenAnnotations
(boolean flattenFreeTextAnnotations) (package private) AcroFields
protected Counter
Use this method to get the direct content for this document.Use this method to get the direct content under for this document.private PdfArray
protected int
getNewObjectNumber
(PdfReader reader, int number, int generation) (package private) PdfContentByte
getOverContent
(int pageNum) getPageReference
(int page) Use this method to get a reference to a page existing or not.(package private) PdfStamperImp.PageStamp
getPageStamp
(int pageNum) Gets the PdfLayer objects in an existing document as a Map with the names/titles of the layers as keys.(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
(package private) boolean
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
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
protected void
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 anUnsupportedOperationException
.(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
void
setOpenAction
(PdfAction action) When the document opens thisaction
will be invoked.void
setOpenAction
(String name) When the document opens it will jump to the destination with this name.protected void
void
setPageAction
(PdfName actionType, PdfAction action) Always throws anUnsupportedOperationException
.(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 anUnsupportedOperationException
.(package private) void
setTransition
(PdfTransition transition, int page) Sets the transition for the pageprotected void
void
setViewerPreferences
(int preferences) Sets the viewer preferences.(package private) void
private Rectangle
transformBBoxByMatrix
(Rectangle bBox, double[] matrix) private Point
transformPoint
(double x, double y, double[] matrix) void
unRegisterReader
(PdfReader reader) protected void
Methods inherited from class com.itextpdf.text.pdf.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 com.itextpdf.text.DocWriter
add, addTabs, flush, getISOBytes, isCloseStream, isPaused, newPage, pause, resetPageCount, resume, setCloseStream, setMarginMirroring, setMarginMirroringTopBottom, setMargins, setPageCount, setPageSize, write, write, writeEnd, writeEnd, writeMarkupAttributes, writeStart
-
Field Details
-
readers2intrefs
HashMap<PdfReader,IntHashtable> readers2intrefs -
readers2file
HashMap<PdfReader,RandomAccessFileOrArray> readers2file -
file
-
reader
PdfReader reader -
myXref
IntHashtable myXref -
pagesToContent
HashMap<PdfDictionary,PdfStamperImp.PageStamp> pagesToContentInteger(page number) -> PageStamp -
closed
protected boolean closed -
rotateContents
private boolean rotateContentsHolds value of property rotateContents. -
acroFields
-
flat
protected boolean flat -
flatFreeText
protected boolean flatFreeText -
flatannotations
protected boolean flatannotations -
namePtr
protected int[] namePtr -
partialFlattening
-
useVp
protected boolean useVp -
viewerPreferences
-
fieldTemplates
-
fieldsAdded
protected boolean fieldsAdded -
sigFlags
protected int sigFlags -
append
protected boolean append -
marked
-
initialXrefSize
protected int initialXrefSize -
openAction
-
namedDestinations
-
COUNTER
-
logger
-
originalLayersAreRead
private boolean originalLayersAreRead -
builtInAnnotationFonts
-
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 PDFos
- the output destinationpdfVersion
- the new pdf version or '\0' to keep the same version as the original documentappend
-- Throws:
DocumentException
- on errorIOException
-
-
Method Details
-
getCounter
- Overrides:
getCounter
in classPdfWriter
-
readColorProfile
protected void readColorProfile() -
setViewerPreferences
protected void setViewerPreferences() -
close
- Throws:
IOException
-
close
- Throws:
IOException
-
applyRotation
-
alterContents
- Throws:
IOException
-
alterResources
-
getNewObjectNumber
- Overrides:
getNewObjectNumber
in classPdfWriter
-
getReaderFile
- Overrides:
getReaderFile
in classPdfWriter
-
registerReader
- Parameters:
reader
-openFile
-- Throws:
IOException
-
unRegisterReader
- Parameters:
reader
-
-
findAllObjects
-
addComments
- Parameters:
fdf
-- Throws:
IOException
-
getPageStamp
-
getUnderContent
-
getOverContent
-
correctAcroFieldPages
void correctAcroFieldPages(int page) -
moveRectangle
private static void moveRectangle(PdfDictionary dic2, PdfReader r, int pageImported, PdfName key, String name) -
replacePage
-
insertPage
-
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
-
flatFields
protected void flatFields() -
eliminateAcroformObjects
void eliminateAcroformObjects() -
calculateTemplateTransformationMatrix
private AffineTransform calculateTemplateTransformationMatrix(AffineTransform currentMatrix, double fieldRotation, Rectangle box) -
sweepKids
-
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
-
transformPoint
-
flatFreeTextFields
protected void flatFreeTextFields() -
getPageReference
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 classPdfWriter
- Parameters:
page
- the page number. The first page is 1- Returns:
- the reference to the page
- See Also:
-
addAnnotation
Description copied from interface:PdfAnnotations
Use this methods to add aPdfAnnotation
or aPdfFormField
to the document. Only the top parent of aPdfFormField
needs to be added.- Specified by:
addAnnotation
in interfacePdfAnnotations
- Overrides:
addAnnotation
in classPdfWriter
- Parameters:
annot
- thePdfAnnotation
or thePdfFormField
to add- See Also:
-
addDocumentField
-
addFieldResources
- Throws:
IOException
-
expandFields
-
addAnnotation
-
addAnnotation
- Overrides:
addAnnotation
in classPdfWriter
-
outlineTravel
-
deleteOutlines
void deleteOutlines() -
setJavaScript
- Throws:
IOException
-
addFileAttachments
- Throws:
IOException
-
makePackage
Adds or replaces the Collection Dictionary in the Catalog.- Parameters:
collection
- the new collection dictionary.
-
setOutlines
- Throws:
IOException
-
setViewerPreferences
public void setViewerPreferences(int preferences) Sets the viewer preferences.- Specified by:
setViewerPreferences
in interfacePdfViewerPreferences
- Overrides:
setViewerPreferences
in classPdfWriter
- Parameters:
preferences
- the viewer preferences- See Also:
-
addViewerPreference
Adds a viewer preference- Specified by:
addViewerPreference
in interfacePdfViewerPreferences
- Overrides:
addViewerPreference
in classPdfWriter
- Parameters:
key
- a key for a viewer preferencevalue
- the value for the viewer preference- See Also:
-
setSigFlags
public void setSigFlags(int f) Set the signature flags.- Specified by:
setSigFlags
in interfacePdfAnnotations
- Overrides:
setSigFlags
in classPdfWriter
- Parameters:
f
- the flags. This flags are ORed with current ones- See Also:
-
setPageAction
Always throws anUnsupportedOperationException
.- Specified by:
setPageAction
in interfacePdfPageActions
- Overrides:
setPageAction
in classPdfWriter
- Parameters:
actionType
- ignoreaction
- ignore- Throws:
PdfException
- ignore- See Also:
-
setPageAction
Sets the open and close page additional action.- Parameters:
actionType
- the action type. It can bePdfWriter.PAGE_OPEN
orPdfWriter.PAGE_CLOSE
action
- the action to performpage
- 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 anUnsupportedOperationException
.- Specified by:
setDuration
in interfacePdfPageActions
- Overrides:
setDuration
in classPdfWriter
- Parameters:
seconds
- ignore- See Also:
-
setTransition
Always throws anUnsupportedOperationException
.- Specified by:
setTransition
in interfacePdfPageActions
- Overrides:
setTransition
in classPdfWriter
- Parameters:
transition
- ignore- See Also:
-
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 entrypage
- the page where the duration will be applied. The first page is 1
-
setTransition
Sets the transition for the page- Parameters:
transition
- the transition object. Anull
removes the transitionpage
- the page where the transition will be applied. The first page is 1
-
markUsed
-
markUsed
protected void markUsed(int num) -
isAppend
boolean isAppend()Getter for property append.- Returns:
- Value of property append.
-
getPdfReader
-
setAdditionalAction
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
andDID_PRINT
.- Specified by:
setAdditionalAction
in interfacePdfDocumentActions
- Overrides:
setAdditionalAction
in classPdfWriter
- Parameters:
actionType
- the action typeaction
- the action to execute in response to the trigger- Throws:
PdfException
- on invalid action type- See Also:
-
setOpenAction
Description copied from interface:PdfDocumentActions
When the document opens thisaction
will be invoked.- Specified by:
setOpenAction
in interfacePdfDocumentActions
- Overrides:
setOpenAction
in classPdfWriter
- Parameters:
action
- the action to be invoked- See Also:
-
setOpenAction
Description copied from interface:PdfDocumentActions
When the document opens it will jump to the destination with this name.- Specified by:
setOpenAction
in interfacePdfDocumentActions
- Overrides:
setOpenAction
in classPdfWriter
- Parameters:
name
- the name of the destination to jump to- See Also:
-
setThumbnail
Description copied from class:PdfWriter
Use this method to set the thumbnail image for the current page.- Overrides:
setThumbnail
in classPdfWriter
- Parameters:
image
- the image- See Also:
-
setThumbnail
- Throws:
PdfException
DocumentException
-
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 classPdfWriter
- Returns:
- the direct content
-
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 classPdfWriter
- 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
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 PdfLayerocgmap
- a HashMap with indirect reference Strings as keys and PdfLayer objects as values.- Since:
- 2.1.2
-
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
- Overrides:
registerLayer
in classPdfWriter
-
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 classPdfWriter
-
getNamedDestinations
-
updateNamedDestinations
- Throws:
IOException
-
getLastChildInNameTree
-