imagejpeg

(PHP 4, PHP 5, PHP 7)

imagejpegExportar la imagen al navegador o a un fichero

Descripción

imagejpeg ( resource $image [, mixed $to [, int $quality ]] ) : bool

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().

to

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.

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(12020);
$color_texto imagecolorallocate($im2331491);
imagestring($im155,  '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:

Salida del ejemplo : Imprimir una imagen JPEG

Ejemplo #2 Guardar una imagen JPEG

<?php
// Crear una imagen en blanco y añadir algún texto
$im imagecreatetruecolor(12020);
$color_texto imagecolorallocate($im2331491);
imagestring($im155,  '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(12020);
$color_texto imagecolorallocate($im2331491);
imagestring($im155,  '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 'to' usando NULL, después establecer la calidad al 75%
imagejpeg($imNULL75);

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

Notas

Nota:

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

Historial de cambios

Versión Descripción
5.4.0 Se añadió soporte para pasar un resource de flujo a to.
5.4.0 Se deshabilitó el paso de un string vacío a filename para saltar este argumeto.

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