Trabajar con clips en PostScript | C++

Agregar clip en documento PS

Un clip en un documento PS es una ruta que limita el contenido del estado gráfico actual que se mostrará en el visor o editor de PS. El contenido que quede fuera de los límites se cortará.

Un trazado de recorte en C++ se puede asignar de tres formas:

• por System.Drawing.Drawing2D.GraphicsPath que puede contener cualquier forma cerrada;
• por esquema de texto;
• por 1 bpp (bits por píxel) imagen de 2 colores como máscara de plantilla;

En este momento, la biblioteca Aspose.Page para C++ ofrece la primera y la segunda forma de recorte. En el siguiente ejemplo, obtenemos un círculo System.Drawing.Drawing2D.GraphicsPath de un rectángulo como trazado de recorte y cortamos un rectángulo relleno de azul en el mismo estado de gráficos.

Para agregar un clip al nuevo PsDocument con la biblioteca Aspose.Page para C++ en este ejemplo, realizamos los siguientes pasos:

1. Cree una secuencia de salida para el archivo PS resultante.
2. Cree el objeto PsSaveOptions con opciones predeterminadas.
3. Cree un PsDocument de 1 página con un flujo de salida ya creado y opciones para guardar.
4. Cree un nuevo estado de gráficos.
5. Crea un círculo System.Drawing.Drawing2D.GraphicsPath a partir del rectángulo.
6. Establezca un clip con esta ruta.
7. Establezca una pintura en el estado de gráficos actual de PsDocument.
8. Rellena el trazado del rectángulo con la pintura actual.
9. Salga del estado de gráficos actual al nivel uno superior.
10. Traduzca al lugar del rectángulo relleno.
11. Traza con una línea discontinua los límites del mismo rectángulo encima del relleno para mostrar los límites del rectángulo relleno recortado.
12. Cierra la página.
13. Guarde el 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());
        }
    }

Vea cómo trabajar con clips en documentos PS en Java.

El resultado de ejecutar este código aparece como

En el siguiente ejemplo, obtenemos una fuente que recorta un rectángulo relleno de azul con el contorno del texto.

Para agregar un recorte por texto al nuevo PsDocument con la biblioteca Aspose.Page para C++ en este ejemplo, realizamos los siguientes pasos:

1. Cree una secuencia de salida para el archivo PS resultante.
2. Cree un objeto PsSaveOptions con opciones predeterminadas.
3. Cree un PsDocument de 1 página con un flujo de salida ya creado y opciones para guardar.
4. Cree un nuevo estado de gráficos.
5. Crea una fuente.
6. Configure un clip con texto y fuente.
7. Establezca una pintura en el estado de gráficos actual de PsDocument.
8. Rellena el trazado del rectángulo con la pintura actual.
9. Salga del estado de gráficos actual al nivel uno superior.
10. Traduzca al lugar del rectángulo relleno.
11. Traza con una línea discontinua los límites del mismo rectángulo encima del relleno para mostrar los límites del rectángulo relleno recortado.
12. Cierra la página.
13. Guarde el 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();
}

Vea cómo trabajar con clips en documentos PS en .NET o Java.

El resultado de ejecutar este código aparece como

Puede descargar ejemplos y archivos de datos desde GitHub.