# 仓库组织结构

本仓库包含两个独立的组件:
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 |
|---|---|
|![image](img/metahuman_008.png)| ![image](img/metahuman_010.png) |

此外,我们添加了在 Maya 场景组装过程中使用的[`gui`](/data/gui.ma)和[`analog_gui`](/data/analog_gui.ma) Maya 场景文件。
另外,[`additional_assemble_script.py`](/data/additional_assemble_script.py)用于组织场景中的对象并连接控制器。理想的设置如下所示:

![image](img/aas.png)

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 场景来使用它,我们可以获得更好的颈部变形效果。