DNACalib

This library is used for performing modifications on a DNA file. It is written in C++ and there is also a Python wrapper for it. SWIG library is used for generating bindings for Python. DNACalib can be used in command line, or in Maya. Binaries for Windows and Linux are provided. If you are using a different architecture and/or platform, you must build DNACalib.

DNACalib folder structure

• DNACalib - Contains C++ source code of DNACalib and its dependencies. There is a library for reading and writing DNA files, along with a few other utility libraries.

• PyDNACalib - Contains the source code for generating the Python wrapper for DNACalib.

• PyDNA - Contains the source code for generating the Python wrapper for DNA library, that is under DNACalib folder containing C++ source code.

• SPyUS - Contains some common SWIG interface files used by both PyDNACalib and PyDNA.

• CMakeModulesExtra - Contains some common CMake functions that are used throughout the project, both in C++ and the Python wrapper.

Usage

For example, to change rotation values of neutral joints, use the SetNeutralJointRotationsCommand.

Below is an example that reads DNA, changes rotation values of all neutral joints to {1, 2, 3}, and overwrites the DNA file with these new values.

// Create DNA reader
auto inOutStream = dnac::makeScoped<dnac::FileStream>("example.dna",
                                                      dnac::FileStream::AccessMode::ReadWrite,
                                                      dnac::FileStream::OpenMode::Binary);
auto reader = dnac::makeScoped<dnac::BinaryStreamReader>(inOutStream.get());
reader->read();

// Check if an error occurred while reading DNA file
if (!dnac::Status::isOk()) {
    // handle reader error
}

// Create DNACalib reader in order to edit DNA
auto dnaReader = dnac::makeScoped<dnac::DNACalibDNAReader>(reader.get());

std::vector<dnac::Vector3> rotations{dnaReader->getJointCount(), {1.0f, 2.0f, 3.0f}};

// Create command instance
dnac::SetNeutralJointRotationsCommand cmd{dnac::ConstArrayView<dnac::Vector3>{rotations}};

// Execute command
cmd.run(dnaReader.get());

// Write DNA file
auto writer = dnac::makeScoped<dnac::BinaryStreamWriter>(inOutStream.get());
writer->setFrom(dnaReader.get());
writer->write();

// Check if an error occurred while writing DNA file
if (!dnac::Status::isOk()) {
    // handle writer error
}

Examples

C++

Examples of C++ library usage can be found here.

These are:

• Chain multiple commands

• Rename a blendshape

Python

Examples of using the library from Python are here.

These are:

• Showcase a few commands

• Rename a joint

• Create a small DNA from scratch

• Create a new DNA from an existing one by extracting specific LODs

• Read binary DNA and write it in a human readable format

• Remove a joint

• Clear blend shape data

• Subtract values from neutral mesh

Build

Prebuilt binaries for 64-bit Windows and Linux are provided. If you are using a different architecture and/or platform, you must build DNACalib.

Prerequisites:

• CMake at least version 3.14

• SWIG at least version 4.0.0

• Python To specify the exact version of python3 to use, set the CMake variable PYTHON3_EXACT_VERSION. For example, to use the lib from Maya 2022, use version 3.7. For Maya 2023, use version 3.9.

Use CMake to generate the build scripts required for building, e.g. by executing the following commands from the MetaHuman-DNA-Calibration/dnacalib/ directory:

mkdir build
cd build
cmake ..

And subsequently, to start the build process:

cmake --build