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.

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.

Signature

inline FVector GetActorScale() const

Return Type

FVector

Examples

Scale the actor up 50% from its current scale on BeginPlay Blueprint
Event BeginPlay Set Actor Scale 3D Target is Actor Target New Scale 3D Get Actor Scale Target is Actor Return Value FVector * Float A B 1.5 Return Value Return Value
Edit Blueprint graph Scale the actor up 50% from its current scale on BeginPlay
Drag node headers to move · Drag from an output pin to an input pin to connect · Scroll to zoom · Right-click for actions

Your edit will be submitted as a suggestion for moderator review.
Read current scale and apply a proportional resize C++ 
FVector CurrentScale = GetActorScale();
SetActorScale3D(CurrentScale * 1.5f); // Grow by 50%

See Also

AActor.SetActorScale3D AActor.GetActorTransform

Tags

#transform

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.