Documentación offline PHP master

imageresolution

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

imageresolution

Recupera o define la resolución de la imagen

Descripción#

imageresolution(GdImage $image, [int $resolution_x], [int $resolution_y]): array
```php

`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 objeto `GdImage`, retornado 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. Cuando se utiliza como definidor, siempre devuelve `true`.

## Historial de cambios

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

## Ejemplos

Definir y recuperar la resolución de una imagen

```php

El ejemplo anterior mostrará:

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