RealDocs

AActor::GetActorScale

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

Description

Returns the world-space scale of the actor's RootComponent as an FVector. Each component (X, Y, Z) represents the scale factor along that axis, where (1,1,1) is unscaled.

Signature

inline FVector GetActorScale() const

Return Type

FVector

Caveats & Gotchas

  • In Blueprints, this is exposed as Get Actor Scale 3D — GetActorScale is the C++ equivalent with the same result.
  • Returns FVector(1,1,1) if the actor has no RootComponent.
  • This returns world scale. If the actor is attached to a scaled parent, the returned value includes the parent's scale contribution.

Example

Read current scale and apply a proportional resize C++
FVector CurrentScale = GetActorScale();
SetActorScale3D(CurrentScale * 1.5f); // Grow by 50%

Version History

Introduced in: 4.0

Version Status Notes
5.6 stable

Feedback

Was this helpful?

Suggest an edit

Select a field above to begin editing.