Dessine un polygone rempli

# imagefilledpolygon

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

imagefilledpolygon — Dessine un polygone rempli

### Description

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

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

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

function 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 contenant successivement les coordonnées `x` et `y` des sommets du polygone.

`num_points`

  Nombre total de points (sommets), qui doit ê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 supposé valoir `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 à :

### Voir aussi

- imagepolygon() - Dessine un polygone

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open