CairoContext::copyPath

cairo_copy_path

(PECL cairo >= 0.1.0)

CairoContext::copyPath -- cairo_copy_path — Crée une copie du chemin courant

Description

Style orienté objet (méthode) :

public CairoContext::copyPath ( void ) : CairoPath

Style procédural :

cairo_copy_path ( CairoContext $context ) : CairoPath

Crée une copie du chemin courant et le retourne à l'utilisateur sous la forme d'un CairoPath. Voir la méthode CairoPathpour des astuces sur l'itération de la structure de données retournée.

Cette fonction retournera toujours un objet CairoPath valide, mais le résultat peut ne pas contenir de données, si une des conditions suivantes n'est pas remplie :

  • 1. S'il n'y a pas suffisamment de mémoire pour copier le chemin. Dans ce cas, CairoPath->status sera défini à CAIRO_STATUS_NO_MEMORY.
  • 2. Si context est déjà dans un statut d'erreur. Dans ce cas, CairoPath->status contiendra le même statut que celui retourné par la fonction cairo_status().
Dans tous les cas, CairoPath->status sera défini à CAIRO_STATUS_NO_MEMORY (suivant le statut de l'erreur dans cr).

Liste de paramètres

context

Un objet CairoContext valide créé avec CairoContext::__construct() ou cairo_create()

Valeurs de retour

Une copie de l'objet CairoPath courant dans le contexte.

Exemples

Exemple #1 Style orienté objet

<?php

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

$context = new CairoContext($surface);

var_dump($context->copyPath())

?>

L'exemple ci-dessus va afficher quelque chose de similaire à :

object(CairoPath)#3 (0) {
}

Exemple #2 Style procédural

<?php

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

$context = cairo_create($surface);

var_dump(cairo_copy_path($context));

?>

L'exemple ci-dessus va afficher quelque chose de similaire à :

object(CairoPath)#3 (0) {
}

Voir aussi