Repolode
VoxelKei

VoxelKei/SplatThumb

Windows 资源管理器缩略图扩展,无需打开即可预览 3D 高斯泼溅 PLY 文件和 Spatialograph Maker 项目。

Star
48
Fork
4
未关闭 Issue
0
最近提交
3天前

这是什么?

SplatThumb 为 Windows 资源管理器中的 3D 高斯泼溅 .ply 文件生成缩略图。它从文件头识别泼溅场景,支持标准 INRIA 格式和 PlayCanvas / SuperSplat 压缩 PLY;网格和点云则交给 Windows 默认处理。程序只读取文件,不联网,也不收集遥测数据。

用户可以通过右键菜单,像转动转盘一样调整单个文件的视角。视角保存在用户配置中,并按文件内容识别,不会写入原文件。大场景会按全局或单文件设置抽样为 5 万到 40 万个泼溅点,以保持缩略图速度。超过 3 秒无法生成时,回退为系统默认图标。

项目还能显示 Spatialograph Maker(.spgm)工程文件中保存的预览图。它是仅适用于 Windows 的 C++ 项目,提供按用户安装的 MSI 安装包,并附带用于检查文件分类和渲染 PNG 预览的命令行工具。

核心功能

  • 01为标准 INRIA 和 PlayCanvas / SuperSplat 压缩 PLY 文件生成缩略图。
  • 02可在小窗口中旋转模型,为每个文件单独选择视角。
  • 03大场景抽样为 5 万至 40 万个泼溅点,加快缩略图生成。
  • 04只读取文件,不联网,不收集遥测数据。
  • 05卸载时恢复之前已注册的缩略图处理程序。
  • 06显示 Spatialograph Maker .spgm 工程中保存的预览图。

适用场景

  • 在资源管理器中浏览 3D 高斯泼溅训练结果文件夹,快速找到目标场景。
  • 打开文件前先确认其中是哪个泼溅场景。
  • 无需启动编辑器即可预览 Spatialograph Maker 工程。

快速上手

  1. 1

    从发布页面下载 SplatThumb 的 MSI 安装包

  2. 2

    运行 MSI 安装程序(仅为当前用户安装,无需管理员权限)

  3. 3

    若要从源码构建,请在仓库文件夹中的 VS 2022 开发者 PowerShell 里运行

    cmake --workflow --preset msvc-debug

使用前须知

  • 仅支持 Windows 10/11 x64。
  • 当前为 v0.4 预览版,安装程序尚未进行代码签名,SmartScreen 可能会发出警告。
  • 仅标准格式和 PlayCanvas/SuperSplat 压缩 PLY 文件会生成溅射缩略图;.spz、.splat、.sog 等格式不受支持。

收录于专题

标签

#3d-gaussian-splatting#windows#thumbnails#shell-extension#ply#3d-visualization#3dgs#gaussian-splatting

常见问题

SplatThumb 是什么?
Windows 资源管理器缩略图扩展,无需打开即可预览 3D 高斯泼溅 PLY 文件和 Spatialograph Maker 项目。 SplatThumb 为 Windows 资源管理器中的 3D 高斯泼溅 .ply 文件生成缩略图。它从文件头识别泼溅场景,支持标准 INRIA 格式和 PlayCanvas / SuperSplat 压缩 PLY;网格和点云则交给 Windows 默认处理。程序只读取文件,不联网,也不收集遥测数据。
SplatThumb 可以免费使用吗?用的什么许可证?
SplatThumb 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
SplatThumb 还在维护吗?
活跃维护中。SplatThumb 最近一次提交是在 2026年11月4日。
SplatThumb 适合用来做什么?
在资源管理器中浏览 3D 高斯泼溅训练结果文件夹,快速找到目标场景。 打开文件前先确认其中是哪个泼溅场景。 无需启动编辑器即可预览 Spatialograph Maker 工程。
SplatThumb 怎么安装和运行?
从发布页面下载 SplatThumb 的 MSI 安装包 运行 MSI 安装程序(仅为当前用户安装,无需管理员权限) 若要从源码构建,请在仓库文件夹中的 VS 2022 开发者 PowerShell 里运行: cmake --workflow --preset msvc-debug
在哪里获取 SplatThumb?
源代码和安装说明在 GitHub 上:https://github.com/VoxelKei/SplatThumb

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目