To Direction And Length
KismetMathLibraryЧто это
Pure-функция из библиотеки KismetMathLibrary. Разлагает двумерный вектор (Vector2D) на две составляющие: нормализованное направление (единичный вектор) и скалярную длину (расстояние от нулевой точки). Полезна, когда нужно одновременно получить и направление, и магнитуду вектора без двух отдельных операций.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- A (Vector2D) — исходный вектор, который требуется разложить.
Выходы (данные):
- Direction (Vector2D) — нормализованное направление исходного вектора (единичный вектор). Если длина A равна нулю, возвращает (0,0).
- Length (float) — длина (магнитуда) исходного вектора A.
Когда используется
- Когда нужно одновременно нормализовать вектор и узнать его длину в одной ноде (оптимизация графа).
- После получение координат в 2D-пространстве (например, разница между двумя точками) для разделения на направление движения и пройденное расстояние.
- В расчётах физики или AI, где требуется и направление луча, и его длина.
Типичные проблемы
- Нулевой вектор на входе – если передан (0,0), Direction станет (0,0), а не единичным вектором. Это может привести к неожиданным ветвлениям, если дальше используется как направление (например, в Normalize). Проверяйте Length перед использованием Direction.
- Путаница с функциями VectorLength/VectorLengthSquared – они возвращают только длину, не затрагивая направление. ToDirectionAndLength2D делает оба вычисления за один вызов.
- Тип выхода Length – возвращает float, но некоторые разработчики ожидают double (как в FVector::Length), что избыточно. В 2D-задачах точности float обычно достаточно, но для сверхточных расчётов учтите потерю.