New Opacity (LinearColor)
KismetMathLibraryЧто это
Pure-функция из категории KismetMathLibrary. Создаёт новый цвет LinearColor с теми же значениями RGB, но с указанной непрозрачностью (альфа). Исходный цвет не изменяется — возвращается новый.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (LinearColor) — исходный цвет, чьи RGB-каналы будут скопированы.
- In Opacity (float) — новое значение альфа-канала (0.0 = полностью прозрачный, 1.0 = полностью непрозрачный). Выход за диапазон 0–1 допустим для HDR-рендеринга.
Выходы (данные):
- ReturnValue (LinearColor) — итоговый цвет с указанным значением альфы, RGB-составляющие не меняются.
Когда используется
- Замена альфы цвета без пересоздания структуры.
- Подготовка цвета для материала, где альфа не равна текущей (например, для отладки или UI).
- Присвоение одинаковой прозрачности разным цветам в цикле.
Типичные проблемы
- Предположение, что функция изменяет исходный цвет.
На самом деле она возвращает новый LinearColor — исходный остаётся без изменений. Чтобы сохранить результат, нужно присвоить его переменной.
- Передача нелинейного значения альфы.
В большинстве случаев ожидается диапазон 0–1. Выход за эти границы может дать неожиданный визуальный результат, если не используется HDR.
- Путаница с другими функциями «Opacity».
В BP есть Get/Set Member (LinearColor) и Make Linear Color — они также могут менять альфу, но ToNewOpacity специально создана для замены только альфы, не затрагивая RGB.