Vector Unwind Euler
KismetMathLibraryЧто это
Pure-функция, которая нормализует (разворачивает) каждую компоненту вектора, интерпретируемую как угол Эйлера (в градусах), в диапазон [-180, 180). Используется для приведения углов к стандартному виду после арифметических операций. Не имеет exec-пинов (не требует запуска по потоку выполнения).
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (Vector) — вектор, компоненты которого (X, Y, Z) рассматриваются как углы (например, Pitch, Yaw, Roll) в градусах.
Выходы (данные):
- Return Value (Vector) — новый вектор с компонентами, нормализованными в диапазон [-180, 180).
Когда используется
- После сложения/вычитания углов вручную, чтобы избежать накопления больших чисел (например, при отслеживании вращения объекта).
- Перед сравнением углов или преобразованием в кватернион, чтобы обеспечить однозначность.
Типичные проблемы
- Путаница с Rotator_UnwindEuler: если работать с переменной типа Rotator, следует использовать одноимённую ноду для Rotator, иначе Vector_UnwindEuler воспримет три числа как единый вектор, а не как отдельные углы.
- Забывают использовать возвращаемое значение: так как функция pure, исходный вектор не изменяется, и результат необходимо сохранять или передавать дальше.
- Неверный порядок компонент: в UE Vector_UnwindEuler работает с координатами в порядке (X, Y, Z), которые, как правило, соответствуют Pitch, Yaw, Roll, но документация не гарантирует жёсткого соответствия — лучше явно использовать Rotator-функции для углов.