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 )

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

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

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()
imagecolordeallocate()