Lavorare con le clip in PostScript | C++

Aggiungi clip in un documento PS

Una clip in un documento PS è un tracciato che delimita il contenuto dello stato grafico corrente che verrà visualizzato nel visualizzatore o nell’editor PS. Il contenuto che rimane oltre i limiti verrà tagliato.

Un tracciato di ritaglio in C++ può essere assegnato in tre modi:

• tramite System.Drawing.Drawing2D.GraphicsPath che può contenere qualsiasi forma chiusa;

• tramite contorno di testo;

• tramite immagine a 2 colori a 1 bpp (bit per pixel) come maschera stencil;

Al momento, la libreria Aspose.Page per C++ offre il primo e il secondo metodo di ritaglio. Nell’esempio seguente otteniamo un cerchio System.Drawing.Drawing2D.GraphicsPath da un rettangolo come tracciato di ritaglio e ritagliamo un rettangolo riempito di blu nello stesso stato grafico.

Per aggiungere una clip al 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 l’oggetto PsSaveOptions con le opzioni predefinite.
3. Creiamo un PsDocument a pagina singola con un flusso di output già creato e opzioni di salvataggio.
4. Creiamo un nuovo stato grafico.
5. Creiamo un cerchio System.Drawing.Drawing2D.GraphicsPath dal rettangolo.
6. Imposta una clip con questo percorso.
7. Imposta un’immagine sullo stato grafico corrente del PsDocument. 8. Riempi il tracciato del rettangolo con il colore corrente.
8. Esci dallo stato grafico corrente e torna al livello superiore.
9. Trasla nella posizione del rettangolo riempito.
10. Traccia con una linea tratteggiata i limiti dello stesso rettangolo sopra quello riempito per mostrare i limiti del rettangolo riempito ritagliato.
11. Chiudi la pagina.
12. Salva il documento.

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

Vedi come lavorare con le clip nei documenti PS in Java.

Il risultato dell’esecuzione di questo codice viene visualizzato come

Nel prossimo esempio, otteniamo un font che ritaglia un rettangolo blu con il contorno del testo.

Per aggiungere un ritaglio di testo al nuovo PsDocument con la libreria Aspose.Page per C++, in questo esempio seguiamo i seguenti passaggi:

1. Creare un flusso di output per il file PS risultante. 2. Crea un oggetto PsSaveOptions con opzioni predefinite.
2. Crea un PsDocument a pagina singola con un flusso di output già creato e opzioni di salvataggio.
3. Crea un nuovo stato grafico.
4. Crea un font.
5. Imposta un ritaglio con testo e font.
6. Imposta un colore sullo stato grafico corrente del PsDocument.
7. Riempi il percorso del rettangolo con il colore corrente.
8. Esci dallo stato grafico corrente e passa a quello di livello superiore.
9. Trasla nella posizione del rettangolo riempito.
10. Traccia con una linea tratteggiata i limiti dello stesso rettangolo sopra quello riempito per mostrare i limiti del rettangolo riempito ritagliato.
11. Chiudi la pagina.
12. Salva il documento.

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

Vedi come lavorare con le clip nei documenti PS in .NET o Java.

Il risultato dell’esecuzione di questo codice viene visualizzato come

Puoi scaricare esempi e file di dati da GitHub.