CairoContext::copyPath

cairo_copy_path

(PECL cairo >= 0.1.0)

CairoContext::copyPath -- cairo_copy_path — Crea una copia del trazado actual

Descripción

Estilo orientado a objetos (método):

public CairoContext::copyPath ( void ) : CairoPath

Estilo por procedimientos:

cairo_copy_path ( CairoContext $context ) : CairoPath

Crea una copia del trazado actual y la devuelve al usuario como un CairoPath. Véase CairoPath para consejo de cómo iterar sobre la estructura de información devuelta.

Esta función siempre devuelve un objeto CairoPath válido, pero el resultado no tendrá información si se cumplen las siguientes condiciones:

  • 1. Si no hay memoria suficiente para copiar el trazado. En este caso CairoPath->status será establecido a CAIRO_STATUS_NO_MEMORY.
  • 2. Si context ya está en un estado de error. En este caso CairoPath->status contendrá el mismo estado que sería devulto por cairo_status().
En ambos casos, CairoPath->status será establecido a CAIRO_STATUS_NO_MEMORY (independientemente del estado de error que pudiera estar cr).

Parámetros

context

Un objeto CairoContext válido creado con CairoContext::__construct() o cairo_create()

Valores devueltos

Una copia del CairoPath actual en el contexto

Ejemplos

Ejemplo #1 Estilo orientado a objetos

<?php

$superficie = new CairoImageSurface(CairoFormat::ARGB32, 50, 50);

$contexto = new CairoContext($superficie);

var_dump($contexto->copyPath())

?>

El resultado del ejemplo sería algo similar a:

object(CairoPath)#3 (0) {
}

Ejemplo #2 Estilo por procedimientos

<?php

$superficie = cairo_image_surface_create(CAIRO_FORMAT_ARGB32, 50, 50);

$contexto = cairo_create($superficie);

var_dump(cairo_copy_path($contexto));

?>

El resultado del ejemplo sería algo similar a:

object(CairoPath)#3 (0) {
}

Ver también