Working with Clips in PS file| Java

[ Hide Show ]

Add Clip in PS Document

A clip in a PS document is a path that bounds the content of the current graphics state that will be shown in the PS viewer or editor. The content that is left beyond the bounds will be cut off.
A clipping path in Java can be assigned in three ways:

At this moment Aspose.Page for Java library offers only the first way of clipping. In the example below we obtain a circle shape as a clipping path and cut off a blue-filled rectangle in the same graphics state.

In order to add a clip to the new PsDocument with Aspose.Page for Java library in this example we do the following steps:

  1. Create an output stream for the resulting PS file.
  2. Create PsSaveOptions object with default options.
  3. Create a 1-paged PsDocument with an already created output stream and save options.
  4. Create a new graphics state.
  5. Create a circle (java.awt.geom.Ellipse2D object) shape.
  6. Set a clip with this path.
  7. Set a paint to the current graphics state of PsDocument.
  8. Fill the rectangle path with the current paint.
  9. Exit from the current graphics state to upper level one.
  10. Translate to the place of the filled rectangle.
  11. Stroke with a dashed line the bounds of the same rectangle above the filled one to show the bounds of the clipped filled rectangle.
  12. Close the page.
  13. Save the document.
 1//Create output stream for PostScript document
 2FileOutputStream outPsStream = new FileOutputStream(dataDir + "");
 3//Create save options with A4 size
 4PsSaveOptions options = new PsSaveOptions();
 6// Create new PS Document with the page opened
 7PsDocument document = new PsDocument(outPsStream, options, false);
 9//Create a rectangle
10Shape rectangle = new Rectangle2D.Float(0, 0, 300, 200);
12//Set paint in the upper level graphics state
15//Save graphics state in order to return back to this state after transformation
18//Displace current graphics state on 100 points to the right and 100 points to the bottom.
19document.translate(100, 100);
21//Create circle shape
22Shape circle = new Ellipse2D.Float(50, 0, 200, 200);
24//Add clipping by circle to the current graphics state
27//Fill the rectangle in the current graphics state (with clipping)
30//Restore graphics state to the previus (upper) level
33//Displace upper level graphics state on 100 points to the right and 100 points to the bottom.
34document.translate(100, 100);
36BasicStroke stroke = new BasicStroke(2,
37        BasicStroke.CAP_BUTT,
38        BasicStroke.JOIN_MITER,
39        10.0f, new float []{5.0f}, 0.0f);
43//Draw the rectangle in the current graphics state (has no clipping) above clipped rectangle
46//Close current page
48//Save the document;

See working with clips in PS documents in .NET and C++.

The result of running this code is appeared as


You can download examples and data files from GitHub.

Subscribe to Aspose Product Updates

Get monthly newsletters & offers directly delivered to your mailbox.