Arbeiten mit Transparenz in PostScript | C++

Fügen Sie Transparenz im PS-Dokument hinzu

PostScript unterstützt keine Transparenz beim Malen von Vektorgrafikobjekten. Durchscheinende (teilweise transparente) Bilder können jedoch als Satz vollständig transparenter und vollständig undurchsichtiger Pixel gerendert werden. Solche Bilder werden Masken genannt.

Die Aspose.Page for C++-Bibliothek bietet eine Methode, die das transparente Bild zum PS-Dokument hinzufügt. Für das Malen von Vektorgrafiken: Formen oder Text bieten wir „Pseudotransparenz“ an.

„Pseudotransparenz“ ist ein Prozess zum Verblassen von Farben, die eine Alpha-Komponente von weniger als 255 haben. Dies wird durch die spezifische Mischung der Rot-, Grün- und Blau-Komponenten mit Alpha eins erreicht.

„Pseudotransparenz“ ermöglicht es uns natürlich nicht, die untere farbige Schicht unter der oberen transparenten Schicht zu sehen, erzeugt aber eine Illusion von Transparenz, wenn die untere Schicht weiß ist.

Transparentes Bild im PS-Dokument hinzufügen

Wie wir zuvor geschrieben haben, können transparente Bilder als Maske zum PS-Dokument hinzugefügt werden, und die Bibliothek Aspose.Page für C++ bietet zu diesem Zweck eine Methode AddTransparentImage(). Diese Methode erkennt, ob das Bild vollständig undurchsichtig oder vollständig transparent bzw. durchscheinend ist. Wenn es vollständig undurchsichtig ist, wird es in der Methode AddImage() als undurchsichtiges Bild hinzugefügt. Wenn es vollständig transparent ist, wird es dem Dokument überhaupt nicht hinzugefügt. Wenn es sich um ein durchscheinendes Bild handelt, wird es als PostScript-Bild hinzugefügt Maske.

Im folgenden Beispiel demonstrieren wir den Unterschied zwischen dem Hinzufügen eines transparenten Bildes in einem PS-Dokument mit AddImage() und AddTransparentImage(). Um das weiße, durchscheinende Bild zu sehen, stellen wir die Hintergrundfarbe der Seite auf nicht weiß ein.

Um in diesem Beispiel ein beliebiges Bild zu einem neuen PsDocument mit der Aspose.Page für C++-Bibliothek hinzuzufügen, führen wir die folgenden Schritte aus:

1. Erstellen Sie einen Ausgabestream für die resultierende PS-Datei.
2. Erstellen Sie ein PsSaveOptions-Objekt mit Standardoptionen. Ändern Sie bei Bedarf die Hintergrundfarbe.
3. Erstellen Sie ein einseitiges PsDocument mit einem bereits erstellten Ausgabestream und Speicheroptionen.
4. Erstellen Sie einen neuen Grafikstatus.
5. Erstellen Sie eine Bitmap aus der Bilddatei.
6. Erstellen Sie die erforderliche Transformation für das Bild.
7. Fügen Sie das Bild als vollständig undurchsichtiges Bild zu PsDocument hinzu (mit der Methode AddImage()), wenn wir sicher sind, dass das Bild undurchsichtig ist, oder fügen Sie eines als transparentes Bild hinzu (mit der Methode AddTransparentImage()). wenn wir nicht sicher sind, ob das Bild undurchsichtig ist.
8. Verlassen Sie den aktuellen Grafikstatus zur oberen Ebene eins.
9. Schließen Sie die Seite.
10. Speichern Sie das Dokument.

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

Weitere Informationen finden Sie unter „Arbeiten mit Transparenz in PS-Dokumenten“ in .NET oder Java.

Das Ergebnis der Ausführung dieses Codes ist das nächste

Hinzufügen eines transparenten Vektorgrafikobjekts

Zuvor haben wir geschrieben, dass die Aspose.Page for C++-Bibliothek einen Paling-Algorithmus für transparente Formen und Text verwendet, den wir „Pseudotransparenz“ nannten. Im folgenden Beispiel zeigen wir einen Unterschied zwischen zwei Formen, die mit derselben Farbe bemalt sind, jedoch in der ersten Form ohne die Alpha-Komponente und im zweiten Fall mit der Alpha-Komponente.

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

Weitere Informationen finden Sie unter „Arbeiten mit Transparenz in PS-Dokumenten“ in .NET oder Java.

Das Ergebnis der Ausführung dieses Codes wird wie folgt angezeigt:

Sie können Beispiele und Datendateien herunterladen von GitHub.