imagecreatefromgif

(PHP 4, PHP 5, PHP 7)

imagecreatefromgifErzeugt ein neues Bild aus einer Datei oder URL

Beschreibung

imagecreatefromgif ( string $filename ) : resource

imagecreatefromgif() gibt den Bezeichner auf ein Bild zurück, der das aus der angegebenen Datei eingelesene Bild darstellt.

Achtung

Werden GIF-Dateien in den Speicher geladen, wird nur der erste Frame in der Bild-Ressource zurückgeliefert. Die Größe des Bildes ist nicht notwendigerweise diejenige, die von getimagesize() gemeldet wird.

Tipp

Mit dieser Funktion können Sie eine URL als Dateinamen verwenden, falls Sie fopen wrappers ermöglicht haben. Mehr Details dazu, wie Sie den Dateinamen angeben müssen finden Sie bei fopen(). 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 finden Sie unter Unterstützte Protokolle und Wrapper.

Parameter-Liste

filename

Pfad zum GIF Bild.

Rückgabewerte

Gibt im Erfolgsfall eine Bildresource zurück, im Fehlerfall FALSE.

Beispiele

Beispiel #1 Beispiel zur Behandlung von Fehlern beim Einlesen einer GIF

<?php
function LoadGif($imgname) {
    
/* Versuch Datei zu öffnen */
    
$im = @imagecreatefromgif($imgname);

    
/* Wenn Öffnen fehlgeschlagen ist */
    
if (!$im) {
        
/* Erzeuge ein leeres Bild */
        
$im  imagecreatetruecolor(15030);
        
$bgc imagecolorallocate($im255255255);
        
$tc  imagecolorallocate($im000);

        
imagefilledrectangle($im0015030$bgc);

        
/* Gebe eine Fehlermeldung im Bild aus */
        
imagestring($im155'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:

Ausgabe des Beispiels zur Behandlung von Fehlern beim Einlesen einer GIF

Anmerkungen

Hinweis:

Ab Version 1.6 wurde die komplette GIF-Unterstützung aus der GD-Bibliothek entfernt und erst in Version 2.0.28 wieder hinzugefügt. Zwischen diesen Versionen ist diese Funktion daher nicht verfügbar.