array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.imagegif.php', 1 => 'imagegif', ), 'up' => array ( 0 => 'ref.image.php', 1 => 'GD- und Image-Funktionen', ), 'prev' => array ( 0 => 'function.imagegetinterpolation.php', 1 => 'imagegetinterpolation', ), 'next' => array ( 0 => 'function.imagegrabscreen.php', 1 => 'imagegrabscreen', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/image/functions/imagegif.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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.
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.
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. */
}
?>