Method Cairo.Context()->fill_extents()

Method fill_extents

array(float) fill_extents()

Description

Computes a bounding box in user coordinates covering the area that would be affected, (the "inked" area), by a fill() operation 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 path_extents(), which is similar, but returns non-zero extents for some paths with no inked area, (such as a simple line segment).

Note that fill_extents() must necessarily do more work to compute the precise inked areas in light of the fill rule, so path_extents() may be more desirable for sake of performance if the non-inked path extents are desired.

Returns

an array with coordinates for the left, top, right, and bottom, respectively, of the resulting extents

See also

fill(), set_fill_rule() and fill_preserve().