Desaturate (LinearColor)
KismetMathLibraryЧто это
Pure-функция для уменьшения насыщенности (обесцвечивания) линейного цвета (LinearColor).
Принимает исходный цвет и коэффициент обесцвечивания, возвращает новый цвет с пониженной насыщенностью.
Тип: pure (не имеет exec-пинов, выполняется сразу при чтении выхода).
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- A (LinearColor) — исходный цвет для десатурации
- Desaturation (float) — степень обесцвечивания:
0.0 = цвет не меняется, 1.0 = полностью серая шкала.
Промежуточные значения дают частичное снижение насыщенности.
Выходы (данные):
- ReturnValue (LinearColor) — результирующий цвет после применения десатурации
Когда используется
- Плавное приглушение цвета при наложении эффектов (урон, заморозка, смерть).
- Быстрая конвертация цветовой гаммы в оттенки серого для HUD-маркеров или миникарты.
Типичные проблемы
- Выход за границы 0..1 — если подать
Desaturation> 1.0, цвет может стать инвертированным (с отрицательной насыщенностью). Движек не всегда клиппирует автоматически – лучше явно зажатёрить значение. - Путаница с насыщением (Saturation) — многие ожидают параметр «насыщенность» (0 = серый, 1 = максимальный), но здесь параметр называется Desaturation (0 = полный цвет, 1 = серый). Неправильный порядок приводит к обратному результату.
- Игнорирование альфа-канала — функция меняет только RGB-компоненты, альфа остаётся неизменной. Если нужна полупрозрачная обесцвеченная текстура, альфа-значение надо корректировать отдельно.