Mesh2Splat快速上手指南:Windows与Linux双平台构建运行零踩坑
Mesh2Splat快速上手指南:Windows与Linux双平台构建运行零踩坑
Mesh2Splat 是一款开源的 3D mesh(网格)转 3DGS(3D Gaussian Splatting,3D高斯泼溅) 转换工具,能把 .glb 格式的 3D 模型在 毫秒级(平均 <0.5ms) 直接转换成 3D 高斯泼溅模型,并自带 3DGS 渲染器实时预览结果。本文将带你完成 Windows 与 Linux 双平台的构建、运行与界面操作,新手照着做即可零踩坑 🚀。
快速了解:Mesh2Splat 能做什么?
传统做法要把一个 3D 模型变成 3DGS,需要先生成虚拟相机位姿、渲染图像集和稀疏点云,再喂给 3DGS 训练管线,往往耗时数分钟。Mesh2Splat 则直接利用模型的几何、材质和贴图信息,借助光栅化器的插值器完成转换,速度提升几个数量级。
主要特性一览:
| 特性 | 说明 |
|---|---|
| 直接处理 3D 模型 | 从 .glb 网格直接获得 3DGS 模型 |
| 采样密度可调 | 界面上用滑杆调节转换质量 |
| 贴图支持 | 漫反射(Diffuse)、Metallic-Roughness、法线(Normal)贴图 |
| 可重打光 | 转换出的高斯可重新打光 |
| 内置 3DGS 渲染器 | PBR 着色、点光源、全向阴影映射、Shader 热重载 |
Windows 平台构建:一键脚本 3 步搞定
环境准备(Prerequisites)
构建前先确认以下三个条件,这也是最容易踩坑的地方:
- CMake ≥ 3.21.1:旧版本(如 3.10、3.11)不认识 VS 2022,会直接生成失败;
- Visual Studio 2019 或 2022:必须安装 "Desktop development with C++" 工作负载;
- OpenGL 兼容的 GPU 和显卡驱动(项目基于 OpenGL 渲染)。
最快构建方法:运行官方批处理脚本
1️⃣ 克隆仓库:
git clone https://gitcode.com/gh_mirrors/me/mesh2splat
2️⃣ 在项目根目录打开 cmd 或 PowerShell,二选一运行脚本:
run_build_debug.bat :: 调试版
run_build_release.bat :: 发布版(推荐日常使用)
两个脚本会自动清空并重建 build 目录,依次执行 cmake .. 和 cmake --build .(详见 run_build_debug.bat、run_build_release.bat)。
3️⃣ 运行可执行文件:
- 直接打开
bin目录(Release 版在bin/Release,Debug 版在bin/Debug)运行Mesh2Splat; - 或者打开
build目录里的.sln文件用 VS 打开调试。
💡 小建议:只需要最终可执行文件就选 Release 构建,运行更快。
Linux 平台构建:apt 装依赖 + CMake 编译
一键安装构建依赖
sudo apt install build-essential cmake pkg-config git \
libfreeimage-dev libglew-dev libglfw3-dev libgl1-mesa-dev \
libxinerama-dev libxcursor-dev libxi-dev libxxf86vm-dev
构建与运行步骤
# 1. 克隆仓库
git clone https://gitcode.com/gh_mirrors/me/mesh2splat
cd mesh2splat
# 2. 创建并进入构建目录
mkdir build && cd build
# 3. 配置并编译(-j16 表示用 16 线程,可按核数调整)
cmake ..
cmake --build . -j16
# 4. 运行 build 目录中生成的可执行文件
💡 想要优化后的版本,把配置命令换成
cmake .. -DCMAKE_BUILD_TYPE=Release即可。
界面使用:从加载模型到导出 3DGS 的完整流程
程序启动后会看到一个 ImGui 界面,按下面 4 步走:
- 选文件:点击左上角 File Selector 窗口的
Select file to load (.glb / .ply),支持.glb(用于转换)和.ply(加载已有 3DGS 查看); - 调参数:在 Properties 窗口拖动
Sampling density滑杆调节采样密度(即转换质量),数值越高高斯数量越多;还可以勾选Enable mesh-gaussian depth test用网格做遮挡提升渲染性能; - 点转换:回到 File Selector 点击绿色的
Convert Mesh to 3DGS,转换在毫秒级完成,可开启 Split-Screen 左右对比 Mesh 与 Splat 效果; - 导出结果:选好输出文件夹(
Select output folder)、输入文件名后,点击Save splat导出。
内置渲染器支持 albedo、法线、深度、几何、overdraw 等多种可视化模式,还能启用点光源 + PBR 阴影查看重打光效果:
常见问题排查清单(FAQ)
-
❓ CMake 报错找不到 VS 2022 / 生成器不匹配 → 升级 CMake 到 3.21.1 以上再重试,这是官方明确提示的最常见坑。
-
❓ 加载
.glb后没有转换按钮 → 确认文件选择成功(窗口内会显示Selected Glb file: xxx);注意.ply只能用于加载已有 3DGS,不能参与转换。 -
❓ 树叶、毛发、草地等转换效果差 → 这是已知限制:Mesh2Splat 面向表面(surface)数据,体积类(Volumetric)数据目前不支持良好转换。
-
❓ 贴图没生效? → 当前支持 Diffuse、Metallic-Roughness、Normal 三类贴图;模型需要符合
.glb/gltf 规范。 -
❓ Linux 下运行黑屏或报错 → 检查是否装齐
libglew-dev libglfw3-dev等依赖,以及显卡 OpenGL 驱动是否正常。
关键文件路径速查
想进一步阅读源码或改 Shader,可以从这些入口入手:
| 内容 | 路径 |
|---|---|
| 官方文档与构建说明 | README.md |
| 构建配置(CMake) | CMakeLists.txt |
| Windows 一键构建脚本 | run_build_release.bat |
| 程序入口 | src/main.cpp |
| 转换核心 Shader(网格着色阶段) | src/shaders/conversion/converterGS.glsl |
| 3DGS 排序与混合 Shader | src/shaders/rendering/gaussianSplattingPS.glsl |
| 渲染 Pass 实现 | src/renderer/renderPasses/ |
| UI 与参数交互 | src/imGuiUi/ImGuiUI.cpp |
| 全局参数定义(模型格式、分辨率等) | src/utils/params.hpp |
写在最后
到这里,你已经完成了 Mesh2Splat 的 Windows/Linux 双平台构建、运行和 3DGS 转换导出全流程。总结 3 个要点:
- ✅ CMake 版本 ≥ 3.21.1 是 Windows 构建的第一道坎;
- ✅ Linux 一条
apt命令装齐依赖,再cmake两步编译; - ✅ 界面操作只需 4 步:选文件 → 调密度 → 点转换 → 存 Splat。
如果只想拿到结果文件,推荐 Release 构建 + 默认采样密度起步,之后再根据效果微调。快去把你手头的 .glb 模型转成 3DGS 试试吧!🎉

