XCEngine/engine/src/Rendering/Execution/CameraRenderer.cpp

#include "Rendering/Execution/CameraRenderer.h"

#include "Components/CameraComponent.h"
#include "Rendering/Caches/DirectionalShadowSurfaceCache.h"
#include "Rendering/Caches/FullscreenPassSurfaceCache.h"
#include "Rendering/Passes/BuiltinDepthOnlyPass.h"
#include "Rendering/Passes/BuiltinObjectIdPass.h"
#include "Rendering/Passes/BuiltinShadowCasterPass.h"
#include "Rendering/Pipelines/BuiltinForwardPipeline.h"
#include "Rendering/RenderPipelineAsset.h"
#include "Rendering/RenderSurface.h"
#include "RHI/RHIResourceView.h"
#include "Scene/Scene.h"

#include <algorithm>

namespace XCEngine {
namespace Rendering {

namespace {

std::shared_ptr<const RenderPipelineAsset> CreateDefaultPipelineAsset() {
    static const std::shared_ptr<const RenderPipelineAsset> s_defaultPipelineAsset =
        std::make_shared<Pipelines::BuiltinForwardPipelineAsset>();
    return s_defaultPipelineAsset;
}

std::unique_ptr<RenderPass> CreateDefaultDepthOnlyPass() {
    return std::make_unique<Passes::BuiltinDepthOnlyPass>();
}

std::unique_ptr<RenderPass> CreateDefaultShadowCasterPass() {
    return std::make_unique<Passes::BuiltinShadowCasterPass>();
}

std::unique_ptr<RenderPipeline> CreatePipelineFromAsset(
    const std::shared_ptr<const RenderPipelineAsset>& pipelineAsset) {
    if (pipelineAsset != nullptr) {
        std::unique_ptr<RenderPipeline> pipeline = pipelineAsset->CreatePipeline();
        if (pipeline != nullptr) {
            return pipeline;
        }
    }

    return std::make_unique<Pipelines::BuiltinForwardPipeline>();
}

Resources::ShaderKeywordSet BuildSceneGlobalShaderKeywords(
    const RenderSceneData& sceneData) {
    Resources::ShaderKeywordSet keywords = {};
    if (sceneData.lighting.HasMainDirectionalShadow()) {
        keywords.enabledKeywords.PushBack("XC_MAIN_LIGHT_SHADOWS");
    }

    Resources::NormalizeShaderKeywordSetInPlace(keywords);
    return keywords;
}

bool InitializeStandalonePass(
    RenderPass* pass,
    const RenderContext& context) {
    if (pass == nullptr) {
        return false;
    }

    if (pass->Initialize(context)) {
        return true;
    }

    pass->Shutdown();
    return false;
}

bool ExecuteScenePassRequest(
    RenderPass* pass,
    const ScenePassRenderRequest& request,
    const RenderContext& context,
    const RenderSceneData& baseSceneData) {
    if (!request.IsRequested()) {
        return true;
    }

    if (!InitializeStandalonePass(pass, context)) {
        return false;
    }

    RenderSceneData sceneData = baseSceneData;
    if (request.hasCameraDataOverride) {
        sceneData.cameraData = request.cameraDataOverride;
    }

    sceneData.cameraData.viewportWidth = request.surface.GetRenderAreaWidth();
    sceneData.cameraData.viewportHeight = request.surface.GetRenderAreaHeight();
    sceneData.cameraData.clearFlags = request.clearFlags;
    if (request.hasClearColorOverride) {
        sceneData.cameraData.clearColor = request.clearColorOverride;
    }

    const RenderPassContext passContext = {
        context,
        request.surface,
        sceneData,
        nullptr,
        nullptr,
        RHI::ResourceStates::Common
    };
    return pass->Execute(passContext);
}

bool ExecuteStandalonePass(
    RenderPass* pass,
    const RenderContext& context,
    const RenderSurface& surface,
    const RenderSceneData& sceneData) {
    if (pass == nullptr) {
        return false;
    }

    if (!InitializeStandalonePass(pass, context)) {
        return false;
    }

    const RenderPassContext passContext = {
        context,
        surface,
        sceneData,
        nullptr,
        nullptr,
        RHI::ResourceStates::Common
    };
    return pass->Execute(passContext);
}

class ScopedInitializedPassSequence {
public:
    ScopedInitializedPassSequence(
        RenderPassSequence* sequence,
        const RenderContext& context)
        : m_sequence(sequence) {
        if (m_sequence == nullptr) {
            return;
        }

        m_initialized = m_sequence->Initialize(context);
        if (!m_initialized) {
            m_failed = true;
            m_sequence->Shutdown();
            m_sequence = nullptr;
        }
    }

