imagecolorallocate
(PHP 4, PHP 5)
imagecolorallocate — Alloue une couleur pour une image
Description
$image
, int $red
, int $green
, int $blue
)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.
Valeurs de retour
Un identifiant de couleur ou FALSE si l'allocation échoue.
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
