AutoRemesher

AutoRemesher is a cross-platform automatic quad remeshing tool that converts high-polygon meshes into clean quad-based topology. It is built on top of libraries: Geogram, libigl, isotropicremesher and others.

Buy me a coffee for staying up late coding :-)

Getting Started

These instructions will get you a copy of AutoRemesher up and running on your local machine for development.

Prerequisites

• C++ compiler with C++14 support (GCC, Clang, or MSVC)
• Qt 5.15.2
• TBB (Intel Threading Building Blocks)
• CMake 3.12 or later (only needed on Windows to build TBB from source)

Building

Linux (Ubuntu/Debian)

# Install Qt and build tools
sudo apt install build-essential qt5-qmake qtbase5-dev qttools5-dev-tools libqt5svg5-dev libqt5multimedia5-dev

# Install TBB and OpenGL
sudo apt install libtbb-dev libgl1-mesa-dev

# Clone and build
git clone https://github.com/huxingyi/autoremesher.git
cd autoremesher
qmake
make -j$(nproc)

Fedora: sudo dnf install gcc-c++ qt5-qtbase-devel qt5-qttools-devel tbb-devel mesa-libGL-devel

Windows (Visual Studio 2022)

1. Install Visual Studio 2022 with Desktop development with C++ workload.
2. Install CMake (required to build TBB from source).
3. Install Qt 5.15.2 with the online installer — select the msvc2019_64 archive.
4. Open a x64 Native Tools Command Prompt for VS 2022 and run:

:: Build TBB from the bundled third-party source
cd thirdparty\tbb
cmake -B build2 ^
    -DTBB_BUILD_SHARED=ON ^
    -DTBB_BUILD_STATIC=OFF ^
    -DTBB_BUILD_TBBMALLOC=OFF ^
    -DTBB_BUILD_TBBMALLOC_PROXY=OFF ^
    -DTBB_BUILD_TESTS=OFF
cmake --build build2 --config Release
cd ..\..

:: Build AutoRemesher
qmake -spec win32-msvc
set CL=/MP
nmake -f Makefile.Release

The release binary will be at release\autoremesher.exe.

Windows (MSYS2 / MinGW-w64)

An alternative to the MSVC toolchain that builds against Qt 6 from MSYS2.

1. Install MSYS2.
2. From the MSYS2 MINGW64 shell, install the toolchain and dependencies:

pacman -S --needed \
    mingw-w64-x86_64-gcc \
    mingw-w64-x86_64-qt6-base \
    mingw-w64-x86_64-tbb \
    make

3. Build from the same shell:

cd /c/path/to/autoremesher
qmake
make -j$(nproc)

The binary will be at release/autoremesher.exe. Run it from the MINGW64 shell so the Qt 6 and oneTBB DLLs on /mingw64/bin are found, or bundle the dependencies next to the binary with windeployqt-qt6 release/autoremesher.exe.

macOS

# Install Xcode Command Line Tools
xcode-select --install

# Install dependencies via Homebrew
brew install qt@5 tbb cmake

# Build
export PATH="/usr/local/opt/qt@5/bin:$PATH"
git clone https://github.com/huxingyi/autoremesher.git
cd autoremesher
qmake CONFIG+=sdk_no_version_check
make -j$(sysctl -n hw.logicalcpu)

Running a quick test

AutoRemesher has a CLI mode for headless processing. Try it with one of the common-3d-test-models:

./autoremesher \
    --input armadillo.obj \
    --output remeshed.obj \
    --report remeshed_report.txt \
    --target-quads 50000 \
    --edge-scaling 1.0 \
    --sharp-edge 90.0 \
    --smooth-normal 0.0 \
    --adaptivity 1.0 \
    --anisotropy 1.0

Quick Start

Windows

Download autoremesher-<version>-win32-x86_64.zip from releases, extract it and run autoremesher.exe.

macOS

Download autoremesher-<version>.dmg from releases.

For the first time, Apple will reject to run and popup something like "can't be opened because its integrity cannot be verified". Go to System Preferences > Security & Privacy > General and under "Allow apps downloaded from" click the button to allow it.

Linux

Download autoremesher-<version>.AppImage from releases.

$ chmod a+x ./autoremesher-<version>.AppImage
$ ./autoremesher-<version>.AppImage

Links

• Check out open-source auto-retopology tool AutoRemesher cgchannel.com
• A New Open-Source Auto-Retopology Tool 80.lv
• [Non-Blender] Autoremesher auto-retopology tool released blendernation.com
• オープンソースの新しいオートリメッシュツール Auto Remesher cginterest.com
• AutoRemesher 1.0.0-alpha - 超高速で高品質のクワッドポリゴン生成！Dust3D開発者によるオープンソースの自動リメッシュツール！ 3dnchu.com
• Open Source AutoRemesher released cgpress.org
• 「autoremesher」多角形を自動でリトポしてれる無料トポロジーツール modelinghappy.com
• Open Source Auto Remesher blender-addons.org
• AutoRemesher | Auto-Retopology-Tool digitalproduction.com
• Autoremesher open source auto-retopology tool blenderartists.org

License

AutoRemesher is licensed under the MIT License - see the LICENSE file for details.

Acknowledgements

See the full ACKNOWLEDGEMENTS for a list of libraries and resources used in this project.