huxingyi/autoremesher：把高模自动拆成干净四边面的几何管线

核心判断

AutoRemesher 解决的是“网格质量”这一在游戏、影视、仿真、3D 打印工作流里反复出现的瓶颈：把任意高模（几百万面、三角形分布混乱）拆成几乎全是四边形的网格，并保证边长、角度、面密度均匀。它的工程价值在于把这套原本散落在研究论文和图形学课程里的算法（基于 Geogram 的 VSA/Instant Meshes 等），打包成一个带 Qt GUI、可直接喂网格文件的桌面工具，对应岗位是 TA / 引擎程序员 / 网格管线工程师。

基本盘

• GitHub：https://github.com/huxingyi/autoremesher
• 仓库描述：Automatic quad remeshing tool（自动四边形网格重建工具）
• 语言：C++（核心），Qt 5.15 GUI
• 依赖库：Geogram（BrunoLevy/geogram）、libigl、isotropicremesher、Qt 5.15.2、TBB、OpenGL
• 平台：Linux / macOS / Windows（README 同时给出三套构建命令）
• 主作者 huxingyi 也是 isotropicremesher、libigl 生态贡献者

它解决什么问题

3D 资产生产中常见两类网格：

• 高密度扫描网格（摄影测量、激光扫描）：几百万三角形，分布极不均匀
• 手工雕刻网格（ZBrush、Blender）：拓扑无规律，不利于后续骨骼绑定 / 减面 / 仿真

直接拿这种网格去做 UV 展开、骨骼绑定、FDM 切片、有限元分析都不友好。AutoRemesher 的目标是输出一张等边、均匀、规则四边面的新网格，把面密度控制在你设定的目标边长附近，并保留原有形状（尖锐特征可能需要后续手动处理，但默认参数已经覆盖大部分常规资产）。

系统地图

输入网格（OBJ / OFF / STL）
    ↓
[加载模块] libigl 读入 V/F
    ↓
[预处理] 测地距离 / 场对齐
    ↓
[四边形化] Geogram Instant Meshes / VSA
    ↓
[各向同性化] isotropicremesher 均匀化
    ↓
[导出] OBJ / OFF（带 UV 候选）

源码层面，autoremesher 仓库把 Geogram、libigl、isotropicremesher 作为 third-party 子模块或外部依赖引用，本身负责：

• Qt 5.15.2 GUI（窗口、菜单、视口）
• 网格 IO（OBJ / OFF / STL）
• 参数面板（目标边长、角度阈值、特征保留等）
• OpenGL 实时预览
• 串接下游 isotropicremesher 做最终各向同性化

构建链路

Linux (Ubuntu / Debian)

sudo apt install build-essential qt5-qmake qtbase5-dev \
                 qttools5-dev-tools libqt5svg5-dev libqt5multimedia5-dev
sudo apt install libtbb-dev libgl1-mesa-dev

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

Fedora 用户换成 dnf install gcc-c++ qt5-qtbase-devel qt5-qttools-devel tbb-devel mesa-libGL-devel。

Windows (Visual Studio 2022)

README 的 Windows 流程比较特别：

1. 装 VS 2022 + Desktop development with C++ 工作负载
2. 装 CMake（TBB 从源码构建需要）
3. 装 Qt 5.15.2（用 online installer，选 msvc2019_64 归档）
4. 在 “x64 Native Tools Command Prompt for VS 2022” 里先 cmake 构建 third-party/tbb，再 qmake -spec win32-msvc
5. 用 Visual Studio 打开生成的 .sln 编译

这一步反映了 cross-platform C++ 工程在 Windows 上的现实：第三方库的二进制分发很难统一，作者宁可让用户从源码构建 TBB 来确保 ABI 匹配。

任务流案例：把一个雕刻网格转成可用四边面

典型 TA 工作流：

1. 准备资产：从 ZBrush / Blender 导出一个 OBJ（不要带 UV，原网格留待拆解）
2. GUI 加载：AutoRemesher → File → Open → 选 OBJ → 在视口里看到原始网格（默认按面着色，能立刻看到三角面分布）
3. 设置参数：Target Edge Length 填你希望的平均边长（例如角色头部 2mm、建筑物面 50cm），Curvature Adaptive 打开以保留边缘
4. 运行：Quad Remesh → 进度条 → 几秒到几分钟（百万级面）
5. 预览：实时显示新四边面网格 + 色彩化的 face quality
6. 导出：File → Export OBJ → 带 UV（可选）
7. 回管线：把新网格导回 Maya / Blender 做骨骼绑定、UV 重新展开、烘焙法线

整个过程不需要写代码。这是“研究员成果转 TA 工具”的典型交付。

与相似项目的对比

AutoRemesher 的定位是“研究算法的可执行封装”——它不重新发明算法，而是把 Geogram、libigl、isotropicremesher 三个项目的精华串成 GUI。如果你不想要写 C++，也不想用 Blender 写 Python 脚本，这是中间一档的折中。

适用边界

适合：

• 影视 / 游戏 TA 需要把扫描网格、雕刻网格转四边面
• 仿真 / CAE 工程师给 CFD、FEM 准备网格
• 3D 打印流程里做各向同性切片前的预处理
• 想在桌面端快速验证 Geogram / Instant Meshes 的参数效果

不适合：

• 要保留任意精度尖锐特征的高精度工业 CAD 模型（需要更专业的 PolyWorks / Geomagic Wrap）
• 自动展开 UV（AutoRemesher 不做 UV，导出后再用 RizomUV、Blender 等做）
• 浏览器内可访问（这是 C++ 桌面工具，没有 Web 版）

性能与资源

README 没明确给出基准，但基于 Geogram + TBB 多线程的实现，千万面级别的网格在 16 核 CPU + 64GB 内存的工作站上可在几分钟内完成。普通 8 核 CPU 上百万面以内的网格是日常。GPU 加速不在路线图里，所有计算都在 CPU 上完成。

学习路径建议

1. 第 1 天：跑通 README 三平台构建步骤中的任意一个，加载一个免费 OBJ（如 Stanford Bunny）跑通端到端
2. 第 3 天：对比 Target Edge Length 在 1mm / 5mm / 20mm 下的输出质量
3. 第 7 天：阅读 src/remesh/ 下串接 Geogram 的代码（通常几百行），理解“调库式集成”模式
4. 第 14 天：尝试在 Blender 里用 AutoRemesher 输出做 UV 重新展开，对比 Blender 自带 Quad Remesh 的速度与质量

参考

• 仓库：https://github.com/huxingyi/autoremesher
• Geogram：https://github.com/BrunoLevy/geogram
• libigl：https://github.com/libigl/libigl
• isotropicremesher：https://github.com/huxingyi/isotropicremesher
• 论文基础：Jakob 等 “Instant Field-Aligned Meshes” (SIGGRAPH Asia 2015)