Skip to content

Add Skeletal Animation Component#98

Merged
CubeBerry merged 25 commits intomainfrom
SkeletalAnimation
Apr 2, 2026
Merged

Add Skeletal Animation Component#98
CubeBerry merged 25 commits intomainfrom
SkeletalAnimation

Conversation

@doyoung413
Copy link
Copy Markdown
Collaborator

@doyoung413 doyoung413 commented Mar 31, 2026

SkeletalAnimator Component:

  • Supports bone-based animation playback with up to 128 bones.
  • Implements linear blend skinning (LBS) with 4 weights per vertex.
  • Features smooth animation blending (crossfading).
  • Added Root Motion support with customizable baking options.

Animation State Machine:

  • Added SkeletalAnimationStateMachine for managing multiple animation states via keys.
  • Enables seamless state transitions with configurable blend durations.

Shader & Renderer Integration:

  • Updated Slang shaders (3D.slang, GBuffer.slang) to support skinning in both Vertex and Mesh shader pipelines.
  • Enhanced Vulkan renderer to handle bone matrix updates.

doyoung413 and others added 23 commits January 17, 2026 02:36
@doyoung413
Minor Change
cca7047
@doyoung413
Fix model visibility issue related to vertex structure
b6dd40d 
Implementation Details
- Added vertex data structures and shader logic for hardware skinning
- Integrated bone and weight data extraction into the model loading process
- Developed core components for bone interpolation and animation state management
- Created helper functions for bone data population and matrix conversion
- Implemented bone offset matrix normalization for proper vertex transformations

Vertex Structure Updates
- Extended ThreeDimension::Vertex with bone IDs and weights arrays
- Support up to 4 bone influences per vertex (MAX_BONE_INFLUENCE)
- Support up to 128 bones per mesh (MAX_BONES)
- Added BoneInfo structure containing bone ID and offset matrix
- Initialize bone IDs to -1 and weights to 0.0 by default

Rendering Pipeline
- Added bone IDs attribute at location 7 (ivec4)
- Added bone weights attribute at location 8 (vec4)
- Implemented skeletal data preservation during vertex quantization
- Added finalBones array to vertex uniform buffer
- Integrated with SkeletalAnimator component for runtime animation

Issues
- Skeletal animation loading is functional, but bone hierarchy display and
  mesh application are still in progress
- Bone positions appear incorrect, resulting in abnormal poses
@doyoung413
Fix model visibility issue related to vertex structure
138a42e 
Implementation Details
- Added vertex data structures and shader logic for hardware skinning
- Integrated bone and weight data extraction into the model loading process
- Developed core components for bone interpolation and animation state management
- Created helper functions for bone data population and matrix conversion
- Implemented bone offset matrix normalization for proper vertex transformations

Vertex Structure Updates
- Extended ThreeDimension::Vertex with bone IDs and weights arrays
- Support up to 4 bone influences per vertex (MAX_BONE_INFLUENCE)
- Support up to 128 bones per mesh (MAX_BONES)
- Added BoneInfo structure containing bone ID and offset matrix
- Initialize bone IDs to -1 and weights to 0.0 by default

Rendering Pipeline
- Added bone IDs attribute at location 7 (ivec4)
- Added bone weights attribute at location 8 (vec4)
- Implemented skeletal data preservation during vertex quantization
- Added finalBones array to vertex uniform buffer
- Integrated with SkeletalAnimator component for runtime animation

Issues
- Skeletal animation loading is functional, but bone hierarchy display and
  mesh application are still in progress
- Bone positions appear incorrect, resulting in abnormal poses
@doyoung413
Fix mesh explosion by removing redundant GlobalInverseTransform
6bcd77b 
Removed redundant GlobalInverseTransform multiplication. Keeping the formula as globalTransformation * offset ensures correct scaling and prevents mesh tearing, especially for FBX models.
@doyoung413
Merge branch 'SkeletalAnimation' of https://github.com/CubeBerry/Cube…
744227f 
…Engine into SkeletalAnimation

# Conflicts:
#	Engine/shaders/glsl/3D.vert
#	Engine/source/BasicComponents/DynamicSprite.cpp
#	Engine/source/BasicComponents/SkeletalAnimator.cpp
#	Engine/source/ObjectManager.cpp
#	Engine/source/RenderManager.cpp
@doyoung413
Fix mesh explosion and PreRotation issues in animations
e3ca3c0 
- Resolved the mesh explosion bug occurring during animation playback.
- Fixed incorrect PreRotation transformations.
- Note: Root Motion implementation is still a work in progress (WIP).
@doyoung413
Implement Root Motion
a900405
@doyoung413
Optimize SkeletalAnimation
a7bc4b0 
- Index caching for position/rotation/scale interpolation
- Removed heavy string allocations by caching dummy node state
- Reduced GetComponent and offset map lookups by passing encodeMatrix directly
- Cleaned up unused variables and functions
@doyoung413
Minor Change
4cfe0cc
@doyoung413
Add SkeletalAnimationDemo and change debug visualization
921b304 
- Implemented new skeletal animation demo scene with dynamic lighting effects
- Replaced Physics3D debug meshes with ImGui line rendering
@doyoung413
Fix model visibility issue related to vertex structure
9d7288f 
Implementation Details
- Added vertex data structures and shader logic for hardware skinning
- Integrated bone and weight data extraction into the model loading process
- Developed core components for bone interpolation and animation state management
- Created helper functions for bone data population and matrix conversion
- Implemented bone offset matrix normalization for proper vertex transformations

