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
Envia uma imagem GD para o arquivo informado em file.
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 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.
Valor Retornado
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.
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);
// 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);
?>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.
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
add a note
