CairoContext::clip
cairo_clip
(PECL cairo >= 0.1.0)
CairoContext::clip -- cairo_clip — Établit une nouvelle région
Description
Style orienté objet (méthode) :
Style procédural :
Établit une nouvelle région par l'intersection de la région courante avec le chemin courant, nouvelle région remplit par la méthode CairoContext::fill() ou la fonction cairo_fill() et suivant la règle de remplissage courant (voir la méthode CairoContext::setFillRule() ou la fonction cairo_set_fill_rule()).
Après un appel à la méthode CairoContext::clip() ou la fonction cairo_clip(), le chemin courant sera effacé du contexte Cairo.
La région courante affecte toutes les opérations de dessin en masquant toutes les modifications de la surface qui se trouve à l'extérieur de la région courante.
L'appel à la méthode CairoContext::clip() ou la fonction cairo_clip() peut rendre uniquement la région plus petite, jamais plus grande. Mais la région courante fait partie du statut du graphique, aussi, une restriction temporaire de la région peut être effectuée en appelant la méthode CairoContext::clip() ou la fonction cairo_clip() dans la paire CairoContext::save()/ CairoContext::restore() ou cairo_save()/ cairo_restore(). Vous pouvez également accroître la taille d'une région avec la méthode CairoContext::resetClip() ou la fonction cairo_reset_clip().
Liste de paramètres
-
context
-
Un objet CairoContext valide.
Valeurs de retour
Aucune valeur n'est retournée.
Exemples
Exemple #1 Style orienté objet
<?php $surface = new CairoImageSurface(CairoFormat::ARGB32, 50, 50); $context = new CairoContext($surface); $context->clip(); ?>
Exemple #2 Style procédural
<?php $surface = cairo_image_surface_create(CAIRO_FORMAT_ARGB32, 50, 50); $context = cairo_create($surface); cairo_clip($context); ?>