Working with Transparency in PS file | Java

Add transparency in PS document

PostScript doesn’t support transparency in painting vector graphics objects. However, translucent (partially transparent) images can be rendered as a set of fully transparent and fully opaque pixels. Such images are called masks.

Aspose.Page for Java library offers a method that adds the transparent image to the PS document. As for painting vector graphics: shapes or text, we offer “pseudo-transparency”. “Pseudo-transparency” is a process of paling colors that have an Alpha component of less than 255. It is reached by the blending of Red, Green, and Blue components with Alpha one. “Pseudo-transparency”, of course, doesn’t allow us to see the lower colored layer from under the upper transparent layer, but makes an illusion of transparency if the bottom layer is white.

Add transparent image in PS document

As we wrote earlier transparent images can be added to the PS document as a mask and Aspose.Page for Java library offers for this purpose a method addTransparentImage(). This method recognizes whether the image is fully opaque or fully transparent or translucent. If it is fully opaque it is added as the opaque image in addImage() method, if it is fully transparent it is not added to the document at all, if it is the translucent image it is added as a PostScript image mask.

In the example below we demonstrate the difference between adding a transparent image in a PS document with addImage() and addTransparentImage(). In order to see the white translucent image we put big red rectangle under the images.

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

1. Create an output stream for the resulting PS file.
2. Create PsSaveOptions object with default options.
3. Create a 1-paged PsDocument with an already created output stream and save options.
4. Create a new graphics state.
5. Create java.awt.BufferedImage from image file.
6. Create the necessary transformation for the image.
7. Add the image to PsDocument as a fully opaque image (using addImage() method) if we are sure that the image is opaque or add one as a transparent image (using addTransparentImage() method) if we are not sure that the image is opaque.
8. Exit from the current graphics state to upper level one.
9. Close the page.
10. Save the document.

// Add transparent image to PS document.

String outputFileName = "AddTransparentImage_outPS.ps";

//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();
//Set page's background color to see white image on it's own transparent background
options.setBackgroundColor(new Color(211, 8, 48));

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

//document.setPaint(new Color(211, 8, 48));
//document.fill(new Rectangle2D.Float(0, 0, (int) options.getPageSize().getWidth(), 300));

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

//Create an image from translucent image file
BufferedImage image = ImageIO.read(new File(getDataDir() + "mask1.png"));

//Add this image to document as usual opaque RGB image
document.drawImage(image, new AffineTransform(1, 0, 0, 1, 100, 0), null);

//Add this image to document as transparent image
document.drawTransparentImage(image, new AffineTransform(1, 0, 0, 1, 350, 0), 255);

document.writeGraphicsRestore();

//Close current page
document.closePage();

//Save the document
document.save();

See working with transparency in PS document in .NET.

The result of running this code is next

Adding transparent vector graphics object

Earlier we wrote that Aspose.Page for Java library uses a paling algorithm for transparent shapes and text, which we called “pseudo-transparency”.

In the example below we demonstrate a difference between two shapes painted with the same color, but in the first shape without the Alpha component and in the second case with the Alpha component.

// Apply pseudo-transparency transparent image to PS document.

String outputFileName = "ApplyPseudoTranparency_outPS.ps";

//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();
//Set page's background color to see white image on it's own transparent background
options.setBackgroundColor(new Color(211, 8, 48));

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

float offsetX = 50;
float offsetY = 100;
float width = 200;
float height = 100;

///////////////////////////////// Create rectangle with opaque gradient fill /////////////////////////////////////////////////////////
GeneralPath path = new GeneralPath();
path.append(new Rectangle2D.Float(offsetX, offsetY, width, height), false);

LinearGradientPaint opaquePaint = new LinearGradientPaint(new Point2D.Float(0, 0), new Point2D.Float(200, 100),
        new float[] {0f, 1f}, new Color[] {new Color(0, 0, 0), new Color(40, 128, 70)} , MultipleGradientPaint.CycleMethod.NO_CYCLE,
        MultipleGradientPaint.ColorSpaceType.SRGB, new AffineTransform(width, 0, 0, height, offsetX, offsetY));

document.setPaint(opaquePaint);
document.fill(path);

offsetX = 350;

///////////////////////////////// Create rectangle with translucent gradient fill ///////////////////////////////////////////////////
path = new GeneralPath();
path.append(new Rectangle2D.Float(offsetX, offsetY, width, height), false);

LinearGradientPaint translucentPaint = new LinearGradientPaint(new Point2D.Float(0, 0), new Point2D.Float(width, height),
        new float[] {0f, 1f}, new Color[] {new Color(0, 0, 0, 150), new Color(40, 128, 70, 50)}, MultipleGradientPaint.CycleMethod.NO_CYCLE,
        MultipleGradientPaint.ColorSpaceType.SRGB, new AffineTransform(width, 0, 0, height, offsetX, offsetY));

document.setPaint(translucentPaint);
document.fill(path);

//Close current page
document.closePage();

//Save the document
document.save();

See working with transparency in PS documents in .NET and C++.

The result of running this code is appeared as

You can download examples and data files from GitHub.