imagecolorallocate

(PHP 3, PHP 4 , PHP 5)

imagecolorallocate -- Alloue une couleur pour une image

Description

int imagecolorallocate ( resource image, int red, int green, int blue )

imagecolorallocate() retourne un identifiant de couleur, représentant la couleur composée avec les couleurs RGB (red, green, blue). L'argument image est le résultat de la fonction imagecreate(). Les paramètres red, green et blue sont les valeurs respectives des composants rouge, vert et bleue de la couleur voulue. Ces paramètres sont des entiers compris entre 0 et 255 ou des hexadécimaux compris entre 0x00 and 0xFF. imagecolorallocate() doit être appelée pour créer chaque couleur qui sera représentée par image.

Note : Le premier appel à imagecolorallocate() remplie la couleur de fond.

Exemple 1. Exemple avec imagecolorallocate()

<?php

// 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);

?>

imagecolorallocate() retourne -1 si l'allocation échoue.

Voir aussi imagecolorallocatealpha() et imagecolordeallocate().