Get Level Transform
ActorЧто это
Pure-функция класса Actor. Возвращает матрицу трансформации уровня (Level Transform) — итоговое преобразование из локального пространства актора в мировое, с учётом всех родительских трансформаций. Не требует exec-пинов, может использоваться как источник данных напрямую.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
нет (pure-функция, вызывается на акторе)
Выходы (данные):
- ReturnValue (Transform) — матрица трансформации уровня (4×4), объединяющая все родительские трансформации
Когда используется
- Получение мировой позиции, вращения и масштаба актора, особенно когда актор вложен в другие акторы (например, прикреплён к родительскому объекту).
- Расчёты, требующие точного преобразования координат из локального пространства актора в мировое (например, для спавна объектов в правильном месте).
Типичные проблемы
- Путаница с GetActorTransform — GetActorTransform возвращает только локальную трансформацию актора без учёта родителей, тогда как GetLevelTransform включает все родительские преобразования. Использование не той функции приводит к неверным координатам при вложенных акторах.
- Вызов до помещения актора в уровень — если актор ещё не заспавнен (не добавлен в мир), трансформация уровня может быть неопределена (единичная матрица или нулевая). Всегда проверяйте, что актор находится в мире перед вызовом.