CairoContext::clip

cairo_clip

(PECL cairo >= 0.1.0)

CairoContext::clip -- cairo_clipEstablece una nueva región de recorte

Descripción

Estilo orientado a objetos (método):

public CairoContext::clip ( void ) : void

Estilo por procedimientos:

cairo_clip ( CairoContext $context ) : void

Establece una nueva región de recorte intersectando la región de recorte actual con el trazado actual como si fuera rellenado con CairoContext::fill() o cairo_fill() y según la regla de relleno actual (véase CairoContext::setFillRule() o cairo_set_fill_rule()).

Después de llamar a CairoContext::clip() o a cairo_clip(), el trazado actual se borrará desde el contexto de cairo.

La región de recorte actual afecta a todas las operaciones de dibujo enmascarando cualquier cambio hecho a la superficie que esté fuera de la región de recorte actual.

Llamar a CairoContext::clip() o a cairo_clip() sólo puede hacer la región de recorte más pequeña, nunca más grande. Pero el recorte actual es parte del estado de gráficos, por lo que se puede llevar a cabo una restricción temporal de la región de recorte llamando a CairoContext::clip() o a cairo_clip() dentro de una pareja CairoContext::save()/CairoContext::restore() o cairo_save()/cairo_restore(). El otro medio para incrementar el tamaño de la región de recorte es CairoContext::resetClip() o en estilo procedural cairo_reset_clip().

Parámetros

context

Un objeto CairoContext válido

Valores devueltos

No devuelve ningún valor.

Ejemplos

Ejemplo #1 Estilo orientado a objetos

<?php

$superficie 
= new CairoImageSurface(CairoFormat::ARGB325050);

$contexto = new CairoContext($superficie);

$contexto->clip();

?>

Ejemplo #2 Estilo por procedimientos

<?php

$superficie 
cairo_image_surface_create(CAIRO_FORMAT_ARGB325050);

$contexto cairo_create($superficie);

cairo_clip($contexto);

?>

Ver también