RealDocs

UAnimInstance::GetInstanceTransitionTimeElapsedFraction

function Engine Blueprint Since 4.8
#include "Animation/AnimInstance.h"
Access: public Specifiers: UFUNCTION

Description

Returns the normalized progress (0.0–1.0) of a state machine transition's crossfade, where 0.0 means the transition just started and 1.0 means it is complete. Equivalent to dividing GetInstanceTransitionTimeElapsed by GetInstanceTransitionCrossfadeDuration.

Caveats & Gotchas

  • • Returns 0.0 when the transition is inactive, the same value it returns at the very start of a transition. You cannot distinguish between 'not active' and 'just started' from this value alone.
  • • If the crossfade duration is zero (instant transition), the fraction jumps directly from 0.0 to 1.0 in a single frame, making it unsuitable for driving smooth visual effects on instant transitions.

Signature

UFUNCTION(BlueprintPure, Category="Animation", meta=(BlueprintInternalUseOnly = "true"))
float GetInstanceTransitionTimeElapsedFraction(int32 MachineIndex, int32 TransitionIndex) const;

Parameters

Name Type Description Default
MachineIndex int32 Index of the state machine containing the transition. —
TransitionIndex int32 Index of the transition within the state machine. —

Return Type

float

Example

Use transition fraction to blend a sound effect C++
float Fraction = GetInstanceTransitionTimeElapsedFraction(MachineIdx, TransitionIdx);
// Smoothly fade in a sound during the transition
MyAudioComponent->SetVolumeMultiplier(Fraction);

Version History

Introduced in: 4.8

Version Status Notes
5.6 stable —

Feedback

Was this helpful?

Suggest an edit

Select a field above to begin editing.