(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)
imagegd2 — Genera una imagen en formato GD2, hacia el navegador o un fichero
$image,$file = null,$chunk_size = 128,$mode = IMG_GD2_RAW
Genera o guarda el fichero file en formato GD2.
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.
chunk_sizeTamaño del fragmento.
mode
Puede ser IMG_GD2_RAW o
IMG_GD2_COMPRESSED. Por omisión, vale
IMG_GD2_RAW.
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 nulo.
|
| 8.0.0 |
image ahora espera una instancia de GdImage;
anteriormente, se esperaba un resource gd válido.
|
Ejemplo #1 Mostrar una imagen GD2
<?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
imagegd2($im);
?>
Ejemplo #2 Guardar una imagen GD2
<?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 GD2
// El formato de fichero para imágenes GD2 es .gd2, ver http://www.libgd.org/GdFileFormats
imagegd2($im, 'simple.gd2');
?>Nota:
El formato GD2 se utiliza comúnmente para cargar rápidamente las partes de una imagen. Tenga en cuenta que el formato GD2 solo es utilizable en aplicaciones compatibles con GD2.
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.