imagecolorallocate

(PHP 4, PHP 5)

imagecolorallocate — Alloue une couleur pour une image

Description

int imagecolorallocate ( resource $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é par une des fonctions de création d'images, comme imagecreatetruecolor() .

red

Valeur pour le composant rouge

green

Valeur pour le composant vert

blue

Valeur pour le composant bleu

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

Valeurs de retour

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

Historique

Version Description
Avant la version 5.1.3 Retourne -1 si l'allocation échoue.

Exemples

Exemple 1140. 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()
imagecolordeallocate()