imageresolution

(PHP 7 >= 7.2.0, PHP 8)

imageresolutionRecupera o define la resolución de la imagen

Descripción

imageresolution(GdImage $image, ?int $resolution_x = null, ?int $resolution_y = null): array|bool

imageresolution() permite definir y recuperar la resolución de una imagen en DPI (puntos por pulgada). Si los parámetros opcionales son null, la resolución actual se devuelve en un array indexado. Si únicamente resolution_x no es null, la resolución horizontal y vertical se establece a este valor. Si ninguno de los parámetros opcionales es null, la resolución horizontal y vertical se establecen a estos valores respectivamente.

La resolución se utiliza únicamente como metadatos cuando las imágenes se leen y escriben en formatos que soportan este tipo de información (actualmente PNG y JPEG). Esto no afecta a las operaciones de dibujo. La resolución por defecto de las nuevas imágenes es de 96 DPI.

Parámetros

image

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

resolution_x

La resolución horizontal en DPI/PPP.

resolution_y

La resolución vertical en DPI/PPP.

Valores devueltos

Cuando se utiliza como recuperador, esto devuelve un array indexado con las resoluciones horizontal y vertical en caso de éxito, o false en caso de error. Cuando se utiliza como definidor, esto devuelve true en caso de éxito, o false en caso de error.

Historial de cambios

Versión Descripción
8.0.0 resolution_x y resolution_y son ahora nullable.

Ejemplos

Ejemplo #1 Definir y recuperar la resolución de una imagen

<?php
$im
= imagecreatetruecolor(100, 100);
imageresolution($im, 200);
print_r(imageresolution($im));
imageresolution($im, 300, 72);
print_r(imageresolution($im));
?>

El resultado del ejemplo sería:

Array
(
    [0] => 200
    [1] => 200
)
Array
(
    [0] => 300
    [1] => 72
)
add a note

User Contributed Notes 1 note

up
1
fernando dot fonseca at afteryou dot pt
4 years ago
It should be clear that the set version of the function doesn't change the image it self, just the resource in memory, which probably is fine if you didn't save the image yet. If your use case is for an image that is already on disk, image you should always do something like:

imageresolution($img, 300, 300);
imagepng($img, $filname, $quality);
To Top