imagesavealpha

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

imagesavealpha — Détermine si les informations complètes du canal alpha doivent être conservées lors de la sauvegardes d'images

Description

imagesavealpha(GdImage $image, bool $enable): bool

imagesavealpha() définit le drapeau qui détermine si les informations du canal alpha (en opposition à la transparence à couleur unique) doivent être conservées lors de la sauvegarde d'images. Cela est supporte seulement pour les formats d'images qui supportent la totalité des informations de chaines alpha, par exemple PNG, WebP et AVIF.

Note: imagesavealpha() est seulement significatif pour les images PNG, comme les chaînes alpha pleines sont toujours sauvegardées pour WebP et AVIF. Il n'est pas recommendé de se reposer sur ce comportement, cela pourrait changer dans le futur. Donc, imagesavealpha() devrait être appelé intentionellement aussi pour les images WebP et AVIF.

Le alphablending doit être désactivé (imagealphablending($im, false)) pour conserver le canal alpha en premier lieu.

Liste de paramètres

image

Un objet GdImage, retournée par une des fonctions de création d'images, comme imagecreatetruecolor().

enable

Si l'on doit ou non sauvegarder le canal alpha. Par défaut false.

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient.

Historique

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

Exemples

Exemple #1 Utilisation simple de imagesavealpha()

<?php
// Charge une image PNG avec un canal alpha
$png = imagecreatefrompng('./alphachannel_example.png');

// Désactiver le alpha blending
imagealphablending($png, false);

// Faire les opérations désirées

// Définir le drapeau alpha
imagesavealpha($png, true);

// Affiche l'image au navigateur
header('Content-Type: image/png');

imagepng($png);
imagedestroy($png);
?>

Voir aussi