Travailler avec des clips dans PostScript | C++

Ajouter un clip dans un document PS

Un clip dans un document PS est un chemin qui délimite le contenu de l’état graphique actuel qui sera affiché dans la visionneuse ou l’éditeur PS. Le contenu laissé au-delà des limites sera coupé.

Un chemin de détourage en C++ peut être attribué de trois manières :

• par System.Drawing.Drawing2D.GraphicsPath qui peut contenir n’importe quelle forme fermée ;
• par contour de texte ;
• par une image bicolore de 1 bpp (bits par pixel) comme masque de pochoir ;

À l’heure actuelle, la bibliothèque Aspose.Page pour C++ propose la première et la deuxième manière de découper. Dans l’exemple ci-dessous, nous obtenons un cercle System.Drawing.Drawing2D.GraphicsPath à partir d’un rectangle comme chemin de détourage et découpons un rectangle rempli de bleu dans le même état graphique.

Afin d’ajouter un clip au nouveau PsDocument avec la bibliothèque Aspose.Page pour C++ dans cet exemple, nous procédons comme suit :

1. Créez un flux de sortie pour le fichier PS résultant.
2. Créez l’objet PsSaveOptions avec les options par défaut.
3. Créez un PsDocument d’une page avec un flux de sortie déjà créé et enregistrez les options.
4. Créez un nouvel état graphique.
5. Créez un cercle System.Drawing.Drawing2D.GraphicsPath à partir du rectangle.
6. Définissez un clip avec ce chemin.
7. Définissez une peinture sur l’état graphique actuel de PsDocument.
8. Remplissez le chemin du rectangle avec la peinture actuelle.
9. Quittez l’état graphique actuel pour passer au niveau supérieur.
10. Traduisez à la place du rectangle rempli.
11. Tracez avec une ligne pointillée les limites du même rectangle au-dessus de celui rempli pour afficher les limites du rectangle rempli coupé.
12. Fermez la page.
13. Enregistrez le document.

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

Voir Travailler avec des clips dans des documents PS dans Java.

Le résultat de l’exécution de ce code apparaît comme

Dans l’exemple suivant, nous obtenons une police qui découpe un rectangle rempli de bleu avec le contour du texte.

Afin d’ajouter un extrait de texte au nouveau PsDocument avec la bibliothèque Aspose.Page pour C++ dans cet exemple, nous procédons comme suit :

1. Créez un flux de sortie pour le fichier PS résultant.
2. Créez un objet PsSaveOptions avec les options par défaut.
3. Créez un PsDocument d’une page avec un flux de sortie déjà créé et enregistrez les options.
4. Créez un nouvel état graphique.
5. Créez une police.
6. Définissez un clip avec le texte et la police.
7. Définissez une peinture sur l’état graphique actuel de PsDocument.
8. Remplissez le chemin du rectangle avec la peinture actuelle.
9. Quittez l’état graphique actuel pour passer au niveau supérieur.
10. Traduisez à la place du rectangle rempli.
11. Tracez avec une ligne pointillée les limites du même rectangle au-dessus de celui rempli pour afficher les limites du rectangle rempli coupé.
12. Fermez la page.
13. Enregistrez le document.

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

Voir Travailler avec des clips dans des documents PS dans .NET ou Java.

Le résultat de l’exécution de ce code apparaît comme

Vous pouvez télécharger des exemples et des fichiers de données à partir de GitHub.