com.itextpdf.kernel.pdf.xobject

Class PdfXObject

java.lang.Object

com.itextpdf.kernel.pdf.PdfObjectWrapper<PdfStream>

com.itextpdf.kernel.pdf.xobject.PdfXObject

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

PdfFormXObject, PdfImageXObject

public abstract class PdfXObject
extends PdfObjectWrapper<PdfStream>

An abstract wrapper for supported types of XObject.

See Also:

PdfFormXObject, PdfImageXObject, Serialized Form

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	PdfXObject(PdfStream pdfObject)

Method Summary

Modifier and Type	Method and Description
void	addAssociatedFile(PdfFileSpec fs) Adds file associated with PDF XObject and identifies the relationship between them.
PdfArray	getAssociatedFiles(boolean create) Returns files associated with XObject.
float	getHeight() Gets height of XObject.
float	getWidth() Gets width of XObject.
protected boolean	isWrappedObjectMustBeIndirect() Defines if the object behind this wrapper must be an indirect object in the resultant document.
static PdfXObject	makeXObject(PdfStream stream) Create PdfFormXObject or PdfImageXObject by PdfStream.
void	setLayer(IPdfOCG layer) Sets the layer this XObject belongs to.

Methods inherited from class com.itextpdf.kernel.pdf.PdfObjectWrapper

ensureObjectIsAddedToDocument, ensureUnderlyingObjectHasIndirectReference, flush, getPdfObject, isFlushed, makeIndirect, makeIndirect, markObjectAsIndirect, setForbidRelease, setModified, setPdfObject, unsetForbidRelease

Methods inherited from class java.lang.Object

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

Constructor Detail

PdfXObject

protected PdfXObject(PdfStream pdfObject)

Method Detail

makeXObject

public static PdfXObject makeXObject(PdfStream stream)

Create PdfFormXObject or PdfImageXObject by PdfStream.

Parameters:

stream - PdfStream with either PdfName.Form or PdfName.Image PdfName.Subtype

Returns:

either PdfFormXObject or PdfImageXObject.

setLayer

public void setLayer(IPdfOCG layer)

Sets the layer this XObject belongs to.

Parameters:

layer - the layer this XObject belongs to.

getWidth

public float getWidth()

Gets width of XObject.

Returns:

float value.

getHeight

public float getHeight()

Gets height of XObject.

Returns:

float value.

addAssociatedFile

public void addAssociatedFile(PdfFileSpec fs)

Adds file associated with PDF XObject and identifies the relationship between them. Associated files may be used in Pdf/A-3 and Pdf 2.0 documents. The method adds file to array value of the AF key in the XObject dictionary.

For associated files their associated file specification dictionaries shall include the AFRelationship key

Parameters:

fs - file specification dictionary of associated file

getAssociatedFiles

public PdfArray getAssociatedFiles(boolean create)

Returns files associated with XObject.

Returns:

associated files array.

isWrappedObjectMustBeIndirect

protected boolean isWrappedObjectMustBeIndirect()

Defines if the object behind this wrapper must be an indirect object in the resultant document.

If this method returns true it doesn't necessarily mean that object must be in the indirect state at any moment, but rather defines that when the object will be written to the document it will be transformed into indirect object if it's not indirect yet.

Return value of this method shouldn't depend on any logic, it should return always true or false.

Specified by:

isWrappedObjectMustBeIndirect in class PdfObjectWrapper<PdfStream>

Returns:

true if in the resultant document the object behind the wrapper must be indirect, otherwise false.