Lavorare con la trasparenza in PostScript | C++

Aggiungere trasparenza in un documento PS

PostScript non supporta la trasparenza nella pittura di oggetti di grafica vettoriale. Tuttavia, le immagini traslucide (parzialmente trasparenti) possono essere renderizzate come un insieme di pixel completamente trasparenti e completamente opachi. Tali immagini sono chiamate maschere.

La libreria Aspose.Page per C++ offre un metodo che aggiunge l’immagine trasparente al documento PS. Per quanto riguarda la pittura di grafica vettoriale: forme o testo, offriamo la “pseudo-trasparenza”.

La “pseudo-trasparenza” è un processo di schiarimento dei colori con una componente alfa inferiore a 255. Si ottiene miscelando specificamente le componenti Rosso, Verde e Blu con la componente alfa.

La “pseudo-trasparenza”, ovviamente, non ci permette di vedere il livello colorato inferiore da sotto il livello trasparente superiore, ma crea un’illusione di trasparenza se il livello inferiore è bianco.

Aggiunta di un’immagine trasparente in un documento PS

Come accennato in precedenza, le immagini trasparenti possono essere aggiunte al documento PS come maschera e la libreria Aspose.Page per C++ offre a questo scopo il metodo AddTransparentImage(). Questo metodo riconosce se l’immagine è completamente opaca, trasparente o traslucida. Se è completamente opaca, viene aggiunta come immagine opaca nel metodo AddImage(), se è completamente trasparente, non viene aggiunta al documento, mentre se è traslucida, viene aggiunta come maschera di immagine PostScript.

Nell’esempio seguente mostriamo la differenza tra l’aggiunta di un’immagine trasparente in un documento PS con AddImage() e AddTransparentImage(). Per visualizzare l’immagine traslucida bianca, impostiamo il colore di sfondo della pagina su un colore diverso dal bianco.

Per aggiungere un’immagine a un nuovo PsDocument con la libreria Aspose.Page per C++, in questo esempio seguiamo i seguenti passaggi:

1. Creiamo un flusso di output per il file PS risultante.
2. Creiamo un oggetto PsSaveOptions con le opzioni predefinite. Se necessario, modifichiamo il colore di sfondo.
3. Creiamo un PsDocument a pagina singola con un flusso di output e opzioni di salvataggio già creati.
4. Creiamo un nuovo stato grafico.
5. Creiamo una Bitmap dal file immagine.
6. Applichiamo la trasformazione necessaria per l’immagine. 7. Aggiungere l’immagine a PsDocument come immagine completamente opaca (utilizzando il metodo AddImage()) se siamo sicuri che l’immagine sia opaca, oppure aggiungerne una come immagine trasparente (utilizzando il metodo AddTransparentImage()) se non siamo sicuri che l’immagine sia opaca.
7. Uscire dallo stato grafico corrente e tornare al livello superiore.
8. Chiudere la pagina.
9. Salvare il 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());
        }
    }

Vedi come lavorare con la trasparenza in un documento PS in .NET o Java.

Il risultato dell’esecuzione di questo codice è il seguente:

Aggiunta di un oggetto grafico vettoriale trasparente

In precedenza abbiamo scritto che la libreria Aspose.Page per C++ utilizza un algoritmo di trasparenza per forme e testo trasparenti, che abbiamo chiamato “pseudo-trasparenza”. Nell’esempio seguente mostriamo una differenza tra due forme dipinte con lo stesso colore, ma nella prima forma senza il componente Alpha e nel secondo caso con il componente Alpha.

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

Vedi come lavorare con la trasparenza nei documenti PS in .NET o Java.

Il risultato dell’esecuzione di questo codice viene visualizzato come

È possibile scaricare esempi e file di dati da GitHub.