UAnimInstance::InitializeGroupedLayers

function Engine Since 4.24

#include "Animation/AnimInstance.h"

Access: public Specifiers: virtual

Description

Initializes grouped animation layers on this anim instance. Called internally during the animation instance initialization process to set up linked animation layer groupings and their associated sub-graphs.

Caveats & Gotchas

• This is an engine-internal initialization function that is called automatically during anim instance setup. Calling it manually can cause double-initialization of layer groups, leading to undefined behavior or wasted memory.
• The bInDeferSubGraphInitialization parameter affects startup performance — deferred initialization reduces initial load time but may cause a hitch when the layer is first evaluated.

Signature

virtual void InitializeGroupedLayers(bool bInDeferSubGraphInitialization)

Parameters

Name	Type	Description	Default
bInDeferSubGraphInitialization	bool	When true, sub-graph initialization is deferred until the layers are actually needed, reducing upfront cost.	—

Return Type

void

Example

Override for custom layer initialization C++

void UMyAnimInstance::InitializeGroupedLayers(bool bInDeferSubGraphInitialization)
{
    Super::InitializeGroupedLayers(bInDeferSubGraphInitialization);
    // Perform additional setup after grouped layers are initialized
    CacheLayerGroupReferences();
}

Version History

Introduced in: 4.24

Version	Status	Notes
5.6	stable	—

Feedback

Was this helpful?