在 PS 文件中使用剪辑 | Java

在 PS 文档中添加剪切

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

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

• 通过任何实现 java.awt.Shape 的类，该类可以包含任何闭合形状；
• 通过文本轮廓；
• 通过 1 bpp（每像素位数）双色图像作为模板蒙版；

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

在本例中，要使用 Aspose.Page for Java 库将剪辑添加到新的 PsDocument，请执行以下步骤：

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

//Create an output stream for the PostScript document
FileOutputStream outPsStream = new FileOutputStream(dataDir + "Clipping_outPS.ps");
//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();

// Create a new PS Document with the page opened
PsDocument document = new PsDocument(outPsStream, options, false);

//Create a rectangle
Shape rectangle = new Rectangle2D.Float(0, 0, 300, 200);

//Set the paint in the upper level graphics state
document.setPaint(Color.BLUE);

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

//Displace the current graphics state on 100 points to the right and 100 points to the bottom.
document.translate(100, 100);

//Create a circle shape
Shape circle = new Ellipse2D.Float(50, 0, 200, 200);

//Add clipping by the circle to the current graphics state
document.clip(circle);

//Fill the rectangle in the current graphics state (with clipping)
document.fill(rectangle);

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

BasicStroke stroke = new BasicStroke(2,
        BasicStroke.CAP_BUTT,
        BasicStroke.JOIN_MITER,
        10.0f, new float []{5.0f}, 0.0f);

document.setStroke(stroke);

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

//Close the current page
document.closePage();
//Save the document
document.save();

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

运行此代码的结果显示为

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

在本例中，要使用 Aspose.Page for Java 库将文本剪辑添加到新的 PsDocument，请执行以下步骤：

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

//Create output stream for PostScript document
FileOutputStream outPsStream = new FileOutputStream(dataDir + "Clipping_outPS.ps");
//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();

// Create a new PS Document with the page opened
PsDocument document = new PsDocument(outPsStream, options, false);

//Create a rectangle
Shape rectangle = new Rectangle2D.Float(0, 0, 300, 200);

//Set paint in the upper-level graphics state
document.setPaint(Color.BLUE);

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

//Displace current graphics state on 100 points to the right and 100 points to the bottom.
document.translate(100, 100);

int fontSize = 120;
Font font = new Font("Arial", Font.BOLD, fontSize);

//Clip rectangle by text's outline
document.clipText("ABC", font, 20, fontSize + 10);		
document.fill(rectangle);

//Restore graphics state to the previous (upper) level
document.writeGraphicsRestore();

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

BasicStroke stroke = new BasicStroke(2,
        BasicStroke.CAP_BUTT,
        BasicStroke.JOIN_MITER,
        10.0f, new float []{5.0f}, 0.0f);

document.setStroke(stroke);

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

//Close the current page
document.closePage();
//Save the document
document.save();

请参阅 .NET 中 PS 文档中的剪辑操作。

运行此代码的结果显示为

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