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

# imagescale

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

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

### Описание

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open