PHP Conference Japan 2024

imagescale

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

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

Описание

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() - Копирование и изменение размера изображения с ресемплированием
Добавить

Примечания пользователей 1 note

up
6
Anonymous
1 year ago
Seemingly, you can't omit the width the same way you do with the height. If you write -1 for the width and specify a number for the height it will return false
To Top