Envia a imagem para o navegador ou para um arquivo

# imagegif

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

imagegif — Envia a imagem para o navegador ou para um arquivo

### Descrição

function imagegif(GdImage `$image`, resource|string|null `$file` = `null`): bool

imagegif() cria o arquivo GIF especificado em `file` a partir da imagem em `image`. O argumento `image` é o retorno da função imagecreate() ou `imagecreatefrom*`.

O formato da imagem será GIF87a a menos que a imagem tenha se tornado transparente com imagecolortransparent(), e neste caso o formato da imagem será GIF89a.

### Parâmetros

`image`
  Um objeto GdImage, retornado por uma das funções de criação de imagem, como imagecreatetruecolor().
`file`

  O caminho ou um recurso de fluxo aberto (que será fechado automaticamente após o retorno desta função) para salvar o arquivo. Se não for definido ou for `null`, o fluxo da imagem bruta será enviado diretamente.

### Valor Retornado

Retorna `true` em caso de sucesso ou `false` em caso de falha.

Cuidado

Entretanto, se a biblioteca libgd falhar ao gerar a imagem, esta função retornará `true`.

### Registro de Alterações

Versão | Descrição
--- | ---
8.0.0 | O parâmetro `image` agora espera uma instância de GdImage; anteriormente, um resource `gd` válido era esperado.

### Exemplos

Exemplo #1 Mostrando uma imagem usando imagegif()

    <?php
    // Cria uma nova instância de imagem
    $im = imagecreatetruecolor(100, 100);

    // Deixa o fundo branco
    imagefilledrectangle($im, 0, 0, 99, 99, 0xFFFFFF);

    // Desenha uma string na imagem
    imagestring($im, 3, 40, 20, 'GD Library', 0xFFBA00);

    // Mostra a imagem no navegador
    header('Content-Type: image/gif');

    imagegif($im);
    ?>

Exemplo #2 Convertendo uma imagem PNG para GIF usando imagegif()

    <?php

    // Carrega o PNG
    $png = imagecreatefrompng('./php.png');

    // Grava a imagem como GIF
    imagegif($png, './php.gif');

    // Pronto
    echo 'Convertida a imagem PNG para GIF com sucesso!';
    ?>

### Notas

> Nota:

> O extrato de código a seguir permite esrever aplicações PHP mais portáveis através de auto-detecção do tipo de suporte GD disponível. Substitua sequência `header ("Content-Type: image/gif"); imagegif ($im);` pela sequência mais flexível:

>     <?php
>     // Cria uma nova instância de imagem
>     $im = imagecreatetruecolor(100, 100);

>     // Faz aqui algumas operações

>     // Lida com a saída
>     if(function_exists('imagegif'))
>     {
>         // Para GIF
>         header('Content-Type: image/gif');

>         imagegif($im);
>     }
>     elseif(function_exists('imagejpeg'))
>     {
>         // Para JPEG
>         header('Content-Type: image/jpeg');

>         imagejpeg($im, NULL, 100);
>     }
>     elseif(function_exists('imagepng'))
>     {
>         // Para PNG
>         header('Content-Type: image/png');

>         imagepng($im);
>     }
>     elseif(function_exists('imagewbmp'))
>     {
>         // Para WBMP
>         header('Content-Type: image/vnd.wap.wbmp');

>         imagewbmp($im);
>     }
>     else
>     {
>         die('Não existe suporte para imagem neste servidor PHP');
>     }
>     ?>

> Nota:

> Pode-se usar a função imagetypes() para verificar a presenção de vários formatos de imagem suportados:

>     <?php
>     if(imagetypes() & IMG_GIF)
>     {
>         header('Content-Type: image/gif');
>         imagegif($im);
>     }
>     elseif(imagetypes() & IMG_JPG)
>     {
>         /* ... etc. */
>     }
>     ?>

### Veja Também

- imagepng() - Envia uma imagem PNG para o navegador ou arquivo
- imagewbmp() - Envia a imagem para o navegador ou para um arquivo
- imagejpeg() - Envia a imagem para o navegador ou para um arquivo
- imagetypes() - Retorna os tipos de imagens suportados pela instalação do PHP

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open