Angular Distance (Quat)
KismetMathLibraryЧто это
Pure-функция (без exec-пинов) из набора Quaternion (KismetMathLibrary). Вычисляет минимальный угол (в радианах) между двумя вращениями, заданными кватернионами. Результат всегда неотрицательный и лежит в диапазоне [0, π]. Полезна для сравнения ориентаций, проверки близости поворотов, интерполяции.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- A (Quat) — первый кватернион (исходная ориентация)
- B (Quat) — второй кватернион (целевая ориентация)
Выходы (данные):
- Return Value (float) — угловое расстояние в радианах
Когда используется
- Проверка, насколько сильно отличаются две ориентации (например, при плавном повороте объекта к цели).
- Определение момента, когда вращение достигло заданного допуска (сравнение с порогом).
- Отладка анимаций и IK: контроль, что промежуточные кватернионы не «перескакивают».
Типичные проблемы
- Путаница радианов и градусов — функция возвращает радианы. Если в проекте приняты градусы, нужно умножить результат на
180 / π(конвертерRadians to Degrees). - Неединичные кватернионы — если входные кватернионы не нормализованы (длина ≠ 1), результат будет некорректным. Перед вызовом стоит применить
Normalize (Quat). - Ожидание знакового угла — функция возвращает абсолютное расстояние (всегда ≥ 0). Для определения направления поворота (по часовой / против) используйте
Rotation Difference (Quat)или комбинацию сDot Product.