Arbeiten mit Clips in PostScript | C++

Clip im PS-Dokument hinzufügen

Ein Clip in einem PS-Dokument ist ein Pfad, der den Inhalt des aktuellen Grafikstatus begrenzt, der im PS-Viewer oder -Editor angezeigt wird. Der Inhalt, der außerhalb der Grenzen verbleibt, wird abgeschnitten.

Ein Beschneidungspfad in C++ kann auf drei Arten zugewiesen werden:

• von System.Drawing.Drawing2D.GraphicsPath, das beliebige geschlossene Formen enthalten kann;
• nach Textgliederung;
• 1 bpp (Bits pro Pixel) 2-Farben-Bild als Schablonenmaske;

Derzeit bietet die Bibliothek Aspose.Page für C++ die erste und die zweite Möglichkeit zum Ausschneiden. Im folgenden Beispiel erhalten wir einen Kreis System.Drawing.Drawing2D.GraphicsPath aus einem Rechteck als Beschneidungspfad und schneiden im gleichen Grafikzustand ein blau gefülltes Rechteck ab.

Um in diesem Beispiel einen Clip zum 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 das Objekt PsSaveOptions mit Standardoptionen.
3. Erstellen Sie ein einseitiges PsDocument mit einem bereits erstellten Ausgabestream und Speicheroptionen.
4. Erstellen Sie einen neuen Grafikstatus.
5. Erstellen Sie aus dem Rechteck einen Kreis System.Drawing.Drawing2D.GraphicsPath.
6. Legen Sie einen Clip mit diesem Pfad fest.
7. Stellen Sie einen Paint auf den aktuellen Grafikstatus von PsDocument ein.
8. Füllen Sie den Rechteckpfad mit der aktuellen Farbe.
9. Verlassen Sie den aktuellen Grafikstatus zur oberen Ebene eins.
10. Übertragen Sie es an die Stelle des gefüllten Rechtecks.
11. Zeichnen Sie mit einer gestrichelten Linie die Grenzen desselben Rechtecks ​​über dem gefüllten Rechteck, um die Grenzen des abgeschnittenen gefüllten Rechtecks ​​anzuzeigen.
12. Schließen Sie die Seite.
13. Speichern Sie das Dokument.

    // The path to the documents directory.
    System::String dataDir = RunExamples::GetDataDir_WorkingWithCanvas();
    
    //Create output stream for PostScript document
    {
        System::SharedPtr<System::IO::Stream> outPsStream = System::MakeObject<System::IO::FileStream>(dataDir + u"Clipping_outPS.ps", System::IO::FileMode::Create);
        // Clearing resources under 'using' statement
        System::Details::DisposeGuard<1> __dispose_guard_0({ outPsStream});
        // ------------------------------------------
        
        try
        {
            //Create save options with default values
            System::SharedPtr<PsSaveOptions> options = System::MakeObject<PsSaveOptions>();
            
            // Create new 1-paged PS Document
            System::SharedPtr<PsDocument> document = System::MakeObject<PsDocument>(outPsStream, options, false);
            
            //Create graphics path from the rectangle
            System::SharedPtr<System::Drawing::Drawing2D::GraphicsPath> rectanglePath = System::MakeObject<System::Drawing::Drawing2D::GraphicsPath>();
            rectanglePath->AddRectangle(System::Drawing::RectangleF(0.0f, 0.0f, 300.0f, 200.0f));
            
            ////////////////////////////////////// Clipping by shape //////////////////////////////////////////////////////////////////////
            
            //Save graphics state in order to return back to this state after transformation
            document->WriteGraphicsSave();
            
            //Displace current graphics state on 100 points to the right and 100 points to the bottom.
            document->Translate(100.0f, 100.0f);
            
            //Create graphics path from the circle
            System::SharedPtr<System::Drawing::Drawing2D::GraphicsPath> circlePath = System::MakeObject<System::Drawing::Drawing2D::GraphicsPath>();
            circlePath->AddEllipse(System::Drawing::RectangleF(50.0f, 0.0f, 200.0f, 200.0f));
            
            //Add clipping by circle to the current graphics state
            document->Clip(circlePath);
            
            //Set paint in the current graphics state
            document->SetPaint(System::MakeObject<System::Drawing::SolidBrush>(System::Drawing::Color::get_Blue()));
            
            //Fill the rectangle in the current graphics state (with clipping)
            document->Fill(rectanglePath);
            
            //Restore graphics state to the previus (upper) level
            document->WriteGraphicsRestore();
            
            //Displace upper level graphics state on 100 points to the right and 100 points to the bottom.
            document->Translate(100.0f, 100.0f);
            
            System::SharedPtr<System::Drawing::Pen> pen = System::MakeObject<System::Drawing::Pen>(System::MakeObject<System::Drawing::SolidBrush>(System::Drawing::Color::get_Blue()), 2.0f);
            pen->set_DashStyle(System::Drawing::Drawing2D::DashStyle::Dash);
            
            document->SetStroke(pen);
            
            //Draw the rectangle in the current graphics state (has no clipping) above clipped rectangle
            document->Draw(rectanglePath);
            
            ////////////////////////////////////// Clipping by text //////////////////////////////////////////////////////////////////////
            
            //Save graphics state in order to return back to this state after transformation
            document->WriteGraphicsSave();
            
            //Displace current graphics state on 100 points to the right and 100 points to the bottom.
            document->Translate(0.0f, 350.0f);
            
            int32_t fontSize = 120;
            System::SharedPtr<System::Drawing::Font> font = System::MakeObject<System::Drawing::Font>(u"Arial", static_cast<float>(fontSize), System::Drawing::FontStyle::Bold);
            
            //Clip rectangle by text's outline
            document->ClipText(u"ABC", font, 20.0f, static_cast<float>(fontSize + 10));
            document->Fill(rectanglePath);
            
            document->WriteGraphicsRestore();
            
            document->Translate(0.0f, 350.0f);
            
            document->SetStroke(pen);
            //Draw the rectangle in the current graphics state (has no clipping) above clipped rectangle
            document->Draw(rectanglePath);
            
            //////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
            
            //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 Clips in PS-Dokumenten in Java.

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

Im nächsten Beispiel erhalten wir eine Schriftart, die ein blau gefülltes Rechteck mit der Textkontur ausschneidet.

Um in diesem Beispiel einen Textausschnitt zum 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.
3. Erstellen Sie ein einseitiges PsDocument mit einem bereits erstellten Ausgabestream und Speicheroptionen.
4. Erstellen Sie einen neuen Grafikstatus.
5. Erstellen Sie eine Schriftart.
6. Legen Sie einen Clip mit Text und Schriftart fest.
7. Stellen Sie einen Paint auf den aktuellen Grafikstatus von PsDocument ein.
8. Füllen Sie den Rechteckpfad mit der aktuellen Farbe.
9. Verlassen Sie den aktuellen Grafikstatus zur oberen Ebene eins.
10. Übertragen Sie es an die Stelle des gefüllten Rechtecks.
11. Zeichnen Sie mit einer gestrichelten Linie die Grenzen desselben Rechtecks ​​über dem gefüllten Rechteck, um die Grenzen des abgeschnittenen gefüllten Rechtecks ​​anzuzeigen.
12. Schließen Sie die Seite.
13. Speichern Sie das Dokument.

//Create an output stream for the PostScript document
using (Stream outPsStream = new FileStream(dataDir + "Clipping_outPS.ps", FileMode.Create))
{
    //Create save options with default values
    PsSaveOptions options = new PsSaveOptions();

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

    //Create a graphics path from the rectangle
    GraphicsPath rectangePath = new GraphicsPath();
    rectangePath.AddRectangle(new RectangleF(0, 0, 300, 200));

    //Save the graphics state in order to return back to this state after transformation
    document.WriteGraphicsSave();

    //Displace the current graphics state on 100 points to the right and 100 points to the bottom.
    document.Translate(100, 100);
    
    //Set the paint in the current graphics state
    document.SetPaint(new SolidBrush(Color.Blue));

    //Create a font
    int fontSize = 120;
    Font font = new Font("Arial", fontSize, FontStyle.Bold);

    //Clip the rectangle by text's outline
    document.ClipText("ABC", font, 20, fontSize + 10);
    document.Fill(rectanglePath);

    //Restore the graphics state to the previus (upper) level
    document.WriteGraphicsRestore();

		//Displace the upper level graphics state on 100 points to the right and 100 points to the bottom.
    document.Translate(100, 100);

		Pen pen = new Pen(new SolidBrush(Color.Blue), 2);
    pen.DashStyle = DashStyle.Dash;

    document.SetStroke(pen);
    
    //Draw the rectangle in the current graphics state (has no clipping) above the clipped rectangle
    document.Draw(rectanglePath);

    //Close the current page
    document.ClosePage();

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

Weitere Informationen finden Sie unter Arbeiten mit Clips 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.