imagecolortransparent

(PHP 4, PHP 5, PHP 7, PHP 8)

imagecolortransparent — Définit la couleur transparente

Description

imagecolortransparent(GdImage $image, ?int $color = null): int

Récupère ou définit la couleur transparente pour l'image fournie.

Liste de paramètres

image: Un objet GdImage, retournée par une des fonctions de création d'images, comme imagecreatetruecolor().
color: Un identificateur de couleur créé avec imagecolorallocate().

Valeurs de retour

L'identifiant de la nouvelle couleur transparente (ou l'actuelle, si aucune n'est spécifiée) est retourné. Si le paramètre color est null, et que l'image n'a pas de couleur transparente, l'identifiant retourné sera -1.

Historique

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

Exemples

Exemple #1 Exemple avec imagecolortransparent()

<?php
// Création d'une image de 55x30
$im = imagecreatetruecolor(55, 30);
$red = imagecolorallocate($im, 255, 0, 0);
$black = imagecolorallocate($im, 0, 0, 0);

// On rend l'arrière-plan transparent
imagecolortransparent($im, $black);

// On dessine un rectangle rouge
imagefilledrectangle($im, 4, 4, 50, 25, $red);

// On sauvegarde l'image
imagepng($im, './imagecolortransparent.png');
?>

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

Notes

Note:
La transparence est copiée uniquement avec la fonction imagecopymerge() et les images en couleur vraies, non pas avec la fonction imagecopy() ou les images de palette.

Note:
La couleur de transparence est une propriété de l'image, elle n'est pas une propriété de la couleur. Une fois que l'on a défini la couleur de transparence, chaque région de l'image de cette couleur que l'on a dessiné précédemment sera transparente.