README

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)

bash
 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:

cmd
:: 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:

bash
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:

bash
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

bash
 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:

bash
./autoremesher \
    --input armadillo.obj \
    --output remeshed.obj \
    --report remeshed_report.txt \
    --tar