Gibt das Bild im Browser oder einer Datei aus.

# imagegif

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

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

### Beschreibung

function 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