From Image to STL: The Basics（从图像到 STL：入门 · 上手练习）

From Image to STL: The Basics (Hands-on Workshop) - User Manual

Dragonfly Prototype Apps · From Image to STL: The Basics...

版本 Version 1.0 · 2026-07-26

第一部分 中文手册

目录

1. 简介

2. 完整流程（四步）

3. 五个标签页

4. 两大设计特点

5. 使用步骤

6. 环境需求

1. 简介

From Image to STL: The Basics（从图像到 STL：入门） 是一个面向最初级用户的上手练习项目，带你把最基础、最常用的完整流程从概念到动手完整跑通：从一张三维图像，一步步得到一个可 3D 打印的 STL 模型。

本功能由第三方（Prototype Labs / Prototype Apps）提供，非 Dragonfly 官方开发或支持，使用风险自负。证书页生成的完成证书亦非官方认证，仅供个人记录。

2. 完整流程（四步）

3. 五个标签页

1. 概念 —— 完整流程、像素/体素、灰度值、分辨率与单位。

2. 加载图像 —— 一键生成球/圆柱/带孔立方体/哑铃等简单示例图像，或选用一个已加载的 Channel。

3. 阈值分割 → ROI —— 手动设范围，或 Otsu 自动阈值；创建并显示真实的 Dragonfly ROI。

4. ROI → 网格 —— marching cubes 生成三角表面网格，并发布为 Dragonfly 网格对象。

5. 导出 STL —— 用 trimesh 写出 .stl 文件（可选二进制/ASCII）。

4. 两大设计特点

• 既能一键完成，也教你手工操作：每一步都有“▶ 操作按钮”真的帮你完成，同时有“🖱 在 Dragonfly 界面里怎么做”弹窗，手把手教你不用插件、纯手工在 Dragonfly 里完成同样的操作（菜单路径、面板、右键项）。
• 尽可能多的概念弹窗：分割、阈值、Otsu、直方图、ROI、表面网格、marching cubes、体素级 vs 亚体素、STL、ASCII vs 二进制、单位陷阱等，每个都有一个简短易懂的“📖 讲解”弹窗。

5. 使用步骤

1. 在“加载图像”页点“生成示例图像”（或选一个 Channel）。

2. 在“阈值分割”页点“Otsu 自动阈值”（或手动设上下限）生成 ROI。

3. 在“ROI → 网格”页点“转换成表面网格”。

4. 在“导出 STL”页点“导出 STL…”，选择文件位置保存。

5. 完成后在“证书”页填写姓名生成完成证书。

6. 环境需求

无需安装、无需联网、无需 GPU、无需虚拟环境。核心动手环节用 Dragonfly 自带的 numpy/scikit-image/trimesh 在进程内运行（阈值用 getAsROIWithinRange 生成真实 ROI，marching cubes 生成网格，trimesh 写 STL）。导出 STL/OBJ/PLY 各版本均可。

Part II English Manual

Contents

1. Introduction

2. The whole pipeline (4 steps)

3. The five tabs

4. Two design features

5. How to use

6. Requirements

1. Introduction

From Image to STL: The Basics is a hands-on project for absolute beginners that teaches and runs the most basic, most common complete workflow end to end: from a single 3D image, step by step, to a 3D-printable STL model.

This feature is provided by a third party (Prototype Labs / Apps), not officially developed or supported by Dragonfly. The completion certificate is also unofficial — for personal record only.

2. The whole pipeline (4 steps)

3. The five tabs

1. Concepts — the pipeline, pixels/voxels, grey values, resolution & units.

2. Load image — one-click sample image (ball/cylinder/cube-with-hole/dumbbell), or use a loaded Channel.

3. Threshold → ROI — manual range or Otsu auto-threshold; creates and shows a real Dragonfly ROI.

4. ROI → Mesh — marching cubes builds a triangular surface mesh, published as a Dragonfly mesh.

5. Export STL — trimesh writes the .stl file (binary or ASCII).

4. Two design features

• One-click AND learn-by-hand: every step has a '▶ action button' that actually does it, plus a '🖱 How to do this in the Dragonfly GUI' pop-up that walks you through doing the same thing by hand in Dragonfly (menu paths, panels, right-click items).
• As many concept pop-ups as possible: segmentation, threshold, Otsu, histogram, ROI, surface mesh, marching cubes, voxel-level vs sub-voxel, STL, ASCII vs binary, units pitfalls — each has a short, beginner-friendly '📖 Learn' pop-up.

5. How to use

1. On 'Load image' click 'Create a sample image' (or pick a Channel).

2. On 'Threshold' click 'Otsu auto-threshold' (or set low/high by hand) to make a ROI.

3. On 'ROI → Mesh' click 'Convert ROI to a surface mesh'.

4. On 'Export STL' click 'Export STL…' and choose where to save.

5. Finish on the 'Certificate' tab by entering your name to generate a completion certificate.

6. Requirements

No install, no internet, no GPU, no venv. The core actions run in-process on Dragonfly's own numpy/scikit-image/trimesh (thresholding makes a real ROI via getAsROIWithinRange, marching cubes builds the mesh, trimesh writes the STL). STL/OBJ/PLY export works on all versions.