com.aspose.pdf

Interfaces

Classes

Enums

Exceptions

Skip navigation links
com.aspose.pdf

Class 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 :  (Iterable<ImagePlacement>)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 Resources. The object ImagePlacement is intended to provide such information like dimensions, resolution and so on.

    • Method Detail

      • getMatrix

        public Matrix getMatrix()

        Current transformation matrix for this image.

        Returns:
        Matrix object

      • getRectangle

        public Rectangle getRectangle()

        Gets rectangle of the Image.

        Returns:
        Rectangle object

      • getRotation

        public float getRotation()

        Gets rotation angle of the Image.

        Returns:
        int value

      • getResolution

        public Resolution getResolution()

        Gets resolution of the Image.

        Returns:
        Resolution object

      • getImage

        public XImage getImage()

        Gets related XImage resource object.

        Returns:
        XImage object

      • getPage

        public Page getPage()

        Gets the page containing the image.

        Returns:
        Page object

      • getCompositingParameters

        public CompositingParameters getCompositingParameters()

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

        Returns:
        CompositingParameters object

      • replace

        public void replace(InputStream image)

        Replace image in collection with another image.

        Parameters:
        image - Stream containing image data.

      • save

        public void save(OutputStream outputStream)

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

        Parameters:
        outputStream - Stream where image will be saved

      • save

        public void save(OutputStream outputStream,
                 ImageType format)

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

        Parameters:
        outputStream - Stream where image will be saved
        format - Format which will be used for image enconding. ImageFormat