Documentación offline PHP master

imagegd

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

imagegd

Genera una imagen en formato GD, hacia el navegador o un fichero

Descripción#

imagegd(GdImage $image, [string $file]): bool
```php

Genera o guarda el fichero `file` en formato GD.

## Parámetros

`image`  
Un objeto `GdImage`, retornado por una de las funciones de creación de imágenes, como `imagecreatetruecolor`.

`file`  
La ruta o un recurso de flujo abierto (que se cierra automáticamente después de que esta función retorne) donde guardar el fichero. Si no se define o es `null`, el flujo de imagen sin procesar se enviará directamente.

## Valores devueltos

Esta función retorna `true` en caso de éxito o `false` si ocurre un error.

> [!CAUTION]
> Sin embargo, si libgd no logra producir la imagen, esta función devuelve `true`.

## Historial de cambios

| 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 recurso `gd` de tipo `resource` válido. |
| 7.2.0 | `imagegd` ahora permite producir imágenes TrueColor. Anteriormente, eran convertidas implícitamente a paleta. |

## Ejemplos

Mostrar una imagen GD
Guardar una imagen GD

```php

Notas#

[!NOTE] 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.

[!WARNING] 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.

Véase también#

imagegd2