CairoContext::clip
cairo_clip
(PECL cairo >= 0.1.0)
CairoContext::clip -- cairo_clip — Establece una nueva región de recorte
Descripción
Estilo orientado a objetos (método):
Estilo por procedimientos:
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::ARGB32, 50, 50);
$contexto = new CairoContext($superficie);
$contexto->clip();
?>
Ejemplo #2 Estilo por procedimientos
<?php
$superficie = cairo_image_surface_create(CAIRO_FORMAT_ARGB32, 50, 50);
$contexto = cairo_create($superficie);
cairo_clip($contexto);
?>
Ver también
- CairoContext::resetClip() - El propósito de resetClip
- cairo_reset_clip() - El propósito de resetClip
add a note
