imagecreatefromgif
(PHP 4, PHP 5, PHP 7, PHP 8)
imagecreatefromgif — Erzeugt ein neues Bild aus einer Datei oder URL
Beschreibung
imagecreatefromgif() gibt den Bezeichner auf ein Bild zurück, der das aus der angegebenen Datei eingelesene Bild darstellt.
Werden GIF-Dateien in den Speicher geladen, wird nur der erste Frame im Bildobjekt zurückgegeben. Die Größe des Bildes ist nicht notwendigerweise diejenige, die von getimagesize() gemeldet wird.
Wenn fopen wrappers aktiviert ist, kann mit dieser Funktion eine URL als Dateiname verwendet werden. Mehr Details dazu, wie der Dateiname angeben werden muss, sind bei fopen() zu finden. Eine Liste der unterstützten URL-Protokolle, die Fähigkeiten der verschiedenen Wrapper, Hinweise zu deren Verwendung und Informationen zu den eventuell vorhandenen vordefinierten Variablen sind unter Unterstützte Protokolle und Wrapper zu finden.
Parameter-Liste
-
filename -
Pfad zum GIF-Bild.
Rückgabewerte
Gibt im Erfolgsfall eine Bildobjekt zurück, im Fehlerfall false.
Changelog
| Version | Beschreibung |
|---|---|
| 8.0.0 | Bei Erfolg gibt diese Funktion jetzt eine GDImage-Instanz zurück; zuvor wurde eine Ressource zurückgegeben. |
Beispiele
Beispiel #1 Beispiel zur Behandlung von Fehlern beim Einlesen eines GIFs
<?php
function LoadGif($imgname) {
/* Versuche Datei zu öffnen */
$im = @imagecreatefromgif($imgname);
/* Wenn Öffnen fehlgeschlagen ist */
if (!$im) {
/* Erzeuge ein leeres Bild */
$im = imagecreatetruecolor(150, 30);
$bgc = imagecolorallocate($im, 255, 255, 255);
$tc = imagecolorallocate($im, 0, 0, 0);
imagefilledrectangle($im, 0, 0, 150, 30, $bgc);
/* Gebe eine Fehlermeldung im Bild aus */
imagestring($im, 1, 5, 5, 'Fehler beim Öffnen von ' . $imgname, $tc);
}
return $im;
}
header('Content-Type: image/gif');
$img = LoadGif('bogus.image');
imagegif($img);
imagedestroy($img);
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
