public HPDF_STATUS clip()

Modifies the current clipping path by intersecting it with the current path using the nonzero winding number rule.

The clipping path is only modified after the succeeding painting operator. To avoid painting the current path, use the function HPDFPageEndPath().

Following painting operations will only affect the regions of the page contained by the clipping path. Initially, the clipping path includes the entire page. There is no way to enlarge the current clipping path, or to replace the clipping path with a new one. The functions HPDFPageGSave() and HPDFPageGRestore() may be used to save and restore the current graphics state, including the clipping path.

Graphics Mode

Before and after - GMode,pathObject.

Parameters

page

The handle of a page object.

Returns

HPDF_OK on success. Otherwise, returns error code and error-handler is invoked.