Trabalhar com Transparência em PostScript | .NET

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 .NET 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 combinação específica 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 .NET 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 ver a imagem branca translúcida, definimos a cor de fundo da página como não branca.

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

1. Crie um fluxo de saída para o ficheiro PS resultante.
2. Crie um objeto PsSaveOptions com as opções padrão. Altere a cor de fundo, se necessário.
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 um Bitmap 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
using (Stream outPsStream = new FileStream(dataDir + "AddTransparentImage_outPS.ps", FileMode.Create))
{
    //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.BackgroundColor = Color.FromArgb(211, 8, 48);

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


    document.WriteGraphicsSave();
    document.Translate(20, 100);

    //Create a bitmap from translucent image file
    using (Bitmap image = new Bitmap(dataDir + "mask1.png"))
    {
        //Add this image to the document as usual opaque RGB image
        document.DrawImage(image, new Matrix(1, 0, 0, 1, 100, 0), Color.Empty);
    }

    //Again create a bitmap from the same image file
    using (Bitmap image = new Bitmap(dataDir + "mask1.png"))
    {
        //Add this image to the document as transparent image
        document.DrawTransparentImage(image, new Matrix(1, 0, 0, 1, 350, 0), 255);
    }

    document.WriteGraphicsRestore();

    //Close current page
    document.ClosePage();

    //Save the document
    document.Save();
}

Para Linux, MacOS e outros sistemas operativos não Windows, oferecemos a utilização do nosso pacote NuGet Aspose.Page.Drawing. Utiliza o backend Aspose.Drawing em vez da biblioteca de sistema System.Drawing.

Assim, importe o namespace Aspose.Page.Drawing em vez do System.Drawing. Nos excertos de código acima e seguintes, será utilizado Aspose.Page.Drawing.Bitmap em vez de System.Drawing.Bitmap, Aspose.Page.Drawing.Drawing2D.Matrix será utilizado em vez de System.Drawing.Drawing2D.Matrix e assim por diante. Os nossos exemplos de código no GitHub contêm todas as substituições necessárias.

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

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

Adicionar objeto gráfico vetorial transparente

Anteriormente, escrevemos que a biblioteca Aspose.Page para .NET 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
using (Stream outPsStream = new FileStream(dataDir + "ShowPseudoTransparency_outPS.ps", FileMode.Create))
{
    //Create save options with A4 size
    PsSaveOptions options = new PsSaveOptions();

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

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

///////////////////////////////// Create a rectangle with opaque gradient fill /////////////////////////////////////////////////////////
    GraphicsPath path = new GraphicsPath();
    path.AddRectangle(new RectangleF(50, 100, 200, 100));

    LinearGradientBrush opaqueBrush = new LinearGradientBrush(new RectangleF(0, 0, 200, 100), Color.FromArgb(0, 0, 0),
        Color.FromArgb(40, 128, 70), 0f);
    Matrix brushTransform = new Matrix(200, 0, 0, 100, 50, 100);
    opaqueBrush.Transform = brushTransform;
    Aspose.Page.EPS.GradientBrush gradientBrush = new GradientBrush(opaqueBrush);
    gradientBrush.WrapMode = WrapMode.Clamp;

    document.SetPaint(gradientBrush);
    document.Fill(path);
/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

    offsetX = 350;

///////////////////////////////// Create a rectangle with translucent gradient fill ///////////////////////////////////////////////////
    //Create graphics path from the first rectangle
    path = new GraphicsPath();
    path.AddRectangle(new RectangleF(offsetX, offsetY, width, height));

    //Create linear gradient brush colors which transparency are not 255, but 150 and 50. So it are translucent.
    LinearGradientBrush translucentBrush = new LinearGradientBrush(new RectangleF(0, 0, width, height), Color.FromArgb(150, 0, 0, 0),
        Color.FromArgb(50, 40, 128, 70), 0f);
    //Create a transform for the brush.
    brushTransform = new Matrix(width, 0, 0, height, offsetX, offsetY);
    //Set the transform
    translucentBrush.Transform = brushTransform;
    
    //Set the paint
    document.SetPaint(translucentBrush);
    //Fill the rectangle
    document.Fill(path);
/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

    //Close current page
    document.ClosePage();

    //Save the document
    document.Save();
}

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

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

Pode descarregar exemplos e ficheiros de dados do GitHub.