Imagick::thumbnailImage

(PECL imagick 2, PECL imagick 3)

Imagick::thumbnailImage — Изменяет размер изображения

Описание

public Imagick::thumbnailImage(
    int $columns,
    int $rows,
    bool $bestfit = false,
    bool $fill = false,
    bool $legacy = false
): bool

Изменяет размер изображения до заданных размеров и удаляет все связанные профили. Цель состоит в том, чтобы создавать миниатюры изображений, подходящие для отображения в Интернете. Если в качестве третьего параметра установлено значение true, тогда параметры столбцов и строк используются как максимальные для каждой стороны. Обе стороны будут уменьшены до тех пор, пока они не станут равными или меньше, чем параметр, указанный для стороны.

Замечание: Поведение параметра bestfit было изменено в Imagick 3.0.0. До этой версии при изменении изображения размером 200x150 до 400x300 никаких операций не происходило. В Imagick 3.0.0 и далее изображение будет масштабировано до размеров 400x300, так как это наилучшим образом соответствует ("best fit") данным размерам. Если используется параметр bestfit, то ширина и высота также должны быть определены.

Список параметров

columns: Ширина изображения.
rows: Высота изображения.
bestfit: Определяет, следует ли принудительно устанавливать максимальные значения.

Возвращаемые значения

В случае успешной работы возвращает true.

Ошибки

Вызывает ImagickException в случае возникновения ошибки.

Примеры

Пример #1 Пример использования Imagick::thumbnailImage()

<?php
function thumbnailImage($imagePath) {
    $imagick = new \Imagick(realpath($imagePath));
    $imagick->setbackgroundcolor('rgb(64, 64, 64)');
    $imagick->thumbnailImage(100, 100, true, true);
    header("Content-Type: image/jpg");
    echo $imagick->getImageBlob();
}

?>