Définit la couleur transparente

# imagecolortransparent

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

imagecolortransparent — Définit la couleur transparente

### Description

function 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 couleurs 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ée précédemment sera transparente.

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open