imagejpeg

imagejpeg(GdImage $image, [resource $file], [int $quality]): bool
```php

`imagejpeg` crea un fichero JPEG a partir de la imagen proporcionada.

## 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.

`quality`  
`quality` es opcional, y toma valores en el intervalo 0 (peor calidad, fichero pequeño) a 100 (mejor calidad, fichero grande). Por omisión (`-1`), se utiliza el valor de calidad IJG por defecto (aproximadamente 75).

## 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`.

## Errores/Excepciones

Se genera una `ValueError` si `quality` es inválido.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.4.0 | Ahora se genera una `ValueError` si `quality` es inválido. |
| 8.0.0 | `image` ahora espera una instancia de `GdImage` ; anteriormente, se esperaba un recurso `gd` de tipo `resource` válido. |

## Ejemplos

Mostrar una imagen JPEG hacia el navegador

Resultado del ejemplo anterior es similar a:

![Visualización del ejemplo: imagejpeg()](en/reference/image/figures/imagejpeg.jpg)

Guardar una imagen JPEG en un fichero

Mostrar la imagen con una calidad del 75% hacia el navegador