Trabalhar com Transparência em PostScript | C++

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 C++ 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 um componente Alfa inferior a 255. É conseguido pela combinação específica dos componentes Vermelho, Verde e Azul com um 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 C++ 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 C++, 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.

    // The path to the documents directory.
    System::String dataDir = RunExamples::GetDataDir_WorkingWithTransparency();
    
    //Create output stream for PostScript document
    {
        System::SharedPtr<System::IO::Stream> outPsStream = System::MakeObject<System::IO::FileStream>(dataDir + u"AddTransparentImage_outPS.ps", System::IO::FileMode::Create);
        // Clearing resources under 'using' statement
        System::Details::DisposeGuard<1> __dispose_guard_2({ outPsStream});
        // ------------------------------------------
        
        try
        {
            //Create save options with A4 size
            System::SharedPtr<PsSaveOptions> options = System::MakeObject<PsSaveOptions>();
            //Set page's background color to see white image on it's own transparent background
            options->set_BackgroundColor(System::Drawing::Color::FromArgb(211, 8, 48));
            
            // Create new 1-paged PS Document
            System::SharedPtr<PsDocument> document = System::MakeObject<PsDocument>(outPsStream, options, false);
            
            
            document->WriteGraphicsSave();
            document->Translate(20.0f, 100.0f);
            
            //Create bitmap from translucent image file
            {
                System::SharedPtr<System::Drawing::Bitmap> image = System::MakeObject<System::Drawing::Bitmap>(dataDir + u"mask1.png");
                // Clearing resources under 'using' statement
                System::Details::DisposeGuard<1> __dispose_guard_0({ image});
                // ------------------------------------------
                
                try
                {
                    //Add this image to document as usual opaque RGB image
                    document->DrawImage(image, System::MakeObject<System::Drawing::Drawing2D::Matrix>(1.0f, 0.0f, 0.0f, 1.0f, 100.0f, 0.0f), System::Drawing::Color::Empty);
                }
                catch(...)
                {
                    __dispose_guard_0.SetCurrentException(std::current_exception());
                }
            }
            
            //Again create bitmap from the same image file
            {
                System::SharedPtr<System::Drawing::Bitmap> image = System::MakeObject<System::Drawing::Bitmap>(dataDir + u"mask1.png");
                // Clearing resources under 'using' statement
                System::Details::DisposeGuard<1> __dispose_guard_1({ image});
                // ------------------------------------------
                
                try
                {
                    //Add this image to document as transparent image image
                    document->DrawTransparentImage(image, System::MakeObject<System::Drawing::Drawing2D::Matrix>(1.0f, 0.0f, 0.0f, 1.0f, 350.0f, 0.0f), 255);
                }
                catch(...)
                {
                    __dispose_guard_1.SetCurrentException(std::current_exception());
                }
            }
            
            document->WriteGraphicsRestore();
            
            //Close current page
            document->ClosePage();
            
            //Save the document
            document->Save();
        }
        catch(...)
        {
            __dispose_guard_2.SetCurrentException(std::current_exception());
        }
    }

Veja como trabalhar com transparência em documentos PS em .NET ou 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 C++ 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.

    // The path to the documents directory.
    System::String dataDir = RunExamples::GetDataDir_WorkingWithTransparency();
    
    //Create output stream for PostScript document
    {
        System::SharedPtr<System::IO::Stream> outPsStream = System::MakeObject<System::IO::FileStream>(dataDir + u"ShowPseudoTransparency_outPS.ps", System::IO::FileMode::Create);
        // Clearing resources under 'using' statement
        System::Details::DisposeGuard<1> __dispose_guard_0({ outPsStream});
        // ------------------------------------------
        
        try
        {
            //Create save options with A4 size
            System::SharedPtr<PsSaveOptions> options = System::MakeObject<PsSaveOptions>();
            
            // Create new 1-paged PS Document
            System::SharedPtr<PsDocument> document = System::MakeObject<PsDocument>(outPsStream, options, false);
            
            float offsetX = 50.0f;
            float offsetY = 100.0f;
            float width = 200.0f;
            float height = 100.0f;
            
            ///////////////////////////////// Create rectangle with opaque gradient fill /////////////////////////////////////////////////////////
            System::SharedPtr<System::Drawing::Drawing2D::GraphicsPath> path = System::MakeObject<System::Drawing::Drawing2D::GraphicsPath>();
            path->AddRectangle(System::Drawing::RectangleF(offsetX, offsetY, width, height));
            
            System::SharedPtr<System::Drawing::Drawing2D::LinearGradientBrush> opaqueBrush = System::MakeObject<System::Drawing::Drawing2D::LinearGradientBrush>(System::Drawing::RectangleF(0.0f, 0.0f, 200.0f, 100.0f), System::Drawing::Color::FromArgb(0, 0, 0), System::Drawing::Color::FromArgb(40, 128, 70), 0.f);
            System::SharedPtr<System::Drawing::Drawing2D::Matrix> brushTransform = System::MakeObject<System::Drawing::Drawing2D::Matrix>(width, 0.0f, 0.0f, height, offsetX, offsetY);
            opaqueBrush->set_Transform(brushTransform);
            System::SharedPtr<GradientBrush> gradientBrush = System::MakeObject<GradientBrush>(opaqueBrush);
            gradientBrush->set_WrapMode(System::Drawing::Drawing2D::WrapMode::Clamp);
            
            document->SetPaint(gradientBrush);
            document->Fill(path);
            /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
            
            offsetX = 350.0f;
            
            ///////////////////////////////// Create rectangle with translucent gradient fill ///////////////////////////////////////////////////
            //Create graphics path from the first rectangle
            path = System::MakeObject<System::Drawing::Drawing2D::GraphicsPath>();
            path->AddRectangle(System::Drawing::RectangleF(offsetX, offsetY, width, height));
            
            //Create linear gradient brush colors which transparency are not 255, but 150 and 50. So it are translucent.
            System::SharedPtr<System::Drawing::Drawing2D::LinearGradientBrush> translucentBrush = System::MakeObject<System::Drawing::Drawing2D::LinearGradientBrush>(System::Drawing::RectangleF(0.0f, 0.0f, width, height), System::Drawing::Color::FromArgb(150, 0, 0, 0), System::Drawing::Color::FromArgb(50, 40, 128, 70), 0.f);
            //Create a transform for brush.
            brushTransform = System::MakeObject<System::Drawing::Drawing2D::Matrix>(width, 0.0f, 0.0f, height, offsetX, offsetY);
            //Set transform
            translucentBrush->set_Transform(brushTransform);
            //Create GradientBrush object containing the linear gradient brush
            gradientBrush = System::MakeObject<GradientBrush>(translucentBrush);
            gradientBrush->set_WrapMode(System::Drawing::Drawing2D::WrapMode::Clamp);
            //Set paint
            document->SetPaint(gradientBrush);
            //Fill the rectangle
            document->Fill(path);
            /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
            
            //Close current page
            document->ClosePage();
            
            //Save the document
            document->Save();
        }
        catch(...)
        {
            __dispose_guard_0.SetCurrentException(std::current_exception());
        }
    }

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

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

Pode descarregar exemplos e ficheiros de dados do GitHub.