Envia uma imagem GD para o navegador ou para um arquivo

# imagegd

(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)

imagegd — Envia uma imagem GD para o navegador ou para um arquivo

### Descrição

function imagegd(GdImage `$image`, ?string `$file` = `null`): bool

Exibe ou salva a imagem informada em `image` no formato GD.

### 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.3 | `file` agora pode ser nulo.
8.0.0 | O parâmetro `image` agora espera uma instância de GdImage; anteriormente, um resource `gd` válido era esperado.
7.2.0 | imagegd() agora permite gerar imagens em cores verdadeiras. Anteriormente, elas eram convertidas implicitamente para paleta.

### Exemplos

Exemplo #1 Mostrando uma imagem GD

    <?php
    // Cria uma imagem vazia e adiciona algum texto
    $im = imagecreatetruecolor(120, 20);
    $text_color = imagecolorallocate($im, 233, 14, 91);
    imagestring($im, 1, 5, 5,  "A Simple Text String", $text_color);

    // Mostra a imagem
    imagegd($im);
    ?>

Exemplo #2 Saving a GD image

    <?php
    // Cria uma imagem vazia e adiciona algum texto
    $im = imagecreatetruecolor(120, 20);
    $text_color = imagecolorallocate($im, 233, 14, 91);
    imagestring($im, 1, 5, 5,  "A Simple Text String", $text_color);

    // Grava a imagem GD
    // O formato de arquivo para imagens GD é .gd, consulte http://www.libgd.org/GdFileFormats
    imagegd($im, 'simple.gd');
    ?>

### Notas

> Nota:

> O formato GD é usado normalmente para permitir carregamento rápido de partes de imagens. Observe que o formato GD é utilizável somente em aplicações compatíveis com GD.

Aviso

Os formatos de imagem GD e GD2 são formatos de imagem proprietários da biblioteca libgd. Eles devem ser considerados obsoletos e só devem ser usados para propósitos de desenvolvimento e testes.

### Veja Também

- imagegd2() - Envia uma imagem GD2 ao navegador ou a um arquivo

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