imagecreatefromgif

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

imagecreatefromgif — Cria uma nova imagem a partir de um arquivo ou URL

Descrição

imagecreatefromgif(string $filename): GdImage|false

imagecreatefromgif() retorna um identificador de imagem representando a imagem obtida a partir do arquivo informado.

Caution

Ao carregar arquivos GIF na memória, apenas o primeiro quadro é retornado ao objeto da imagem. O tamanho da imagem não é necessariamente o reportado por getimagesize().

Tip

Uma URL pode ser usada como um nome de arquivo com esta função se os wrappers fopen estiverem habilitados. Consulte a função fopen() para mais detalhes sobre como especificar o nome do arquivo. Consulte os Protocolos e empacotadores suportados para obter links para informações sobre as capacidades de cada wrapper, notas de uso e informações sobre quaisquer variáveis predefinidas que eles possam fornecer.

Parâmetros

filename

Caminho para a imagem GIF.

Valor Retornado

Retorna um objeto de imagem em caso de sucesso, false em caso de erros.

Registro de Alterações

Versão Descrição
8.0.0 Em caso de sucesso, esta função agora retorna um objeto GDImage; anteriormente, um resource era retornado.

Exemplos

Example #1 Exemplo de gerenciamento de erro durante carregamento de um GIF

<?php
function LoadGif($imgname)
{
    /* Tenta abrir */
    $im = @imagecreatefromgif($imgname);

    /* Ver se falhou */
    if(!$im)
    {
        /* Cria uma imagem vazia */
        $im = imagecreatetruecolor (150, 30);
        $bgc = imagecolorallocate ($im, 255, 255, 255);
        $tc = imagecolorallocate ($im, 0, 0, 0);

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

        /* Mostra uma mensagem de erro */
        imagestring ($im, 1, 5, 5, 'Error loading ' . $imgname, $tc);
    }

    return $im;
}

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

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

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

O exemplo acima produzirá algo semelhante a:

Saída do exemplo: Exemplo de gerenciamento de erro durante carregamento de um GIF