imageresolution

(PHP 7 >= 7.2.0)

imageresolution — Получить или установить разрешение изображения

Описание

imageresolution ( resource $image ) : mixed

imageresolution ( resource $image , int $res_x , int $res_y = $res_x ) : mixed

imageresolution() позволяет установить или получить разрешение изображения в DPI (точки на дюйм). Если при вызове не указан ни один из необязательных параметров, то будет возращено текущее разрешение изображения в виде индексированного массива. Если указан только параметр res_x, то это значение будет присвоено горизонтальному и вертикальному разрешениям. Если указаны оба необязательных параметра, то эти значения будут присвоены горизонтальному и вертикальному разрешениям соответственно.

Разрешение используется только как метаданные во время чтения или записи изображений в форматы, которые поддерживают этот вид данных (на данный момент это PNG и JPEG). Это никак не влияет на любые операции рисования. Разрешение по умолчанию для новых изображений — 96 DPI.

Список параметров

image: Ресурс изображения, возвращаемый одной из функций создания изображений, например, такой как imagecreatetruecolor().
res_x: Горизонтальное разрешение в DPI.
res_y: Вертикальное разрешение в DPI.

Возвращаемые значения

Когда используется для получения информации о разрешении изображения, в случае успешного выполнения возращается индексированный массив с информацией о горизонтальном и вертикальном разрешении, или false в случае возникновения ошибки. Когда используется для установки разрешения изображения, в случае успешного выполнения возвращается true, или false в случае возникновения ошибки.

Примеры

Пример #1 Установка и получение разрешения изображения


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

Результат выполнения данного примера:

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