RealDocs

AActor::GetActorScale3D

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

Description

Returns the actor's world-space scale as an FVector with X, Y, and Z scale factors. This is the scale of the RootComponent in world space, not relative to any parent.

Caveats & Gotchas

  • • Returns world-space scale, not the relative scale stored on the component. If the actor is attached to another actor with non-unit scale, these values will differ from what you set via SetActorRelativeScale3D.
  • • Non-uniform scale (different X, Y, Z values) can cause unexpected results with physics simulation and collision shapes — keep scale uniform when physics is enabled.

Signature

ENGINE_API FVector GetActorScale3D() const;

Return Type

FVector

Examples

Check if the actor is at default scale (1,1,1) and print a message Blueprint
Event BeginPlay Branch Condition Condition True False Print String In String Actor is unscaled Actor is unscaled Get Actor Scale 3D Target is Actor Return Value Equal (Vector) A B (1.0,1.0,1.0) (1.0,1.0,1.0) Return Value Return Value
Edit Blueprint graph Check if the actor is at default scale (1,1,1) and print a message
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 scale and print each axis C++ 
FVector Scale = MyActor->GetActorScale3D();
UE_LOG(LogTemp, Log, TEXT("Scale: X=%.2f Y=%.2f Z=%.2f"), Scale.X, Scale.Y, Scale.Z);

See Also

AActor.SetActorScale3D AActor.GetActorRelativeScale3D AActor.SetActorRelativeScale3D

Tags

#transform #scale

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.