插入块 · Insert Block
在指定平面位置放置指定名称的图块实例
📖 功能概述
该组件用于在 Grasshopper 中根据块名称和放置平面创建图块实例。通过查找当前 Rhino 文档中的块定义，在指定位置生成 LKBlock 对象。
- 根据块名称自动查找 Rhino 文档中的块定义
- 支持在世界 XY 平面以外的任意平面放置图块
- 输出可直接用于 分解图块（ExplodeBlock）组件
📥 输入参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 名称 (N) | Text | 必需 | 块定义名称，需与 Rhino 文档中已存在的块定义名称完全一致 |
| 平面 (P) | Plane | 必需 | 块放置的目标平面，图块将从世界 XY 平面变换到该平面 |
📤 输出参数
| 名称 | 类型 | 说明 |
|---|---|---|
| 块 (B) | LKBlock | 放置后生成的图块实例，包含块定义引用和变换矩阵信息 |
🧠 工作流程
1
输入名称 + 平面
→
2
查找块定义
→
3
创建变换矩阵
→
4
生成 LKBlock
💡 变换逻辑：使用
Transform.PlaneToPlane 将块定义从世界 XY 平面变换到目标平面，实现任意位置和朝向的图块放置。
🧪 典型使用场景
- 批量放置图块 — 配合点阵和平面计算，在多个位置批量插入相同图块
- 幕墙单元布置 — 按规则网格在各面板位置放置标准图块
- 图块组合 — 先放置图块，再使用 分解图块 提取几何进行进一步处理
⚠️ 注意事项
- 块名称必须与 Rhino 文档中已存在的块定义完全匹配（区分大小写）
- 如果找不到匹配的块定义，组件会抛出警告信息并跳过处理
- 块定义需提前在 Rhino 中创建并保存到文档中，Grasshopper 运行时无法动态创建块定义
- 输出为自定义类型 LKBlock，可与 LK 系列其他 Block 组件配合使用
📋 组件信息
| 名称 | 插入块 |
| 英文名 | Insert Block |
| 分类 | LK → Block |
| 基类 | GH_Component |
| GUID | 147F2696-97BC-405A-ABDA-056022811AE6 |