ImagePlacement

Inheritance: java.lang.Object, com.aspose.pdf.ImagePlacement

public final class ImagePlacement extends Object

Represents characteristics of an image placed to Pdf document page.


 The example demonstrates how to find images on the first PDF document page and get images as bitmaps with visible dimensions. // Open document Document doc = new Document("D:\\Tests\\input.pdf"); // Create ImagePlacementAbsorber object to perform image placement search ImagePlacementAbsorber abs = new ImagePlacementAbsorber(); // Accept the absorber for first page doc.getPages().get_Item(1).accept(abs); // Retrieve images with visible dimensions for (ImagePlacement imagePlacement : {@code (Iterable)}abs.getImagePlacements()) { BufferedImage scaledImage; ByteArrayOutputStream imageStream = new ByteArrayOutputStream()) // Retrieve image from resources imagePlacement.getImage().save(imageStream, ImageFormatInternal.Png); BufferedImage resourceImage = (BufferedImage) ImageIO.read(imageStream); // Create new bitmap with actual dimensions scaledImage = new BufferedImage(resourceImage, (int)imagePlacement.getRectangle().getWidth(), (int)imagePlacement.getRectangle().getHeight()); } 

When an image is placed to a page it may have dimensions other than physical dimensions defined in {@code Resources}. The object {@code ImagePlacement} is intended to provide such information like dimensions, resolution and so on.

Methods

MethodDescription
getCompositingParametersGets compositing parameters of graphics state active for the image placed to the page.
getImageGets related XImage resource object.
getMatrixCurrent transformation matrix for this image.
getOperatorOperator used for displaying the image.
getPageGets the page containing the image.
getRectangleGets rectangle of the Image.
getResolutionGets resolution of the Image.
getRotationGets rotation angle of the Image.
hideDelete image from the page.
replaceReplace image in collection with another image.
saveSaves image with corresponding transformations: scaling, rotation and resolution.
saveSaves image with corresponding transformations: scaling, rotation and resolution.

getCompositingParameters

public CompositingParameters getCompositingParameters()

Gets compositing parameters of graphics state active for the image placed to the page.

Returns: CompositingParameters object

getImage

public XImage getImage()

Gets related XImage resource object.

Returns: XImage object

getMatrix

public Matrix getMatrix()

Current transformation matrix for this image.

Returns: Matrix object

getOperator

public final Operator getOperator()

Operator used for displaying the image.

Returns: Operator instance

getPage

public Page getPage()

Gets the page containing the image.

Returns: Page object

getRectangle

public Rectangle getRectangle()

Gets rectangle of the Image.

Returns: Rectangle object

getResolution

public Resolution getResolution()

Gets resolution of the Image.

Returns: Resolution object

getRotation

public float getRotation()

Gets rotation angle of the Image.

Returns: int value

hide

public final void hide()

Delete image from the page.

replace

Replace image in collection with another image.

save

Saves image with corresponding transformations: scaling, rotation and resolution.

save

Saves image with corresponding transformations: scaling, rotation and resolution.