    ScopedInitializedPassSequence(const ScopedInitializedPassSequence&) = delete;
    ScopedInitializedPassSequence& operator=(const ScopedInitializedPassSequence&) = delete;

    ~ScopedInitializedPassSequence() {
        // Request-owned pass sequences may record GPU work that executes only after the
        // caller closes/submits the command list. Do not destroy sequence-owned GPU
        // resources here; the sequence owner must shut them down explicitly when the
        // sequence is no longer needed.
    }

    bool IsReady() const {
        return !m_failed;
    }

    bool Execute(const RenderPassContext& context) const {
        return m_sequence == nullptr || m_sequence->Execute(context);
    }

private:
    RenderPassSequence* m_sequence = nullptr;
    bool m_initialized = false;
    bool m_failed = false;
};

struct CameraFrameExecutionState {
    RenderPipeline* pipeline = nullptr;
    RenderPass* objectIdPass = nullptr;
    RenderPass* depthOnlyPass = nullptr;
    RenderPass* shadowCasterPass = nullptr;
    FullscreenPassSurfaceCache* postProcessSurfaceCache = nullptr;
    FullscreenPassSurfaceCache* finalOutputSurfaceCache = 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;
};

bool ExecutePassSequenceStage(
    std::unique_ptr<ScopedInitializedPassSequence>& activeSequence,
    RenderPassSequence* sequence,
    const RenderContext& context,
    const RenderPassContext& passContext) {
    activeSequence = std::make_unique<ScopedInitializedPassSequence>(sequence, context);
    return activeSequence->IsReady() && activeSequence->Execute(passContext);
}

void CopyIntermediateSurfaceLayout(
    const RenderSurface& templateSurface,
    RenderSurface& destinationSurface) {
    destinationSurface.SetSize(templateSurface.GetWidth(), templateSurface.GetHeight());
    if (templateSurface.HasCustomRenderArea()) {
        destinationSurface.SetRenderArea(templateSurface.GetRenderArea());
    } else {
        destinationSurface.ResetRenderArea();
    }

    destinationSurface.ClearClearColorOverride();
    destinationSurface.SetAutoTransitionEnabled(true);
}

bool ExecuteFullscreenPassSequenceStage(
    std::unique_ptr<ScopedInitializedPassSequence>& activeSequence,
    RenderPassSequence* sequence,
    const RenderContext& context,
    const RenderPassContext& passContext,
    FullscreenPassSurfaceCache* surfaceCache) {
    activeSequence = std::make_unique<ScopedInitializedPassSequence>(sequence, context);
    if (!activeSequence->IsReady()) {
        return false;
    }

    if (sequence == nullptr || sequence->GetPassCount() <= 1u) {
        return activeSequence->Execute(passContext);
    }

    if (surfaceCache == nullptr ||
        passContext.sourceSurface == nullptr ||
        passContext.sourceColorView == nullptr ||
        !HasValidColorTarget(passContext.surface)) {
        return false;
    }

    const std::vector<RHI::RHIResourceView*>& colorAttachments = passContext.surface.GetColorAttachments();
    const RHI::Format outputFormat = colorAttachments[0]->GetFormat();
    const size_t intermediateSurfaceCount = std::min<size_t>(2u, sequence->GetPassCount() - 1u);
    if (!surfaceCache->EnsureSurfaces(
            context,
            passContext.surface.GetWidth(),
            passContext.surface.GetHeight(),
            outputFormat,
            intermediateSurfaceCount)) {
        return false;
    }

    const RenderSurface* currentSourceSurface = passContext.sourceSurface;
    RHI::RHIResourceView* currentSourceColorView = passContext.sourceColorView;
    RHI::ResourceStates currentSourceColorState = passContext.sourceColorState;

    for (size_t passIndex = 0; passIndex < sequence->GetPassCount(); ++passIndex) {
        const bool isLastPass = (passIndex + 1u) == sequence->GetPassCount();
        const RenderSurface* outputSurface = &passContext.surface;
        FullscreenPassSurfaceCache::SurfaceEntry* intermediateEntry = nullptr;
        if (!isLastPass) {
            intermediateEntry = surfaceCache->GetSurfaceEntry(passIndex % intermediateSurfaceCount);
            if (intermediateEntry == nullptr) {
                return false;
            }

            CopyIntermediateSurfaceLayout(passContext.surface, intermediateEntry->surface);
            intermediateEntry->surface.SetColorStateBefore(intermediateEntry->currentColorState);
            intermediateEntry->surface.SetColorStateAfter(RHI::ResourceStates::PixelShaderResource);
            outputSurface = &intermediateEntry->surface;
        }

        const RenderPassContext chainedContext = {
            context,
            *outputSurface,
            passContext.sceneData,
            currentSourceSurface,
            currentSourceColorView,
            currentSourceColorState
        };
        if (!sequence->ExecutePass(passIndex, chainedContext)) {
            return false;
        }

        if (intermediateEntry != nullptr) {
            intermediateEntry->currentColorState = RHI::ResourceStates::PixelShaderResource;
            currentSourceSurface = &intermediateEntry->surface;
            currentSourceColorView = intermediateEntry->shaderResourceView;
            currentSourceColorState = intermediateEntry->currentColorState;
        }
    }

    return true;
}

RenderPassContext BuildFrameStagePassContext(
    CameraFrameStage stage,
    const CameraFramePlan& plan,
    const RenderSceneData& sceneData) {
    const RenderSurface* outputSurface = plan.GetOutputSurface(stage);
    return {
        plan.request.context,
        outputSurface != nullptr ? *outputSurface : plan.request.surface,
        sceneData,
        plan.GetSourceSurface(stage),
        plan.GetSourceColorView(stage),
        plan.GetSourceColorState(stage)
    };
}

bool ExecuteFrameStage(
    CameraFrameStage stage,
    const CameraFramePlan& plan,
    const ShadowCasterRenderRequest& resolvedShadowCaster,
    const RenderSceneData& sceneData,
    CameraFrameExecutionState& executionState) {
    const RenderPassContext passContext = BuildFrameStagePassContext(stage, plan, sceneData);

    switch (stage) {
    case CameraFrameStage::PreScenePasses:
        return ExecutePassSequenceStage(
            executionState.preScenePasses,
            plan.GetPassSequence(stage),
            plan.request.context,
            passContext);
    case CameraFrameStage::ShadowCaster:
        return ExecuteScenePassRequest(
            executionState.shadowCasterPass,
            resolvedShadowCaster,
            plan.request.context,
            sceneData);
    case CameraFrameStage::DepthOnly:
        return ExecuteScenePassRequest(
            executionState.depthOnlyPass,
            plan.request.depthOnly,
            plan.request.context,
            sceneData);
    case CameraFrameStage::MainScene:
        return executionState.pipeline != nullptr &&
               executionState.pipeline->Render(
                   FrameExecutionContext(
                       plan.request.context,
                       passContext.surface,
                       sceneData,
                       passContext.sourceSurface,
                       passContext.sourceColorView,
                       passContext.sourceColorState));
    case CameraFrameStage::PostProcess:
        return ExecuteFullscreenPassSequenceStage(
            executionState.postProcessPasses,
            plan.GetPassSequence(stage),
            plan.request.context,
            passContext,
            executionState.postProcessSurfaceCache);
    case CameraFrameStage::FinalOutput:
        return ExecuteFullscreenPassSequenceStage(
            executionState.finalOutputPasses,
            plan.GetPassSequence(stage),
            plan.request.context,
            passContext,
            executionState.finalOutputSurfaceCache);
    case CameraFrameStage::ObjectId:
        return !plan.request.objectId.IsRequested() ||
               ExecuteStandalonePass(
                   executionState.objectIdPass,
                   plan.request.context,
                   plan.request.objectId.surface,
                   sceneData);
    case CameraFrameStage::PostScenePasses:
        return ExecutePassSequenceStage(
            executionState.postScenePasses,
            plan.GetPassSequence(stage),
            plan.request.context,
            passContext);
    case CameraFrameStage::OverlayPasses:
        return ExecutePassSequenceStage(
            executionState.overlayPasses,
            plan.GetPassSequence(stage),
            plan.request.context,
            passContext);
    default:
        return false;
    }
}

RenderDirectionalShadowData BuildDirectionalShadowData(
    const DirectionalShadowRenderPlan& plan,
    RHI::RHIResourceView* shadowMapView) {
    RenderDirectionalShadowData shadowData = {};
    if (!plan.IsValid() || shadowMapView == nullptr) {
        return shadowData;
    }

    shadowData.enabled = true;
    shadowData.viewProjection = plan.cameraData.viewProjection;
    shadowData.shadowMap = shadowMapView;
    const float texelWorldSize = plan.texelWorldSize > Math::EPSILON
        ? plan.texelWorldSize
        : (plan.orthographicHalfExtent > Math::EPSILON && plan.mapWidth > 0u
            ? (plan.orthographicHalfExtent * 2.0f) / static_cast<float>(plan.mapWidth)
            : 0.0f);
    shadowData.mapMetrics.inverseMapSize = Math::Vector2(
        1.0f / static_cast<float>(plan.mapWidth),
        1.0f / static_cast<float>(plan.mapHeight));
    shadowData.mapMetrics.worldTexelSize = texelWorldSize;
    shadowData.sampling.enabled = 1.0f;
    shadowData.sampling.settings = plan.sampling;
    shadowData.casterBias.settings = plan.casterBias;
    return shadowData;
}

RenderEnvironmentData BuildEnvironmentData(const CameraFramePlan& plan) {
    RenderEnvironmentData environment = {};
    const RenderSurface& mainSceneSurface = plan.GetMainSceneSurface();
    if (plan.request.camera == nullptr ||
        mainSceneSurface.GetDepthAttachment() == nullptr ||
        !HasRenderClearFlag(plan.request.clearFlags, RenderClearFlags::Color) ||
        !plan.request.camera->IsSkyboxEnabled() ||
        plan.request.camera->GetProjectionType() != Components::CameraProjectionType::Perspective) {
        return environment;
    }

    if (const Resources::Material* skyboxMaterial = plan.request.camera->GetSkyboxMaterial()) {
        environment.mode = RenderEnvironmentMode::MaterialSkybox;
        environment.materialSkybox.material = skyboxMaterial;
        return environment;
    }

    environment.mode = RenderEnvironmentMode::ProceduralSkybox;
    environment.skybox.topColor = plan.request.camera->GetSkyboxTopColor();
    environment.skybox.horizonColor = plan.request.camera->GetSkyboxHorizonColor();
    environment.skybox.bottomColor = plan.request.camera->GetSkyboxBottomColor();
    return environment;
}

} // namespace

CameraRenderer::CameraRenderer()
    : CameraRenderer(CreateDefaultPipelineAsset()) {
}

CameraRenderer::CameraRenderer(std::unique_ptr<RenderPipeline> pipeline)
    : CameraRenderer(
        std::move(pipeline),
        std::make_unique<Passes::BuiltinObjectIdPass>(),
        CreateDefaultDepthOnlyPass(),
        CreateDefaultShadowCasterPass()) {
}

CameraRenderer::CameraRenderer(
    std::unique_ptr<RenderPipeline> pipeline,
    std::unique_ptr<RenderPass> objectIdPass,
    std::unique_ptr<RenderPass> depthOnlyPass,
    std::unique_ptr<RenderPass> shadowCasterPass)
    : m_pipelineAsset(nullptr)
    , m_objectIdPass(std::move(objectIdPass))
    , m_depthOnlyPass(std::move(depthOnlyPass))
    , m_shadowCasterPass(std::move(shadowCasterPass))
    , m_postProcessSurfaceCache(std::make_unique<FullscreenPassSurfaceCache>())
    , m_finalOutputSurfaceCache(std::make_unique<FullscreenPassSurfaceCache>()) {
    if (m_objectIdPass == nullptr) {
        m_objectIdPass = std::make_unique<Passes::BuiltinObjectIdPass>();
    }
    if (m_depthOnlyPass == nullptr) {
        m_depthOnlyPass = CreateDefaultDepthOnlyPass();
    }
    if (m_shadowCasterPass == nullptr) {
        m_shadowCasterPass = CreateDefaultShadowCasterPass();
    }
    ResetPipeline(std::move(pipeline));
}

CameraRenderer::CameraRenderer(std::shared_ptr<const RenderPipelineAsset> pipelineAsset)
    : m_pipelineAsset(std::move(pipelineAsset))
    , m_objectIdPass(std::make_unique<Passes::BuiltinObjectIdPass>())
    , m_depthOnlyPass(CreateDefaultDepthOnlyPass())
    , m_shadowCasterPass(CreateDefaultShadowCasterPass())
    , m_postProcessSurfaceCache(std::make_unique<FullscreenPassSurfaceCache>())
    , m_finalOutputSurfaceCache(std::make_unique<FullscreenPassSurfaceCache>()) {
    SetPipelineAsset(m_pipelineAsset);
}

CameraRenderer::~CameraRenderer() {
    if (m_pipeline) {
        m_pipeline->Shutdown();
    }
    if (m_objectIdPass != nullptr) {
        m_objectIdPass->Shutdown();
    }
    if (m_depthOnlyPass != nullptr) {
        m_depthOnlyPass->Shutdown();
    }
    if (m_shadowCasterPass != nullptr) {
        m_shadowCasterPass->Shutdown();
    }
}

void CameraRenderer::SetPipeline(std::unique_ptr<RenderPipeline> pipeline) {
    m_pipelineAsset.reset();
    ResetPipeline(std::move(pipeline));
}

void CameraRenderer::SetPipelineAsset(std::shared_ptr<const RenderPipelineAsset> pipelineAsset) {
    m_pipelineAsset = pipelineAsset != nullptr ? std::move(pipelineAsset) : CreateDefaultPipelineAsset();
    ResetPipeline(CreatePipelineFromAsset(m_pipelineAsset));
}

void CameraRenderer::SetObjectIdPass(std::unique_ptr<RenderPass> objectIdPass) {
    if (m_objectIdPass != nullptr) {
        m_objectIdPass->Shutdown();
    }

    m_objectIdPass = std::move(objectIdPass);
    if (m_objectIdPass == nullptr) {
        m_objectIdPass = std::make_unique<Passes::BuiltinObjectIdPass>();
    }
}

void CameraRenderer::SetDepthOnlyPass(std::unique_ptr<RenderPass> depthOnlyPass) {
    if (m_depthOnlyPass != nullptr) {
        m_depthOnlyPass->Shutdown();
    }

    m_depthOnlyPass = std::move(depthOnlyPass);
    if (m_depthOnlyPass == nullptr) {
        m_depthOnlyPass = CreateDefaultDepthOnlyPass();
    }
}

void CameraRenderer::SetShadowCasterPass(std::unique_ptr<RenderPass> shadowCasterPass) {
    if (m_shadowCasterPass != nullptr) {
        m_shadowCasterPass->Shutdown();
    }

    m_shadowCasterPass = std::move(shadowCasterPass);
    if (m_shadowCasterPass == nullptr) {
        m_shadowCasterPass = CreateDefaultShadowCasterPass();
    }
}

void CameraRenderer::ResetPipeline(std::unique_ptr<RenderPipeline> pipeline) {
    if (m_pipeline != nullptr) {
        m_pipeline->Shutdown();
    }

    m_pipeline = std::move(pipeline);
    if (m_pipeline == nullptr) {
        m_pipelineAsset = CreateDefaultPipelineAsset();
        m_pipeline = CreatePipelineFromAsset(m_pipelineAsset);
    }
}

bool CameraRenderer::ResolveShadowCasterRequest(
    const CameraFramePlan& plan,
    ShadowCasterRenderRequest& outResolvedShadowCaster,
    RHI::RHIResourceView*& outShadowMapView) {
    outResolvedShadowCaster = plan.shadowCaster;
    outShadowMapView = nullptr;

    if (outResolvedShadowCaster.IsRequested()) {
        return outResolvedShadowCaster.IsValid();
    }

    if (!plan.directionalShadow.IsValid()) {
        return true;
    }

    if (m_directionalShadowSurface == nullptr) {
        m_directionalShadowSurface = std::make_unique<DirectionalShadowSurfaceCache>();
    }

    if (!m_directionalShadowSurface->EnsureSurface(plan.request.context, plan.directionalShadow)) {
        return false;
    }

    outResolvedShadowCaster.surface = m_directionalShadowSurface->GetSurface();
    outResolvedShadowCaster.clearFlags = RenderClearFlags::Depth;
    if (!outResolvedShadowCaster.hasCameraDataOverride) {
        outResolvedShadowCaster.hasCameraDataOverride = true;
        outResolvedShadowCaster.cameraDataOverride = plan.directionalShadow.cameraData;
    }

    outShadowMapView = m_directionalShadowSurface->GetDepthShaderView();
    return true;
}

bool CameraRenderer::BuildSceneDataForPlan(
    const CameraFramePlan& plan,
    RHI::RHIResourceView* shadowMapView,
    RenderSceneData& outSceneData) {
    const RenderSurface& mainSceneSurface = plan.GetMainSceneSurface();
    outSceneData = m_sceneExtractor.ExtractForCamera(
        *plan.request.scene,
        *plan.request.camera,
        mainSceneSurface.GetRenderAreaWidth(),
        mainSceneSurface.GetRenderAreaHeight());
    if (!outSceneData.HasCamera()) {
        return false;
    }

    if (plan.directionalShadow.IsValid()) {
        outSceneData.lighting.mainDirectionalShadow =
            BuildDirectionalShadowData(plan.directionalShadow, shadowMapView);
    }
    outSceneData.globalShaderKeywords = BuildSceneGlobalShaderKeywords(outSceneData);

    outSceneData.cameraData.clearFlags = plan.request.clearFlags;
    outSceneData.environment = BuildEnvironmentData(plan);
    if (plan.request.hasClearColorOverride) {
        outSceneData.cameraData.clearColor = plan.request.clearColorOverride;
    }

    return true;
}

bool CameraRenderer::ExecuteRenderPlan(
    const CameraFramePlan& plan,
    const ShadowCasterRenderRequest& resolvedShadowCaster,
    const RenderSceneData& sceneData) {
    CameraFrameExecutionState executionState = {};
    executionState.pipeline = m_pipeline.get();
    executionState.objectIdPass = m_objectIdPass.get();
    executionState.depthOnlyPass = m_depthOnlyPass.get();
    executionState.shadowCasterPass = m_shadowCasterPass.get();
    executionState.postProcessSurfaceCache = m_postProcessSurfaceCache.get();
    executionState.finalOutputSurfaceCache = m_finalOutputSurfaceCache.get();

    for (const CameraFrameStageInfo& stageInfo : kOrderedCameraFrameStages) {
        if (!plan.HasFrameStage(stageInfo.stage) &&
            stageInfo.stage != CameraFrameStage::MainScene) {
            continue;
        }

        if (!ExecuteFrameStage(
                stageInfo.stage,
                plan,
                resolvedShadowCaster,
                sceneData,
                executionState)) {
            return false;
        }
    }

    return true;
}

bool CameraRenderer::Render(
    const CameraRenderRequest& request) {
    return Render(CameraFramePlan::FromRequest(request));
}

bool CameraRenderer::Render(
    const CameraFramePlan& plan) {
    if (!plan.IsValid() || m_pipeline == nullptr) {
        Debug::Logger::Get().Error(
            Debug::LogCategory::Rendering,
            "CameraRenderer::Render failed: plan invalid or pipeline missing");
        return false;
    }

    const RenderSurface& mainSceneSurface = plan.GetMainSceneSurface();
    if (mainSceneSurface.GetRenderAreaWidth() == 0 ||
        mainSceneSurface.GetRenderAreaHeight() == 0) {
        Debug::Logger::Get().Error(
            Debug::LogCategory::Rendering,
            "CameraRenderer::Render failed: main scene surface render area is empty");
        return false;
    }
    if (plan.request.depthOnly.IsRequested() &&
        !plan.request.depthOnly.IsValid()) {
        Debug::Logger::Get().Error(
            Debug::LogCategory::Rendering,
            "CameraRenderer::Render failed: depth-only request invalid");
        return false;
    }
    if (plan.postProcess.IsRequested() &&
        !plan.postProcess.IsValid()) {
        Debug::Logger::Get().Error(
            Debug::LogCategory::Rendering,
            "CameraRenderer::Render failed: post-process request invalid");
        return false;
    }
    if (plan.finalOutput.IsRequested() &&
        !plan.finalOutput.IsValid()) {
        Debug::Logger::Get().Error(
            Debug::LogCategory::Rendering,
            "CameraRenderer::Render failed: final-output request invalid");
        return false;
    }
    if (plan.request.objectId.IsRequested() &&
        !plan.request.objectId.IsValid()) {
        Debug::Logger::Get().Error(
            Debug::LogCategory::Rendering,
            "CameraRenderer::Render failed: object-id request invalid");
        return false;
    }

    ShadowCasterRenderRequest resolvedShadowCaster = {};
    RHI::RHIResourceView* shadowMapView = nullptr;
    if (!ResolveShadowCasterRequest(plan, resolvedShadowCaster, shadowMapView)) {
        Debug::Logger::Get().Error(
            Debug::LogCategory::Rendering,
            "CameraRenderer::Render failed: ResolveShadowCasterRequest returned false");
        return false;
    }

    RenderSceneData sceneData = {};
    if (!BuildSceneDataForPlan(plan, shadowMapView, sceneData)) {
        Debug::Logger::Get().Error(
            Debug::LogCategory::Rendering,
            "CameraRenderer::Render failed: BuildSceneDataForPlan returned false");
        return false;
    }

    if (!ExecuteRenderPlan(plan, resolvedShadowCaster, sceneData)) {
        Debug::Logger::Get().Error(
            Debug::LogCategory::Rendering,
            "CameraRenderer::Render failed: ExecuteRenderPlan returned false");
        return false;
    }

    return true;
}

} // namespace Rendering
} // namespace XCEngine