UAnimInstance::GetActiveCurveNames

function Engine Blueprint Since 4.14

#include "Animation/AnimInstance.h"

Access: public Specifiers: UFUNCTIONBlueprintPureBlueprintThreadSafeconst

Description

Populates OutNames with the names of all animation curves of the given type that are currently non-zero or active. Useful for debugging which curves are driving behaviour on a given frame.

Caveats & Gotchas

• Reports curves as active based on the last completed evaluation — if the AnimGraph hasn't ticked yet (e.g. first frame), the list may be empty even if animations are set up.
• For the common case of reading all curve names without filtering by type, prefer GetAllCurveNames() which is equivalent to passing EAnimCurveType::AttributeCurve.

Signature

ENGINE_API void GetActiveCurveNames(EAnimCurveType CurveType, TArray<FName>& OutNames) const;

Parameters

Name	Type	Description	Default
CurveType	EAnimCurveType	The type of curve to enumerate (AttributeCurve, MorphTargetCurve, MaterialCurve).	—
OutNames	TArray<FName>&	Receives the names of all active curves of the specified type.	—

Return Type

void

Example

Logging active morph target curve names for debugging C++

TArray<FName> MorphNames;
GetActiveCurveNames(EAnimCurveType::MorphTargetCurve, MorphNames);
for (const FName& Name : MorphNames)
{
    UE_LOG(LogTemp, Log, TEXT("Active morph curve: %s"), *Name.ToString());
}

Version History

Introduced in: 4.14

Version	Status	Notes
5.6	stable	—

Feedback

Was this helpful?