Manuel PHP
Précédent |  | Suivant

# 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

Version | Description
--- | ---
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()

Précédent | Sommaire | Suivant
imagecharup | Niveau supérieur | imagecolorallocatealpha