XCEngine/docs/api/XCEngine/Rendering/Planning/SceneRenderRequestUtils/SceneRenderRequestUtils.md

SceneRenderRequestUtils

命名空间: XCEngine::Rendering::SceneRenderRequestUtils

类型: utility header

头文件: XCEngine/Rendering/Planning/SceneRenderRequestUtils.h

描述: request planning 规则库，统一相机可用性判断、稳定排序、clear flag 推导、render area 解析，以及基础 CameraRenderRequest 组装。

概览

SceneRenderRequestUtils 是 planning 层的规则收口点。

它当前提供的核心 helper 包括：

• IsUsableCamera(...)
• SortSceneCamerasForRendering(...)
• SortCameraRenderRequests(...)
• ResolveClearFlags(...)
• ResolveCameraRenderArea(...)
• BuildCameraRenderRequest(...)

当前规则重点

• 场景相机按 stackType -> depth 稳定排序。
• request 按 cameraStackOrder -> cameraDepth 稳定排序。
• CameraClearMode::Auto 不是固定值，而要结合 base/overlay 计数推导。
• normalized viewport 会叠加到父 RenderSurface::renderArea 上，而不是总以整张 surface 为基准。

相关文档

• Planning
• SceneRenderRequestPlanner
• CameraRenderRequest
• Camera Request Planning And Clear Rules