imagecreatefromgif

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

imagecreatefromgif — Crée une nouvelle image depuis un fichier ou une URL

Description

imagecreatefromgif(string $filename): GdImage|false

imagecreatefromgif() retourne un identifiant d'image qui représente l'image obtenue à partir du fichier dont le nom est donné par filename.

Attention

Lors de la lecture en mémoire de fichiers GIF animés, seule la première frame est retournée par l'objet de l'image. La taille de l'image n'est pas forcément ce qui est rapporté par getimagesize().

Astuce

Vous pouvez utiliser une URL comme nom de fichier avec cette fonction, si le gestionnaire fopen a été activé. Voyez fopen() pour plus de détails sur la façon de spécifier le nom du fichier. Reportez-vous aux Liste des protocoles et des gestionnaires supportés pour plus d'informations sur les capacités des différents gestionnaires, les notes sur leur utilisation, ainsi que les informations sur les variables prédéfinies qu'elles fournissent.

Liste de paramètres

filename: Chemin vers l'image GIF.

Valeurs de retour

Retourne un objet d'image en cas de succès, ou false si une erreur survient.

Historique

Version	Description
8.0.0	En cas de succès, cette fonction retourne désormais une instance de GDImage ; auparavant, une resource était retournée.

Exemples

Exemple #1 Exemple de prise en charge d'une erreur lors du chargement d'une image GIF


<?php
function LoadGif($imgname)
{
    /* Tente d'ouvrir l'image */
    $im = @imagecreatefromgif($imgname);

    /* Traitement si l'ouverture a échoué */
    if(!$im)
    {
        /* Création d'une image vide */
        $im = imagecreatetruecolor (150, 30);
        $bgc = imagecolorallocate ($im, 255, 255, 255);
        $tc = imagecolorallocate ($im, 0, 0, 0);

        imagefilledrectangle ($im, 0, 0, 150, 30, $bgc);

        /* Affiche un message d'erreur dans l'image */
        imagestring ($im, 1, 5, 5, 'Error loading ' . $imgname, $tc);
    }

    return $im;
}

header('Content-Type: image/gif');

$img = LoadGif('bogus.image');

imagegif($img);
imagedestroy($img);
?>

Résultat de l'exemple ci-dessus est similaire à :