php man page for cairo_clip_preserve

CAIRO_CLIP_PRESERVE(3)							 1						    CAIRO_CLIP_PRESERVE(3)

CairoContext::clipPreserve - Establishes a new clip region from the current clip

       Object oriented style (method):

SYNOPSIS
       public void CairoContext::clipPreserve (void  )

DESCRIPTION
       Procedural style:
       void cairo_clip_preserve (CairoContext  $context)

	Establishes  a	new  clip  region  by intersecting the current clip region with the current path as it would be filled by Context.fill and
       according to the current FILL RULE (see CairoContext::setFillRule or cairo_set_fill_rule(3)).

	Unlike CairoContext::clip, CairoContext::clipPreserve preserves the path within the Context. The current clip region affects  all  drawing
       operations by effectively masking out any changes to the surface that are outside the current clip region.

	Calling  CairoContext::clipPreserve  can  only	make  the  clip region smaller, never larger. But the current clip is part of the graphics
       state, so a temporary restriction of the clip region can be achieved by calling	CairoContext::clipPreserve  within  a  CairoContext::save/
       CairoContext::restore pair. The only other means of increasing the size of the clip region is CairoContext::resetClip.

PARAMETERS
	      o $context
		- A valid CairoContext object

RETURN VALUES
	No value is returned.

EXAMPLES
       Example #1

	      Object oriented style

	      <?php

	      $surface = new CairoImageSurface(CairoFormat::ARGB32, 50, 50);

	      $context = new CairoContext($surface);

	      $context->clipPreserve();

	      ?>

       Example #2

	      Procedural style

	      <?php

	      $surface = cairo_image_surface_create(CAIRO_FORMAT_ARGB32, 50, 50);

	      $context = cairo_create($surface);

	      cairo_clip_preserve($context);

	      ?>

SEE ALSO
       CairoContext::save, CairoContext::restore, CairoContext::resetClip.

PHP Documentation Group 												    CAIRO_CLIP_PRESERVE(3)