Alloue une couleur pour une image

# imagecolorallocate

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

imagecolorallocate — Alloue une couleur pour une image

### Description

function imagecolorallocate(
GdImage `$image`,
int `$red`,
int `$green`,
int `$blue`
): int|false

Retourne un identifiant de couleur, représentant la couleur composée avec les couleurs RGB.

imagecolorallocate() doit être appelée pour créer chaque couleur qui sera représentée par `image`.

> Note:

> Le premier appel à imagecolorallocate() remplit la couleur de fond avec la palette des images - images créées en utilisant imagecreate().

### Liste de paramètres

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

  Valeur du composant rouge.

`green`

  Valeur du composant vert.

`blue`

  Valeur du composant bleu.

Ces paramètres sont des entiers compris entre 0 et 255 ou des hexadécimaux compris entre 0x00 et 0xFF.

### Valeurs de retour

Un identifiant de couleur ou `false` si l'allocation échoue.

Avertissement

Cette fonction peut retourner `false`, mais elle peut aussi retourner une valeur équivalent à `false`. Veuillez lire la section sur les booléens pour plus d'informations. Utilisez l'opérateur === pour tester la valeur de retour exacte de cette fonction.

### Historique

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

### Exemples

Exemple #1 Exemple avec imagecolorallocate()

    <?php

    $im = imagecreate(100, 100);

    // Le fond de l'image est en rouge
    $background = imagecolorallocate($im, 255, 0, 0);

    // On définit des couleurs avec des entiers ..
    $white = imagecolorallocate($im, 255, 255, 255);
    $black = imagecolorallocate($im, 0, 0, 0);

    // .. ou des hexadécimaux
    $white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
    $black = imagecolorallocate($im, 0x00, 0x00, 0x00);

    ?>

### Voir aussi

- imagecolorallocatealpha() - Alloue une couleur à une image
- imagecolordeallocate() - Supprime une couleur d'une image

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