搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

siliconjungle/shapeshift-labs-ink-studio

多媒体与设计

面向像素风高斯泼溅的程序化创作工具,可雕刻 SDF 实体、烘焙场景并做动画、物理与无头渲染。

103
11
JavaScript
今天创建

项目介绍

Ink Studio 是一个基于 Node 的 JavaScript 工具包,用来创作像素风格的高斯泼溅场景。实体用有向距离场(SDF)描述,通过球、盒、旋转体等基本形体以及并集、切割、扭曲、材质等操作雕刻,再采样烘焙成带调色板外观的泼溅数据。在此之上,它提供动画、形变、粒子、物理、程序化环境生成和无头软件渲染器。产物是 PNG/APNG 图片和运行时世界数据;仓库不包含交互式编辑器,视口与界面需要宿主应用自己实现。

适合熟悉 JavaScript 或 JSON 场景描述、希望以程序化方式生成可复现像素动画的技术美术和开发者。内置 demo 与 lab 场景可以作为参考。

快速使用

需要 Node 18 或更高版本。从仓库检出目录开始,先查看命令和内置场景,再渲染一帧:

node cli/ink-studio.js help
node cli/ink-studio.js scenes
node cli/ink-studio.js render watcher --t 2.6 --colored

渲染结果默认写入 studio/out/。运行 npm test 可执行数值与像素测试。

该包是私有包,安装到其他项目时需要使用能读取仓库的凭据:

npm install github:siliconjungle/shapeshift-labs-ink-studio
npx ink-studio help
npx ink-studio render watcher --colored

自定义场景可以写成导出 { id, name, seed, build(seed) } 的 JavaScript 模块:build 中创建 builder 和 sculptor,添加实体,调用 S.bake(),再用 B.finish(...) 返回带相机参数的世界。完整示例见 examples/sculpt.js,渲染命令为:

npx ink-studio render model.js --colored

JSON 场景则通过 style 把材质角色映射到调色板,可用 CLI 校验和渲染。字段说明见首个场景教程和 JSON 场景章节。

创作模型与生命周期

世界需要按固定顺序构建:用种子和调色板创建 builder;在烘焙前安装骨架或形变标签;添加实体并烘焙;在 B.finish() 固定数据区间之前分配泼溅池;最后补相机参数并挂载 stage 或 puppet。静态景物应先于动态物体烘焙,避免烘焙进动态物体的空洞或阴影。烘焙后的世界用 Float32Array 存储,每个泼溅 16 个浮点数;修改数据时应优先使用工具包系统,以保持协方差、颜色和变更行跟踪一致。有状态的动画必须逐步向前推进,要回到更早时间需要重建世界。

主要能力

各层能力都可以从 CLI 或 JavaScript 使用:

  • 几何与材质: 球、盒、旋转体、管、岩石、植被,以及切割、并集等连接操作,扭曲和褶皱,调色板渐变材质,玻璃、毛发、蜡质等外观。
  • 动画: 骨架、分层 puppet、姿态片段、缓动、层、状态机、面部控制、动作片段和输入驱动的角色。
  • 粒子与交互: 粒子池、发射器、流场,以及通过 --poke 脚本化点击。
  • 模拟: 破碎与碎石、果冻与沙、物质点求解器、布料、毛发、绳索、基于体素的火/霜/生长,以及切咬后露出的内部泼溅。
  • 程序化内容: 散布与生长、晶体与洞穴形态、碎裂、侵蚀、装配式建筑、天气与鸟群。
  • 导入: 将 OBJ、glTF、GLB 网格转换为距离场实体并生成调色板渐变;不导入纹理图片。

模块划分见模块参考,可用 ink-studio catalog <words> 查找功能。

渲染与嵌入

CLI 提供无头渲染、帧序列图、多角度图、APNG 动画、叠影、统计、性能测量、运动检查和基线比对。渲染选项包括 --colored、--raw、--fine、--bounce、--focus、--follow、--clean,相机角度单位为弧度。渲染器会按场景的 detail 设置得到较低分辨率的像素网格,默认使用调色板量化和抖动。详见命令参考。

浏览器嵌入时,studio.bundle() 返回一个脚本字符串,在脚本作用域内定义创作 API,但不含 DOM 界面或 WebGL 视口。宿主需要自行提供渲染、输入处理和动画更新循环。CLI 使用的场景集合可通过 ink-studio.config.js 的 load 回调配置。

使用约束

  • 需要 Node 18+。包为私有,版本 0.1.0,许可证元数据为 UNLICENSED,未声明已发布到包仓库。
  • load() 会把拼接后的 bundle 编译缓存到 dist/standalone.js,首次使用和源码变更后需要包目录可写。
  • 不附带交互式视口或编辑器;软件渲染器供 CLI 使用,浏览器端渲染由集成方负责。
  • JSON 场景只支持已定义的实体、样式和动作子集,可用 validate 一次拿到全部诊断问题。
  • 动画片段旋转用角度,矩阵旋转和许多几何选项用弧度。
  • 仓库不附带视觉基线,需要用 snap 生成、用 check 比对。

HotRepo 点评

该项目在 2026-11-16 进入 HotRepo 新项目榜,七小时观察窗口内新增 103 Star 和 11 Fork,尚无全语言日榜名次记录。这些数字只反映早期短窗口,不能说明持续采用情况。技术上比较突出的是单一命令背后的覆盖面:SDF 雕刻、泼溅烘焙、无头渲染和模拟系统在同一套文档里,配有可运行示例和 171 项数值自检。实际限制在分发:包为私有且未声明开源许可证,按当前资料更适合以检出目录或有凭据的 Git 安装方式使用,而不是作为公开依赖。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。