Get Unit Axis (Matrix)
KismetMathLibrary
0
Что это
Pure-функция (не требует exec). Извлекает из матрицы 4×4 единичный вектор заданной оси (X, Y или Z). Результат нормализован — длина всегда равна 1 (если ось не нулевая). Полезна для получения направления из матрицы трансформации, когда нужен только орт.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- In Matrix (Matrix) — исходная матрица
- Axis (EAxis::Type) — ось: X, Y или Z (в редакторе выбирается из выпадающего списка)
Выходы (данные):
- Return Value (Vector) — единичный вектор направления выбранной оси
Когда используется
- Разложение матрицы вращения на орты — когда нужен, например, Forward, Right или Up вектор из матрицы трансформации, но без Scale.
- Построение систем координат: взять нормализованную ось из произвольной матрицы без риска получить масштабированный вектор.
Типичные проблемы
- Если матрица содержит нулевые масштабы (все компоненты оси равны 0) — возвращается нулевой вектор, что может привести к неверным направлениям в последующих вычислениях.
- Использование невалидного значения оси (например, EAxis::None) приведёт к падению или некорректному результату — всегда проверять, что передаётся только X/Y/Z.
- Функция возвращает нормализованный вектор, но не проверяет длину исходной оси — если ось не нулевая, результат корректен, но при очень малых длинах возможны ошибки точности.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.