Normalize
KismetMathLibraryЧто это
Pure-функция из библиотеки KismetMathLibrary («Normalize»). Возвращает вектор единичной длины (нормализованный), сохраняя направление исходного вектора. Если длина входного вектора равна нулю, возвращается нулевой вектор (защита от деления на ноль). Полезна для получения направления без учёта длины.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- A (Vector) — исходный вектор
Выходы (данные):
- ReturnValue (Vector) — нормализованный вектор
Когда используется
Для преобразования любого вектора (например, разности позиций, скорости или направления луча) в единичный вектор направления. Применяется в расчётах освещения, прицеливания, перемещения физических объектов и в любой математике, где нужен только поворот без учёта масштаба.
Типичные проблемы
- Нулевой входной вектор: если A = (0,0,0), результат будет (0,0,0) — это может привести к неожиданному поведению в последующей арифметике (например, умножение на ноль). Рекомендуется проверять длину вектора перед нормализацией.
- Путаница с нормализацией 2D-вектора: в Unreal есть отдельная функция
Normalize2D(классKismetMathLibrary), для работы с двумерными векторами. ИспользованиеNormalizeнаVector2Dне скомпилируется — требуется явное приведение. - Pure vs exec: нода не имеет exec-пинов, поэтому её нельзя «вызвать» — она вычисляется при обращении к выходному пину. Попытка подключить к ней exec-поток (например, через последовательность) бессмысленна и не приведёт к ошибке, но может сбить с толку новичков.