Map Range Unclamped
KismetMathLibraryЧто это
Pure-функция (без exec-пинов) из библиотеки KismetMathLibrary. Преобразует числовое значение из одного линейного диапазона в другой без зажимания (unclamped) – результат может выходить за границы целевого диапазона. Полезна для масштабирования величин, когда нужно сохранить пропорции за пределами исходного отрезка.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Value (float) — исходное значение, которое нужно преобразовать
- InRangeA (float) — начало исходного диапазона
- InRangeB (float) — конец исходного диапазона
- OutRangeA (float) — начало целевого диапазона
- OutRangeB (float) — конец целевого диапазона
Выходы (данные):
- ReturnValue (float) — преобразованное значение (может быть вне [OutRangeA, OutRangeB])
Когда используется
- Нормализация значений с последующей денормализацией в другой шкале (например, перевод громкости 0–100 в 0–1 и обратно).
- Интерполяция без ограничения (например, экстраполяция анимационных параметров за границы ключей).
- Пересчёт координат из одной системы в другую (например, из пикселей в проценты экрана).
Типичные проблемы
- Путаница с MapRangeClamped – если нужно, чтобы результат не выходил за границы целевого диапазона, используйте MapRangeClamped, иначе получите значения меньше OutRangeA или больше OutRangeB.
- Деление на ноль – если InRangeA == InRangeB, функция вернёт некорректное значение (обычно 0 или NaN). Всегда проверяйте, что исходный диапазон не нулевой.
- Неверный порядок аргументов – легко перепутать InRangeA/InRangeB или OutRangeA/OutRangeB, что приведёт к инвертированному результату.