在 PostScript 中使用剪辑 | C++

在 PS 文档中添加剪切

PS 文档中的剪切路径是指一条路径，它限定了当前图形状态的内容，这些内容将在 PS 查看器或编辑器中显示。超出边界的内容将被截断。

C++ 中的剪切路径可以通过三种方式指定：

• 通过 System.Drawing.Drawing2D.GraphicsPath 指定，该路径可以包含任何闭合形状；
• 通过文本轮廓指定；
• 通过 1 bpp（每像素位数）双色图像作为模板蒙版；

目前，Aspose.Page for C++ 库提供了第一种和第二种剪切方式。在下面的示例中，我们从一个矩形获取一个圆形 System.Drawing.Drawing2D.GraphicsPath 作为剪切路径，并在相同的图形状态下截取一个蓝色填充的矩形。

为了使用 Aspose.Page for C++ 库将剪辑添加到新的 PsDocument，在本例中，我们执行以下步骤：

1. 为生成的 PS 文件创建输出流。
2. 使用默认选项创建 PsSaveOptions 对象。
3. 使用已创建的输出流和保存选项创建一个单页 PsDocument。
4. 创建新的图形状态。
5. 根据矩形创建一个圆形 System.Drawing.Drawing2D.GraphicsPath。
6. 使用此路径设置一个剪辑。
7. 将绘制设置为 PsDocument 的当前图形状态。
8. 使用当前绘制填充矩形路径。
9. 从当前图形状态退出到上一级图形状态。
10. 平移到已填充矩形的位置。
11. 用虚线勾勒出填充矩形上方相同矩形的边界，以显示剪切后的填充矩形的边界。
12. 关闭页面。
13. 保存文档。

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

请参阅如何在 Java 中使用 PS 文档中的剪辑。

运行此代码的结果显示为

在下一个示例中，我们获取一种字体，用于根据文本轮廓裁剪蓝色填充的矩形。

为了在本例中使用 Aspose.Page for C++ 库将文本剪辑添加到新的 PsDocument，我们执行以下步骤：

1. 为生成的 PS 文件创建输出流。
2. 使用默认选项创建一个 PsSaveOptions 对象。
3. 创建一个单页 PsDocument，其中包含已创建的输出流和保存选项。
4. 创建新的图形状态。
5. 创建字体。
6. 设置包含文本和字体的裁剪区域。
7. 将绘制设置为 PsDocument 的当前图形状态。
8. 使用当前绘制填充矩形路径。
9. 从当前图形状态退出到上一级图形状态。
10. 平移到已填充矩形的位置。
11. 用虚线勾勒出已填充矩形上方相同矩形的边界，以显示裁剪后的已填充矩形的边界。
12. 关闭页面。
13. 保存文档。

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

请参阅如何在 .NET 或 Java 中使用 PS 文档中的剪辑。

运行此代码的结果显示为

您可以从 GitHub 下载示例和数据文件。