Imagick::setOption

(PECL imagick 2, PECL imagick 3)

Imagick::setOption — Устанавливает опцию

Описание

public function Imagick::setOption(string $key, string $value): bool

Метод связывает опции с палочкой.

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

key
value

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

При успешном выполнении функция возвращает true.

Примеры

Пример #1 Пример попытки достичь размера '$extent' методом Imagick::setOption()

<?php

function renderJPG($extent)
{
    $imagePath = $this->control->getImagePath();

    $imagick = new \Imagick(realpath($imagePath));
    $imagick->setImageFormat('jpg');
    $imagick->setOption('jpeg:extent', $extent);

    header("Content-Type: image/jpg");
    echo $imagick->getImageBlob();
}

?>

Пример #2 Пример работы метода Imagick::setOption()

<?php

function renderPNG($imagePath, $format)
{
    $imagick = new \Imagick(realpath($imagePath));
    $imagick->setImageFormat('png');
    $imagick->setOption('png:format', $format);

    header("Content-Type: image/png");
    echo $imagick->getImageBlob();
}

// Сохраняем как 64-битное PNG-изображение
renderPNG($imagePath, 'png64');

?>

Пример #3 Пример работы метода Imagick::setOption()

<?php

function renderCustomBitDepthPNG()
{
    $imagePath = $this->control->getImagePath();

    $imagick = new \Imagick(realpath($imagePath));
    $imagick->setImageFormat('png');
    $imagick->setOption('png:bit-depth', '16');
    $imagick->setOption('png:color-type', 6);

    header("Content-Type: image/png");

    $crash = true;

    if ($crash) {
        echo $imagick->getImageBlob();
    } else {
        $tempFilename = tempnam('./', 'imagick');
        $imagick->writeimage(realpath($tempFilename));
        echo file_get_contents($tempFilename);
    }
}

?>

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

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

down

kicha at kreker dot org ¶

10 years ago

List of options (with key => value) on official imagemagick site:
http://www.imagemagick.org/script/command-line-options.php#define

down

alexandre at gaigalas dot net ¶

15 years ago

If you want to extract a preview from a PDF file using the CropBox instead of the whole document, setOption() is the right method:

<?php
$handler = new Imagick();
$handler->setOption('pdf:use-cropbox', 'true');
$handler->readImage($imageFileName);
$handler->thumbnailImage(200, 200, true);
$handler->setImageFormat('jpeg');
$handler->writeImage($destThumbFileName);
?>

It is the equivalent to the -define pdf:use-cropbox=true for the convert command line tool. pdf:use-trimbox is also available.

Note that on my environment the setOption only worked when i called it before the readImage method, which means that you can't pass the filename to the Imagick constructor directly.

down

SkepticaLee ¶

6 years ago

Actually setImageArtifact () can be used if setOption () fails, e.g.

$im->setImageartifact ("distort:viewport", "960x540+0-151");

Or maybe setOption () is deprecated.

down

dodginess at yahoo dot com ¶

2 years ago

It does not appear to be possible to disable anti-aliasing using the setOption() method as might be expected, and calling the setOption() method like this does not do anything:

$imagick->setOption('antialias', FALSE);

As discussed at https://github.com/Imagick/imagick/issues/83 the correct way to do this appears to be to use the setAntiAlias() method, which is not currently documented in the PHP manual. As an example, to disable anti-aliasing for an image you can do this:

$imagick->setAntiAlias(FALSE);

＋Добавить