imagegif

(PHP 3, PHP 4 )

imagegif --  Ausgabe eines Bildes an den Browser oder in eine Datei

Beschreibung:

int imagegif ( int im [, string filename])

ImageGIF() erzeugt eine Datei im Format GIF aus im. Falls Sie [filename] angegeben haben, wird die Ausgabe in diese Datei geschrieben, ansonsten wird die Ausgabe direkt an den Browser geleitet. Im ist das Ergebnis der imagecreate()-Funktion.

Das Format wird GIF87a sein, es sei denn, Sie haben das Bild per ImageColorTransparent() als transparent formatiert. In diesem Fall wird das Bild im GIF89a-Format ausgegeben.

Die Angabe des Dateinamens ist optional. Falls er fehlt, werden die Bilddaten direkt ausgegeben. Durch Verwendung der Funktion header() mit der "content-type"-Angabe "image/gif" können Sie PHP-Skripte erstellen, welche die GIF-Ausgabe direkt vornehmen.

Anmerkung: ACHTUNG: Ab Version 1.6 wurde die GIF-Unterstützung komplett aus der GD-Bibliothek entfernt. Diese Funktion ist also nur verfügbar, wenn Sie eine Version vor 1.6 verwenden.

Um trotzdem portable PHP-Anwendungen schreiben zu können, kann mit folgendem Code-Stück automatisch geprüft werden, welches Bildformat in der mitgebundenen GD-Bibliothek nutzbar ist. Ersetzen Sie hierfür die Codesequenz Header("Content-type: image/gif"); ImageGif($im); durch die flexiblere Folge:

<?php
  if (function_exists("imagegif")) {
    Header("Content-type: image/gif");
    ImageGif($im);
  }
  elseif (function_exists("imagejpeg")) {
    Header("Content-type: image/jpeg");
    ImageJpeg($im, "", 0.5);
  }
  elseif (function_exists("imagepng")) {
    Header("Content-type: image/png");
    ImagePng($im);
  }
  else
    die("Keine Grafik-Unterstützung vorhanden");
?>

Anmerkung: In PHP 4 ab Version 4.0.2 haben Sie alternativ zum Test per function_exists() auch die Möglichkeit, mit der imagetypes()-Funktion die unterstützten Bildformate abzutesten.

if (ImageTypes() & IMG_GIF) {
    Header("Content-type: image/gif");
    ImageGif($im);
}
elseif (ImageTypes() & IMG_JPG) {
... etc.

Siehe auch imagepng(), imagejpeg(), imagetypes().