GD- und Image-Funktionen
PHP-Handbuch

imagegif

Gibt das Bild im Browser oder einer Datei aus.

Beschreibung

bool imagegif ( resource $image [, mixed $to ] )

imagegif erzeugt eine GIF-Datei gemäß to aus dem übergebenen image. Der Inhalt des Parameters image ist die Rückgabe der Funktionen imagecreate oder imagecreatefrom*

Das Dateiformat wird GIF87a sein, es sei denn das Bild wurde mittels imagecolortransparent transparent gemacht. In diesem Fall wird das Dateiformat GIF89a sein.

Parameter-Liste

image

Eine von den verschiedenen Erzeugungsfunktionen wie imagecreatetruecolor gelieferte Grafikressource.

to

Der Pfad unter dem das Bild gespeichert werden soll. Ist dies nicht gesetzt oder NULL wird der rohe Bilddatenstrom direkt ausgegeben.

Rückgabewerte

Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.

Changelog

Version Beschreibung
5.4.0 Unterstützung für die Übergabe einer Stream-Ressource (resource) an to wurde hinzugefügt.

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);
imagedestroy($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');

// Den Speicher freigeben
imagedestroy($png);

// Wir sind fertig
echo 'Die PNG-Datei wurde erfolgreich nach GIF konvertiert!';
?>

Anmerkungen

Hinweis:

Die Unterstützung des GIF-Dateiformates wurde in der Version 1.6 der GD-Bibliothek entfernt und in der Version 2.0.28 wieder hinzugefügt. Nähere Angaben finden Sie auf der Webseite des » GD Projekts.

Der folgende Codeauszug erlaubt es Ihnen leichter umzuziehende PHP-Anwendungen zu schreiben, indem die von GD unterstützten Dateiformat automatisch erkannt werden. Ersetzen Sie den Abschnitt header ("Content-Type: image/gif"); imagegif ($im); durch den folgenden Abschnitt:

<?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
{
    imagedestroy($im);

    die('Auf diesem Server gibt es keine unterstützten Bildformate');
}

// Falls Unterstützung für eines von diesen Formaten
// gefunden wurde, geben wir den Speicher frei
if($im)
{
    imagedestroy($im);
}
?>

Hinweis:

Die Funktion imagetypes kann zur Prüfung der Unterstützung der verschiedenen Bildformate verwendet werden:

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

Siehe auch

  • imagepng
  • imagewbmp
  • imagejpeg
  • imagetypes