# 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);
?>`

### Siehe auch

- imagealphablending() - Set the blending mode for an image

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