(PHP 5 >= 5.5.0, PHP 7, PHP 8)
imagescale — Масштабировать изображение по заданной ширине и высоте
$image,$width,$height = -1,$mode = IMG_BILINEAR_FIXEDimagescale() масштабирует изображение, используя заданный алгоритм интерполяции.
Замечание:
В отличие от многих функций по работе с изображениями, imagescale() не изменяет переданный параметр
image; вместо него будет возвращено новое изображение.
imageОбъект GdImage, который возвращает одна из функций, создающих изображения, например, imagecreatetruecolor().
widthШирина для масштабирования.
heightВысота для масштабирования изображения. Если этот параметр опущен или отрицателен, соотношение сторон будет сохранено.
mode
Одна из констант IMG_NEAREST_NEIGHBOUR,
IMG_BILINEAR_FIXED,
IMG_BICUBIC,
IMG_BICUBIC_FIXED или что-либо ещё (будет использовано
два прохода).
Замечание:
IMG_WEIGHTED4пока ещё не поддерживается.
Возвращает объект масштабированного изображения в случае успешного выполнения или false, если возникла ошибка.
Функция выбрасывает ошибку ValueError,
если значение параметра width или height
приведёт к переполнению или недополнению.
Функция выбрасывает ошибку ValueError,
если значение параметра mode некорректно.
| Версия | Описание |
|---|---|
| 8.4.0 |
Функция теперь выбрасывает ошибку ValueError,
если значение параметра width или height
приведёт к переполнению или недополнению.
|
| 8.4.0 |
Функция теперь выбрасывает ошибку ValueError,
если значение параметра mode некорректно.
|
| 8.0.0 | В случае успешного выполнения функция теперь возвращает экземпляр GDImage; ранее возвращался ресурс (resource). |
| 8.0.0 |
Параметр image теперь ожидает экземпляр класса GdImage;
раньше параметр ждал корректный gd-ресурс (resource).
|