/**************************************************************************** Copyright (c) 2020-2023 Xiamen Yaji Software Co., Ltd. http://www.cocos.com Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ****************************************************************************/ #include "RenderPipeline.h" #if CC_USE_GEOMETRY_RENDERER #include "GeometryRenderer.h" #endif #include "GlobalDescriptorSetManager.h" #include "InstancedBuffer.h" #include "PipelineSceneData.h" #include "PipelineStateManager.h" #include "PipelineUBO.h" #include "RenderFlow.h" #include "base/StringUtil.h" #include "base/std/hash/hash.h" #include "frame-graph/FrameGraph.h" #include "gfx-base/GFXDevice.h" #include "helper/Utils.h" #if CC_USE_DEBUG_RENDERER #include "profiler/DebugRenderer.h" #endif #include "custom/NativeBuiltinUtils.h" #include "scene/Camera.h" #include "scene/Skybox.h" namespace cc { namespace pipeline { framegraph::StringHandle RenderPipeline::fgStrHandleOutDepthTexture = framegraph::FrameGraph::stringToHandle("depthTexture"); framegraph::StringHandle RenderPipeline::fgStrHandleOutColorTexture = framegraph::FrameGraph::stringToHandle("outputTexture"); framegraph::StringHandle RenderPipeline::fgStrHandlePostprocessPass = framegraph::FrameGraph::stringToHandle("pipelinePostPass"); framegraph::StringHandle RenderPipeline::fgStrHandleBloomOutTexture = framegraph::FrameGraph::stringToHandle("combineTex"); RenderPipeline *RenderPipeline::instance = nullptr; RenderPipeline *RenderPipeline::getInstance() { return RenderPipeline::instance; } RenderPipeline::RenderPipeline() : _device(gfx::Device::getInstance()) { RenderPipeline::instance = this; _globalDSManager = ccnew GlobalDSManager(); _pipelineUBO = ccnew PipelineUBO(); } RenderPipeline::~RenderPipeline() { RenderPipeline::instance = nullptr; } bool RenderPipeline::initialize(const RenderPipelineInfo &info) { _flows = info.flows; _tag = info.tag; return true; } bool RenderPipeline::isEnvmapEnabled() const { return _pipelineSceneData->getSkybox()->isUseIBL(); } bool RenderPipeline::activate(gfx::Swapchain * /*swapchain*/) { _globalDSManager->activate(_device); _descriptorSet = _globalDSManager->getGlobalDescriptorSet(); _pipelineUBO->activate(_device, this); _pipelineSceneData->activate(_device); #if CC_USE_DEBUG_RENDERER CC_DEBUG_RENDERER->activate(_device); #endif // generate macros here rather than construct func because _clusterEnabled // switch may be changed in root.ts setRenderPipeline() function which is after // pipeline construct. generateConstantMacros(); for (auto const &flow : _flows) { flow->activate(this); } return true; } void RenderPipeline::render(const ccstd::vector &cameras) { for (auto const &flow : _flows) { for (auto *camera : cameras) { flow->render(camera); } } RenderPipeline::framegraphGC(); } void RenderPipeline::onGlobalPipelineStateChanged() { // do nothing } void RenderPipeline::destroyQuadInputAssembler() { CC_SAFE_DESTROY_AND_DELETE(_quadIB); for (auto *node : _quadVB) { CC_SAFE_DESTROY_AND_DELETE(node); } for (auto node : _quadIA) { CC_SAFE_DESTROY_AND_DELETE(node.second); } _quadVB.clear(); _quadIA.clear(); } #if CC_USE_GEOMETRY_RENDERER void RenderPipeline::updateGeometryRenderer(const ccstd::vector &cameras) { if (_geometryRenderer) { return; } // Query the first camera rendering to swapchain. for (const auto *camera : cameras) { if (camera && camera->getWindow() && camera->getWindow()->getSwapchain()) { const_cast(camera)->initGeometryRenderer(); _geometryRenderer = camera->getGeometryRenderer(); return; } } } #endif bool RenderPipeline::destroy() { for (auto const &flow : _flows) { CC_SAFE_DESTROY(flow); } _flows.clear(); #if CC_USE_GEOMETRY_RENDERER _geometryRenderer = nullptr; #endif _descriptorSet = nullptr; CC_SAFE_DESTROY_AND_DELETE(_globalDSManager); CC_SAFE_DESTROY_AND_DELETE(_pipelineUBO); CC_SAFE_DESTROY_NULL(_pipelineSceneData); #if CC_USE_DEBUG_RENDERER CC_DEBUG_RENDERER->destroy(); #endif for (auto *const queryPool : _queryPools) { queryPool->destroy(); } _queryPools.clear(); for (auto *const cmdBuffer : _commandBuffers) { cmdBuffer->destroy(); } _commandBuffers.clear(); PipelineStateManager::destroyAll(); framegraph::FrameGraph::gc(0); return Super::destroy(); } gfx::Color RenderPipeline::getClearcolor(scene::Camera *camera) const { auto *const sceneData = getPipelineSceneData(); gfx::Color clearColor{0.0F, 0.0F, 0.0F, 1.0F}; if (static_cast(camera->getClearFlag()) & static_cast(gfx::ClearFlagBit::COLOR)) { clearColor = camera->getClearColor(); } clearColor.w = 0.F; return clearColor; } void RenderPipeline::updateQuadVertexData(const Vec4 &viewport, gfx::Buffer *buffer) { float vbData[16] = {0.F}; genQuadVertexData(viewport, vbData); buffer->update(vbData, sizeof(vbData)); } gfx::InputAssembler *RenderPipeline::getIAByRenderArea(const gfx::Rect &renderArea) { auto bufferWidth{static_cast(_width)}; auto bufferHeight{static_cast(_height)}; Vec4 viewport{ static_cast(renderArea.x) / bufferWidth, static_cast(renderArea.y) / bufferHeight, static_cast(renderArea.width) / bufferWidth, static_cast(renderArea.height) / bufferHeight, }; const auto iter = _quadIA.find(viewport); if (iter != _quadIA.end()) { return iter->second; } gfx::Buffer *vb = nullptr; gfx::InputAssembler *ia = nullptr; createQuadInputAssembler(_quadIB, &vb, &ia); _quadVB.push_back(vb); _quadIA[viewport] = ia; updateQuadVertexData(viewport, vb); return ia; } bool RenderPipeline::createQuadInputAssembler(gfx::Buffer *quadIB, gfx::Buffer **quadVB, gfx::InputAssembler **quadIA) { // step 1 create vertex buffer uint32_t vbStride = sizeof(float) * 4; uint32_t vbSize = vbStride * 4; if (*quadVB == nullptr) { *quadVB = _device->createBuffer({gfx::BufferUsageBit::VERTEX | gfx::BufferUsageBit::TRANSFER_DST, gfx::MemoryUsageBit::DEVICE, vbSize, vbStride}); } // step 2 create input assembler gfx::InputAssemblerInfo info; info.attributes.push_back({"a_position", gfx::Format::RG32F}); info.attributes.push_back({"a_texCoord", gfx::Format::RG32F}); info.vertexBuffers.push_back(*quadVB); info.indexBuffer = quadIB; *quadIA = _device->createInputAssembler(info); return (*quadIA) != nullptr; } void RenderPipeline::ensureEnoughSize(const ccstd::vector &cameras) { for (auto *camera : cameras) { _width = std::max(camera->getWindow()->getWidth(), _width); _height = std::max(camera->getWindow()->getHeight(), _height); } } gfx::Viewport RenderPipeline::getViewport(scene::Camera *camera) { auto scale{_pipelineSceneData->getShadingScale()}; const gfx::Rect &rect = getRenderArea(camera); return { static_cast(static_cast(rect.x) * scale), static_cast(static_cast(rect.y) * scale), static_cast(static_cast(rect.width) * scale), static_cast(static_cast(rect.height) * scale)}; } gfx::Rect RenderPipeline::getScissor(scene::Camera *camera) { auto scale{_pipelineSceneData->getShadingScale()}; const gfx::Rect &rect = getRenderArea(camera); return { static_cast(static_cast(rect.x) * scale), static_cast(static_cast(rect.y) * scale), static_cast(static_cast(rect.width) * scale), static_cast(static_cast(rect.height) * scale)}; } gfx::Rect RenderPipeline::getRenderArea(scene::Camera *camera) { float w{static_cast(camera->getWindow()->getWidth())}; float h{static_cast(camera->getWindow()->getHeight())}; const auto &vp = camera->getViewport(); return { static_cast(vp.x * w), static_cast(vp.y * h), static_cast(vp.z * w), static_cast(vp.w * h), }; } float RenderPipeline::getShadingScale() const { return _pipelineSceneData->getShadingScale(); } void RenderPipeline::setShadingScale(float scale) { _pipelineSceneData->setShadingScale(scale); } void RenderPipeline::genQuadVertexData(const Vec4 &viewport, float vbData[16]) { render::setupQuadVertexBuffer(*_device, viewport, vbData); } void RenderPipeline::generateConstantMacros() { _constantMacros = StringUtil::format( R"( #define CC_DEVICE_SUPPORT_FLOAT_TEXTURE %d #define CC_ENABLE_CLUSTERED_LIGHT_CULLING %d #define CC_DEVICE_MAX_VERTEX_UNIFORM_VECTORS %d #define CC_DEVICE_MAX_FRAGMENT_UNIFORM_VECTORS %d #define CC_DEVICE_CAN_BENEFIT_FROM_INPUT_ATTACHMENT %d #define CC_PLATFORM_ANDROID_AND_WEBGL 0 #define CC_ENABLE_WEBGL_HIGHP_STRUCT_VALUES 0 #define CC_JOINT_UNIFORM_CAPACITY %d )", hasAnyFlags(_device->getFormatFeatures(gfx::Format::RGBA32F), gfx::FormatFeature::RENDER_TARGET | gfx::FormatFeature::SAMPLED_TEXTURE), _clusterEnabled ? 1 : 0, _device->getCapabilities().maxVertexUniformVectors, _device->getCapabilities().maxFragmentUniformVectors, _device->hasFeature(gfx::Feature::INPUT_ATTACHMENT_BENEFIT), SkinningJointCapacity::jointUniformCapacity); } gfx::DescriptorSetLayout *RenderPipeline::getDescriptorSetLayout() const { return _globalDSManager->getDescriptorSetLayout(); } RenderStage *RenderPipeline::getRenderstageByName(const ccstd::string &name) const { for (auto const &flow : _flows) { auto *val = flow->getRenderstageByName(name); if (val) { return val; } } return nullptr; } bool RenderPipeline::isOccluded(const scene::Camera *camera, const scene::SubModel *subModel) { auto *model = subModel->getOwner(); auto *worldBound = model->getWorldBounds(); // assume visible if there is no worldBound. if (!worldBound) { return false; } // assume visible if camera is inside of worldBound. if (worldBound->contain(camera->getPosition())) { return false; } // assume visible if no query in the last frame. uint32_t id = subModel->getId(); if (!_queryPools[0]->hasResult(id)) { return false; } // check query results. return _queryPools[0]->getResult(id) == 0; } void RenderPipeline::framegraphGC() { static uint64_t frameCount{0U}; static constexpr uint32_t INTERVAL_IN_SECONDS = 30; if (++frameCount % (INTERVAL_IN_SECONDS * 60) == 0) { framegraph::FrameGraph::gc(INTERVAL_IN_SECONDS * 60); } } } // namespace pipeline } // namespace cc