# 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` fournit.

### 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 vous avez défini la couleur de transparence, chaque région de l'image de cette couleur que vous avez dessiné précédemment sera transparente.