UKismetMathLibrary::Quat_IsNormalized
#include "Kismet/KismetMathLibrary.h"
Access: public
Specifiers: staticBlueprintPure
Description
Returns true if the quaternion has unit length (magnitude ≈ 1). A non-normalized quaternion will scale geometry instead of purely rotating it.
Caveats & Gotchas
- • There is no tolerance parameter; internally FQuat::IsNormalized uses a hardcoded threshold (THRESH_QUAT_NORMALIZED, typically 0.01). You cannot tighten this check.
- • Quaternions returned by engine systems (e.g. FRotator::Quaternion, USceneComponent::GetComponentQuat) are guaranteed normalized; prefer Quat_IsFinite over Quat_IsNormalized to guard against NaN/Inf corruption.
Signature
static UE_INL_API bool Quat_IsNormalized(const FQuat& Q)Parameters
| Name | Type | Description | Default |
|---|---|---|---|
| Q | const FQuat& | The quaternion to test for unit length. | — |
Return Type
bool Example
Assert normalization before using in a transform C++
FQuat Q = SomeExternalSource();
ensure(UKismetMathLibrary::Quat_IsNormalized(Q));
MyTransform.SetRotation(Q);Tags
Version History
Introduced in: 4.0
| Version | Status | Notes |
|---|---|---|
| 5.6 | stable | — |
Feedback
Was this helpful?