2026-04-05 21:33:58 +08:00
|
|
|
#include "Rendering/Execution/CameraRenderer.h"
|
2026-03-27 16:22:59 +08:00
|
|
|
|
2026-04-05 23:44:32 +08:00
|
|
|
#include "Components/CameraComponent.h"
|
2026-04-13 23:11:28 +08:00
|
|
|
#include "Rendering/Execution/DirectionalShadowExecutionState.h"
|
2026-04-14 22:50:16 +08:00
|
|
|
#include "Rendering/Execution/Internal/CameraFrameRenderGraphExecution.h"
|
2026-04-04 14:41:01 +08:00
|
|
|
#include "Rendering/Passes/BuiltinDepthOnlyPass.h"
|
2026-04-01 16:44:11 +08:00
|
|
|
#include "Rendering/Passes/BuiltinObjectIdPass.h"
|
2026-04-04 14:41:01 +08:00
|
|
|
#include "Rendering/Passes/BuiltinShadowCasterPass.h"
|
2026-03-27 16:22:59 +08:00
|
|
|
#include "Rendering/Pipelines/BuiltinForwardPipeline.h"
|
2026-04-15 01:57:14 +08:00
|
|
|
#include "Rendering/Pipelines/ManagedScriptableRenderPipelineAsset.h"
|
2026-04-15 01:33:42 +08:00
|
|
|
#include "Rendering/Pipelines/ScriptableRenderPipelineHost.h"
|
2026-04-01 00:56:48 +08:00
|
|
|
#include "Rendering/RenderPipelineAsset.h"
|
2026-03-27 16:22:59 +08:00
|
|
|
#include "Rendering/RenderSurface.h"
|
2026-04-13 23:11:28 +08:00
|
|
|
#include "Rendering/Shadow/DirectionalShadowRuntime.h"
|
2026-03-27 16:22:59 +08:00
|
|
|
#include "Scene/Scene.h"
|
|
|
|
|
|
|
|
|
|
namespace XCEngine {
|
|
|
|
|
namespace Rendering {
|
|
|
|
|
|
2026-04-05 00:03:22 +08:00
|
|
|
namespace {
|
|
|
|
|
|
2026-04-01 00:56:48 +08:00
|
|
|
std::shared_ptr<const RenderPipelineAsset> CreateDefaultPipelineAsset() {
|
2026-04-15 01:57:14 +08:00
|
|
|
return Pipelines::CreateManagedOrDefaultScriptableRenderPipelineAsset();
|
2026-04-01 00:56:48 +08:00
|
|
|
}
|
|
|
|
|
|
2026-04-04 14:41:01 +08:00
|
|
|
std::unique_ptr<RenderPass> CreateDefaultDepthOnlyPass() {
|
|
|
|
|
return std::make_unique<Passes::BuiltinDepthOnlyPass>();
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
std::unique_ptr<RenderPass> CreateDefaultShadowCasterPass() {
|
|
|
|
|
return std::make_unique<Passes::BuiltinShadowCasterPass>();
|
|
|
|
|
}
|
|
|
|
|
|
2026-04-01 00:56:48 +08:00
|
|
|
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;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2026-04-15 01:33:42 +08:00
|
|
|
return std::make_unique<Pipelines::ScriptableRenderPipelineHost>();
|
2026-04-01 00:56:48 +08:00
|
|
|
}
|
|
|
|
|
|
2026-04-06 20:30:25 +08:00
|
|
|
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;
|
|
|
|
|
}
|
|
|
|
|
|
2026-04-13 22:16:04 +08:00
|
|
|
RenderEnvironmentData BuildEnvironmentData(const CameraFramePlan& plan) {
|
2026-04-05 23:44:32 +08:00
|
|
|
RenderEnvironmentData environment = {};
|
2026-04-13 22:16:04 +08:00
|
|
|
const RenderSurface& mainSceneSurface = plan.GetMainSceneSurface();
|
|
|
|
|
if (plan.request.camera == nullptr ||
|
2026-04-06 03:55:06 +08:00
|
|
|
mainSceneSurface.GetDepthAttachment() == nullptr ||
|
2026-04-13 22:16:04 +08:00
|
|
|
!HasRenderClearFlag(plan.request.clearFlags, RenderClearFlags::Color) ||
|
|
|
|
|
!plan.request.camera->IsSkyboxEnabled() ||
|
|
|
|
|
plan.request.camera->GetProjectionType() != Components::CameraProjectionType::Perspective) {
|
2026-04-05 23:44:32 +08:00
|
|
|
return environment;
|
|
|
|
|
}
|
|
|
|
|
|
2026-04-13 22:16:04 +08:00
|
|
|
if (const Resources::Material* skyboxMaterial = plan.request.camera->GetSkyboxMaterial()) {
|
2026-04-06 00:39:08 +08:00
|
|
|
environment.mode = RenderEnvironmentMode::MaterialSkybox;
|
|
|
|
|
environment.materialSkybox.material = skyboxMaterial;
|
|
|
|
|
return environment;
|
|
|
|
|
}
|
|
|
|
|
|
2026-04-05 23:44:32 +08:00
|
|
|
environment.mode = RenderEnvironmentMode::ProceduralSkybox;
|
2026-04-13 22:16:04 +08:00
|
|
|
environment.skybox.topColor = plan.request.camera->GetSkyboxTopColor();
|
|
|
|
|
environment.skybox.horizonColor = plan.request.camera->GetSkyboxHorizonColor();
|
|
|
|
|
environment.skybox.bottomColor = plan.request.camera->GetSkyboxBottomColor();
|
2026-04-05 23:44:32 +08:00
|
|
|
return environment;
|
|
|
|
|
}
|
|
|
|
|
|
2026-03-31 21:54:00 +08:00
|
|
|
} // namespace
|
|
|
|
|
|
2026-03-27 16:22:59 +08:00
|
|
|
CameraRenderer::CameraRenderer()
|
2026-04-01 00:56:48 +08:00
|
|
|
: CameraRenderer(CreateDefaultPipelineAsset()) {
|
2026-03-27 16:22:59 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
CameraRenderer::CameraRenderer(std::unique_ptr<RenderPipeline> pipeline)
|
2026-04-04 14:41:01 +08:00
|
|
|
: CameraRenderer(
|
|
|
|
|
std::move(pipeline),
|
|
|
|
|
std::make_unique<Passes::BuiltinObjectIdPass>(),
|
|
|
|
|
CreateDefaultDepthOnlyPass(),
|
|
|
|
|
CreateDefaultShadowCasterPass()) {
|
2026-04-01 16:44:11 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
CameraRenderer::CameraRenderer(
|
|
|
|
|
std::unique_ptr<RenderPipeline> pipeline,
|
2026-04-05 18:20:19 +08:00
|
|
|
std::unique_ptr<RenderPass> objectIdPass,
|
2026-04-04 14:41:01 +08:00
|
|
|
std::unique_ptr<RenderPass> depthOnlyPass,
|
|
|
|
|
std::unique_ptr<RenderPass> shadowCasterPass)
|
2026-04-01 16:44:11 +08:00
|
|
|
: m_pipelineAsset(nullptr)
|
2026-04-04 14:41:01 +08:00
|
|
|
, m_objectIdPass(std::move(objectIdPass))
|
|
|
|
|
, m_depthOnlyPass(std::move(depthOnlyPass))
|
2026-04-06 13:58:17 +08:00
|
|
|
, m_shadowCasterPass(std::move(shadowCasterPass))
|
2026-04-14 19:04:55 +08:00
|
|
|
, m_directionalShadowRuntime(std::make_unique<DirectionalShadowRuntime>()) {
|
2026-04-01 16:44:11 +08:00
|
|
|
if (m_objectIdPass == nullptr) {
|
|
|
|
|
m_objectIdPass = std::make_unique<Passes::BuiltinObjectIdPass>();
|
|
|
|
|
}
|
2026-04-04 14:41:01 +08:00
|
|
|
if (m_depthOnlyPass == nullptr) {
|
|
|
|
|
m_depthOnlyPass = CreateDefaultDepthOnlyPass();
|
|
|
|
|
}
|
|
|
|
|
if (m_shadowCasterPass == nullptr) {
|
|
|
|
|
m_shadowCasterPass = CreateDefaultShadowCasterPass();
|
|
|
|
|
}
|
2026-04-01 00:56:48 +08:00
|
|
|
ResetPipeline(std::move(pipeline));
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
CameraRenderer::CameraRenderer(std::shared_ptr<const RenderPipelineAsset> pipelineAsset)
|
2026-04-01 16:44:11 +08:00
|
|
|
: m_pipelineAsset(std::move(pipelineAsset))
|
2026-04-04 14:41:01 +08:00
|
|
|
, m_objectIdPass(std::make_unique<Passes::BuiltinObjectIdPass>())
|
|
|
|
|
, m_depthOnlyPass(CreateDefaultDepthOnlyPass())
|
2026-04-06 13:58:17 +08:00
|
|
|
, m_shadowCasterPass(CreateDefaultShadowCasterPass())
|
2026-04-14 19:04:55 +08:00
|
|
|
, m_directionalShadowRuntime(std::make_unique<DirectionalShadowRuntime>()) {
|
2026-04-01 00:56:48 +08:00
|
|
|
SetPipelineAsset(m_pipelineAsset);
|
2026-03-27 16:22:59 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
CameraRenderer::~CameraRenderer() {
|
|
|
|
|
if (m_pipeline) {
|
|
|
|
|
m_pipeline->Shutdown();
|
|
|
|
|
}
|
2026-04-01 16:44:11 +08:00
|
|
|
if (m_objectIdPass != nullptr) {
|
|
|
|
|
m_objectIdPass->Shutdown();
|
|
|
|
|
}
|
2026-04-04 14:41:01 +08:00
|
|
|
if (m_depthOnlyPass != nullptr) {
|
|
|
|
|
m_depthOnlyPass->Shutdown();
|
|
|
|
|
}
|
|
|
|
|
if (m_shadowCasterPass != nullptr) {
|
|
|
|
|
m_shadowCasterPass->Shutdown();
|
|
|
|
|
}
|
2026-03-27 16:22:59 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
void CameraRenderer::SetPipeline(std::unique_ptr<RenderPipeline> pipeline) {
|
2026-04-01 00:56:48 +08:00
|
|
|
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));
|
|
|
|
|
}
|
|
|
|
|
|
2026-04-05 18:20:19 +08:00
|
|
|
void CameraRenderer::SetObjectIdPass(std::unique_ptr<RenderPass> objectIdPass) {
|
2026-04-01 16:44:11 +08:00
|
|
|
if (m_objectIdPass != nullptr) {
|
|
|
|
|
m_objectIdPass->Shutdown();
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
m_objectIdPass = std::move(objectIdPass);
|
|
|
|
|
if (m_objectIdPass == nullptr) {
|
|
|
|
|
m_objectIdPass = std::make_unique<Passes::BuiltinObjectIdPass>();
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2026-04-04 14:41:01 +08:00
|
|
|
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();
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2026-04-01 00:56:48 +08:00
|
|
|
void CameraRenderer::ResetPipeline(std::unique_ptr<RenderPipeline> pipeline) {
|
|
|
|
|
if (m_pipeline != nullptr) {
|
2026-03-27 16:22:59 +08:00
|
|
|
m_pipeline->Shutdown();
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
m_pipeline = std::move(pipeline);
|
2026-04-01 00:56:48 +08:00
|
|
|
if (m_pipeline == nullptr) {
|
|
|
|
|
m_pipelineAsset = CreateDefaultPipelineAsset();
|
|
|
|
|
m_pipeline = CreatePipelineFromAsset(m_pipelineAsset);
|
2026-03-27 16:22:59 +08:00
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2026-04-13 22:16:04 +08:00
|
|
|
bool CameraRenderer::BuildSceneDataForPlan(
|
|
|
|
|
const CameraFramePlan& plan,
|
2026-04-13 23:11:28 +08:00
|
|
|
const DirectionalShadowExecutionState& shadowState,
|
2026-04-05 19:55:37 +08:00
|
|
|
RenderSceneData& outSceneData) {
|
2026-04-13 22:16:04 +08:00
|
|
|
const RenderSurface& mainSceneSurface = plan.GetMainSceneSurface();
|
2026-04-05 19:55:37 +08:00
|
|
|
outSceneData = m_sceneExtractor.ExtractForCamera(
|
2026-04-13 22:16:04 +08:00
|
|
|
*plan.request.scene,
|
|
|
|
|
*plan.request.camera,
|
2026-04-06 03:55:06 +08:00
|
|
|
mainSceneSurface.GetRenderAreaWidth(),
|
|
|
|
|
mainSceneSurface.GetRenderAreaHeight());
|
2026-04-05 19:55:37 +08:00
|
|
|
if (!outSceneData.HasCamera()) {
|
2026-03-27 16:22:59 +08:00
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
|
2026-04-13 23:11:28 +08:00
|
|
|
outSceneData.lighting.mainDirectionalShadow = shadowState.shadowData;
|
2026-04-06 20:30:25 +08:00
|
|
|
outSceneData.globalShaderKeywords = BuildSceneGlobalShaderKeywords(outSceneData);
|
2026-04-04 23:01:34 +08:00
|
|
|
|
2026-04-13 22:16:04 +08:00
|
|
|
outSceneData.cameraData.clearFlags = plan.request.clearFlags;
|
|
|
|
|
outSceneData.environment = BuildEnvironmentData(plan);
|
|
|
|
|
if (plan.request.hasClearColorOverride) {
|
|
|
|
|
outSceneData.cameraData.clearColor = plan.request.clearColorOverride;
|
2026-04-01 22:49:26 +08:00
|
|
|
}
|
2026-04-05 19:55:37 +08:00
|
|
|
|
|
|
|
|
return true;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
bool CameraRenderer::ExecuteRenderPlan(
|
2026-04-13 22:16:04 +08:00
|
|
|
const CameraFramePlan& plan,
|
2026-04-13 23:11:28 +08:00
|
|
|
const DirectionalShadowExecutionState& shadowState,
|
2026-04-05 19:55:37 +08:00
|
|
|
const RenderSceneData& sceneData) {
|
2026-04-14 22:50:16 +08:00
|
|
|
return ExecuteCameraFrameRenderGraphPlan(
|
|
|
|
|
plan,
|
|
|
|
|
shadowState,
|
|
|
|
|
sceneData,
|
|
|
|
|
m_pipeline.get(),
|
|
|
|
|
m_objectIdPass.get(),
|
|
|
|
|
m_depthOnlyPass.get(),
|
|
|
|
|
m_shadowCasterPass.get());
|
2026-04-13 22:16:04 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
bool CameraRenderer::Render(
|
|
|
|
|
const CameraFramePlan& plan) {
|
|
|
|
|
if (!plan.IsValid() || m_pipeline == nullptr) {
|
2026-04-11 22:14:02 +08:00
|
|
|
Debug::Logger::Get().Error(
|
|
|
|
|
Debug::LogCategory::Rendering,
|
2026-04-13 22:16:04 +08:00
|
|
|
"CameraRenderer::Render failed: plan invalid or pipeline missing");
|
2026-04-05 19:55:37 +08:00
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
|
2026-04-13 22:16:04 +08:00
|
|
|
const RenderSurface& mainSceneSurface = plan.GetMainSceneSurface();
|
2026-04-06 03:55:06 +08:00
|
|
|
if (mainSceneSurface.GetRenderAreaWidth() == 0 ||
|
|
|
|
|
mainSceneSurface.GetRenderAreaHeight() == 0) {
|
2026-04-11 22:14:02 +08:00
|
|
|
Debug::Logger::Get().Error(
|
|
|
|
|
Debug::LogCategory::Rendering,
|
|
|
|
|
"CameraRenderer::Render failed: main scene surface render area is empty");
|
2026-04-03 13:22:30 +08:00
|
|
|
return false;
|
|
|
|
|
}
|
2026-04-13 22:16:04 +08:00
|
|
|
if (plan.request.depthOnly.IsRequested() &&
|
|
|
|
|
!plan.request.depthOnly.IsValid()) {
|
2026-04-11 22:14:02 +08:00
|
|
|
Debug::Logger::Get().Error(
|
|
|
|
|
Debug::LogCategory::Rendering,
|
|
|
|
|
"CameraRenderer::Render failed: depth-only request invalid");
|
2026-04-05 19:55:37 +08:00
|
|
|
return false;
|
|
|
|
|
}
|
2026-04-13 22:16:04 +08:00
|
|
|
if (plan.postProcess.IsRequested() &&
|
2026-04-14 19:32:27 +08:00
|
|
|
!plan.IsPostProcessStageValid()) {
|
2026-04-11 22:14:02 +08:00
|
|
|
Debug::Logger::Get().Error(
|
|
|
|
|
Debug::LogCategory::Rendering,
|
|
|
|
|
"CameraRenderer::Render failed: post-process request invalid");
|
2026-04-06 03:55:06 +08:00
|
|
|
return false;
|
|
|
|
|
}
|
2026-04-15 00:32:23 +08:00
|
|
|
if (plan.UsesGraphManagedMainSceneColor() &&
|
2026-04-14 19:32:27 +08:00
|
|
|
(m_pipeline == nullptr || !m_pipeline->SupportsMainSceneRenderGraph())) {
|
|
|
|
|
Debug::Logger::Get().Error(
|
|
|
|
|
Debug::LogCategory::Rendering,
|
|
|
|
|
"CameraRenderer::Render failed: graph-managed main scene color requires pipeline main-scene render-graph support");
|
|
|
|
|
return false;
|
|
|
|
|
}
|
2026-04-13 22:16:04 +08:00
|
|
|
if (plan.finalOutput.IsRequested() &&
|
2026-04-14 19:32:27 +08:00
|
|
|
!plan.IsFinalOutputStageValid()) {
|
2026-04-11 22:14:02 +08:00
|
|
|
Debug::Logger::Get().Error(
|
|
|
|
|
Debug::LogCategory::Rendering,
|
|
|
|
|
"CameraRenderer::Render failed: final-output request invalid");
|
2026-04-06 03:55:06 +08:00
|
|
|
return false;
|
|
|
|
|
}
|
2026-04-13 22:16:04 +08:00
|
|
|
if (plan.request.objectId.IsRequested() &&
|
|
|
|
|
!plan.request.objectId.IsValid()) {
|
2026-04-11 22:14:02 +08:00
|
|
|
Debug::Logger::Get().Error(
|
|
|
|
|
Debug::LogCategory::Rendering,
|
|
|
|
|
"CameraRenderer::Render failed: object-id request invalid");
|
2026-04-03 13:22:30 +08:00
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
|
2026-04-13 23:11:28 +08:00
|
|
|
DirectionalShadowExecutionState shadowState = {};
|
|
|
|
|
if (m_directionalShadowRuntime == nullptr ||
|
|
|
|
|
!m_directionalShadowRuntime->ResolveExecutionState(plan, shadowState)) {
|
2026-04-11 22:14:02 +08:00
|
|
|
Debug::Logger::Get().Error(
|
|
|
|
|
Debug::LogCategory::Rendering,
|
2026-04-13 23:11:28 +08:00
|
|
|
"CameraRenderer::Render failed: DirectionalShadowRuntime::ResolveExecutionState returned false");
|
2026-04-05 19:55:37 +08:00
|
|
|
return false;
|
|
|
|
|
}
|
2026-03-31 21:54:00 +08:00
|
|
|
|
2026-04-05 19:55:37 +08:00
|
|
|
RenderSceneData sceneData = {};
|
2026-04-13 23:11:28 +08:00
|
|
|
if (!BuildSceneDataForPlan(plan, shadowState, sceneData)) {
|
2026-04-11 22:14:02 +08:00
|
|
|
Debug::Logger::Get().Error(
|
|
|
|
|
Debug::LogCategory::Rendering,
|
2026-04-13 22:16:04 +08:00
|
|
|
"CameraRenderer::Render failed: BuildSceneDataForPlan returned false");
|
2026-04-05 19:55:37 +08:00
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
|
2026-04-13 23:11:28 +08:00
|
|
|
if (!ExecuteRenderPlan(plan, shadowState, sceneData)) {
|
2026-04-11 22:14:02 +08:00
|
|
|
Debug::Logger::Get().Error(
|
|
|
|
|
Debug::LogCategory::Rendering,
|
|
|
|
|
"CameraRenderer::Render failed: ExecuteRenderPlan returned false");
|
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
return true;
|
2026-03-27 16:22:59 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
} // namespace Rendering
|
|
|
|
|
} // namespace XCEngine
|
2026-04-14 22:50:16 +08:00
|
|
|
|