Set World Location And Rotation
SceneComponentЧто это
Exec-функция компонента SceneComponent. Устанавливает новое положение (Location) и поворот (Rotation) компонента в мировых координатах за один вызов. Позволяет опционально выполнять sweep-проверку (плавное перемещение с учётом коллизий) и телепортацию (мгновенное перемещение без вызова физики).
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Target (SceneComponent Object Reference) — компонент, который перемещается
- New Location (Vector) — новая позиция в мировых координатах
- New Rotation (Rotator) — новый поворот в мировых координатах
- bSweep (bool) — если true, при перемещении проверяется столкновение с другими объектами; в случае коллизии компонент останавливается перед препятствием
- bTeleport (bool) — если true, физическое тело перемещается мгновенно без расчёта столкновений (полезно для телепортации)
Выходы (данные):
- Sweep Hit Result (Hit Result) — результат sweep-проверки (заполняется только если
bSweep = trueи произошло столкновение)
Когда используется
- Когда нужно одновременно изменить и положение, и поворот компонента (например, переместить персонажа в определённую точку с нужным направлением взгляда).
- Для более эффективного кода — один вызов вместо двух отдельных (
Set World Location+Set World Rotation). - При реализации перемещения с проверкой коллизий (sweep) или без неё.
Типичные проблемы
- Забытый bSweep — если нужно обнаружить столкновение при перемещении, но флаг
bSweepне включён, выходSweep Hit Resultостанется невалидным. - Неправильное использование bTeleport — при перемещении физических объектов (например, симуляции Rigid Body) включение
bTeleportможет привести к некорректной обработке физики; обычно его стоит использовать только для телепортации без расчёта столкновений. - Игнорирование Sweep Hit Result — если
bSweep = true, но результат не проверяется, можно пропустить важную информацию о столкновении (например, при перемещении персонажа сквозь стены).