array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.imagegif.php', 1 => 'imagegif', 2 => 'Gibt das Bild im Browser oder einer Datei aus.', ), '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', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

imagegif

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

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

Beschreibung

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