MetaFusion/docs/repository_organization.md
2025-01-06 23:33:41 +08:00

2.8 KiB

仓库组织结构

本仓库包含两个独立的组件:

  1. dnacalib C++ 库 - 用于操作 DNA 文件
  2. dna_viewer python 代码 - 用于在 Autodesk Maya 中可视化 DNA

文件夹结构

  • dnacalib - DNACalib 源代码
  • dna_viewer - dna_viewer 源代码
  • examples - 多个 Python 脚本,展示 dna_viewer 和 DNACalib Python 封装的基本用法
  • lib - DNACalib、PyDNACalib 和 PyDNA 的预编译二进制文件
  • data - 必需的 DNA 文件和 Maya 场景文件
  • docs - 文档

DNACalib

文档位于此处

DNAViewer

文档位于此处

示例

要运行 DNAViewer 示例,您必须安装 Maya 2022。 要运行 DNACalib 示例,您需要 Python3。

Lib

Lib 文件夹包含 Windows 和 Linux 平台的 DNACalib 库预编译二进制文件。此外,还提供了 Maya 的 RL4 插件。

Linux 路径

您需要为lib中的所有 .so 文件复制或创建符号链接:

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 文件夹包含示例 DNA 文件。我们提供了两个 MetaHuman DNA 文件(我们的首个预设 Ada 和 Taro)。

Ada Taro
image image

此外,我们添加了在 Maya 场景组装过程中使用的guianalog_gui Maya 场景文件。 另外,additional_assemble_script.py用于组织场景中的对象并连接控制器。理想的设置如下所示:

image

MHC 2023 春季版本对骨骼定义进行了更改(增加了关节数量和表情数量)。 为适应这些更改,我们在 /data/mh4 文件夹中添加了几个文件:新的gui 场景、更新的组装脚本和 Ada 的DNA 文件示例。 此外,在 lib 文件夹中我们添加了用于控制颈部表情的 Maya RBF 插件。最近对颈部设置进行了改进,添加 RBF 插件以及新的 gui 场景来使用它,我们可以获得更好的颈部变形效果。