generate new documentation
This commit is contained in:
parent
67ed4ad552
commit
801a082494
@ -37,10 +37,16 @@ To use these tools, you should be familiar with:
|
||||
|
||||
|
||||
## External Software Dependencies
|
||||
DNACalib's Python wrapper is compiled against Python 3.7. If you are using a different version of Python, you must recompile it. Any Python 3 version should be fine.
|
||||
Pre-compiled binaries for Windows and Linux (both 64-bit) are part of the repository.
|
||||
DNACalib's Python wrapper is compiled against Python 3.7. Pre-compiled binaries for Windows and Linux (both 64-bit) are part of the repository.
|
||||
If you are using a different version of Python, you must recompile it. Any Python 3 version should be fine.
|
||||
If a user has a different platform or architecture, the library and its dependencies must be compiled.
|
||||
|
||||
**Important**
|
||||
DNA files are stored as [LFS (Large File Storage)](https://git-lfs.github.com/) files. They are downloaded with the rest of the code if
|
||||
git-lfs is installed and configured to use. If you are not using git-lfs, you have to download DNA files manually.
|
||||
|
||||
Additional information can be found [here](faq_md#fix--runtimeerror--error-loading-dna--dna-signature-mismatched-expected-dna-got-ver-)
|
||||
|
||||
**Warning:**
|
||||
Python 2 is not supported.
|
||||
|
||||
|
@ -37,10 +37,16 @@ To use these tools, you should be familiar with:
|
||||
|
||||
|
||||
## External Software Dependencies
|
||||
DNACalib's Python wrapper is compiled against Python 3.7. If you are using a different version of Python, you must recompile it. Any Python 3 version should be fine.
|
||||
Pre-compiled binaries for Windows and Linux (both 64-bit) are part of the repository.
|
||||
DNACalib's Python wrapper is compiled against Python 3.7. Pre-compiled binaries for Windows and Linux (both 64-bit) are part of the repository.
|
||||
If you are using a different version of Python, you must recompile it. Any Python 3 version should be fine.
|
||||
If a user has a different platform or architecture, the library and its dependencies must be compiled.
|
||||
|
||||
**Important**
|
||||
DNA files are stored as [LFS (Large File Storage)](https://git-lfs.github.com/) files. They are downloaded with the rest of the code if
|
||||
git-lfs is installed and configured to use. If you are not using git-lfs, you have to download DNA files manually.
|
||||
|
||||
Additional information can be found [here](faq_md#fix--runtimeerror--error-loading-dna--dna-signature-mismatched-expected-dna-got-ver-)
|
||||
|
||||
**Warning:**
|
||||
Python 2 is not supported.
|
||||
|
||||
|
@ -206,7 +206,7 @@ If you are using a different architecture and/or platform, you must build DNACal
|
||||
<li><p><a class="reference external" href="https://cmake.org/download/">CMake</a> at least version 3.14</p></li>
|
||||
<li><p><a class="reference external" href="https://www.swig.org/download.html">SWIG</a> at least version 4.0.0</p></li>
|
||||
<li><p><a class="reference external" href="https://www.python.org/downloads/">Python</a> To specify the exact version of python3 to use, set the CMake variable
|
||||
<code class="docutils literal notranslate"><span class="pre">PYTHON3_EXACT_VERSION</span></code>. For example, to use the lib from Maya 2022, use minimum version 3.7.</p></li>
|
||||
<code class="docutils literal notranslate"><span class="pre">PYTHON3_EXACT_VERSION</span></code>. For example, to use the lib from Maya 2022, use version 3.7.</p></li>
|
||||
</ul>
|
||||
<p>Use CMake to generate the build scripts required for building, e.g. by executing the following commands from the
|
||||
<a class="reference external" href="https://github.com/EpicGames/MetaHuman-DNA-Calibration/tree/main/dnacalib"><code class="docutils literal notranslate"><span class="pre">dna_calibration/dnacalib/</span></code></a> directory:</p>
|
||||
|
@ -88,7 +88,7 @@ Prerequisites:
|
||||
- [CMake](https://cmake.org/download/) at least version 3.14
|
||||
- [SWIG](https://www.swig.org/download.html) at least version 4.0.0
|
||||
- [Python](https://www.python.org/downloads/) 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 minimum version 3.7.
|
||||
`PYTHON3_EXACT_VERSION`. For example, to use the lib from Maya 2022, use version 3.7.
|
||||
|
||||
Use CMake to generate the build scripts required for building, e.g. by executing the following commands from the
|
||||
[`dna_calibration/dnacalib/`](https://github.com/EpicGames/MetaHuman-DNA-Calibration/tree/main/dnacalib) directory:
|
||||
|
@ -112,22 +112,9 @@
|
||||
<h1>Frequently Asked Questions (FAQ)<a class="headerlink" href="#frequently-asked-questions-faq" title="Permalink to this headline"></a></h1>
|
||||
<section id="fix-runtimeerror-error-loading-dna-dna-signature-mismatched-expected-dna-got-ver">
|
||||
<h2>Fix “RuntimeError: Error loading DNA: DNA signature mismatched, expected DNA, got ver?”<a class="headerlink" href="#fix-runtimeerror-error-loading-dna-dna-signature-mismatched-expected-dna-got-ver" title="Permalink to this headline"></a></h2>
|
||||
<p>DNA files are stored as <a class="reference external" href="https://git-lfs.github.com/">LFS</a> files (Here is <a class="reference external" href="https://www.atlassian.com/git/tutorials/git-lfs">another explanaintion</a> 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.<br />
|
||||
Open that Ada.dna file in some editor file, from location were MetaHuman DNA Calibration is downloaded and then in
|
||||
<code class="docutils literal notranslate"><span class="pre">data/dna/Ada.dna</span></code> (eg <code class="docutils literal notranslate"><span class="pre">c:/MetaHuman-DNA-Calibration/data/dna/Ada.dna</span></code> you will got this:</p>
|
||||
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">version</span> <span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">git</span><span class="o">-</span><span class="n">lfs</span><span class="o">.</span><span class="n">github</span><span class="o">.</span><span class="n">com</span><span class="o">/</span><span class="n">spec</span><span class="o">/</span><span class="n">v1</span>
|
||||
<span class="n">oid</span> <span class="n">sha256</span><span class="p">:</span><span class="n">e764cfab938283231bcb3e5af1c7bcbec5154bab4804aafa1b5b7dc6e400ca5e</span>
|
||||
<span class="n">size</span> <span class="mi">73730354</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>Which is not valid DNA file.</p>
|
||||
<p>There is two ways to fix this issue:</p>
|
||||
<ul class="simple">
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">git</span> <span class="pre">clone</span> <span class="pre">git</span> <span class="pre">clone</span> <span class="pre">https://github.com/EpicGames/MetaHuman-DNA-Calibration.git</span></code></p></li>
|
||||
<li><p>manually download <span class="xref myst">Ada.dna</span> and/or <span class="xref myst">Taro.dna</span>, and put them in data directory
|
||||
where you downloaded MetaHuman DNA Calibration. eg. <code class="docutils literal notranslate"><span class="pre">c:/MetaHuman-DNA-Calibration/data/dna</span></code></p></li>
|
||||
</ul>
|
||||
<p>In order to fix this issue, you should install <a class="reference external" href="https://git-lfs.github.com/">git-lfs</a>, and clone the repository again.
|
||||
DNA files will be downloaded correctly then.
|
||||
If you cannot install git-lfs, you can download DNA files manually.</p>
|
||||
</section>
|
||||
<section id="how-do-i-distribute-a-maya-scene">
|
||||
<h2>How do I distribute a Maya scene?<a class="headerlink" href="#how-do-i-distribute-a-maya-scene" title="Permalink to this headline"></a></h2>
|
||||
|
BIN
docs/faq_out.md
(Stored with Git LFS)
BIN
docs/faq_out.md
(Stored with Git LFS)
Binary file not shown.
@ -145,9 +145,13 @@ MetaHuman DNA Calibration tools are provided in a GitHub repository located at t
|
||||
</section>
|
||||
<section id="external-software-dependencies">
|
||||
<h2>External Software Dependencies<a class="headerlink" href="#external-software-dependencies" title="Permalink to this headline"></a></h2>
|
||||
<p>DNACalib’s Python wrapper is compiled against Python 3.7. If you are using a different version of Python, you must recompile it. Any Python 3 version should be fine.
|
||||
Pre-compiled binaries for Windows and Linux (both 64-bit) are part of the repository.
|
||||
<p>DNACalib’s Python wrapper is compiled against Python 3.7. Pre-compiled binaries for Windows and Linux (both 64-bit) are part of the repository.
|
||||
If you are using a different version of Python, you must recompile it. Any Python 3 version should be fine.
|
||||
If a user has a different platform or architecture, the library and its dependencies must be compiled.</p>
|
||||
<p><strong>Important</strong>
|
||||
DNA files are stored as <a class="reference external" href="https://git-lfs.github.com/">LFS (Large File Storage)</a> files. They are downloaded with the rest of the code if
|
||||
git-lfs is installed and configured to use. If you are not using git-lfs, you have to download DNA files manually.</p>
|
||||
<p>Additional information can be found <span class="xref myst">here</span></p>
|
||||
<p><strong>Warning:</strong>
|
||||
Python 2 is not supported.</p>
|
||||
<p>DNACalib can be used in C++ projects as a C++ library.</p>
|
||||
|
@ -156,9 +156,13 @@ MetaHuman DNA Calibration tools are provided in a GitHub repository located at t
|
||||
</section>
|
||||
<section id="external-software-dependencies">
|
||||
<h2>External Software Dependencies<a class="headerlink" href="#external-software-dependencies" title="Permalink to this headline"></a></h2>
|
||||
<p>DNACalib’s Python wrapper is compiled against Python 3.7. If you are using a different version of Python, you must recompile it. Any Python 3 version should be fine.
|
||||
Pre-compiled binaries for Windows and Linux (both 64-bit) are part of the repository.
|
||||
<p>DNACalib’s Python wrapper is compiled against Python 3.7. Pre-compiled binaries for Windows and Linux (both 64-bit) are part of the repository.
|
||||
If you are using a different version of Python, you must recompile it. Any Python 3 version should be fine.
|
||||
If a user has a different platform or architecture, the library and its dependencies must be compiled.</p>
|
||||
<p><strong>Important</strong>
|
||||
DNA files are stored as <a class="reference external" href="https://git-lfs.github.com/">LFS (Large File Storage)</a> files. They are downloaded with the rest of the code if
|
||||
git-lfs is installed and configured to use. If you are not using git-lfs, you have to download DNA files manually.</p>
|
||||
<p>Additional information can be found <span class="xref myst">here</span></p>
|
||||
<p><strong>Warning:</strong>
|
||||
Python 2 is not supported.</p>
|
||||
<p>DNACalib can be used in C++ projects as a C++ library.</p>
|
||||
|
File diff suppressed because one or more lines are too long
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@ -206,7 +206,7 @@ If you are using a different architecture and/or platform, you must build DNACal
|
||||
<li><p><a class="reference external" href="https://cmake.org/download/">CMake</a> at least version 3.14</p></li>
|
||||
<li><p><a class="reference external" href="https://www.swig.org/download.html">SWIG</a> at least version 4.0.0</p></li>
|
||||
<li><p><a class="reference external" href="https://www.python.org/downloads/">Python</a> To specify the exact version of python3 to use, set the CMake variable
|
||||
<code class="docutils literal notranslate"><span class="pre">PYTHON3_EXACT_VERSION</span></code>. For example, to use the lib from Maya 2022, use minimum version 3.7.</p></li>
|
||||
<code class="docutils literal notranslate"><span class="pre">PYTHON3_EXACT_VERSION</span></code>. For example, to use the lib from Maya 2022, use version 3.7.</p></li>
|
||||
</ul>
|
||||
<p>Use CMake to generate the build scripts required for building, e.g. by executing the following commands from the
|
||||
<a class="reference external" href="https://github.com/EpicGames/MetaHuman-DNA-Calibration/tree/main/dnacalib"><code class="docutils literal notranslate"><span class="pre">dna_calibration/dnacalib/</span></code></a> directory:</p>
|
||||
|
@ -112,22 +112,9 @@
|
||||
<h1>Frequently Asked Questions (FAQ)<a class="headerlink" href="#frequently-asked-questions-faq" title="Permalink to this headline"></a></h1>
|
||||
<section id="fix-runtimeerror-error-loading-dna-dna-signature-mismatched-expected-dna-got-ver">
|
||||
<h2>Fix “RuntimeError: Error loading DNA: DNA signature mismatched, expected DNA, got ver?”<a class="headerlink" href="#fix-runtimeerror-error-loading-dna-dna-signature-mismatched-expected-dna-got-ver" title="Permalink to this headline"></a></h2>
|
||||
<p>DNA files are stored as <a class="reference external" href="https://git-lfs.github.com/">LFS</a> files (Here is <a class="reference external" href="https://www.atlassian.com/git/tutorials/git-lfs">another explanaintion</a> 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.<br />
|
||||
Open that Ada.dna file in some editor file, from location were MetaHuman DNA Calibration is downloaded and then in
|
||||
<code class="docutils literal notranslate"><span class="pre">data/dna/Ada.dna</span></code> (eg <code class="docutils literal notranslate"><span class="pre">c:/MetaHuman-DNA-Calibration/data/dna/Ada.dna</span></code> you will got this:</p>
|
||||
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">version</span> <span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">git</span><span class="o">-</span><span class="n">lfs</span><span class="o">.</span><span class="n">github</span><span class="o">.</span><span class="n">com</span><span class="o">/</span><span class="n">spec</span><span class="o">/</span><span class="n">v1</span>
|
||||
<span class="n">oid</span> <span class="n">sha256</span><span class="p">:</span><span class="n">e764cfab938283231bcb3e5af1c7bcbec5154bab4804aafa1b5b7dc6e400ca5e</span>
|
||||
<span class="n">size</span> <span class="mi">73730354</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>Which is not valid DNA file.</p>
|
||||
<p>There is two ways to fix this issue:</p>
|
||||
<ul class="simple">
|
||||
<li><p><code class="docutils literal notranslate"><span class="pre">git</span> <span class="pre">clone</span> <span class="pre">git</span> <span class="pre">clone</span> <span class="pre">https://github.com/EpicGames/MetaHuman-DNA-Calibration.git</span></code></p></li>
|
||||
<li><p>manually download <span class="xref myst">Ada.dna</span> and/or <span class="xref myst">Taro.dna</span>, and put them in data directory
|
||||
where you downloaded MetaHuman DNA Calibration. eg. <code class="docutils literal notranslate"><span class="pre">c:/MetaHuman-DNA-Calibration/data/dna</span></code></p></li>
|
||||
</ul>
|
||||
<p>In order to fix this issue, you should install <a class="reference external" href="https://git-lfs.github.com/">git-lfs</a>, and clone the repository again.
|
||||
DNA files will be downloaded correctly then.
|
||||
If you cannot install git-lfs, you can download DNA files manually.</p>
|
||||
</section>
|
||||
<section id="how-do-i-distribute-a-maya-scene">
|
||||
<h2>How do I distribute a Maya scene?<a class="headerlink" href="#how-do-i-distribute-a-maya-scene" title="Permalink to this headline"></a></h2>
|
||||
|
@ -145,9 +145,13 @@ MetaHuman DNA Calibration tools are provided in a GitHub repository located at t
|
||||
</section>
|
||||
<section id="external-software-dependencies">
|
||||
<h2>External Software Dependencies<a class="headerlink" href="#external-software-dependencies" title="Permalink to this headline"></a></h2>
|
||||
<p>DNACalib’s Python wrapper is compiled against Python 3.7. If you are using a different version of Python, you must recompile it. Any Python 3 version should be fine.
|
||||
Pre-compiled binaries for Windows and Linux (both 64-bit) are part of the repository.
|
||||
<p>DNACalib’s Python wrapper is compiled against Python 3.7. Pre-compiled binaries for Windows and Linux (both 64-bit) are part of the repository.
|
||||
If you are using a different version of Python, you must recompile it. Any Python 3 version should be fine.
|
||||
If a user has a different platform or architecture, the library and its dependencies must be compiled.</p>
|
||||
<p><strong>Important</strong>
|
||||
DNA files are stored as <a class="reference external" href="https://git-lfs.github.com/">LFS (Large File Storage)</a> files. They are downloaded with the rest of the code if
|
||||
git-lfs is installed and configured to use. If you are not using git-lfs, you have to download DNA files manually.</p>
|
||||
<p>Additional information can be found <span class="xref myst">here</span></p>
|
||||
<p><strong>Warning:</strong>
|
||||
Python 2 is not supported.</p>
|
||||
<p>DNACalib can be used in C++ projects as a C++ library.</p>
|
||||
|
@ -156,9 +156,13 @@ MetaHuman DNA Calibration tools are provided in a GitHub repository located at t
|
||||
</section>
|
||||
<section id="external-software-dependencies">
|
||||
<h2>External Software Dependencies<a class="headerlink" href="#external-software-dependencies" title="Permalink to this headline"></a></h2>
|
||||
<p>DNACalib’s Python wrapper is compiled against Python 3.7. If you are using a different version of Python, you must recompile it. Any Python 3 version should be fine.
|
||||
Pre-compiled binaries for Windows and Linux (both 64-bit) are part of the repository.
|
||||
<p>DNACalib’s Python wrapper is compiled against Python 3.7. Pre-compiled binaries for Windows and Linux (both 64-bit) are part of the repository.
|
||||
If you are using a different version of Python, you must recompile it. Any Python 3 version should be fine.
|
||||
If a user has a different platform or architecture, the library and its dependencies must be compiled.</p>
|
||||
<p><strong>Important</strong>
|
||||
DNA files are stored as <a class="reference external" href="https://git-lfs.github.com/">LFS (Large File Storage)</a> files. They are downloaded with the rest of the code if
|
||||
git-lfs is installed and configured to use. If you are not using git-lfs, you have to download DNA files manually.</p>
|
||||
<p>Additional information can be found <span class="xref myst">here</span></p>
|
||||
<p><strong>Warning:</strong>
|
||||
Python 2 is not supported.</p>
|
||||
<p>DNACalib can be used in C++ projects as a C++ library.</p>
|
||||
|
File diff suppressed because one or more lines are too long
Loading…
Reference in New Issue
Block a user