随机颜色显示 · Random Preview
将不同分支的几何物件按不同的随机颜色显示
📖 功能概述
输入一个树形结构（DataTree）的几何物件，组件会为每个分支分配一种独立的随机颜色进行视口显示。每个分支之间的颜色相互区分，同分支内的物件颜色一致。
这是一个纯显示组件，帮助你快速区分不同分组的几何元素——非常适合在复杂的图面中按类别着色查看。
💡 什么时候用？当你有一个按分支组织的几何树，想快速查看哪些元件属于同一分支组时，连进这个组件就能一目了然。如不同楼层、不同建筑构件按组着色。
📥 输入参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 物件列表 (G) | Geometry | 必需 | 树形结构（DataTree）的几何物件，每个分支会获得不同的颜色（此端口默认隐藏）。 |
| 随机种子 (S) | Integer | 可选 | 控制颜色生成的随机种子，相同种子产生相同颜色序列。默认 15。 |
| 透明度 (T) | Number | 可选 | 显示透明度，取值范围 0~1。0 为不透明，1 为全透明。默认 0。 |
🧩 典型使用场景
- 按类着色 — 按 DataTree 的分支结构为不同类别的几何体赋予不同颜色
- 楼层区分 — 将按楼层组织的几何树可视化，每个楼层一种颜色
- 分组展示 — 在汇报时用不同颜色区分设计分区
- 材质示意 — 为不同面域赋予示意颜色，预览整体设计效果
📤 输出参数
| 名称 | 类型 | 说明 |
|---|---|---|
| 此组件无输出端口 | ||
⚠️ 注意事项
- 输入端口（G）默认隐藏，需要在组件属性中设置显示。
- 颜色按 分支 分配，而非按单个物件——同一分支内的所有物件颜色相同。
- 透明度参数控制显示材质的透明度，取值 0~1。
- 随机种子决定了颜色序列，固定种子每次运行结果一致。
📋 组件信息
| 名称 | 随机颜色显示 |
| 英文名 | Random Preview (RP) |
| 分类 | LK → Display |
| 基类 | GH_Component |
| GUID | 0CC35E73-2A10-4D16-A43F-5101CDA8DB2C |