Online demo · 在线演示
下面每个模型都是一段几百 token 的 sand3d 程序,在 Blender bpy 里跑出来的。
页面上的 3D 预览是构建时导出的 .glb(拖拽旋转、滚轮缩放、右键平移),旁边可以下载同一个模型的
五种工程格式与生成它的源码。
一块 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 对每个动词的确定性承诺。
柜体、滚筒、带玻璃和把手的门、抽屉、旋钮,各自是命名零件;四个关节描述它们怎么动。
下面的开关切换导出的两个姿态(washer_closed.glb / washer_open.glb)。
URDF 需要同目录的 washer_open_meshes/*.obj;USDA 已内嵌网格,可单独拖进
USD Composer / Isaac Sim / Blender。
| 关节 | 类型 | 轴 / 范围 |
|---|---|---|
door_hinge | revolute | −Z · 0–143° |
drum_spin | continuous | 滚筒轴 |
drawer_slide | prismatic | +X · 0–200 mm |
dial_turn | continuous | 旋钮轴 |
打开姿态由 s3d.pose() 写在导出前:门 92°、抽屉 120 mm、旋钮 30°。
| 导出物 | 实测内容 |
|---|---|
.glb | 96 KB · 13 节点 · 7 网格 · 5 材质,关节与姿态写在 extras.s3d_joint |
.urdf | 3.2 KB · 5 link · 4 joint,门 −Z 0–2.49582083 rad、抽屉 0–0.2 m |
.usda | 337 KB · 3 个 PhysicsRevoluteJoint + 1 个 PhysicsPrismaticJoint + ArticulationRootAPI |
.obj | 1,483 顶点 · Y 向上(米) |
.stl | 2,942 三角面 · Z 向上(二进制) |
用中文给零件命名,名字会原样写进 .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,首屏一次就加载完。
sand3d 装到服务器上(Python 3.11 + Linux 版 bpy 4.5),做一个真正的在线沙盒:网页里写程序,服务端跑出 GLB 直接回传。main 分支已支持)接进 BIM 流程。