Package org.apache.poi.xslf.usermodel

Class XSLFPictureData

java.lang.Object

org.apache.poi.ooxml.POIXMLDocumentPart

org.apache.poi.xslf.usermodel.XSLFPictureData

All Implemented Interfaces:

PictureData

@Beta
public final class XSLFPictureData
extends POIXMLDocumentPart
implements PictureData

Instantiates sub-classes of POIXMLDocumentPart depending on their relationship type

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.poi.ooxml.POIXMLDocumentPart

POIXMLDocumentPart.RelationPart

Nested classes/interfaces inherited from interface org.apache.poi.sl.usermodel.PictureData

PictureData.PictureType

Constructor Summary

Constructors

Constructor	Description
XSLFPictureData(PackagePart part)	Construct XSLFPictureData from a package part

Method Summary

Modifier and Type	Method	Description
byte[]	getChecksum()	Gets the checksum - the checksum can be of various length - mostly it's 8 (XSLF) or 16 (HSLF) bytes long.
String	getContentType()	Returns content type (mime type) of this picture.
byte[]	getData()	Gets the picture data as a byte array.
String	getFileName()	Returns the file name of the image, eg image7.jpg .
Dimension	getImageDimension()	Return the original image dimensions in points (for formats supported by BufferedImage).
Dimension	getImageDimensionInPixels()	Return the original image dimensions in pixels
int	getIndex()
InputStream	getInputStream()	An InputStream to read the picture data directly from the underlying package part
PictureData.PictureType	getType()
void	setData(byte[] data)	Sets the binary picture data
void	setIndex(int index)
String	suggestFileExtension()	Suggests a file extension for this image.

Methods inherited from class org.apache.poi.ooxml.POIXMLDocumentPart

_invokeOnDocumentRead, addRelation, createRelationship, createRelationship, createRelationship, getPackagePart, getParent, getRelationById, getRelationId, getRelationPartById, getRelationParts, getRelations, isCommited, setCommited, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

XSLFPictureData

public XSLFPictureData(PackagePart part)

Construct XSLFPictureData from a package part

Parameters:

part - the package part holding the drawing data

Since:

POI 3.14-Beta1

Method Detail

getInputStream

public InputStream getInputStream()
                           throws IOException

An InputStream to read the picture data directly from the underlying package part

Returns:

InputStream

Throws:

IOException

getData

public byte[] getData()

Gets the picture data as a byte array. You can grab the picture data directly from the underlying package part with the getInputStream() method

Specified by:

getData in interface PictureData

Returns:

the Picture data.

getFileName

public String getFileName()

Returns the file name of the image, eg image7.jpg . The original filename isn't always available, but if it can be found it's likely to be in the CTDrawing

suggestFileExtension

public String suggestFileExtension()

Suggests a file extension for this image.

Returns:

the file extension.

getChecksum

public byte[] getChecksum()

Description copied from interface: PictureData

Gets the checksum - the checksum can be of various length - mostly it's 8 (XSLF) or 16 (HSLF) bytes long.

Specified by:

getChecksum in interface PictureData

Returns:

the checksum

getImageDimension

public Dimension getImageDimension()

Description copied from interface: PictureData

Return the original image dimensions in points (for formats supported by BufferedImage). Will return a Dimension with a default width of 200x200 if the format unsupported.

Specified by:

getImageDimension in interface PictureData

getImageDimensionInPixels

public Dimension getImageDimensionInPixels()

Description copied from interface: PictureData

Return the original image dimensions in pixels

Specified by:

getImageDimensionInPixels in interface PictureData

See Also:

PictureData.getImageDimension()

getContentType

public String getContentType()

Description copied from interface: PictureData

Returns content type (mime type) of this picture.

Specified by:

getContentType in interface PictureData

Returns:

content type of this picture.

setData

public void setData(byte[] data)
             throws IOException

Description copied from interface: PictureData

Sets the binary picture data

Specified by:

setData in interface PictureData

Parameters:

data - picture data

Throws:

IOException

getType

public PictureData.PictureType getType()

Specified by:

getType in interface PictureData

Returns:

the picture type

getIndex

public int getIndex()

Returns:

the 0-based index of this pictures within the picture parts

setIndex

public void setIndex(int index)

Parameters:

index - sets the 0-based index of this pictures within the picture parts