139 lines
3.1 KiB
Markdown
139 lines
3.1 KiB
Markdown
# MetaWhiz - Maya MetaHuman 插件
|
||
|
||
## 项目概述
|
||
|
||
- **语言**：基于Python
|
||
- **Maya版本**：2022, 2023, 2024, 2025
|
||
- **目标**：本项目是一个Maya自定义MetaHuman插件
|
||
- **功能**：提供与MetaHuman相同拓扑的模型或自定义3D模型的处理功能，包括：
|
||
- 自定义绑定
|
||
- 编辑DNA
|
||
- 校准骨骼位置
|
||
- 保存/载入DNA
|
||
- 导出FBX
|
||
- 批量导出BlendShape
|
||
- 编辑BlendShape
|
||
|
||
## 代码规则
|
||
|
||
- Cascade使用中文回复
|
||
- 代码注释用英文
|
||
- Reference路径不参与功能实现，只作为参考，可以从中拷贝必要的文件到当前项目中，但不可直接引用
|
||
- UI样式参考SuperRiggingEditor，使用PySide的QtWidgets、QtLayouts、QtConnect等功能
|
||
|
||
## 参考文档
|
||
|
||
- DNA 校准文档：[MetaHuman DNA Calibration](https://epicgames.github.io/MetaHuman-DNA-Calibration/index.html)
|
||
- DNA 校准文档：`Reference\MetaHuman-DNA-Calibration\docs`
|
||
- Metahuman文档：`Reference\docs\Metahuman.pdf`
|
||
- SuperRiggingEditor文档：`Reference\docs\SuperRiggingEditor.pdf`
|
||
|
||
## 代码参考
|
||
|
||
- Metahuman DNA 校准器：`Reference\MetaHuman-DNA-Calibration`
|
||
- SuperRiggingEditor：`Reference\SuperRiggingEditor`
|
||
- MSLiveLink：`Reference\MSLiveLink`
|
||
|
||
**参考指向**：
|
||
|
||
- MetaHuman-DNA-Calibration：主要参考DNA编辑等功能
|
||
- SuperRiggingEditor：主要参考UI样式和对应的UI元素
|
||
|
||
## 项目结构
|
||
|
||
### 配置文件
|
||
|
||
- `config.py`：全局配置文件
|
||
|
||
### 主要文件
|
||
|
||
- `Install.py`：安装和卸载主程序
|
||
- `scripts\Main.py`：主程序入口文件
|
||
- `scripts\ui\`：UI程序模块目录
|
||
- `scripts\utils\`：功能模块目录
|
||
- `scripts\style\`：样式文件目录
|
||
|
||
### 资源文件
|
||
|
||
- `assets`：资源文件目录
|
||
- `icons`：图标文件目录
|
||
- `icons\logo.png`：Logo图标文件
|
||
- `plugins`：插件文件目录
|
||
|
||
## 安装说明
|
||
|
||
1. 将整个项目文件夹复制到您的Maya插件目录或任意位置
|
||
2. 在Maya中运行以下Python代码：
|
||
|
||
```python
|
||
import maya.cmds as cmds
|
||
import sys
|
||
|
||
# 替换为您的项目路径
|
||
project_path = "path/to/Tool"
|
||
if project_path not in sys.path:
|
||
sys.path.append(project_path)
|
||
|
||
# 运行安装程序
|
||
import Install
|
||
Install.main()
|
||
```
|
||
|
||
## 使用说明
|
||
|
||
安装完成后，可以通过Maya架子上的Tool按钮启动插件，或者运行以下Python代码：
|
||
|
||
```python
|
||
import maya.cmds as cmds
|
||
import sys
|
||
|
||
# 替换为您的项目路径
|
||
project_path = "path/to/Tool"
|
||
if project_path not in sys.path:
|
||
sys.path.append(project_path)
|
||
|
||
# 运行主程序
|
||
from scripts import Main
|
||
Main.main()
|
||
```
|
||
|
||
## 功能模块说明
|
||
|
||
### DNA编辑器
|
||
|
||
- 支持加载和保存DNA文件
|
||
- 编辑DNA参数和属性
|
||
- 从选中模型创建DNA
|
||
- 导出DNA文件
|
||
|
||
### 骨骼校准
|
||
|
||
- 自动和手动校准骨骼位置
|
||
- 加载参考骨骼
|
||
- 可视化骨骼差异
|
||
- 重置和应用校准数据
|
||
|
||
### 自定义绑定
|
||
|
||
- 支持多种绑定方法
|
||
- 导入和导出权重
|
||
- 权重绘制工具
|
||
- 权重镜像和裁剪
|
||
|
||
### BlendShape编辑
|
||
|
||
- 创建和管理BlendShape
|
||
- 添加、移除和编辑目标
|
||
- 批量导出目标
|
||
- 连接到控制器
|
||
|
||
## 技术要求
|
||
|
||
- Maya 2022或更高版本
|
||
- Python 3.7+
|
||
- PySide2/PySide6
|
||
|
||
## 联系与支持
|
||
|
||
如有任何问题或建议，请联系项目维护者。
|