CascadiaPHP 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, если возникла ошибка.

Список изменений

Версия Описание
8.0.0 В случае успешного выполнения функция теперь возвращает экземпляр GDImage; ранее возвращался ресурс (resource).
8.0.0 Параметр image теперь ожидает экземпляр класса GdImage; раньше параметр ждал корректный gd-ресурс (resource).

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

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

User Contributed Notes 1 note

up
3
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