AActor::SetActorLocationAndRotation

Move the actor instantly to the specified location and rotation.

Windows
MacOS
Linux

Syntax

bool SetActorLocationAndRotation
(
    FVector NewLocation,
    const FQuat & NewRotation,
    bool bSweep,
    FHitResult * OutSweepHitResult,
    ETeleportType Teleport
)

Remarks

Move the actor instantly to the specified location and rotation.

Returns

Whether the rotation was successfully set.

Parameters

Parameter

Description

NewLocation

The new location to teleport the Actor to.

NewRotation

The new rotation for the Actor.

bSweep

Whether we sweep to the destination location, triggering overlaps along the way and stopping short of the target if blocked by something. Only the root component is swept and checked for blocking collision, child components move without sweeping. If collision is off, this has no effect.

Teleport

How we teleport the physics state (if physics collision is enabled for this object). If equal to ETeleportType::TeleportPhysics, physics velocity for this object is unchanged (so ragdoll parts are not affected by change in location). If equal to ETeleportType::None, physics velocity is updated based on the change in position (affecting ragdoll parts). If CCD is on and not teleporting, this will affect objects along the entire swept volume.

OutSweepHitResult

The hit result from the move if swept.

References

Module

Engine

Header

Runtime/Engine/Classes/GameFramework/Actor.h

Source

Runtime/Engine/Private/Actor.cpp

Welcome to the new Unreal Engine 4 Documentation site!

We're working on lots of new features including a feedback system so you can tell us how we are doing. It's not quite ready for use in the wild yet, so head over to the Documentation Feedback forum to tell us about this page or call out any issues you are encountering in the meantime.

We'll be sure to let you know when the new system is up and running.

Post Feedback