imagepolygon

(PHP 4, PHP 5, PHP 7, PHP 8)

imagepolygon — Dessine un polygone

Description

Signature à partir de PHP 8.0.0 (non supportée avec les arguments nommés)

imagepolygon(GdImage $image, array $points, int $color): bool

Signature alternative (obsolète à partir de PHP 8.1.0)

imagepolygon(
    GdImage $image,
    array $points,
    int $num_points,
    int $color
): bool

imagepolygon() dessine un polygone dans l'image image.

Liste de paramètres

image
Un objet GdImage, retournée par une des fonctions de création d'images, comme imagecreatetruecolor().
points

Un tableau contenant les sommets du polygone, p. ex. :

points[0] = x0
points[1] = y0
points[2] = x1
points[3] = y1

num_points

Nombre total de points (sommets), qui doivent être d'au moins 3.

Si ce paramètre est omis conformément à la deuxième signature, points doit avoir un nombre pair d'éléments, et num_points est assumé d'être count($points)/2.
color

Un identificateur de couleur créé avec imagecolorallocate().

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient.

Historique

Version Description
8.1.0 Le paramètre num_points a été rendu obsolète.
8.0.0 image attend une instance de GdImage désormais; auparavant, une resource gd était attendue.

Exemples

Exemple #1 Exemple avec imagepolygon()

<?php
// Création d'une image vide
$image = imagecreatetruecolor(400, 300);

// Alloue une couleur pour le polygone
$col_poly = imagecolorallocate($image, 255, 255, 255);

// Dessine le polygone
imagepolygon($image, array(
0, 0,
100, 200,
300, 200
),
$col_poly);

// Affichage de l'image sur le navigateur
header('Content-type: image/png');

imagepng($image);
?>

Résultat de l'exemple ci-dessus est similaire à :

Affichage de l'exemple : imagepolygon()

Voir aussi