Create Synthetic CAD Models（创建合成 CAD 模型 · STEP）
Create Synthetic CAD Models (STEP) - User Manual
Dragonfly Prototype Apps · Create Synthetic CAD Models (STEP)...
版本 Version 1.0 · 2026-07-26
第一部分 中文手册
目录
1. 简介
2. 支持的形状
3. 使用步骤
4. 环境需求
5. 提示
1. 简介
Create Synthetic CAD Models (STEP) 从多种预设的参数化形状/设计中生成真实的 CAD 实体，并保存为 STEP 文件；在 Dragonfly 2027.1 及以上版本中还可一键把 STEP 作为网格（Mesh）加载到当前场景。
几何由开源库 cadquery（OpenCASCADE / cadquery-ocp，Apache-2.0）生成，运行在插件专用的虚拟环境（venv）子进程中，不会影响 Dragonfly 自身的 Python。所有尺寸单位为毫米（mm）。
本功能由第三方（Prototype Labs / Prototype Apps）提供，非 Dragonfly 官方开发或支持，使用风险自负。
2. 支持的形状
形状按三组组织，可在下拉框中选择：
- 基本体（Primitives）：长方体、圆柱、球、圆锥/圆台、圆环、四棱锥、楔形。
- 机械零件（Mechanical Parts）：六角螺栓、六角螺母、垫圈、正齿轮、L 形支架、螺栓圆法兰、管件。
- 测试标定件（Test Artifacts）：孔阵列板（CAD 孔隙率假体）、阶梯规、球-柱标定件（CT）、多孔立方体、圆角/倒角块。
选择形状后，右侧会自动列出该形状的参数（如长/宽/高、半径、齿数、孔径等），可逐一调整。
3. 使用步骤
1. 从下拉框选择一个形状/设计，并设置其参数。
2. 在“Output”中确认或用“Browse…”选择 STEP 保存文件夹。
3. 首次使用：点击一次“⚙ 设置环境”，构建 cadquery 虚拟环境（需联网，约数百 MB）。
4. 点击“创建 CAD 模型并保存 STEP 文件”，稍候即可在所选文件夹得到 <形状>_<时间戳>.step。
5. （可选）点击“加载到 Dragonfly”，把刚生成的 STEP 作为网格导入当前场景。
4. 环境需求
首次点击“设置环境”会用 Dragonfly 自带 Python 在 %LOCALAPPDATA%\DragonflyPrototypeLabs\CreateSyntheticCAD\venv（较短路径，以规避 Windows 路径长度限制）构建 venv，并安装 cadquery + numpy。之后生成不再需要联网，也无需 GPU。
“加载到 Dragonfly”仅在 Dragonfly 2027.1 及以上版本可用（更早版本没有 STEP 导入）。在旧版本中该按钮会被禁用并给出提示；STEP 文件仍可正常生成、供其它软件使用。
5. 提示
- STEP 是 B-rep（精确边界表示）实体；加载到 Dragonfly 时会经 OpenCASCADE 三角化为网格（
MeshHelper.importSTEPFile）。 - 生成的 STEP 也可直接用于网格划分、有限元/CFD 仿真、逆向、或作为算法测试的标准件。
Part II English Manual
Contents
1. Introduction
2. Available shapes
3. How to use
4. Requirements
5. Tips
1. Introduction
Create Synthetic CAD Models (STEP) builds real CAD solids from a menu of preset parametric shapes/designs and writes them as STEP files. On Dragonfly 2027.1+, it can also load a STEP into the current scene as a Mesh with one click.
Geometry is built with the open-source cadquery library (OpenCASCADE / cadquery-ocp, Apache-2.0), running in the plugin's dedicated venv as a subprocess so it never touches Dragonfly's own Python. All dimensions are in millimetres (mm).
This feature is provided by a third party (Prototype Labs / Apps), not officially developed or supported by Dragonfly. Use at your own risk.
2. Available shapes
Shapes are organised into three groups in the dropdown:
- Primitives: box, cylinder, sphere, cone/frustum, torus, square pyramid, wedge.
- Mechanical Parts: hex bolt, hex nut, washer, spur gear, L-bracket, bolt-circle flange, pipe.
- Test Artifacts: hole-array plate (CAD porosity phantom), step gauge, sphere-on-stem (CT), perforated cube, fillet/chamfer block.
Selecting a shape lists its parameters (length/width/height, radius, tooth count, hole diameter, …) for you to edit.
3. How to use
1. Pick a shape/design from the dropdown and set its parameters.
2. Confirm the STEP output folder under 'Output' (or 'Browse…').
3. First time only: click '⚙ Setup Environment' once to build the cadquery venv (needs internet, a few hundred MB).
4. Click 'Create CAD Model and Save STEP File' — a <shape>_<timestamp>.step appears in the chosen folder.
5. (Optional) Click 'Load to Dragonfly' to import the STEP you just created as a Mesh.
4. Requirements
The first 'Setup Environment' builds a venv at %LOCALAPPDATA%\DragonflyPrototypeLabs\CreateSyntheticCAD\venv (a short path, to keep OpenCASCADE DLLs under the Windows MAX_PATH limit) from Dragonfly's own Python and installs cadquery + numpy. After that, generation needs no internet and no GPU.
'Load to Dragonfly' works only on Dragonfly 2027.1+ (older versions have no STEP import). On older versions the button is disabled with a tooltip; the STEP file is still produced for use in other software.
5. Tips
- STEP is a B-rep (exact boundary) solid; loading into Dragonfly triangulates it into a Mesh via OpenCASCADE (
MeshHelper.importSTEPFile). - The STEP files are also ready for downstream meshing, FE/CFD simulation, reverse engineering, or as standard parts for algorithm testing.