cobanov/pixelart-gaussiansplat
多媒体与设计在浏览器中把真实三维高斯泼溅渲染成像素画,支持代码编写场景和转换 glTF/GLB 模型。
项目简介
这个项目把通常呈柔和云雾状的高斯泼溅(Gaussian splats)渲染成可以旋转浏览的像素画立体场景。它由三部分组成:基于 three.js 和 Spark 的浏览器查看器、以 JavaScript 文件编写的场景,以及把普通 glTF/GLB 模型转成泼溅场景的转换器。适合希望获得像素风三维场景和动画模型展示、又不想自己搭建渲染管线的人。
像素效果来自绘制方式:每个泼溅以两倍于美术分辨率的硬边圆盘绘制,每个 2×2 区块按覆盖率归为一个美术像素;每个像素的颜色由样本投票选出最近的调色板色,轮廓像素取自身颜色的暗色。静态场景在构建时烘焙光照,转换来的动画模型则在 GPU 上逐帧打光。像素网格固定在屏幕上,因此缩放不会改变像素大小。各步骤和对应文件见工作原理文档。
快速使用
需要 Node 20.19 以上(22 系列需 22.12 以上)以及支持 WebGL 2 的浏览器。
git clone https://github.com/cobanov/pixelart-gaussiansplat
cd pixelart-gaussiansplat
npm install
npm run dev
打开 Vite 输出的地址。拖动旋转视角,滚轮缩放;左侧面板可切换内置示例,并调整像素大小、抖动、调色板、超采样和描边。
要编写自己的场景,编辑一个 JavaScript 场景文件——入门用的 hello.js 约 60 行——然后运行:
npm run scene hello
这会生成 public/models/hello.dio。场景 API 见场景制作指南。
要导入模型,先转换 glTF/GLB 文件,可选地把它放到主题岛上,再按名称打开:
npm run convert path/to/model.glb mymodel
npm run island mymodel ruins
打开 /?m=mymodel。带骨骼的模型会保留动画;海岛主题有 ruins、desert、swamp、crag、dais。详见导入模型指南。
使用约束
- 需要 WebGL 2 和较新的 Node 版本;场景编写在 Node 中运行,不在浏览器里。
- 内置的生物模型(minotaur、toad、vulture、hyena、dragon shield)来自游戏 Kervan,仅作示例,不在 MIT 许可范围内。仓库代码和生成的场景采用 MIT 许可(LICENSE)。
- 渲染依赖 Spark,转换器读取模型依赖 glTF Transform(致谢),若要改动这两层,需要在对应库的框架内工作。
HotRepo 点评
该项目在 2026-11-20 出现在 HotRepo 新项目榜,记录到 104 个 Star、约一小时窗口内净增 4 个 Star、8 个 Fork。观察窗口很短,也没有记录到 GitHub 日榜名次,因此这些数据只能说明当天有一些早期关注,不能据此判断趋势。真正有辨识度的是渲染思路:它没有对泼溅渲染结果做后处理,而是改变了泼溅的绘制方式并逐像素投票选调色板色,所以截图呈现的是平坦、带描边的像素场景,而不是模糊的点云。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- ooolabdev/ooosplat把视频或图片序列一键生成为 3D Gaussian Splat,并在本地预览、编辑和导出的桌面应用。
- siliconjungle/shapeshift-labs-ink-studio面向像素风高斯泼溅的程序化创作工具,可雕刻 SDF 实体、烘焙场景并做动画、物理与无头渲染。
- deepopen-com/deepopen-3d-webs用一张参考图与中文提示词生成可预览、可回放的三维场景,并导出高斯点云、彩色与深度动画。
- harry7557558/spirula-studio用一个原生二进制完成从照片或视频到 3D Gaussian Splatting 模型的训练,不依赖 Python、PyTorch 和 COLMAP。
- LibreSprite/LibreSprite面向像素画与逐帧动画制作的开源精灵编辑器,支持 Linux、Windows、macOS 和 Android。