imageresolution
(PHP 7 >= 7.2.0, PHP 8)
imageresolution — Получить или установить разрешение изображения
Описание
$image, int|null $resolution_x = null, int|null $resolution_y = null): array|bool
imageresolution() позволяет установить и получить разрешение
изображения в DPI (точек на дюйм). Если необязательные параметры указаны как null,
то будет возращено текущее разрешение в виде индексированного массива.
Если только resolution_x не является null,
для горизонтального и вертикального разрешения будет установлено это значение.
Если все необязательные параметры не являются null, для горизонтального и вертикального
разрешения устанавливаются эти значения соответственно.
Разрешение используется только как метаданные во время чтения или записи изображений в форматы, которые поддерживают этот вид данных (на данный момент это PNG и JPEG). Это никак не влияет на любые операции рисования. Разрешение по умолчанию для новых изображений — 96 DPI.
Список параметров
-
image -
Объект GdImage, возвращаемый одной из функций создания изображений, например, такой как imagecreatetruecolor().
-
resolution_x -
Горизонтальное разрешение в DPI.
-
resolution_y -
Вертикальное разрешение в DPI.
Возвращаемые значения
Когда используется для получения информации о разрешении изображения,
в случае успешного выполнения возвращается индексированный массив с информацией о
горизонтальном и вертикальном разрешении, или false в случае возникновения ошибки.
Когда используется для установки разрешения изображения, в случае
успешного выполнения возвращается true, или false в случае возникновения ошибки.
Список изменений
| Версия | Описание |
|---|---|
| 8.0.0 |
resolution_x и resolution_y теперь допускают значение null.
|
Примеры
Пример #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
)
add a note
