(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.
image
Un recurso image, es devuelto por una de las funciones de creación de imágenes, como imagecreatetruecolor().
file
La ruta o un recurso de flujo de apertura (el cual se cierra automáticamente después de que devuelva esta función) donde guardar el fichero. Si no se establece, o su valor es null
, se mostrará directamente en la salida el flujo de imagen sin tratar.
Devuelve true
en caso de éxito o false
en caso de error.
Sin embargo, si libgd falla al producir la imagen, esta función devuelve true
.
Versión | Descripción |
---|---|
8.0.3 |
file ahora es nullable.
|
8.0.0 |
image expects a GdImage
instance now; previously, a valid gd resource was expected.
|
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.
The GD and GD2 image formats are proprietary image formats of libgd. They have to be regarded obsolete, and should only be used for development and testing purposes.