imagesavealpha

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

imagesavealpha — Ob beim Speichern von Bildern vollständige Alphakanal-Information erhalten wird

Beschreibung

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

imagesavealpha() setzt das Flag, das bestimmt, ob beim Speichern von Bildern vollständige Alphakanal-Information (im Gegensatz zu Einfarb-Transparenz) erhalten wird. Dies wird nur von Bildformaten mit vollständiger Alphakanal-Information unterstützt, d. h. PNG, WebP und AVIF.

Hinweis: imagesavealpha() ist nur für PNG-Bilder sinnvoll, da bei WebP und AVIF immer der volle Alphakanal gespeichert wird. Es wird empfohlen, sich nicht auf dieses Verhalten zu verlassen, da es sich in Zukunft ändern kann. Daher sollte diese Funktion bei WebP- und AVIF-Bildern auch mit Bedacht aufgerufen werden.

Alphablending muss deaktiviert sein (imagealphablending($im, false)), um den Alphakanal überhaupt zu erhalten.

Parameter-Liste

image

Ein GdImage-Objekt, das von einer der Funktionen zur Bilderzeugung, z. B. imagecreatetruecolor(), zurückgegeben wurde.

enable

Ob der Alphakanal gespeichert werden soll, oder nicht. Die Voreinstellung ist false.

Rückgabewerte

Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.

Changelog

Version Beschreibung
8.0.0 image erwartet nun eine GdImage-Instanz; vorher wurde eine gültige gd-Ressource erwartet.

Beispiele

Beispiel #1 Grundlegende Verwendung imagesavealpha()-Verwendung

<?php
// Lade ein PNG-Bild mit Alphakanal
$png = imagecreatefrompng('./alphachannel_example.png');

// Deaktiviere das Alphablending
imagealphablending($png, false);

// Führe die gewünschten Operationen durch

// Setze das Alphakanal-Flag
imagesavealpha($png, true);

// Gibt das Bild zum Browser aus
header('Content-Type: image/png');

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

Siehe auch