diff --git a/.gitignore b/.gitignore index 70c95e1..ac3d08f 100644 --- a/.gitignore +++ b/.gitignore @@ -37,4 +37,4 @@ *.pyc /.idea -/output \ No newline at end of file +/output diff --git a/README.md b/README.md index 5454ab3..ca95456 100644 --- a/README.md +++ b/README.md @@ -1,17 +1,17 @@ -# DNA Calibration -DNA Calibration is a set of tools used for working with MetaHuman DNA files, bundled into a single package. +# MetaHuman DNA Calibration +MetaHuman DNA Calibration is a set of tools used for working with MetaHuman DNA files, bundled into a single package. DNA is an integral part of [MetaHuman](https://www.unrealengine.com/en-US/metahuman) identity. DNA files are created with [MetaHuman Creator](https://metahuman.unrealengine.com/) and downloaded with [Quixel Bridge](https://docs.metahuman.unrealengine.com/en-US/downloading-metahumans-with-quixel-bridge/). -DNA Calibration is a set of tools used for working with MetaHuman DNA files, bundled into a single package. We wanted to share this code to help users customize DNA files so they can better integrate the characters they create into their games and experiences. -DNA Calibration tools are provided in a GitHub repository located at this address. +MetaHuman DNA Calibration is a set of tools used for working with MetaHuman DNA files, bundled into a single package. We wanted to share this code to help users customize DNA files so they can better integrate the characters they create into their games and experiences. +MetaHuman DNA Calibration tools are provided in a GitHub repository located at this address. # Overview For an explanation about how the repository is organized, [click here](docs/repository_organization.md). -The DNA Calibration repository contains two distinct tools: +The MetaHuman DNA Calibration repository contains two distinct tools: - [DNACalib](docs/dnacalib.md) (and its dependencies) - [DNAViewer](docs/dna_viewer.md) @@ -81,4 +81,4 @@ eg. `c:/dna_calibration` in Windows or `/home/user/dna_calibration` in Linux. Im See the [FAQ guide](docs/faq.md) for additional specifications. # License -DNACalibration is released with [licence](LICENSE). +MetaHuman DNA Calibration is released with [licence](LICENSE). diff --git a/docs/faq.md b/docs/faq.md index fdbfdf2..b43fa5f 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -1,5 +1,25 @@ # Frequently Asked Questions (FAQ) +## Fix "RuntimeError: Error loading DNA: DNA signature mismatched, expected DNA, got ver?" + +DNA files are stored as [LFS](https://git-lfs.github.com/) files (Here is [another explanaintion](https://www.atlassian.com/git/tutorials/git-lfs) what LFS is). +This problem occurs when repo is downloaded as zip, and github then does not download LFS files as whole file, but as some metadata file. +Open that Ada.dna file in some editor file, from location were MetaHuman DNA Calibration is downloaded and then in +`data/dna/Ada.dna` (eg `c:/MetaHuman-DNA-Calibration/data/dna/Ada.dna` you will got this: + +``` +version https://git-lfs.github.com/spec/v1 +oid sha256:e764cfab938283231bcb3e5af1c7bcbec5154bab4804aafa1b5b7dc6e400ca5e +size 73730354 +``` +Which is not valid DNA file. + +There is two ways to fix this issue: +- `git clone git clone https://github.com/EpicGames/MetaHuman-DNA-Calibration.git` +- manually download [Ada.dna](../data/dna/Ada.dna) and/or [Taro.dna](../data/dna/Taro.dna), and put them in data directory +where you downloaded MetaHuman DNA Calibration. eg. `c:/MetaHuman-DNA-Calibration/data/dna` + + ## How do I distribute a Maya scene? Your scene should work out of the box if you include the following in the distribution: