Automate the conversion of high-polygon 3D models into quad topology for animation and games
The tool automates the retopology process, which otherwise requires manually aligning tens of thousands of faces. It takes complex 3D models and converts them into a clean, quad-based structure suitable for animation or game engines. The output is ready for immediate use in subsequent workflow stages.
Conversion method and control options
The tool operates based on open-source libraries such as Geogram, libigl, and isotropicremesher. It takes a high-polygon mesh as input and applies internal algorithms to reconstruct it into quadrilateral faces. The CLI mode allows processing in headless environments, and the --target-quads option lets you specify the desired number of quads. Parameters like --sharp-edge or --anisotropy can be adjusted to control the preservation of sharp edges or the degree of anisotropy. Upon completion, a report file is generated alongside the converted mesh, allowing you to verify the results.
Platform-specific build environments
The project can be built on Linux, Windows, and macOS. On Linux (Ubuntu/Debian), you build using qmake and make commands, installing the required dependencies Qt 5.15.2 and TBB via the package manager. On Windows, you use Visual Studio 2022 and CMake to build TBB from source and then compile with nmake. An alternative path is provided for the MSYS2/MinGW-w64 environment, allowing builds with Qt 6. The built binaries are generated in the release folder for each platform.
Release downloads and execution
If you want to use the tool without building it, you can download the binaries from the release page. For Windows, unzip the file and run autoremesher.exe. For macOS, install the dmg file; you may need to click allow in the security settings on the first run. For Linux, download the AppImage file, grant execution permissions, and run it. This method allows users without a development environment to easily experience the tool.
Pre-use considerations
The tool is distributed under the MIT license, permitting commercial use. However, it requires a C++14 compiler, Qt 5.15.2, and the TBB library, so you must meet these version requirements when setting up the build environment. Specifically, if using MSVC on Windows, CMake 3.12 or higher is required. Processing time may vary depending on the complexity of the input model, so it is recommended to adjust CLI mode parameters appropriately for large models. The README does not specify particular hardware specifications or minimum system requirements, so self-testing is recommended when planning high-end 3D work.
