RealDocs

UKismetMathLibrary::BreakQuat

function Engine Blueprint Since 4.0
#include "Kismet/KismetMathLibrary.h"
Access: public Specifiers: staticBlueprintPure

Description

Decomposes an FQuat into its raw X, Y, Z, W float components. Primarily used by the Blueprint Break node for FQuat.

Caveats & Gotchas

  • The raw XYZW components have no direct human-readable meaning as angles — to get human-readable rotations, convert to FRotator first using FQuat::Rotator().
  • Storing and restoring a quaternion via its XYZW components is numerically safe, but if the original was not unit-length, the broken-out values will reflect that non-normalised state.

Signature

static UE_INL_API void BreakQuat(const FQuat& InQuat, float& X, float& Y, float& Z, float& W)

Parameters

Name Type Description Default
InQuat const FQuat& The quaternion to decompose.
X float& Output X component.
Y float& Output Y component.
Z float& Output Z component.
W float& Output W (scalar) component.

Return Type

void

Example

Extract components for serialization C++
float X, Y, Z, W;
UKismetMathLibrary::BreakQuat(ActorQuat, X, Y, Z, W);
UE_LOG(LogTemp, Log, TEXT("Quat: (%.3f, %.3f, %.3f, %.3f)"), X, Y, Z, W);

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.