(PHP 4, PHP 5, PHP 7, PHP 8)
imagecolorat — Получение индекса цвета пиксела
Возвращает индекс цвета пиксела на заданных координатах на изображении image
.
Если передаётся truecolor-изображение, функция возвращает целочисленное RGB значение для пиксела. Для выделения отдельных компонентов красного, зелёного или синего каналов используйте битовый сдвиг и маскирование:
image
Объект GdImage, который возвращает одна из функций, создающих изображения, например, imagecreatetruecolor().
x
x-координата пиксела.
y
y-координата пиксела.
Возвращает индекс цвета или false
, если возникла ошибка.
Функция возвращает как логическое значение false
, так и нелогическое значение, которое приводится к false
. Прочитайте раздел «Логический тип», чтобы получить дополнительную информацию. Используйте оператор === для проверки значения, которое возвращает функция.
Версия | Описание |
---|---|
8.0.0 | Параметр image теперь ожидает экземпляр класса GdImage; раньше параметр ждал корректный gd -ресурс (resource). |
Пример #1 Доступ к компонентам RGB цвета
<?php
$im = imagecreatefrompng("php.png");
$rgb = imagecolorat($im, 10, 15);
$r = ($rgb >> 16) & 0xFF;
$g = ($rgb >> 8) & 0xFF;
$b = $rgb & 0xFF;
var_dump($r, $g, $b);
?>
Вывод приведённого примера будет похож на:
int(119) int(123) int(180)
Пример #2 Удобочитаемые RGB значения с использованием imagecolorsforindex()
<?php
$im = imagecreatefrompng("php.png");
$rgb = imagecolorat($im, 10, 15);
$colors = imagecolorsforindex($im, $rgb);
var_dump($colors);
?>
Вывод приведённого примера будет похож на:
array(4) { ["red"]=> int(119) ["green"]=> int(123) ["blue"]=> int(180) ["alpha"]=> int(127) }