Dessine un polygone rempli

Description

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

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

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

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

imagefilledpolygon() dessine un polygone rempli 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 qui contient les coordonnées x et y du sommet des polygones.
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 imagefilledpolygon()

<?php
// Définition du tableau de points pour le polygone
$values = array(
            40,  50,  // Point 1 (x, y)
            20,  240, // Point 2 (x, y)
            60,  60,  // Point 3 (x, y)
            240, 20,  // Point 4 (x, y)
            50,  40,  // Point 5 (x, y)
            10,  10   // Point 6 (x, y)
            );

// Création d'une image
$image = imagecreatetruecolor(250, 250);

// Alloue quelques couleurs
$bg   = imagecolorallocate($image, 0, 0, 0);
$blue = imagecolorallocate($image, 0, 0, 255);

// Remplit l'arrière-plan
imagefilledrectangle($image, 0, 0, 249, 249, $bg);

// Dessine le polygone
imagefilledpolygon($image, $values, $blue);

// Affichage de l'image
header('Content-type: image/png');
imagepng($image);
?>

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

Affichage de l'exemple : imagefilledpolygon()

Voir aussi

imagepolygon() - Dessine un polygone