Масштабировать изображение по заданной ширине и высоте

Описание

function imagescale(
    GdImage $image,
    int $width,
    int $height = -1,
    int $mode = IMG_BILINEAR_FIXED
): GdImage|false

imagescale() масштабирует изображение, используя заданный алгоритм интерполяции.

Замечание:
В отличие от многих функций по работе с изображениями, 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).

Смотрите также

imagecopyresized() - Копирует и изменяет размер части изображения
imagecopyresampled() - Копирует и изменяет размер части изображения с ресемплированием