CairoContext::clip

cairo_clip

(PECL cairo >= 0.1.0)

CairoContext::clip -- cairo_clipÉtablit une nouvelle région

Description

Style orienté objet (méthode) :

public void CairoContext::clip ( void )

Style procédural :

void cairo_clip ( CairoContext $context )

É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);

?>

Voir aussi

LoadingChargement en cours