Alloue une couleur pour une image

# imagecolorallocate

(PHP 4, PHP 5, PHP 7)

imagecolorallocate — Alloue une couleur pour une image

### Description

imagecolorallocate ( resource `$image` , int `$red` , int `$green` , int `$blue` ) : int

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`

  Une ressource d'image, 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 and 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
--- | ---
5.1.3 | Retourne `FALSE` si l'allocation échoue. Précédemment, -1 était retourné.

### 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