UAnimInstance::UninitializeAnimation

function Engine Since 4.0

#include "Animation/AnimInstance.h"

Access: public Specifiers: ENGINE_APIvirtual

Description

Tears down the animation instance, releasing animation nodes and internal state. Called automatically when the skeletal mesh component is unregistered or the anim instance is being replaced.

Caveats & Gotchas

• After this call, the animation instance is in an uninitialized state. Calling update or evaluation functions on it will fail or produce undefined results until InitializeAnimation is called again.
• Override NativeUninitializeAnimation for custom teardown logic rather than overriding this method directly, as this function manages the full uninitialization sequence including linked instances.

Signature

ENGINE_API virtual void UninitializeAnimation();

Return Type

void

Example

Lifecycle awareness (no manual call needed) C++

// UninitializeAnimation is called automatically when the mesh component unregisters.
// Override NativeUninitializeAnimation for custom cleanup:
void UMyAnimInstance::NativeUninitializeAnimation()
{
    // Clean up custom resources
    CachedData.Reset();
    Super::NativeUninitializeAnimation();
}

Version History

Introduced in: 4.0

Version	Status	Notes
5.6	stable	—

Feedback

Was this helpful?