RealDocs

AActor::K2_AddActorWorldTransformKeepScale

function Engine Blueprint Since 4.14
#include "GameFramework/Actor.h"
Access: public Specifiers: UFUNCTIONBlueprintCallable

Description

Adds a delta transform to the actor in world space while preserving the actor's current scale. Use this instead of K2_AddActorWorldTransform when you do not want the actor's scale reset to (1,1,1).

Caveats & Gotchas

  • • Despite accepting a full FTransform delta, the scale component of DeltaTransform is still ignored — only the existing actor scale is preserved, not multiplied by the delta scale.
  • • Added in UE 4.14 specifically to address the scale-destroying behaviour of K2_AddActorWorldTransform. In older engines this function does not exist.

Signature

ENGINE_API void K2_AddActorWorldTransformKeepScale(const FTransform& DeltaTransform, bool bSweep, FHitResult& SweepHitResult, bool bTeleport);

Parameters

Name Type Description Default
DeltaTransform const FTransform& The delta transform to apply. Scale is ignored in the delta but the actor's existing scale is preserved. —
bSweep bool Whether to sweep to the new location during the translation. —
SweepHitResult FHitResult& Output hit result populated when bSweep is true and a blocking hit occurs. —
bTeleport bool If true, physics velocity is preserved. If false, physics velocity is updated based on displacement. —

Return Type

void

Example

Move and rotate a scaled actor without losing its scale C++
FTransform Delta(FRotator(0.f, 30.f, 0.f), FVector(100.f, 0.f, 0.f));
FHitResult Hit;
// Actor scale remains unchanged (e.g., (2,2,2))
MyActor->K2_AddActorWorldTransformKeepScale(Delta, false, Hit, false);

Version History

Introduced in: 4.14

Version Status Notes
5.6 stable —

Feedback

Was this helpful?

Suggest an edit

Select a field above to begin editing.