# imagegif

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

imagegif — Gibt das Bild im Browser oder einer Datei aus.

### Beschreibung

imagegif(GdImage `$image`, resource|string|null `$file` = `null`): bool

imagegif() erzeugt aus dem übergebenen `image` eine GIF-Datei in `file`. Der Inhalt des Parameters `image` ist der Rückgabewert der Funktionen imagecreate() oder `imagecreatefrom*`.

Das Bildformat ist GIF87a, es sei denn, das Bild wurde mittels imagecolortransparent() transparent gemacht. In diesem Fall ist das Bildformat GIF89a.

### Parameter-Liste

`image`

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

`file`

  Der Pfad oder eine offene Stream-Ressource (die nach der Beendigung dieser Funktion automatisch geschlossen wird), in dem bzw. der die Datei gespeichert werden soll. Falls nicht gesetzt oder `null`, wird der rohe Bilddatenstrom direkt ausgegeben.

### Rückgabewerte

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

Achtung

Wenn libgd das Bild nicht ausgeben kann, gibt diese Funktion `true` zurück.

### Changelog

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

### Beispiele

Beispiel #1 Ein Bild mittels imagegif() ausgeben

`<?php
// Erzeugt ein neues Bild
$im = imagecreatetruecolor(100, 100);
// Den Hintergrund weiß machen
imagefilledrectangle($im, 0, 0, 99, 99, 0xFFFFFF);
// Einen Text im Bild ausgeben
imagestring($im, 3, 40, 20, 'GD Library', 0xFFBA00);
// Das Bild an den Browser ausgeben
header('Content-Type: image/gif');
imagegif($im);
?>`

Beispiel #2 Eine PNG-Datei mit imagegif() in GIF konvertieren

`<?php
// Die PNG-Datei laden
$png = imagecreatefrompng('./php.png');
// Die Datei im GIF-Format speichern
imagegif($png, './php.gif');
// Wir sind fertig
echo 'Die PNG-Datei wurde erfolgreich nach GIF konvertiert!';
?>`

### Anmerkungen

> Hinweis:

> Der folgende Codeauszug erlaubt es Ihnen, besser portierbare PHP-Anwendungen zu schreiben, indem die von GD unterstützten Bildformate automatisch erkannt werden. Ersetzen Sie den Abschnitt `header ("Content-Type: image/gif"); imagegif ($im);` durch diesen flexibleren Code:

> `<?php
> // Ein neues Bild erzeugen
> $im = imagecreatetruecolor(100, 100);
> // Hier wird das Bild bearbeitet
> // Ausgabebehandlung
> if(function_exists('imagegif'))
> {
> // Für GIF
> header('Content-Type: image/gif');
> imagegif($im);
> }
> elseif(function_exists('imagejpeg'))
> {
> // Für JPEG
> header('Content-Type: image/jpeg');
> imagejpeg($im, NULL, 100);
> }
> elseif(function_exists('imagepng'))
> {
> // Für PNG
> header('Content-Type: image/png');
> imagepng($im);
> }
> elseif(function_exists('imagewbmp'))
> {
> // Für WBMP
> header('Content-Type: image/vnd.wap.wbmp');
> imagewbmp($im);
> }
> else
> {
> die('Auf diesem Server gibt es keine unterstützten Bildformate');
> }
> ?>`

> Hinweis:

> Die Funktion imagetypes() kann verwendet werden, um die Unterstützung für verschiedene Bildformate zu überprüfen:

> `<?php
> if(imagetypes() & IMG_GIF)
> {
> header('Content-Type: image/gif');
> imagegif($im);
> }
> elseif(imagetypes() & IMG_JPG)
> {
> /* ... etc. */
> }
> ?>`

### Siehe auch

- imagepng() - Ausgabe eines Bildes im Browser oder als Datei im PNG-Format
- imagewbmp() - Gibt das Bild im Browser oder einer Datei aus.
- imagejpeg() - Gibt das Bild im Browser oder einer Datei aus.
- imagetypes() - Liefert die von der verwendeten PHP-Version unterstützten Grafikformate

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