struct
AnimationState
A single animation state in the controller
- Module
- Animation
- Header
#include "Animation/AnimationController.h"- Namespace
Mowo
Properties
| Type | Name | Description |
|---|---|---|
std::string | name | |
std::string | clipName | Durable clip reference. clipName is the authored identity — matched against AnimatorComponent::clips by AnimationClip::GetName() so reordering a model's clips (or sharing a controller across models) doesn't rebind the state. clipIndex is the resolved cache the runtime samples; it is filled from the name at bind time and, for legacy index-only assets with no name, kept as the serialized fallback. |
std::string | clipId | The AnimSequence package's id, when the clips come from packages. It wins over the name — UE references an AnimSequence as an asset, and a clip renamed in its package, or two meshes' clips of one name sharing a skeleton, still bind to the asset the state was authored against. |
int32_t | clipIndex | resolved from clipId/clipName; representative/ Default -1. |
float | speed | timing clip for a blend-space state Default 1.0f. |
bool | loop | Default true. |
bool | useBlendSpace | Optional 1D blend space (locomotion). When useBlendSpace is set, the state additionally blends two clips chosen from blendSpace1D by the float param blendParam; the AnimationSystem samples bsClipA/bsClipB at the state's current time and blends by bsWeight (see UpdateResult). clipIndex still drives timing + transition exit-time. Default false. |
BlendSpace1D | blendSpace1D | |
std::string | blendParam | |
bool | useBlendSpace2D | Optional 2D blend space (8-way directional locomotion). When useBlendSpace2D is set the state blends up to 3 clips chosen from blendSpace2D by (blendParamX, blendParamY); the AnimationSystem samples them phase-matched (see UpdateResult::bs2*). clipIndex is still the representative/timing clip. Takes precedence over the 1D blend space. Default false. |
BlendSpace2D | blendSpace2D | |
std::string | blendParamX | |
std::string | blendParamY | |
bool | useMotionMatching | Motion-matching state: the pose comes from the entity's MotionMatchingComponent database instead of clipIndex. clipIndex still drives timing + transition exit-time, so authoring stays unchanged. Default false. |
std::string | syncGroup | |
EAnimSyncRole | syncRole | Default EAnimSyncRole::Auto. |
Ref<class AnimationController> | subMachine | Nested state machine (I5). A state carrying one has no clip of its own: while it is active the machine inside decides the pose, and the PARENT still owns the transitions in and out. Entering the state re-enters the nested machine at its default state, so a sub-graph never resumes mid-stride from the last time the parent visited it. |
std::vector<AnimationTransition> | transitions | Outgoing transitions from this state |
Generated from Animation/AnimationController.h via animation.json · Oct 26, 2026Version 1.0.0