(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)
imagegd — Genera una imagen en formato GD, hacia el navegador o un fichero
Genera o guarda el fichero file en formato GD.
imageUn objeto GdImage, retornado por una de las funciones de creación de imágenes, como imagecreatetruecolor().
fileLa ruta o un recurso de flujo abierto (que se cierra automáticamente después de que esta función retorne) donde guardar el archivo. Si no se define o es null, el flujo de imagen sin procesar se enviará directamente.
Esta función retorna true en caso de éxito o false si ocurre un error.
Sin embargo, si libgd no logra producir la imagen, esta función devuelve true.
| Versión | Descripción |
|---|---|
| 8.0.3 |
file ahora es nullable.
|
| 8.0.0 |
image ahora espera una instancia de GdImage;
anteriormente, se esperaba un resource gd válido.
|
| 7.2.0 | imagegd() ahora permite producir imágenes TrueColor. Anteriormente, eran convertidas implícitamente a paleta. |
Ejemplo #1 Mostrar una imagen GD
<?php
// Creación de una imagen vacía y adición de texto
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, "Un texto simple", $text_color);
// Mostrar la imagen
imagegd($im);
?>
Ejemplo #2 Guardar una imagen GD
<?php
// Creación de una imagen vacía y adición de texto
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, "Un texto simple", $text_color);
// Guardar la imagen GD
// El formato de fichero para imágenes GD es .gd, ver http://www.libgd.org/GdFileFormats
imagegd($im, 'simple.gd');
?>Nota:
El formato GD se utiliza comúnmente para permitir la carga rápida de partes de una imagen. Tenga en cuenta que el formato GD solo es utilizable en aplicaciones compatibles con GD.
Los formatos de imagen GD y GD2 son formatos propietarios de libgd. Deben considerarse obsoletos, y solo deben utilizarse con fines de desarrollo y pruebas.