Luminance (LinearColor)
KismetMathLibrary
0
Что это
Pure-функция, возвращающая яркость (luminance) линейного цвета. Использует стандартные коэффици Rec.709 / sRGB для расчёта Y. Не требует exec-пинов — вычисляется мгновенно и может быть подключена напрямую к другим нодам.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- In Linear Color (LinearColor) — цвет в линейном цветовом пространстве, для которого вычисляется яркость.
Выходы (данные):
- Return Value (float) — вычисленная яркость (значение от 0.0 и выше, обычно в пределах [0, 1]).
Когда используется
- Для преобразования цвета в оттенки серого на основе фотометрической яркости.
- Для анализа освещённости сцены или интенсивности цвета.
- Для пороговой обработки (например, отделение тёмных участков) без ручного смешивания каналов.
Типичные проблемы
- Подача цвета в sRGB-пространстве без конвертации в linear — результат будет неверным. Всегда преобразуйте цвет через
SRGBToLinearили используйтеGet Luminanceтолько после гамма-коррекции. - Неосведомлённость о том, что функция использует конкретные веса (R:0.2126, G:0.7152, B:0.0722). Если нужна другая метрика яркости (например, равномерное усреднение), применяйте
(R+G+B)/3вручную. - Передача цвета со значениями >1.0 (например, HDR-цвет) — возвращаемая яркость может превышать 1.0, что корректно, но иногда сбивает с толку при ожидании диапазона [0,1].
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.