How it differs from AutoRemesher
Quadami started as a fork of Jeremy Hu's AutoRemesher 1.2 (see Origin and credits) and keeps its overall method: a cross field guides a quad parameterization, which is rounded to whole numbers and turned into quads. Since then most stages have changed:
- a Blender add-on that runs the remesher in its own process, instead of a standalone app;
- quad extraction by libQEx, with closed inputs kept closed and small pieces kept present;
- a reworked rounding and untangling of the parameterization, a validity check of the map before extraction, and an output projected onto and relaxed along the input surface;
- input cleanup (broken triangles, inconsistent winding, unwelded seams, duplicate faces, pinched vertices) and detection and optional repair of folded sculpt input;
- a quality report with every run, and a test harness that measures every change on the same meshes before it is merged.
The standalone AutoRemesher desktop app is still in this repository for development and is built and tested by CI, but it is no longer packaged or supported as a product.
License
Quadami is licensed under the GNU General Public License, version 3 or later (GPL-3.0-or-later), see LICENSE.
It contains code derived from AutoRemesher, which is under the MIT License. That license
requires its copyright and permission notice to stay with the code, so it is kept in
LICENSE-MIT-upstream and in the headers of the files that came from
AutoRemesher. The bundled libraries keep their own licenses, listed in
THIRD_PARTY_NOTICES; the add-on zip carries all of them in its licenses/
folder.
Origin and credits
Quadami is derived from AutoRemesher by
Jeremy Hu (version 1.2.0, commit 4a49f82), MIT License. The field-guided method, the first
versions of most of the core and the desktop app are his work, together with the people listed in
AUTHORS and CONTRIBUTORS. AutoRemesher's own releases and history are in
its repository; its changelog is kept in CHANGELOGS.md. Quadami is a separate
project: please report Quadami problems here, not upstream.
Quadami also builds on:
- libQEx (Hans-Christian Ebke et al., RWTH Aachen; GPL-3.0-or-later),
the implementation of QEx: Robust Quad Mesh Extraction (Ebke, Bommes, Campen, Kobbelt, SIGGRAPH Asia
2013). Our changes are listed in
thirdparty/libQEx/PATCHES.md. - OpenMesh (RWTH Aachen; BSD-3-Clause), used by libQEx.
- isotropicremesher (Jeremy Hu; MIT).
- Eigen (MPL-2.0), oneTBB (Apache-2.0), meshoptimizer (Arseny Kapoulkine; MIT), tinyobjloader (MIT).
- The desktop app also uses Qt, QtAwesome and QtWaitingSpinner.
ACKNOWLEDGEMENTS.html is AutoRemesher's list for its desktop app, kept as it was; it names libraries that are not in this repository. THIRD_PARTY_NOTICES is the list of what Quadami actually contains.