Name
  page:Clip -- modify clipping path
Synopsis

      status = page:Clip()

Function
  `page: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 page:EndPath().

  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 page:GSave() and page:GRestore() may be used to save and restore the current graphics state, including the clipping path.

Inputs
  none

Results
  status
    status code

Show TOC