位置：LK → Dim
功能概览
从 Rhino 文档拾取一个或多个文字对象，并以引用或复制方式带入 Grasshopper。数据会保存文字内容、平面、字高、旋转、水平与垂直对齐、字体、粗斜体、父标注样式和对象颜色，可用于预览、文件保存和烘焙。
只接受 Rhino 文字对象。尺寸标注、引线和注解点不会被当作普通文字；它们分别有自己的拾取组件。
逻辑流程图
适用场景
- 把 Rhino 工程图中的说明文字带入 GH 进行分析、复制排版或重新定位。
- 保留现有字体、字高、旋转与对齐，不把文字降级成普通字符串。
- 将文字及外观内置到 GH 文件中，便于交付、重开和烘焙恢复。
拾取流程
- 右键参数，选择拾取单个或多个文字。
- 在拾取过程的 Mode 选项中切换 Reference 或 Copy。
- 选择 Rhino 文字对象。取消选择时保留参数中已有数据。
- 引用模式保存对象身份并可重新读取变化；复制模式立即生成独立文字副本。
- 需要解除外部依赖时，使用 Grasshopper 的“内置数据”。
输入方式
| 方式 | 接受内容 | 行为 |
|---|---|---|
| 文档拾取 | Rhino 中一个或多个文字对象 | 可选择引用或复制；非文字注释被过滤，不进入结果。 |
| 连线输入 | 兼容的文字几何、Rhino 文字对象或对象引用 | 转换为独立文字副本；若来源带对象信息，同时保存对象颜色。 |
保存的文字信息
| 类别 | 包含内容 | 用途 |
|---|---|---|
| 内容与定位 | 最终文字、文字平面、旋转 | 确定文字显示内容和空间方向。 |
| 尺寸与对齐 | 字高、水平对齐、垂直对齐、标注比例 | 让预览和重新放置保持原排版关系。 |
| 字体与样式 | 字体名称、粗体、斜体、父标注样式 | 保存文字外观并支持 GH 文件重开。 |
| 对象颜色 | 从 Rhino 对象取得的颜色 | 烘焙时恢复为对象颜色；没有有效对象颜色时使用目标属性设置。 |
预览、保存与烘焙
- 视口只绘制文字线框，不生成额外曲线输出。
- 预览会把文字旋转合入文字平面；启用模型空间注释缩放时，显示高度会结合标注比例。
- GH 文件保存文字几何、父样式、对齐设置和颜色，重新打开后可以恢复。
- 烘焙会创建新的 Rhino 文字对象；若保存了对象颜色，会按对象颜色写入。
实际示例
拾取一段三行设备说明文字，原对象使用指定字体、35 mm 字高、右对齐并旋转 15°。引用模式下，修改 Rhino 原文字后重新读取即可同步；复制或内置后，文字保持当时内容和外观。烘焙到新文档时，会恢复文字几何、对齐、字体和保存的对象颜色。
常见问题与限制
- 注解点不是文字对象，请使用“拾取注解点”。尺寸标注也不会被当作普通文字。
- 引用对象被删除或当前 Rhino 文档中找不到它时，引用无法重新加载。
- 本参数保存的是可编辑文字，不会自动把文字炸成曲线；需要轮廓曲线时应使用专门的文字分解流程。
- 取消拾取不会清空参数原有数据。