imagecolorallocatealpha
(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)
imagecolorallocatealpha — Створення кольору для зображення
Опис
imagecolorallocatealpha( GdImage $image, int $red, int $green, int $blue, int $alpha): int|false
imagecolorallocatealpha() працює аналогічно до функцій imagecolorallocate(), але ще додає до кольору параметр alpha, що відповідає за прозорість.
Список параметрів
image
Об'єкт GdImage, що повертається однією з функцій створення зображень, наприклад, такий як imagecreatetruecolor()
red
Значення червоного компонента кольору.
green
Значення зеленого компонента кольору.
blue
Значення синього компонента кольору.
alpha
Значение в диапазоне от до127. . означає непрозорий колір, 127 означає повну прозорість.
Параметри red greenиblue можуть бути або цілими в діапазоні від 0 до 255 або шістнадцятковими в діапазоні від 0x00 до 0xFF.
Значення, що повертаються
Идентификатор цвета или**false**в случае возникновении ошибки при создании цвета.
Увага
Ця функція може повертати як логічне значення **false**так і значення не типу boolean, яке наводиться до false. За більш детальною інформацією зверніться до розділу Логічний типИспользуйтеоператор === для перевірки значення, яке повертається цією функцією.
список змін
| Версия | Опис |
|---|---|
| 8.0.0 | image тепер чекає екземпляр GdImage; раніше очікувався коректний gd ресурс (Resource). |
Приклади
Приклад #1 Приклад використання imagecolorallocatealpha()****
Висновок наведеного прикладу буде схожим на:
Приклад #2 Перетворення типових альфа-значень для використання з imagecolorallocatealpha()
Зазвичай альфа-значення позначають повністю прозорі пікселі, а альфа-канал має 8 бітів. Щоб перетворити такі альфа-значення для сумісності з imagecolorallocatealpha(), досить трохи простої арифметики:
Результат виконання наведеного прикладу:
int(127)
int(0)
Дивіться також
- imagecolorallocate() - Створення кольору для зображення
- imagecolordeallocate() - Розрив асоціації змінної із кольором для заданого зображення