imagejpeg

    (PHP 4, PHP 5, PHP 7, PHP 8)

    imagejpeg — Exportar 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(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:

    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(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 'to' usando NULL, después establecer la calidad al 75%
    imagejpeg($im, NULL, 75);

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

    Notas

    Nota:

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

    Historial de cambios

    VersiónDescripció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
    To Top