# VisibleRenderItem

**命名空间**: `XCEngine::Rendering`

**类型**: `struct`

**头文件**: `XCEngine/Rendering/FrameData/VisibleRenderItem.h`

**描述**: scene extraction 之后交给渲染阶段消费的一条可绘制项记录，已经带上材质槽位、section、render queue、相机距离和世界变换。

## 字段

| 字段 | 说明 |
|------|------|
| `gameObject` | 来源场景对象。 |
| `meshFilter` | 提供 mesh 引用的组件。 |
| `meshRenderer` | 提供材质与渲染状态的组件。 |
| `mesh` | 当前要绘制的 mesh。 |
| `material` | 当前解析出的材质指针，可为空。 |
| `materialIndex` | 当前材质槽位索引。 |
| `sectionIndex` | 当前 section 索引。 |
| `hasSection` | 当前项是否绑定到特定 section。 |
| `renderQueue` | 当前项的渲染队列。 |
| `cameraDistanceSq` | 到当前相机的距离平方。 |
| `localToWorld` | 当前项的世界变换。 |

## 当前语义

- 同一个 `GameObject` 可能展开成多个 `VisibleRenderItem`。
- opaque / transparent 的默认排序都会消费 `renderQueue` 与 `cameraDistanceSq`。
- 这个结构是当前正式名称；旧文档里的 `VisibleRenderObject` 应视为兼容历史命名。

## 相关文档

- [FrameData](../FrameData.md)
- [RenderSceneData](../RenderSceneData/RenderSceneData.md)
- [RenderSceneUtility](../../Extraction/RenderSceneUtility/RenderSceneUtility.md)