Normal Unsafe (Vector)
KismetMathLibraryЧто это
Pure-функция, возвращающая нормализованную копию вектора без проверки на нулевую длину. В отличие от Normalize, не изменяет исходный вектор и не проверяет, что длина больше нуля — если длина вектора равна нулю, результат будет содержать NaN. Используется для производительности, когда гарантированно известен ненулевой вектор.
Пины
Exec-входы:
- нет (pure)
Exec-выходы:
- нет (pure)
Входы (данные):
- In Vec (Vector) — исходный вектор для нормализации
Выходы (данные):
- Return Value (Vector) — нормализованный вектор единичной длины (или NaN, если длина In Vec равна нулю)
Когда используется
- Когда вектор гарантированно ненулевой (например, результат вычитания двух известных разных точек).
- В критичных по производительности участках, где лишняя проверка на нулевую длину недопустима.
Типичные проблемы
- Получение NaN — если передать нулевой вектор (0,0,0), функция вернёт вектор с NaN-компонентами, что приведёт к невидимым ошибкам в последующих вычислениях (например, при поворотах или физике).
- Путаница с Normalize — разработчики ожидают, что функция изменит исходный вектор (как Normalize), но она возвращает новый, не трогая оригинал.