imagejpeg

(PHP 4, PHP 5)

imagejpeg — Exportar la imagen al navegador o a un fichero

Descripción

bool imagejpeg ( resource $image [, string $filename [, int $quality ]] )

imagejpeg() crea un archivo JPEG desde image.

Parámetros

image

Un recurso image, es devuelto por una de las funciones de creación de imágenes, como imagecreatetruecolor().

filename

Ruta en la que guardar el fichero. Si no se establece, o su valor es NULL, se mostrará directamente en la salida el flujo de imagen.

Para saltarse este argumeto para proporcionar el parámetro quality, use NULL.

quality

quality es opcional, y su valor es desde 0 (peor calidad, archivo más pequeño) a 100 (mejor calidad, archivo más grande). El valor por defecto es el valor de calidad predeterminada de IJG (sobre 75).

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error.

Ejemplos

Ejemplo #1 Imprimir una imagen JPEG


<?php
// Crear una imagen en blanco y añadir algún texto
$im = imagecreatetruecolor(120, 20);
$color_texto = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5,  'A Simple Text String', $color_texto);

// Establecer la cabecera de tipo de contenido - en este caso image/jpeg
header('Content-Type: image/jpeg');

// Imprimir la imagen
imagejpeg($im);

// Liberar memoria
imagedestroy($im);
?>

El resultado del ejemplo sería algo similar a:

Ejemplo #2 Guardar una imagen JPEG


<?php
// Crear una imagen en blanco y añadir algún texto
$im = imagecreatetruecolor(120, 20);
$color_texto = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5,  'Una Sencilla Cadena De Texto', $color_texto);

// Guardar la imagen como 'textosimple.jpg'
imagejpeg($im, 'textosimple.jpg');

// Liberar memoria
imagedestroy($im);
?>

Ejemplo #3 Imprimir la imagen al 75% de calidad


<?php
// Crear una imagen en blanco y añadir algún texto
$im = imagecreatetruecolor(120, 20);
$color_texto = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5,  'Una Sencilla Cadena De Texto', $color_texto);

// Establecer la cabecera de tipo de contenido - en este caso image/jpeg
header('Content-Type: image/jpeg');

// Saltarse el parámetro filename usando NULL, después establecer la calidad al 75%
imagejpeg($im, NULL, 75);

// Liberar memoria
imagedestroy($im);
?>

Notas

Nota: El soporte de JPEG sólo está disponible si PHP fue compilado con GD-1.8 o superior.

Nota:
Si quiere imprimir imágenes JPEG Progresivas, necesita habilitar el entrelazamiento con imageinterlace().

Ver también

imagepng() - Imprimir una imagen PNG al navegador o a un archivo
imagegif() - Exportar la imagen al navegador o a un fichero
imagewbmp() - Exportar la imagen al navegador o a un fichero
imageinterlace() - Habilitar o deshabilitar en entrelazamiento
imagetypes() - Devolver los tipos de imagen soportados por la versión actual de PHP