imagecolorexactalpha

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

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

Description

imagecolorexactalpha(
    GdImage $image,
    int $red,
    int $green,
    int $blue,
    int $alpha
): int

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

Liste de paramètres

image: Un objet GdImage, 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.

Historique

Version	Description
8.0.0	`image` attend une instance de GdImage désormais; auparavant, une resource `gd` était attendue.

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);
?>

Résultat de l'exemple ci-dessus est similaire à :

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

Voir aussi

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

add a note

User Contributed Notes 2 notes

down

matt at matt-darby dot com ¶

19 years ago


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!

down

-1

phpdoc-comment at aditus dot nu ¶

22 years ago


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