关键字 · 建模
Sand3D 建模指南:用 Python 制作可修改的 3D 小物件
Sandflow 的 Sand3D 用 Python 描述零件、关节和装配。从安装、第一个支架、交给 AI 建模,到检查尺寸和导出。
影片介绍的项目是 Sandflow 的 Sand3D。这里把原片里提到的代码建模、可活动零件、模型导出和数据集入口整理成一套学习路线。先完成一个简单支架,再尝试门、抽屉等活动结构,会更容易确认尺寸和代码是否符合自己的想法。
01先认识项目和材料
Sand3D 用 Python 描述轮廓、实体、修改、位置、关节与装配,底层使用 Blender 的 bpy。零件以名称组织,方便回到代码中查找和调整。官网的交互示例可以旋转查看,并选择零件阅读相应程序。先打开官方入门页,看一次支架和洗衣机示例,确认这种工作方式适合你的目标。
开始前写下小物件的用途、长宽高、接触面与需要留出的空隙。比如桌面手机支架,要明确手机放置方向、底座宽度、支撑角度和充电线空间。把这些写成尺寸表,后续每次修改都能对照。选一个容易量度、零件少的练习对象,错误更容易定位。
02准备 Python 环境
- 第 1 步 · 核对系统与 Python:官方 README 建议 Python 3.13,也支持 3.11。bpy 的可用版本与 Python、操作系统及处理器架构有关,README 特别列出 Intel Mac 使用 Python 3.11 的情况。为练习建立独立项目目录和虚拟环境,记录系统、Python、sand3d 与 bpy 的版本。
- 第 2 步 · 在练习环境安装:在已启用的虚拟环境中运行 pip install sand3d;uv 项目可以用 uv add sand3d。安装后先测试能否 import sand3d as s3d。模块找不到时,核对安装和执行是否用同一个 Python;依赖装不上时,回到官方支持版本表核查。
03完成第一个模型
- 第 3 步 · 使用官方支架示例:打开官方 quickstart 的 A first program,取得完整示例。它用矩形轮廓、拉伸、孔和倒角组成一个支架,最后导出模型。先执行原始示例,确认生成了输出文件;再另存工作副本,只改宽度一个参数,重新执行并比较两次结果。
- 第 4 步 · 给 AI 一份明确的建模任务:向你已有的编程助手提供官方 API 链接、目标尺寸和输出文件格式。要求它先列出零件再写程序,把宽度、高度、孔径等放在容易修改的位置,零件分别命名。生成后逐段核对调用是否存在于官方 API,再在练习目录执行。额外模型服务的费用按你自己的设置和预算处理。
做一个桌面支架,底座宽度由参数控制,保留充电线开口,零件分别命名,先输出 GLB 预览;列出尺寸假设后再给完整 Python 文件。
这是可以按需要修改的任务模板。生成后的尺寸、结构强度和实际用途,仍要通过你的检查确认。
04检查尺寸、方向与活动结构
把预期长宽高记下来,在接收模型的软件里再次检查尺寸。旋转查看底部、背面和孔的位置,检查支撑面是否平稳、零件是否穿插。
活动结构需要分别描述零件和关节。原片展示的洗衣机示例有门、滚筒、抽屉及旋钮,官方程序提供对应的运动关系。学习时先选一个简单门铰链,分别检查静止位置、旋转轴和允许范围,再扩展到多个活动零件。给每个关节起清楚的名称。
05选择导出格式与验证成品
官方 export 接口根据文件扩展名选择格式。GLB 适合放到三维查看器中检查形状和材质,STL 常用于后续切片。其他格式保留零件、关节和材质的范围,查看官方 README 的导出表。先保留 Python 源文件和预览结果,再选择最终格式。
准备打印时,在切片软件里查看实际尺寸、摆放方向、薄壁、悬空区域与预计材料用量。先做一个小尺寸样件,测量孔径和装配间隙,再调整参数。用清楚的版本名保存每次测试结果。
06使用数据集和理解效果数字
官方 Hugging Face 集合提供相关数据集入口。下载前进入具体数据集卡片,核对许可证、文件大小、对象来源和使用说明,先取一个样例观察程序、模型和预览之间的对应关系。代码库许可证与各项模型素材的许可应分别阅读,发布或商用时把素材来源和必要署名一起保存。
影片提到的 token 节省数字来自项目的测量,官方测量页列出比较对象、方法与结果。你可以在同一尺寸要求下保存两份程序,分别记录提示、模型、token 用量和结果是否合格,再决定是否值得用到日常工作中。
07常见问题与练习验收
- 安装失败:记录 Python 与 bpy 版本,核对官方支持组合,再检查当前虚拟环境。
- 模型尺寸异常:核对毫米与米,以及接收软件的导入单位。
- AI 写出不存在的方法:回到官方 API 查签名,把具体报错和最小代码交给助手修改。
- 孔或倒角结果异常:先在简单几何上测试单个操作,再逐步组合。
- 关节方向异常:单独检查一个活动部件的轴、原点和范围。
用六项结果验收:项目目录保存源程序,环境版本有记录,最小模型能执行,至少一个参数修改后产生预期变化,预览软件显示的尺寸正确,最终导出可以被目标软件打开。完成后再加入材质、多个零件或数据集对象。
下一个好用的工具是什么?
每条视频都有一篇完整详情。关注 @serrini666,第一时间看到新分享。
