Remplit une région avec une couleur spécifique

# imagefilltoborder

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

imagefilltoborder — Remplit une région avec une couleur spécifique

### Description

function imagefilltoborder(
GdImage `$image`,
int `$x`,
int `$y`,
int `$border_color`,
int `$color`
): true

imagefilltoborder() remplit avec la couleur `color` toute la région à l'intérieur de la région limitée par la couleur `border_color`. Le point de départ est (`x`, `y`) (le coin supérieur gauche est l'origine (0,0)) et la couleur de la région est `color`.

### Liste de paramètres

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

  Coordonnée x du point de départ.

`y`

  Coordonnée y du point de départ.

`border_color`

  La couleur de la bordure. Un identificateur de couleur créé avec imagecolorallocate().

`color`

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

### Valeurs de retour

Retourne toujours `true`.

### Historique

Version | Description
--- | ---
8.0.0 | `image` attend une instance de GdImage désormais; auparavant, une resource `gd` était attendue.

### Exemples

Exemple #1 Remplissage d'une ellipse avec une couleur

    <?php
    // Création d'un gestionnaire d'image, puis définit la couleur d'arrière-plan
    // à blanc
    $im = imagecreatetruecolor(100, 100);
    imagefilledrectangle($im, 0, 0, 100, 100, imagecolorallocate($im, 255, 255, 255));

    // Dessine une ellipse dont les bordures seront noires
    imageellipse($im, 50, 50, 50, 50, imagecolorallocate($im, 0, 0, 0));

    // Définit la bordure et remplit l'ellipse de la couleur choisie
    $border = imagecolorallocate($im, 0, 0, 0);
    $fill = imagecolorallocate($im, 255, 0, 0);

    // Remplit la sélection
    imagefilltoborder($im, 50, 50, $border, $fill);

    // Affichage et libération de la mémoire
    header('Content-type: image/png');
    imagepng($im);
    ?>

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

### Notes

L'algorithme ne se souvient pas explicitement de quels pixels ont déjà été définis, mais plutôt l'infère à partir de la couleur du pixel, donc il ne peut pas faire la distinction entre un pixel qui vient juste d'être défini et un pixel qui était déjà présent. Ceci signifie que choisir toute couleur de remplissage qui est déjà présente dans l'image peut produire des résultats indésirables.

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