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

    VersionBeschreibung
    8.0.0image 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

    To Top