Vertex Structure Updates
- Extended ThreeDimension::Vertex with bone IDs and weights arrays
- Support up to 4 bone influences per vertex (MAX_BONE_INFLUENCE)
- Support up to 128 bones per mesh (MAX_BONES)
- Added BoneInfo structure containing bone ID and offset matrix
- Initialize bone IDs to -1 and weights to 0.0 by default

Rendering Pipeline
- Added bone IDs attribute at location 7 (ivec4)
- Added bone weights attribute at location 8 (vec4)
- Implemented skeletal data preservation during vertex quantization
- Added finalBones array to vertex uniform buffer
- Integrated with SkeletalAnimator component for runtime animation

Issues
- Skeletal animation loading is functional, but bone hierarchy display and
  mesh application are still in progress
- Bone positions appear incorrect, resulting in abnormal poses
@doyoung413
Fix mesh explosion by removing redundant GlobalInverseTransform
463fd70 
Removed redundant GlobalInverseTransform multiplication. Keeping the formula as globalTransformation * offset ensures correct scaling and prevents mesh tearing, especially for FBX models.
@doyoung413
Fix model visibility issue related to vertex structure
bd456c4 
Implementation Details
- Added vertex data structures and shader logic for hardware skinning
- Integrated bone and weight data extraction into the model loading process
- Developed core components for bone interpolation and animation state management
- Created helper functions for bone data population and matrix conversion
- Implemented bone offset matrix normalization for proper vertex transformations

Vertex Structure Updates
- Extended ThreeDimension::Vertex with bone IDs and weights arrays
- Support up to 4 bone influences per vertex (MAX_BONE_INFLUENCE)
- Support up to 128 bones per mesh (MAX_BONES)
- Added BoneInfo structure containing bone ID and offset matrix
- Initialize bone IDs to -1 and weights to 0.0 by default

Rendering Pipeline
- Added bone IDs attribute at location 7 (ivec4)
- Added bone weights attribute at location 8 (vec4)
- Implemented skeletal data preservation during vertex quantization
- Added finalBones array to vertex uniform buffer
- Integrated with SkeletalAnimator component for runtime animation

Issues
- Skeletal animation loading is functional, but bone hierarchy display and
  mesh application are still in progress
- Bone positions appear incorrect, resulting in abnormal poses
@doyoung413
Fix mesh explosion and PreRotation issues in animations
7768eb5 
- Resolved the mesh explosion bug occurring during animation playback.
- Fixed incorrect PreRotation transformations.
- Note: Root Motion implementation is still a work in progress (WIP).
@doyoung413
Implement Root Motion
c1e5358
@doyoung413
Optimize SkeletalAnimation
ec49381 
- Index caching for position/rotation/scale interpolation
- Removed heavy string allocations by caching dummy node state
- Reduced GetComponent and offset map lookups by passing encodeMatrix directly
- Cleaned up unused variables and functions
@doyoung413
Minor Change
4acfb5f
@doyoung413
Add SkeletalAnimationDemo and change debug visualization
3c463ad 
- Implemented new skeletal animation demo scene with dynamic lighting effects
- Replaced Physics3D debug meshes with ImGui line rendering
@doyoung413
Minor change
94c9d6e
@doyoung413
Skeletal Animation On Vulkan
071a8ee 
- Added finalBones array to shader uniform block and implemented skinning loop in 3D.slang.
- Updated VKRenderManager to register boneIDs (loc 7) and weights (loc 8) attributes.
- Wrapped shadow-related shader resources with #if defined(__hlsl__) to prevent validation errors on Vulkan.
- Adjusted WorldToScreen calculation for Vulkan NDC to correctly orient ImGui debug lines.
@doyoung413
Merge branch 'SkeletalAnimation' of https://github.com/CubeBerry/Cube…
310c321 
…Engine into SkeletalAnimation

# Conflicts:
#	Engine/source/ObjectManager.cpp
#	Engine/source/RenderManager.cpp
@CubeBerry
Fixed .gitignore
6c6eb08
@doyoung413
Skeletal Animation On DX and Enhance Component Logging
a56b6cd 
- Integrated skeletal animation skinning logic into Mesh Shaders (3D.slang, GBuffer.slang)
@CubeBerry CubeBerry added the enhancement New feature or request label Mar 31, 2026
@CubeBerry CubeBerry self-requested a review March 31, 2026 20:19
CubeBerry
CubeBerry requested changes Apr 1, 2026
View reviewed changes
Copy link
Copy Markdown
Owner

@CubeBerry CubeBerry left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

image image

There is a problem that some duplicated finger meshes are rendered on OpenGL, Vulkan, and DirectX 12.

@doyoung413
Fix skinning error for un-animated bones in SkeletalAnimator
9eb1545 
- Fixed an issue where specific mesh parts (ex:fingertips) would float in the air if they lacked animation tracks in the current clip.
- Updated the logic to calculate final bone matrices using the rig's boneIDMap instead of relying solely on SkeletalBone animation channels.
- This ensures all bones, including those without active animation data, correctly follow the skeletal hierarchy and offset transformations.
@doyoung413
Adjust skeletal animation to support standard hierarchies
0ccb1c5 
- Implemented dynamic root bone detection by traversing the skeleton hierarchy instead of relying on hardcoded name matching.
- Added support for standard animation hierarchies (ex: glTF) by providing fallbacks for missing FBX-specific dummy nodes (_$AssimpFbx$_).
@CubeBerry CubeBerry merged commit 202f03c into main Apr 2, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@CubeBerry CubeBerry CubeBerry approved these changes

Assignees

@doyoung413 doyoung413

Labels

enhancement New feature or request

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@doyoung413 @CubeBerry