XCEngine/docs/api/XCEngine/Rendering/CameraRenderRequest/IsValid.md

CameraRenderRequest::IsValid

命名空间: XCEngine::Rendering

类型: method

头文件: XCEngine/Rendering/CameraRenderRequest.h

签名

bool IsValid() const

作用

检查当前请求是否满足进入 CameraRenderer 主流程的最小前提。

当前实现行为

按头文件内联实现，当前只检查三件事：

return scene != nullptr &&
       camera != nullptr &&
       context.IsValid();

这意味着

• surface 不参与这里的校验。
• objectId 的完整性也不在这里检查。
• cameraDepth、cameraStackOrder、clearFlags 和 clear color override 都不会影响这里的结果。

因此它只是“最小可进入渲染器”的校验，而不是“这次请求一定能完整跑通”的保证。

与 CameraRenderer::Render() 的关系

CameraRenderer::Render() 在调用这个方法之后，还会继续检查：

• surface.GetRenderAreaWidth() / GetRenderAreaHeight() 是否大于 0
• objectId.IsRequested() 时 objectId.IsValid() 是否为真

返回值

• 返回 true：scene、camera 非空，且 context 通过校验。
• 返回 false：至少有一个最小前提不满足。

相关文档

• CameraRenderRequest
• CameraRenderer::Render