PHP Conference Nagoya 2025

ImagickPixel::getColor

(PECL imagick 2, PECL imagick 3)

ImagickPixel::getColorВозвращает цвет

Описание

public ImagickPixel::getColor(int $normalized = 0): array

Возвращает цвет в виде массива, описанный в объекте ImagickPixel. Если у цвета установлен канал прозрачности, то он будет отражён в четвёртом значении списка.

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

normalized

Нормализовать значение цвета. Возможные значения: 0, 1 или 2.

Список возможных значений для normalized
normalized Описание
0 Значения RGB возвращаются как целые числа (int) в диапазоне от 0 до 255 (включительно). Альфа-значение возвращается как целое число (int) и равно либо 0, либо 1.
1 Значения RGBA возвращаются как числа с плавающей точкой (float) в диапазоне от 0 до 1 (включительно).
2 Значения RGBA возвращаются как целые числа (int) в диапазоне от 0 до 255 (включительно).

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

Массив значений канала. Выбрасывает исключение ImagickPixelException в случае возникновения ошибки.

Примеры

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

<?php

// Создание ImagickPixel со стандартным цветом 'brown'
$color = new ImagickPixel('brown');

// настройка цвета с альфа каналом 25%
$color->setColorValue(Imagick::COLOR_ALPHA, 64 / 256.0);

$colorInfo = $color->getColor();

echo
"Стандартные значения" . PHP_EOL;
print_r($colorInfo);

$colorInfo = $color->getColor(1);

echo
"Нормализованные значения:" . PHP_EOL;
print_r($colorInfo);

?>

Результат выполнения приведённого примера:

Стандартные значения
Array
(
    [r] => 165
    [g] => 42
    [b] => 42
    [a] => 0
)
Нормализованные значения:
Array
(
    [r] => 0.64705882352941
    [g] => 0.16470588235294
    [b] => 0.16470588235294
    [a] => 0.25000381475547
)

Добавить

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

up
3
roman
11 years ago
In case you use default un-normalized getColor value the alpha value will always be either 0 or 1.

If you want to use real full-range 0-1 alpha channel on your 24bit transparent images use the alpha value from the normalized one, even if you use the rest of unnormalized data.

To copy a 24bit png with real alpha transparency, you would have to do this:
<?php

$im
=new Imagick( 'image.png' );
$iterator=$im->getPixelIterator();
foreach (
$iterator as $row=>$pixels) {
foreach (
$pixels as $column => $pixel ){
$un_color=$pixel->getColor(); //unnormalized color
$nor_color=$pixel->getColor(true); //normalized color
$pixel->setColor('rgba('.$un_color['r'].','.$un_color['g'].','.$un_color['b'].','.$nor_color['a'].')');
}
}
?>

If you use 'a' (alpha) value from the unnormalized color there will only be binary transparency.
To Top