Working with Images in PS file | Java

Add Image in PS Document

The Aspose.Page for Java library offers two methods for adding images to a PS document:

• for opaque images;
• for transparent images;

This was done because PostScript doesn’t support transparency. However, translucent images can be rendered as a set of fully transparent and fully opaque pixels. Such images are called masks.

If we want to see the translucent image in the PS document as a mask that will better reflect the transparency of the image, we should do some checking and preprocessing of such an image. The check and preprocessing require time. Therefore, if one is sure that the image is fully opaque, it is better to use the first method, as it saves execution time.

The second method recognizes whether the image is fully opaque, fully transparent, or translucent. If it is fully opaque, it is added as the opaque image in the first method; if it is fully transparent, it is not added to the document at all; if it is a translucent image, it is added as a PostScript image mask.

In the example below, we demonstrate how to add a fully opaque image. Adding a transparent image will be demonstrated in the “Working with Transparency” article.

In order to add an image to a new PsDocument with the Aspose.Page for Java library in this example, we take the following steps:

1. Create an output stream for the resulting PS file.
2. Create a PsSaveOptions object with default options.
3. Create a 1-paged PsDocument with the already created output stream and save options.
4. Create a new graphics state.
5. Create java.awt.image.BufferedImage from an image file.
6. Create the necessary transformation for the image.
7. Add the image to the PsDocument object.
8. Exit from the current graphics state to the upper-level one.
9. Close the page.
10. Save the document.

// Add image to PS document.

String outputFileName = "AddImage_outPS.ps";

//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();

// Create new 1-paged PS Document
PsDocument document = new PsDocument(getOutputDir() + outputFileName, options, false);

document.writeGraphicsSave();
document.translate(100, 100);

//Create a BufferedImage object from image file
try {
    BufferedImage image = ImageIO.read(new java.io.File(getDataDir() + "TestImage Format24bppRgb.jpg"));
    
    //Create image transform
    AffineTransform transform = new AffineTransform();
    transform.translate(35, 300);
    transform.scale(3, 3);
    transform.rotate(Math.toRadians(-45));

    //Add image to document
    document.drawImage(image, transform, Color.WHITE);
} catch (IOException ex) {
}

document.writeGraphicsRestore();

//Close current page
document.closePage();

//Save the document
document.save();

See working with images in PS documents in .NET.

The result of running this code appears as follows:

You can download examples and data files from GitHub.