imagecolorat
(PHP 4, PHP 5, PHP 7, PHP 8)
imagecolorat — Отримання індексу кольору пікселя
Опис
imagecolorat(GdImage $image, int $x, int $y): int|false
Повертає індекс кольору пікселя на заданих координатах на зображенні image
Якщо передається truecolor-зображення, функція повертає ціле число RGB значення для пікселя. Для виділення окремих компонентів червоного, зеленого або синього каналів використовуйте бітовий зсув та маскування:
Список параметрів
image
Об'єкт GdImage, що повертається однією з функцій створення зображень, наприклад, такий як imagecreatetruecolor()
x
x-координата пікселя.
y
y-координата пікселя.
Значення, що повертаються
Повертає індекс кольору або **false**в случае возникновения ошибки.
Увага
Ця функція може повертати як логічне значення **false**так і значення не типу boolean, яке наводиться до false. За більш детальною інформацією зверніться до розділу Логічний типИспользуйтеоператор === для перевірки значення, яке повертається цією функцією.
список змін
| Версия | Опис |
|---|---|
| 8.0.0 | image тепер чекає екземпляр GdImage; раніше очікувався коректний gd ресурс (Resource). |
Приклади
Приклад #1 Доступ до компонентів RGB кольору
Висновок наведеного прикладу буде схожим на:
int(119)
int(123)
int(180)
Приклад #2 Додані RGB значення з використанням imagecolorsforindex()
Висновок наведеного прикладу буде схожим на:
array(4) {
["red"]=>
int(119)
["green"]=>
int(123)
["blue"]=>
int(180)
["alpha"]=>
int(127)
}
Дивіться також
- imagecolorset() - Встановлення набору кольорів для заданого індексу палітри
- imagecolorsforindex() - Отримання кольорів, що відповідають індексу
- imagesetpixel() - Малювання точки