Dutch PHP Conference 2023 - Call for Papers


(PECL imagick 2, PECL imagick 3)

Imagick::paintTransparentImageИзменяет любой пиксель, соответствующий цвету, на цвет, определённый заливкой


Функция объявлена УСТАРЕВШЕЙ в Imagick 3.4.4. Полагаться на эту функцию крайне не рекомендуется.


public Imagick::paintTransparentImage(mixed $target, float $alpha, float $fuzz): bool

Изменяет любой пиксель, соответствующий цвету, на цвет, определённый заливкой.

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


Целевой цвет, заменяемый на указанное значение непрозрачности в изображении.


Уровень прозрачности: 1.0 - полностью непрозрачный, 0.0 - полностью прозрачный.


Определяет, насколько допустимо считать два цвета одинаковыми.

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

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


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

Список изменений

Версия Описание
PECL imagick 2.1.0 Теперь разрешает использовать строку, представляющую цвет, в качестве первого параметра. Предыдущие версии допускали только объект ImagickPixel.

add a note

User Contributed Notes 3 notes

14 years ago
Actually it does seem to work just not the way expected perhaps.

Looking at the fuzz option on ImageMagick's site (http://www.imagemagick.org/script/command-line-options.php#fuzz), "The distance can be in absolute intensity units or, by appending % as a percentage of the maximum possible intensity (255, 65535, or 4294967295)."

As it requires a float, the percentage value won't work so it actually one of the max intensity values.  In my case, the images I was working with seemed to have max intensity values of 65535.  So a fuzz of 6500, for roughly 10%, seemed to do the trick.

The part that might be problematic though is how do you determine the max intensity of a color/image?  Using a static 6500 would be fine until I would have to convert an image with a max intensity other than 65535.  If it's 255 it would wipe the entire image.  Or fall far short on the fuzz with the larger value.
quickshiftin at gmail dot com
8 years ago
Have a look at this thread on Stackoverflow for the answer regarding how to determine the max intensity of an image.


In short here is the code to make the $fuzz parameter behave more like you would expect (it now represents a percentage between 0-100). The $fuzz value should now be a float between 0 and 1.

class SaneImagick extends Imagick
    public function paintTransparentImage($target, $alpha, $fuzz)
        $iQuantumDepth = pow(2, $this->getQuantumDepth()['quantumDepthLong']);
        return parent::paintTransparentImage($target, $alpha, $fuzz * $iQuantumDepth);
alain at ocarina dot fr
11 years ago
The fuzz is just working well in a range of 0 to 65535.

I suggest you to try to move fuzz on a color spectrum image.

1/ Get a color spectrum ( Google Image has a lot )

2/ Try this code :


function fuzzTest($source, $target, $fuzz) {

// Loads image
$im = new Imagick($source);

// Resizes images to make them easily comparable
$im->resizeImage(320, 240, Imagick::FILTER_LANCZOS, 1, true);
// Apply fuzz
$im->paintTransparentImage($im->getImagePixelColor(0, 0), 0, $fuzz);
// Writes image

     for (
$i = 0; ($i <= 10); $i++) {
fuzzTest('spectrum.png', "test_{$i}.png", (6553.5 * $i));
'<img src="test_' . $i . '.png" />&nbsp;';

To Top