62 lines
2.8 KiB
Markdown
62 lines
2.8 KiB
Markdown
# 仓库组织结构
|
|
|
|
本仓库包含两个独立的组件:
|
|
1. **dnacalib C++ 库** - 用于操作 DNA 文件
|
|
2. **dna_viewer python 代码** - 用于在 Autodesk Maya 中可视化 DNA
|
|
|
|
# 文件夹结构
|
|
|
|
- [dnacalib](/dnacalib) - DNACalib 源代码
|
|
- [dna_viewer](/dna_viewer) - dna_viewer 源代码
|
|
- [examples](/examples) - 多个 Python 脚本,展示 dna_viewer 和 DNACalib Python 封装的基本用法
|
|
- [lib](/lib) - DNACalib、PyDNACalib 和 PyDNA 的预编译二进制文件
|
|
- [data](/data) - 必需的 DNA 文件和 Maya 场景文件
|
|
- [docs](/docs) - 文档
|
|
|
|
## DNACalib
|
|
文档位于[此处](dnacalib.md)
|
|
|
|
## DNAViewer
|
|
文档位于[此处](dna_viewer.md)
|
|
|
|
## 示例
|
|
要运行 [DNAViewer 示例](/docs/dna_viewer.md#examples),您必须安装 Maya 2022。
|
|
要运行 [DNACalib 示例](/docs/dnacalib.md#python),您需要 Python3。
|
|
|
|
## Lib
|
|
|
|
[Lib 文件夹](/lib)包含 Windows 和 Linux 平台的 DNACalib 库预编译二进制文件。此外,还提供了 Maya 的 RL4 插件。
|
|
|
|
### Linux 路径
|
|
您需要为[lib](lib/Maya2022/linux)中的所有 **.so** 文件复制或创建符号链接:
|
|
|
|
```shell
|
|
sudo ln -s ~/MetaHuman-DNA-Calibration/lib/Maya2022/linux/_py3dna.so /usr/lib/_py3dna.so
|
|
|
|
sudo ln -s ~/MetaHuman-DNA-Calibration/lib/Maya2022/linux/libdnacalib.so /usr/lib/libdnacalib.so
|
|
|
|
sudo ln -s ~/MetaHuman-DNA-Calibration/lib/Maya2022/linux/libdnacalib.so.6 /usr/lib/libdnacalib.so.6
|
|
|
|
sudo ln -s ~/MetaHuman-DNA-Calibration/lib/Maya2022/linux/libembeddedRL4.so /usr/lib/embeddedRL4.mll
|
|
|
|
sudo ln -s ~/MetaHuman-DNA-Calibration/lib/Maya2022/linux/MayaUERBFPlugin.mll /usr/lib/MayaUERBFPlugin.mll
|
|
```
|
|
|
|
注意:请将路径 `~/MetaHuman-DNA-Calibration` 更改为您的 `MetaHuman-DNA-Calibration` 实际所在位置。
|
|
|
|
## Data
|
|
|
|
[`data 文件夹`](/data)包含示例 DNA 文件。我们提供了两个 MetaHuman DNA 文件(我们的首个预设 Ada 和 Taro)。
|
|
|
|
| Ada | Taro |
|
|
|---|---|
|
|
||  |
|
|
|
|
此外,我们添加了在 Maya 场景组装过程中使用的[`gui`](/data/gui.ma)和[`analog_gui`](/data/analog_gui.ma) Maya 场景文件。
|
|
另外,[`additional_assemble_script.py`](/data/additional_assemble_script.py)用于组织场景中的对象并连接控制器。理想的设置如下所示:
|
|
|
|
|
|
|
|
MHC 2023 春季版本对骨骼定义进行了更改(增加了关节数量和表情数量)。
|
|
为适应这些更改,我们在 `/data/mh4` 文件夹中添加了几个文件:新的[gui 场景](/data/mh4/gui.ma)、更新的[组装脚本](/data/mh4/additional_assemble_script.py)和 Ada 的[DNA 文件](data/mh4/dna_files/Ada.dna)示例。
|
|
此外,在 lib 文件夹中我们添加了用于控制颈部表情的 Maya RBF 插件。最近对颈部设置进行了改进,添加 RBF 插件以及新的 gui 场景来使用它,我们可以获得更好的颈部变形效果。 |