imagegif
(PHP 4, PHP 5, PHP 7, PHP 8)
imagegif — Gibt das Bild im Browser oder einer Datei aus.
Beschreibung
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. Wenn 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.
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
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);
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:
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. */
}
?>
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
