Clamp Angle
KismetMathLibraryЧто это
Pure-функция из KismetMathLibrary. Принимает угол в градусах и ограничивает его так, чтобы результирующее значение лежало в заданном диапазоне [Min, Max] с учётом циклической природы углов (0–360). Полезна, когда нужно гарантировать, что угол не выйдет за пределы, но при этом корректно обрабатываются значения >360 или <0.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Angle (Float) — исходный угол в градусах
- Min (Float) — минимальная граница диапазона
- Max (Float) — максимальная граница диапазона
Выходы (данные):
- Return Value (Float) — угол, приведённый к диапазону
[Min, Max]
Когда используется
- Нормализация угла поворота объекта после арифметических операций (сложение, вычитание) без потери циклической логики.
- Ограничение угла взгляда камеры или поворота джойстика в заданных пределах (например, от -90 до +90 градусов).
Типичные проблемы
- Перепутаны единицы измерения: функция ожидает градусы, а не радианы.
- Если
Min > Max, результат может быть непредсказуемым — всегда проверяйте порядок границ. - Новички ожидают, что функция «обрежет» угол (как clamp для линейных величин), но она учитывает циклический перенос, поэтому угол 370° с границами 0–360 вернёт 10°, а не 360°.