Formalize camera post-process frame contract

This commit is contained in:
2026-04-06 03:55:06 +08:00
parent 5e489b61d2
commit 31d14abece
4 changed files with 345 additions and 29 deletions

View File

@@ -85,7 +85,8 @@ bool ExecuteScenePassRequest(
const RenderPassContext passContext = {
context,
request.surface,
sceneData
sceneData,
nullptr
};
return pass->Execute(passContext);
}
@@ -106,7 +107,8 @@ bool ExecuteStandalonePass(
const RenderPassContext passContext = {
context,
surface,
sceneData
sceneData,
nullptr
};
return pass->Execute(passContext);
}
@@ -158,6 +160,8 @@ struct CameraFrameExecutionState {
RenderPass* depthOnlyPass = nullptr;
RenderPass* shadowCasterPass = nullptr;
std::unique_ptr<ScopedInitializedPassSequence> preScenePasses;
std::unique_ptr<ScopedInitializedPassSequence> postProcessPasses;
std::unique_ptr<ScopedInitializedPassSequence> finalOutputPasses;
std::unique_ptr<ScopedInitializedPassSequence> postScenePasses;
std::unique_ptr<ScopedInitializedPassSequence> overlayPasses;
};
@@ -171,12 +175,27 @@ bool ExecutePassSequenceStage(
return activeSequence->IsReady() && activeSequence->Execute(passContext);
}
RenderPassContext BuildFrameStagePassContext(
CameraFrameStage stage,
const CameraRenderRequest& request,
const RenderSceneData& sceneData) {
const RenderSurface* outputSurface = request.GetOutputSurface(stage);
return {
request.context,
outputSurface != nullptr ? *outputSurface : request.surface,
sceneData,
request.GetSourceSurface(stage)
};
}
bool ExecuteFrameStage(
CameraFrameStage stage,
const CameraRenderRequest& request,
const ShadowCasterRenderRequest& resolvedShadowCaster,
const RenderPassContext& passContext,
const RenderSceneData& sceneData,
CameraFrameExecutionState& executionState) {
const RenderPassContext passContext = BuildFrameStagePassContext(stage, request, sceneData);
switch (stage) {
case CameraFrameStage::PreScenePasses:
return ExecutePassSequenceStage(
@@ -189,23 +208,35 @@ bool ExecuteFrameStage(
executionState.shadowCasterPass,
resolvedShadowCaster,
request.context,
passContext.sceneData);
sceneData);
case CameraFrameStage::DepthOnly:
return ExecuteScenePassRequest(
executionState.depthOnlyPass,
request.depthOnly,
request.context,
passContext.sceneData);
sceneData);
case CameraFrameStage::MainScene:
return executionState.pipeline != nullptr &&
executionState.pipeline->Render(request.context, request.surface, passContext.sceneData);
executionState.pipeline->Render(request.context, passContext.surface, sceneData);
case CameraFrameStage::PostProcess:
return ExecutePassSequenceStage(
executionState.postProcessPasses,
request.GetPassSequence(stage),
request.context,
passContext);
case CameraFrameStage::FinalOutput:
return ExecutePassSequenceStage(
executionState.finalOutputPasses,
request.GetPassSequence(stage),
request.context,
passContext);
case CameraFrameStage::ObjectId:
return !request.objectId.IsRequested() ||
ExecuteStandalonePass(
executionState.objectIdPass,
request.context,
request.objectId.surface,
passContext.sceneData);
sceneData);
case CameraFrameStage::PostScenePasses:
return ExecutePassSequenceStage(
executionState.postScenePasses,
@@ -244,8 +275,9 @@ RenderDirectionalShadowData BuildDirectionalShadowData(
RenderEnvironmentData BuildEnvironmentData(const CameraRenderRequest& request) {
RenderEnvironmentData environment = {};
const RenderSurface& mainSceneSurface = request.GetMainSceneSurface();
if (request.camera == nullptr ||
request.surface.GetDepthAttachment() == nullptr ||
mainSceneSurface.GetDepthAttachment() == nullptr ||
!HasRenderClearFlag(request.clearFlags, RenderClearFlags::Color) ||
!request.camera->IsSkyboxEnabled() ||
request.camera->GetProjectionType() != Components::CameraProjectionType::Perspective) {
@@ -416,11 +448,12 @@ bool CameraRenderer::BuildSceneDataForRequest(
const CameraRenderRequest& request,
RHI::RHIResourceView* shadowMapView,
RenderSceneData& outSceneData) {
const RenderSurface& mainSceneSurface = request.GetMainSceneSurface();
outSceneData = m_sceneExtractor.ExtractForCamera(
*request.scene,
*request.camera,
request.surface.GetRenderAreaWidth(),
request.surface.GetRenderAreaHeight());
mainSceneSurface.GetRenderAreaWidth(),
mainSceneSurface.GetRenderAreaHeight());
if (!outSceneData.HasCamera()) {
return false;
}
@@ -443,11 +476,6 @@ bool CameraRenderer::ExecuteRenderPlan(
const CameraRenderRequest& request,
const ShadowCasterRenderRequest& resolvedShadowCaster,
const RenderSceneData& sceneData) {
const RenderPassContext passContext = {
request.context,
request.surface,
sceneData
};
CameraFrameExecutionState executionState = {};
executionState.pipeline = m_pipeline.get();
executionState.objectIdPass = m_objectIdPass.get();
@@ -464,7 +492,7 @@ bool CameraRenderer::ExecuteRenderPlan(
stageInfo.stage,
request,
resolvedShadowCaster,
passContext,
sceneData,
executionState)) {
return false;
}
@@ -479,14 +507,23 @@ bool CameraRenderer::Render(
return false;
}
if (request.surface.GetRenderAreaWidth() == 0 ||
request.surface.GetRenderAreaHeight() == 0) {
const RenderSurface& mainSceneSurface = request.GetMainSceneSurface();
if (mainSceneSurface.GetRenderAreaWidth() == 0 ||
mainSceneSurface.GetRenderAreaHeight() == 0) {
return false;
}
if (request.depthOnly.IsRequested() &&
!request.depthOnly.IsValid()) {
return false;
}
if (request.postProcess.IsRequested() &&
!request.postProcess.IsValid()) {
return false;
}
if (request.finalOutput.IsRequested() &&
!request.finalOutput.IsValid()) {
return false;
}
if (request.objectId.IsRequested() &&
!request.objectId.IsValid()) {
return false;