cairo_fill_extents(3) [php man page]

CAIRO_FILL_EXTENTS(3)							 1						     CAIRO_FILL_EXTENTS(3)

CairoContext::fillExtents - Computes the filled area

       Object oriented style (method):

SYNOPSIS

       public array CairoContext::fillExtents (void  )

DESCRIPTION

       Procedural style:
       array cairo_fill_extents (CairoContext  $context)

	Computes  a  bounding box in user coordinates covering the area that would be affected, (the "inked" area), by a CairoContext::fill opera-
       tion given the current path and fill parameters. If the current path is empty, returns an empty rectangle (0,0,0,0). Surface dimensions and
       clipping are not taken into account.

	Contrast with CairoContext::pathExtents, which is similar, but returns non-zero extents for some paths with no inked area, (such as a sim-
       ple line segment).

	Note that CairoContext::fillExtents must necessarily do more work to compute the precise inked areas in light of the fill rule, so  Cairo-
       Context::pathExtents may be more desirable for sake of performance if the non-inked path extents are desired.

PARAMETERS

	      o $context
		- A valid CairoContext object created with CairoContext::__construct or cairo_create(3)

RETURN VALUES

	An array with the coordinates of the afected area

EXAMPLES

       Example #1

	      Object oriented style

	      <?php
	      /* ... */
	      ?>

	      The above example will output something similar to:

       Example #2

	      Procedural style

	      <?php
	      /* ... */
	      ?>

	      The above example will output something similar to:

SEE ALSO

       CairoContext::fill, CairoContext::setFillRule, CairoContext::fillPreserve.

PHP Documentation Group 												     CAIRO_FILL_EXTENTS(3)

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)