CairoContext::clipPreserve
cairo_clip_preserve
(PECL cairo >= 0.1.0)
CairoContext::clipPreserve -- cairo_clip_preserve — Establce una nueva región de recorte desde el recorte actual
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 fuese rellenada por Context.fill() y según la acutual FILL RULE (véase CairoContext::setFillRule() o cairo_set_fill_rule()).
A diferencia de CairoContext::clip(), CairoContext::clipPreserve() preserva el trazado dentro de Context. 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::clipPreserve() 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::clipPreserve() dentro de una pareja CairoContext::save()/CairoContext::restore(). El otro medio para incrementar el tamaño de la región de recorte es CairoContext::resetClip().
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->clipPreserve();
?>
Ejemplo #2 Estilo por procedimientos
<?php
$superficie = cairo_image_surface_create(CAIRO_FORMAT_ARGB32, 50, 50);
$contexto = cairo_create($superficie);
cairo_clip_preserve($contexto);
?>
Ver también
- CairoContext::save() - El propósito de save
- CairoContext::restore() - El propósito de restore
- CairoContext::resetClip() - El propósito de resetClip
add a note
