# import_mixamo-root_motion

**Repository Path**: SunZiBingFa/import_mixamo-root_motion

## Basic Information

- **Project Name**: import_mixamo-root_motion
- **Description**: No description available
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-06-19
- **Last Updated**: 2025-04-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# import mixamo - root motion
这是一个blender插件，用来批量导入从 Mixamo.com 下载的fbx动画文件。<br>创建根骨骼烘焙 Root Motion （根位移）。 <br>

## 功能
- 多选导入Fbx文件
- 批量移除前缀名称 "mixamorig:"
- 批量以文件名命名重命名动画名称
- 批量应用变换并修复动画强度
- 批量移除多余的骨架和物体；规则,文件名为:"Armature.00*"
- 批量创建根骨骼，用以记录Root Motion信息
- Root Motion 提供了几种计算方式烘焙关键帧


## Root Motion
Root Motion 将角色位移烘焙到`Root`骨骼并将它作为父级，烘焙后的动画会与原动画（Mixamo.com下载的）保持一致。 <br>
**⚠️ Root Motion 功能是会修改动画Hips骨头的关键帧(用来记录修正位移)**

<details>
<summary> 为什么需要修正动画</summary>
· 骨骼的关键帧动画使用的是 <font color='LightSeaGreen'>Local</font> 局部空间坐标系。<br>
·  <font color='SeaGreen'> mixamo.com </font> 的动画记录位移信息的是Hips骨骼，可能有一定旋转角度。<br>
· 而创建的Root骨骼自身Y轴与世界Z轴重合。<br>
· 当两个骨骼局部空间坐标系不重合时，夹角越大误差越大。<br>
· 这里把骨骼都转化为 <font color='LightSeaGreen'>Global</font> 全局空间坐标系，再进行根骨骼动画的计算，最后转化为各个骨骼的 <font color='LightSeaGreen'>Local</font> 局部空间坐标系进行关键帧烘焙。<br>
· 当没有对X/Y/Z三个轴都烘焙时，需要对动画进行修正。

</details>

## 更新
2024/07/01 从选中一个文件夹批量导入fbx文件，修改为多选fbx文件的方式导入

## 使用方法
1. 安装Blender 4.2.0 或更高版本。
2. 下载并安装该插件。
3. 打开Blender，选择“文件”>“导入”>“Mixamo Fbx(floder/*.fbx)”。
4. 在打开的对话框中，选择动画文件的文件夹，右侧面板进行设置，点击导入“Import Mixamo *.Fbx”。

## 演示说明
![001](./img/001.png)
![002](./img/002.png)
![003](./img/003.png)
![004](./img/004.png)
![005](./img/005.png)
![005](./img/005.gif)
![006](./img/006.gif)
![007](./img/007.gif)

## TODO LIST
- [ ] 增加：自定义骨骼前缀名称设置（默认值："mixamorig:"），以适配从其他动捕网站下载的动画，以及过滤非法字符。
- [ ] 增加：导入时添加 ".L" / ".R" 后缀或替换"Left" / “Right"为".L" / ".R"的可勾选按钮。
- [ ] 增加：导入时计算原点的选项（世界坐标系中心｜双脚中心｜边界盒底面中心），“双脚中心｜边界盒底面中心”这两种情况用以适配初始模型不在世界坐标系中心的情况。


<font color=gray>搞掂！</font>
<font color=gray>坐翻低、饮啖茶、吃个包 🍵🫖🍞</font>