UKismetMathLibrary::Quat_Rotator
#include "Kismet/KismetMathLibrary.h"
Access: public
Specifiers: staticUFUNCTIONBlueprintPure
Description
Converts a quaternion to its FRotator representation. This is the canonical way to move from quaternion math back to UE's Pitch/Yaw/Roll convention for use with SetActorRotation, animation, and UI display.
Caveats & Gotchas
- • FRotator cannot represent all quaternion states losslessly. Conversions near gimbal lock (pitch ≈ ±90°) may produce unexpected Yaw/Roll values — always store orientations as FQuat if precision is required and only convert to FRotator for output.
- • This function has a BlueprintAutocast specifier, meaning Blueprint graphs will automatically call it when a Quat pin is connected to a Rotator pin. If unexpected conversions appear in your graph, this implicit cast is likely the cause.
Signature
static UE_INL_API FRotator Quat_Rotator(const FQuat& Q);Parameters
| Name | Type | Description | Default |
|---|---|---|---|
| Q | const FQuat& | The quaternion to convert. | — |
Return Type
FRotator Example
Apply a quaternion rotation to an actor C++
FQuat ComputedQuat = GetDesiredOrientation();
// SetActorRotation accepts FRotator, so convert
SetActorRotation(UKismetMathLibrary::Quat_Rotator(ComputedQuat));Tags
Version History
Introduced in: 4.0
| Version | Status | Notes |
|---|---|---|
| 5.6 | stable | — |
Feedback
Was this helpful?