(PHP 4, PHP 5, PHP 7, PHP 8)
imagegif — Gibt das Bild im Browser oder einer Datei aus.
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.
imageEin GdImage-Objekt, das von einer der Funktionen zur Bilderzeugung, z. B. imagecreatetruecolor(), zurückgegeben wurde.
fileDer 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.
Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.
Wenn libgd das Bild nicht ausgeben kann, gibt diese Funktion true zurück.
| Version | Beschreibung |
|---|---|
| 8.0.0 |
image erwartet nun eine
GdImage-Instanz; vorher wurde eine gültige
gd-Ressource erwartet.
|
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!';
?>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
{
imagedestroy($im);
die('Auf diesem Server gibt es keine unterstützten Bildformate');
}
// Falls Unterstützung für eines dieser Formate
// gefunden wurde, geben wir den Speicher frei
if($im)
{
imagedestroy($im);
}
?>
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. */
}
?>