(PHP 4, PHP 5, PHP 7, PHP 8)
imagecolorat — Получение индекса цвета пиксела
Возвращает индекс цвета пиксела на заданных координатах на изображении
image.
Если передаётся truecolor-изображение, функция возвращает целочисленное RGB значение для пиксела. Для выделения отдельных компонентов красного, зелёного или синего каналов используйте битовый сдвиг и маскирование:
imageОбъект GdImage, который возвращает одна из функций, создающих изображения, например, imagecreatetruecolor().
xx-координата пиксела.
yy-координата пиксела.
Возвращает индекс цвета или 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)
}