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.

// 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();

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.

// 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();

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.