XCEngine/docs/api/XCEngine/Rendering/FrameData/VisibleRenderItem/VisibleRenderItem.md

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
• RenderSceneData
• RenderSceneUtility