Mesh2Splat快速上手指南:Windows与Linux双平台构建运行零踩坑

原创2026-10-22 11:44:271,417 阅读

Mesh2Splat快速上手指南:Windows与Linux双平台构建运行零踩坑

Mesh2Splat 是一款开源的 3D mesh(网格)转 3DGS(3D Gaussian Splatting,3D高斯泼溅) 转换工具,能把 .glb 格式的 3D 模型在 毫秒级(平均 <0.5ms) 直接转换成 3D 高斯泼溅模型,并自带 3DGS 渲染器实时预览结果。本文将带你完成 Windows 与 Linux 双平台的构建、运行与界面操作,新手照着做即可零踩坑 🚀。

快速了解:Mesh2Splat 能做什么?

传统做法要把一个 3D 模型变成 3DGS,需要先生成虚拟相机位姿、渲染图像集和稀疏点云,再喂给 3DGS 训练管线,往往耗时数分钟。Mesh2Splat 则直接利用模型的几何、材质和贴图信息,借助光栅化器的插值器完成转换,速度提升几个数量级。

Mesh2Splat 网格转 3DGS 高斯泼溅转换演示

主要特性一览:

特性 说明
直接处理 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 步走:

  1. 选文件:点击左上角 File Selector 窗口的 Select file to load (.glb / .ply),支持 .glb(用于转换)和 .ply(加载已有 3DGS 查看);
  2. 调参数:在 Properties 窗口拖动 Sampling density 滑杆调节采样密度(即转换质量),数值越高高斯数量越多;还可以勾选 Enable mesh-gaussian depth test 用网格做遮挡提升渲染性能;
  3. 点转换:回到 File Selector 点击绿色的 Convert Mesh to 3DGS,转换在毫秒级完成,可开启 Split-Screen 左右对比 Mesh 与 Splat 效果;
  4. 导出结果:选好输出文件夹(Select output folder)、输入文件名后,点击 Save splat 导出。

内置渲染器支持 albedo、法线、深度、几何、overdraw 等多种可视化模式,还能启用点光源 + PBR 阴影查看重打光效果:

Mesh2Splat 3DGS 渲染器 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 试试吧!🎉

登录后查看全文
mesh2splat