Trabalhar com Transparência em ficheiro PS | Java

Adicionar transparência no documento PS

O PostScript não suporta transparência na pintura de objetos gráficos vetoriais. No entanto, as imagens translúcidas (parcialmente transparentes) podem ser renderizadas como um conjunto de pixéis totalmente transparentes e totalmente opacos. Estas imagens são chamadas de máscaras.

A biblioteca Aspose.Page para Java oferece um método que adiciona a imagem transparente ao documento PS. Para pintar gráficos vectoriais: formas ou texto, oferecemos “pseudotransparência”. “Pseudotransparência” é um processo de palidez de cor com uma componente Alfa inferior a 255. É conseguida pela mistura dos componentes Vermelho, Verde e Azul com uma componente Alfa. “Pseudotransparência”, claro, não nos permite ver a camada colorida inferior por baixo da camada transparente superior, mas cria uma ilusão de transparência se a camada inferior for branca.

Adicionar imagem transparente num documento PS

Como já referimos anteriormente, as imagens transparentes podem ser adicionadas ao documento PS como uma máscara e a biblioteca Aspose.Page para Java oferece para este efeito o método addTransparentImage(). Este método reconhece se a imagem é totalmente opaca, totalmente transparente ou translúcida. Se for totalmente opaca, é adicionada como a imagem opaca no método addImage(); se for totalmente transparente, não é adicionada ao documento; se for a imagem translúcida, é adicionada como uma máscara de imagem PostScript.

No exemplo abaixo, demonstramos a diferença entre adicionar uma imagem transparente num documento PS com addImage() e addTransparentImage(). Para visualizar a imagem branca translúcida, colocamos um grande retângulo vermelho por baixo das imagens.

Para adicionar qualquer imagem a um novo PsDocument com a biblioteca Aspose.Page para Java, neste exemplo, seguimos os seguintes passos:

1. Crie um fluxo de saída para o ficheiro PS resultante.
2. Crie o objeto PsSaveOptions com as opções padrão.
3. Crie um PsDocument de 1 página com um fluxo de saída já criado e opções de guardar.
4. Crie um novo estado gráfico.
5. Crie java.awt.BufferedImage a partir do ficheiro de imagem.
6. Crie a transformação necessária para a imagem.
7. Adicione a imagem ao PsDocument como uma imagem totalmente opaca (utilizando o método addImage()) se tivermos a certeza de que a imagem é opaca ou adicione uma como uma imagem transparente (utilizando o método addTransparentImage()) se não tivermos a certeza de que a imagem é opaca.
8. Saia do estado gráfico atual para o nível superior.
9. Feche a página.
10. Guarde o documento.

//Create an output stream for PostScript document
FileOutputStream outPsStream = new FileOutputStream(dataDir + "AddTransparentImage_outPS.ps");
//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();

//Create new PS Document with the page opened
PsDocument document = new PsDocument(outPsStream, options, false);

//Add big red rectangle under images to see the difference between addImage() and addTransparentImage() methods 
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(dataDir + "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();

Veja como trabalhar com transparência em documentos PS em .NET.

O resultado da execução deste código é o seguinte:

Adicionar objeto gráfico vetorial transparente

Anteriormente, escrevemos que a biblioteca Aspose. Page para Java utiliza um algoritmo de paleta para formas e texto transparentes, a que chamamos “pseudo-transparência”.

No exemplo abaixo, demonstramos a diferença entre duas formas pintadas com a mesma cor, mas na primeira forma sem a componente Alfa e no segundo caso com a componente Alfa.

//Create an output stream for PostScript document
FileOutputStream outPsStream = new FileOutputStream(dataDir + "ShowPseudoTransparency_outPS.ps");
//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();

//Create new PS Document with the page opened
PsDocument document = new PsDocument(outPsStream, options, false);

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

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

LinearGradientPaint paint = new LinearGradientPaint(new Point2D.Float(0, 0), new Point2D.Float(200, 100),
		new float [] {0, 1}, 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));

//Set paint
document.setPaint(paint);
//Fill the rectangle
document.fill(rectangle);
/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

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

paint = new LinearGradientPaint(new Point2D.Float(0, 0), new Point2D.Float(200, 100),
new float [] {0, 1}, 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));

//Set paint
document.setPaint(paint);
//Fill the rectangle
document.fill(rectangle);
/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////        

//Close current page
document.closePage();
//Save the document
document.save();

Veja como trabalhar com transparência em documentos PS em .NET e C++.

O resultado da execução deste código é apresentado como

Pode descarregar exemplos e ficheiros de dados do GitHub.