Imagick::setOption

(PECL imagick 2.0.0)

Imagick::setOption — Set an option

Описание

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

Associates one or more options with the wand.

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

key
value

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

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

Примеры

Пример #1 Attempt to reach '$extent' sizeImagick::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();
    }
    
    //Save as 64bit 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);
        }
    }

?>

Коментарии

Jul 11

Автор: alexandre at gaigalas dot net


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.

2011-07-11 17:43:37

http://php5.kiev.ua/manual/ru/imagick.setoption.html

Sep 24

Автор: kicha at kreker dot org


List of options (with key => value) on official imagemagick site:

http://www.imagemagick.org/script/command-line-options.php#define

2015-09-24 17:48:49

http://php5.kiev.ua/manual/ru/imagick.setoption.html

Mar 29

Автор: SkepticaLee


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



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



Or maybe setOption () is deprecated.

2020-03-29 22:17:02

http://php5.kiev.ua/manual/ru/imagick.setoption.html

Apr 15

Автор: dodginess at yahoo dot com


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);

2024-04-15 17:50:14

http://php5.kiev.ua/manual/ru/imagick.setoption.html

Imagick::setLastIterator

Imagick::setPage

Imagick

PHP Manual