Imagick::thumbnailImage

(PECL imagick 2, PECL imagick 3)

Imagick::thumbnailImage — Changes the size of an image

Опис

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

Changes the size of an image to the given dimensions and removes any associated profiles. The goal is to produce small, low cost thumbnail images suited for display on the Web. If true is given as a third parameter then columns and rows parameters are used as maximums for each side. Both sides will be scaled down until they match or are smaller than the parameter given for the side.

Зауваження: Поведінка параметра bestfit змінилася в Imagick 3.0.0. Раніше він не діяв на зображення розмірів 400x400 та 200x150. Починаючи з Imagick 3.0.0, такі зображення отримають розмір 400x300, оскільки це "найкраще підходить" для заданих розмірів. Якщо параметр bestfit використовується, необхідно вказати як висоту, так і ширину.

Параметри

columns: Image width
rows: Image height
bestfit: Whether to force maximum values
fill: If the image does not fill the box completely then the box is filled with image's background color.
legacy: Round the smaller dimension down instead to the closest integer.

Значення, що повертаються

Повертає 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();
}

?>