把 Grasshopper 中的单个可烘焙物件写入当前 Rhino 文档，并可同时指定目标图层、图层颜色及成组的自定义键值信息。
功能概览
该组件用于把参数化结果转成 Rhino 文档中的真实对象。V1.0.8.1 可直接识别携带 LK 图层标签的图元：如果没有填写“图层”，组件会按标签创建或使用相应的 LK 子图层；如果明确填写了图层名称，则用户指定的图层始终优先。普通、未标记图元在没有显式图层时写入当前 Rhino 图层。
组件支持同时附加自定义信息。每个“键”按相同位置匹配一个“值”，数量必须完全一致。输入对象必须本身支持烘焙；不支持的对象会显示错误，而不会静默跳过。烘焙是会修改当前 Rhino 文档的操作，只有布尔输入为真或按下组件按钮时才执行。
适用场景
- 把计算完成的单个几何结果写入 Rhino，供人工编辑、保存或交付。
- 把带 LK 图层标签的出图图元自动烘焙到对应图层体系。
- 在烘焙对象上附加构件编号、分类或其他成对的自定义信息。
- 明确指定一个新图层及颜色，并让本次烘焙对象进入该图层。
工作流程
- 连接一个支持烘焙的物件；带 LK 图层标签的图元可以直接连接，无须先分解。
- 如需覆盖自动图层选择，填写有效图层名称；否则保持“图层”未连接。
- 如需附加信息，按相同顺序提供等量的“键”和“值”；不需要时两端都留空。
- 需要显式图层时设置其颜色；颜色只用于创建或取得该明确图层的流程。
- 将“烘焙”从假切换为真，或按下组件上的烘焙按钮，把对象写入当前 Rhino 文档。
输入
| 端口 | 是否必需 | 数据与结构 | 默认、匹配与误接说明 |
|---|---|---|---|
| 物件（G） | 必需 | 单个支持烘焙的 Grasshopper 物件，也可为携带 LK 图层标签的图元。 | 每次求解处理一项。图层标签只影响自动选层，实际写入的是其中的原始图元。不支持烘焙的数据会报错。 |
| 图层（L） | 可选 | 单个有效图层名称。 | 非空输入优先于图层标签。未输入时，有标签则使用对应 LK 图层；无标签则使用当前 Rhino 图层。无效名称会阻止本次烘焙。 |
| 键（K） | 可选 | 文本列表，每项是一个要附加到对象的信息名称。 | 按索引与“值”逐项匹配。未输入时可正常烘焙；键和值数量不一致时不执行。 |
| 值（V） | 可选 | 通用数据列表，与“键”列表一一对应。 | 每项按相同位置写给对应键。不要把不同长度的数据树误当作会自动扩展的键值表；本组件要求本次求解中的数量相等。 |
| 颜色（C） | 可选 | 单个颜色。 | 默认灰色，用于明确指定图层时的图层颜色。它不是逐对象显示颜色，也不会替代图层标签所对应图层的既有定义。 |
| 烘焙（B） | 可选 | 单个布尔值。 | 默认假；为真时执行写入。也可使用组件按钮触发。持续保持为真可能在后续重新求解时再次烘焙，应在完成后复位。 |
输出
| 端口 | 结果与结构 | 典型下游 |
|---|---|---|
| 无输出端 | 结果直接写入当前 Rhino 文档，而不是作为 Grasshopper 数据返回。 | 在 Rhino 中继续编辑、选择、分层管理、保存或导出烘焙后的对象。 |
实际示例
将一条已经标记为 LK 图层角色的轮廓曲线接入“物件”，保持“图层”为空；向“键”输入两个文本“构件编号”“状态”，向“值”输入“P-023”“已复核”，两边数量均为 2。把“烘焙”切换为真后，Rhino 文档中生成一条可编辑曲线，并自动进入该标签对应的 LK 子图层；对象同时带有这两项信息。随后在“图层”端填写“交付::轮廓”，再次触发烘焙，新对象将进入明确指定的图层，而不会继续使用原标签图层。若删去一个值但保留两个键，组件会报告数量不匹配，本次不会生成对象。
设置与交互
- 组件画布上的烘焙按钮与“烘焙”布尔输入都可以触发写入，两者不需要同时启用。
- 触发会修改当前 Rhino 文档；组件没有用于撤销、更新或替换既有烘焙对象的输出控制。
- 明确图层只对本次求解生效，并优先覆盖输入物件携带的图层标签。
配合使用
- 上游可连接图层图元组件，让几何携带 LK 图层角色，再由本组件自动完成图层选择。
- 需要手动控制图层时，直接提供图层文本和颜色，无须先移除物件原有标签。
- 键和值可由文本面板、列表或构件数据拆分结果提供，但必须在触发前保证数量一致。
- 烘焙完成后在 Rhino 图层面板中管理结果，或交给 Rhino 的保存与导出流程。
常见问题与限制
- 为什么没有生成对象？
- 检查是否真正触发了烘焙、输入是否支持烘焙，以及键和值数量是否相等。无效的明确图层名称也会中止操作。
- 为什么对象没有进入标签对应图层？
- 只要“图层”端存在非空有效名称，明确图层就具有更高优先级。清空该输入后才会采用图层标签。
- 没有填写图层且物件没有标签时会怎样？
- 对象进入当前 Rhino 图层，不会凭空推断其他分类。
- 为什么一次操作产生了重复对象？
- 烘焙是新增写入；布尔输入持续为真时，后续求解可能再次执行。完成后将其恢复为假，并避免重复按按钮。
- 颜色是否会变成对象颜色？
- 确认的用途是明确图层的颜色，不是对象级颜色。对象显示仍受 Rhino 图层和对象属性控制。