在 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. 保存文档。

// Demonstrates clipping by shape and clipping by text in PS document.
String outputFileName = "ApplyClipByShape_outPS.ps";

//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();

// Create new 1-paged PS Document
PsDocument document = new PsDocument(getOutputDir() + outputFileName, options, false);

//Create graphics path from the rectangle
GeneralPath rectanglePath = new GeneralPath();
rectanglePath.append(new Rectangle2D.Float(0, 0, 300, 200), false);

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

//Create graphics path from the circle
GeneralPath circlePath = new GeneralPath();
circlePath.append(new Ellipse2D.Float(50, 0, 200, 200), false);

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

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

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

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

//Create dashed stroke similar to Pen with DashStyle.Dash
float[] dash = new float[] { 5.0f };
BasicStroke stroke = new BasicStroke(2.0f, BasicStroke.CAP_BUTT, BasicStroke.JOIN_MITER, 10.0f, dash, 0.0f);

document.setStroke(stroke);

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

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

运行此代码的结果显示为

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

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

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

// Demonstrates clipping by text in PS document.
String outputFileName = "ApplyClipByText_outPS.ps";

//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();

// Create new 1-paged PS Document
PsDocument document = new PsDocument(getOutputDir() + outputFileName, options, false);

//Create graphics path from the rectangle
GeneralPath rectanglePath = new GeneralPath();
rectanglePath.append(new Rectangle2D.Float(0, 0, 300, 200), false);

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

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

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

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

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

document.fill(rectanglePath);

document.writeGraphicsRestore();

document.translate(100, 100);

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

document.setStroke(stroke);
//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();

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

运行此代码的结果显示为

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