Normalize To Range
KismetMathLibraryЧто это
Pure-функция из KismetMathLibrary. Принимает число с плавающей точкой и линейно преобразует его из исходного диапазона [RangeMin, RangeMax] в нормализованный диапазон [0, 1]. Если входное значение лежит вне заданного диапазона, результат может быть меньше 0 или больше 1 (без автоматического ограничения). Полезна для масштабирования величин, расчёта процентов, интерполяции и подготовки данных для других математических операций.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Value (float) — исходное значение, которое нужно нормализовать
- RangeMin (float) — нижняя граница исходного диапазона
- RangeMax (float) — верхняя граница исходного диапазона
Выходы (данные):
- ReturnValue (float) — нормализованное значение в диапазоне
[0, 1](если Value внутри[RangeMin, RangeMax])
Когда используется
- Преобразование произвольного числа в относительную величину (например, 0.0–1.0) для дальнейшего использования в смешивании, анимации, шкалах прогресса.
- Нормализация данных из внешних источников (датчики, UI-слайдеры) перед передачей в функции, ожидающие диапазон
[0, 1]. - Расчёт положения точки между двумя границами (линейная интерполяция без фактического вызова
Lerp).
Типичные проблемы
- Результат вне [0, 1] при выходе за границы — функция не выполняет
Clamp, поэтому еслиValueменьшеRangeMinили большеRangeMax, возвращаемое число будет отрицательным или больше единицы. Если нужно ограничение, используйте дополнительноClampилиInverseLerpсClamp. - Перепутан порядок RangeMin и RangeMax — если
RangeMin>RangeMax, нормализация будет работать «в обратную сторону» (значения будут уменьшаться при ростеValue). Убедитесь, чтоRangeMin— это нижняя граница, аRangeMax— верхняя. - Деление на ноль — если
RangeMinиRangeMaxравны, произойдёт деление на ноль, что приведёт кNaNили бесконечности. Всегда проверяйте, что диапазон ненулевой.