Function Context.clip
Establishes a new clip
region by intersecting the current
clip
region with the current path as it would be filled by
fill
() and according to the current
fill
rule (see setFillRule
()).
After clip
(), the current path will be cleared from the
cairo 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 clip
() 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 clip
() within a save
()/restore
()
pair. The only other means of increasing the size
of the clip
region is resetClip
().
Prototype
void clip();
Authors
Johannes Pfau | cairoD |
Andrej Mitrovic | cairoD |
cairo team | cairo |
Copyright
License
cairoD wrapper/bindings | Boost License 1.0 |
cairo | LGPL 2.1 / MPL 1.1 |