(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)
imagegd2 — Envia uma imagem GD2 ao navegador ou a um arquivo
Envia uma imagem GD2 para o arquivo informado em file.
imageUm objeto GdImage, retornado por uma das funções de criação de imagem, como imagecreatetruecolor().
fileO caminho ou um recurso de stream 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 stream da imagem bruta será enviado diretamente.
chunk_sizeTamanho do pacote.
mode Pode ser IMG_GD2_RAW ou IMG_GD2_COMPRESSED. O padrão é IMG_GD2_RAW.
Retorna true em caso de sucesso ou false em caso de falha.
Entretanto, se a biblioteca libgd falhar ao gerar a imagem, esta função retornará true.
| 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 resourcegd válido era esperado. |
Exemplo #1 Mostrando uma imagem GD2
<?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
imagegd2($im);
// Libera memória
imagedestroy($im);
?>Exemplo #2 Saving a GD2 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 GD2
// O formato de arquivo para imagens GD2 é .gd2, consulte http://www.libgd.org/GdFileFormats
imagegd2($im, 'simple.gd2');
// Libera memória
imagedestroy($im);
?>Nota:
O formato GD2 é 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 GD2.
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.