imagecolorexactalpha

(PHP 4 >= 4.0.6, PHP 5)

imagecolorexactalpha — Retourne l'index d'une couleur avec son canal alpha

Description

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

Retourne l'index d'une couleur avec son canal alpha.

Liste de paramètres

image: Une ressource d'image, retournée par une des fonctions de création d'images, comme imagecreatetruecolor().
red: Valeur du composant rouge.
green: Valeur du composant vert.
blue: Valeur du composant bleu.
alpha: Une valeur comprise entre 0 et 127. 0 indique une opacité complète tandis que 127 indique une transparence complète.

Les paramètres sur les couleurs sont des entiers compris entre 0 et 255 ou des hexadécimaux compris entre 0x00 and 0xFF.

Valeurs de retour

Retourne l'index de la couleur fournie et son canal alpha dans la palette de l'image, ou -1 si la couleur n'existe pas dans la palette de l'image.

Exemples

Exemple #1 Récupération des couleurs composant le logo GD


<?php

// Définit l'image
$im = imagecreatefrompng('./gdlogo.png');

$colors   = Array();
$colors[] = imagecolorexactalpha($im, 255, 0, 0, 0);
$colors[] = imagecolorexactalpha($im, 0, 0, 0, 127);
$colors[] = imagecolorexactalpha($im, 255, 255, 255, 55);
$colors[] = imagecolorexactalpha($im, 100, 255, 52, 20);

print_r($colors);

// Libération de la mémoire
imagedestroy($im);
?>

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

Array
(
    [0] => 16711680
    [1] => 2130706432
    [2] => 939524095
    [3] => 342163252
)

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

imagecolorclosestalpha() - Retourne la couleur la plus proche, en tenant compte du canal alpha

add a note User Contributed Notes imagecolorexactalpha

matt at matt-darby dot com 11-Jul-2005 06:09


Note that a color allocated with imagecolorexactalpha won't show alpha (it will be opaque) when used with imageline(). Use imagerectangle() set to your normal start and end points instead.



Ensure that the image is created via imagecreatetruecolor() as well!

phpdoc-comment at aditus dot nu 08-Nov-2002 10:01


What might be misleading in the docs is that if the specified color + alpha channel does not exist it will be created. So if you like to use an alpha channel in your image enable alpha blending and then create you color using this method.

add a note