imagecreatefromgif

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

imagecreatefromgif — Создаёт новое изображение из файла или URL

Описание

imagecreatefromgif(string $filename): GdImage|false

imagecreatefromgif() возвращает объект изображения, представляющего изображение полученное из файла с заданным именем.

Предостережение

При чтении анимированных файлов GIF в память, возвращается указатель на ресурс изображения только для первого фрейма. Размер изображения не обязательно будет соответствует тому, что вернёт функция getimagesize().

Подсказка

Для этой функции вы можете использовать URL в качестве имени файла, если была включена опция fopen wrappers. Смотрите более подробную информацию об определении имени файла в описании функции fopen(). Смотрите также список поддерживаемых обёрток URL, их возможности, замечания по использованию и список предопределённых констант в разделе Поддерживаемые протоколы и обёртки.

Список параметров

filename: Путь к GIF картинке.

Возвращаемые значения

Возвращает объект изображения в случае успешного выполнения или false в случае возникновения ошибки.

Список изменений

Версия	Описание
8.0.0	В случае успешного выполнения функция теперь возвращает экземпляр GDImage; ранее возвращался ресурс (resource).

Примеры

Пример #1 Пример обработки ошибки при загрузке GIF

<?php
function LoadGif($imgname)
{
    /* Пытаемся открыть */
    $im = @imagecreatefromgif($imgname);

    /* Если не удалось */
    if(!$im)
    {
        /* Создаём пустое изображение */
        $im = imagecreatetruecolor (150, 30);
        $bgc = imagecolorallocate ($im, 255, 255, 255);
        $tc = imagecolorallocate ($im, 0, 0, 0);

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

        /* Выводим сообщение об ошибке */
        imagestring ($im, 1, 5, 5, 'Ошибка загрузки ' . $imgname, $tc);
    }

    return $im;
}

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

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

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

Результатом выполнения данного примера будет что-то подобное: