Normal Safe (Vector2D)
KismetMathLibraryЧто это
Pure-функция, возвращает нормализованную копию вектора. Если длина входного вектора меньше заданного порога (Tolerance), возвращает нулевой вектор. Предотвращает деление на ноль при нормализации.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- In (Vector2D) — исходный вектор для нормализации.
- Tolerance (float) — порог, при котором вектор считается нулевым (по умолчанию 1e-8).
Выходы (данные):
- ReturnValue (Vector2D) — нормализованный вектор (длина 1) или (0,0) если вход близок к нулю.
Когда используется
Когда нужно безопасно нормализовать вектор, который может быть нулевым — например, направление от одного объекта к другому при совпадении позиций. Гарантирует отсутствие ошибок деления на ноль.
Типичные проблемы
- Слишком маленький Tolerance может не отловить очень малые векторы, что приведёт к делению на ноль. Слишком большой — обнулит векторы, которые стоило нормализовать.
- Не учитывают, что при нулевом входе возвращается (0,0), а не единичный вектор. Последующее умножение на такой вектор даст ноль, что может быть неожиданным.