(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)
imagegd — Envia uma imagem GD para o navegador ou para um arquivo
Envia uma imagem GD 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.
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 resource gd válido era esperado.
|
| 7.2.0 | imagegd() agora permite gerar imagens em cores verdadeiras. Anteriormente, elas eram convertidas implicitamente para paleta. |
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);
// Libera memória
imagedestroy($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');
// Libera memória
imagedestroy($im);
?>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.
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.