Normal Unsafe XYZ (Vector4)
KismetMathLibraryЧто это
Pure-функция из библиотеки KismetMathLibrary. Нормализует только компоненты X, Y, Z переданного Vector4, оставляя компоненту W без изменений. Указание «Unsafe» означает, что при нулевой длине XYZ результат будет неопределён (NaN). Подходит для случаев, когда нужно нормализовать направление, но сохранить гомогенную координату W.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- A (Vector4) — исходный вектор
Выходы (данные):
- ReturnValue (Vector4) — нормализованный вектор (XYZ, W не изменён)
Когда используется
- Когда требуется нормализовать только трёхмерную часть 4D-вектора (например, направление) с сохранением гомогенной координаты W.
- В случаях, когда гарантировано, что длина XYZ не равна нулю (нет проверки на ноль).
Типичные проблемы
- Не обработана нулевая длина XYZ — при длине равной нулю результат станет NaN, что может «сломать» дальнейшие вычисления. Всегда проверяйте длину, если не уверены в ненулевом векторе.
- Неправильное понимание «unsafe» — новички могут ожидать «безопасного» поведения с проверкой на ноль, но функция этого не делает.
- Забывают, что W остаётся нетронутым — если нужна полная нормализация 4D-вектора (всех четырёх компонентов), эта функция не подходит.