(PHP 4, PHP 5, PHP 7)
imagecolorallocate — Alloue une couleur pour une image
$image
, int $red
, int $green
, int $blue
) : intRetourne 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().
imageUne ressource d'image, retournée par une des fonctions de création d'images, comme imagecreatetruecolor().
redValeur du composant rouge.
greenValeur du composant vert.
blueValeur du composant bleu.
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.
| Version | Description |
|---|---|
| 5.1.3 |
Retourne FALSE si l'allocation échoue. Précédemment,
-1 était retourné.
|
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);
?>