Online demo · 在线演示

sand3d 生成的模型,在浏览器里转一转

下面每个模型都是一段几百 token 的 sand3d 程序,在 Blender bpy 里跑出来的。 页面上的 3D 预览是构建时导出的 .glb(拖拽旋转、滚轮缩放、右键平移),旁边可以下载同一个模型的 五种工程格式与生成它的源码。

构建环境:sand3d 1.6.3(PyPI 最新版)· Python 3.13.15 · bpy 5.2.2 LTS · Windows 11 x86-64
工程格式:.glb.urdf.usda.obj.stl 同一份程序,五种导出,几何逐位一致(同一进程内两次运行 sha256 相同)

1 · 支架:一段最小的 sand3d 程序

拖拽旋转 · 滚轮缩放

一块 80 × 40 × 6 mm 的板,两个 Ø6.6 通孔按 50 mm 间距排布,顶面 1 mm 圆角——四行 sand3d:

import sand3d as s3d

plate = s3d.extrude("plate", s3d.rect(80, 40, r=4), 6)
s3d.hole(plate, 6.6, on=s3d.grid(2, 1, 50, 0))
s3d.fillet(plate, 1, edges="top")
s3d.export(plate, "out/bracket.glb")

完整脚本见 01_bracket.py:608 顶点 / 538 面,80.0 × 40.0 × 6.0 mm,导出后 24 KB。 两次独立进程运行得到的 bracket.glb sha256 完全相同,这是 sand3d 对每个动词的确定性承诺。

2 · 洗衣机:四个关节、五种导出

柜体、滚筒、带玻璃和把手的门、抽屉、旋钮,各自是命名零件;四个关节描述它们怎么动。 下面的开关切换导出的两个姿态(washer_closed.glb / washer_open.glb)。

拖拽旋转 · 滚轮缩放

URDF 需要同目录的 washer_open_meshes/*.obj;USDA 已内嵌网格,可单独拖进 USD Composer / Isaac Sim / Blender。

关节类型轴 / 范围
door_hingerevolute−Z · 0–143°
drum_spincontinuous滚筒轴
drawer_slideprismatic+X · 0–200 mm
dial_turncontinuous旋钮轴

打开姿态由 s3d.pose() 写在导出前:门 92°、抽屉 120 mm、旋钮 30°。

导出物实测内容
.glb96 KB · 13 节点 · 7 网格 · 5 材质,关节与姿态写在 extras.s3d_joint
.urdf3.2 KB · 5 link · 4 joint,门 −Z 0–2.49582083 rad、抽屉 0–0.2 m
.usda337 KB · 3 个 PhysicsRevoluteJoint + 1 个 PhysicsPrismaticJoint + ArticulationRootAPI
.obj1,483 顶点 · Y 向上(米)
.stl2,942 三角面 · Z 向上(二进制)

3 · 中文命名:名字一直跟到导出文件里

机柜 / 顶盖 / 合页 / 电控柜

用中文给零件命名,名字会原样写进 .glb 的节点、.urdf 的 link 和 .obj 的分组头:

格式名字
GLB机柜 顶盖 合页 电控柜
OBJ / URDF同上,UTF-8 原样保留
USDA___:USD 规范只允许 ASCII 标识符,非 ASCII 会被替换(不是 bug)

这一项顺带复现了 1.6.3 的一个真实缺陷:文本写出没有指定 encoding="utf-8",在 Windows 的 cp936 区域设置下,OBJ 头部的长破折号被写成单字节 A1 AA,整个文件不是合法 UTF-8。已在本地打补丁, main 分支也已经用 _core.text_file() 修掉。

这份演示是怎么部署上去的

项目值
站点https://s3d.ycgzs.com/(本文档站)· /demo/(本页)
服务器腾讯云 CentOS Stream 9 · nginx 1.20.1 · 站点根目录 /www/wwwroot/s3d.ycgzs.com
证书Let's Encrypt,certbot webroot 签发,HTTP 全量 301 到 HTTPS
模型构建本地 Windows:sand3d 1.6.3 + bpy 5.2.2,运行 run_all.ps1
前端预览@google/model-viewer 4.x,随站点自带(demo/vendor/),不依赖任何 CDN

页面除了 model-viewer 之外没有任何外部请求;GLB 也只有几十 KB,首屏一次就加载完。

下一步能做什么

文档站内容来自 github.com/Sandflow-ai/sand3d(Apache-2.0)· 静态站与演示页由部署脚本生成 · 返回 sand3d 文档