imagecolorallocatealpha

(PHP 4 >= 4.3.2, PHP 5)

imagecolorallocatealpha — Alloue une couleur à une image

Description

int imagecolorallocatealpha ( resource $image, int $red, int $green, int $blue, int $alpha )

imagecolorallocatealpha() se comporte comme imagecolorallocate() avec en plus le paramètre de transparence alpha .

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

alpha

Une valeur entre 0 et 127 . 0 indique une opacité complète tandis que 127 indique une transparence complète.

Les paramètres de couleurs sont des entiers compris entre 0 et 255, ou des hexadécimaux compris entre 0x00 et 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 1141. Exemple avec imagecolorallocatealpha()

<?php
$size 
300 ;
$image = imagecreatetruecolor ( $size $size );

// quelque chose pour obtenir un fond blanc avec une bordure noire
$back  imagecolorallocate ( $image 255 255 255 );
$border  imagecolorallocate ( $image 0 0 0 );
imagefilledrectangle ( $image 0 0 $size  1 $size  1 $back );
imagerectangle ( $image 0 0 $size  1 $size  1 $border );

$yellow_x  100 ;
$yellow_y  75 ;
$red_x     120 ;
$red_y     165 ;
$blue_x    187 ;
$blue_y    125 ;
$radius    150 ;

// alloue des couleurs avec des valeurs alpha
$yellow  imagecolorallocatealpha ( $image 255 255 0 75 );
$red     imagecolorallocatealpha ( $image 255 0 0 75 );
$blue    imagecolorallocatealpha ( $image 0 0 255 75 );

// Dessine 3 ellipses
imagefilledellipse ( $image $yellow_x $yellow_y $radius $radius $yellow );
imagefilledellipse ( $image $red_x $red_y $radius $radius $red );
imagefilledellipse ( $image $blue_x $blue_y $radius $radius $blue );

// Ne pas oublier d'envoyer un header correct
header ( 'Content-type: image/png' );

// et finallement, afficher le résultat
imagepng ( $image );
imagedestroy ( $image );
?>

L'exemple ci-dessus va afficher quelque chose de similaire à :


Notes

Note: Cette fonction requiert la bibliothèque GD 2.0.1 ou supérieure (2.0.28 ou supérieure est recommandée).

Voir aussi

imagecolorallocate()
imagecolordeallocate()