AActor::SetActorScale3D
#include "GameFramework/Actor.h"
Access: public
Specifiers: UFUNCTIONBlueprintCallable
Description
Sets the world-space scale of the actor's root component. Changing scale updates the entire component hierarchy relative to the root.
Caveats & Gotchas
- • Non-uniform scale (e.g. FVector(1, 1, 2)) can cause shearing artefacts on skeletal meshes and unpredictable physics collision shapes — use uniform scale wherever possible.
- • Setting scale to FVector::ZeroVector will cause degenerate transforms that break physics, rendering, and collision; always ensure scale components are non-zero.
Signature
ENGINE_API void SetActorScale3D(FVector NewScale3D)Parameters
| Name | Type | Description | Default |
|---|---|---|---|
| NewScale3D | FVector | The new world-space scale to apply to the actor's root component. | — |
Return Type
void Examples
Double the actor's size uniformly on BeginPlay
Blueprint
Double the actor's size uniformly C++
SetActorScale3D(FVector(2.0f, 2.0f, 2.0f));Tags
Version History
Introduced in: 4.0
| Version | Status | Notes |
|---|---|---|
| 5.6 | stable | — |
Feedback
Was this helpful?