Code/Engine/RendererCore/Pipeline/RenderPipeline.h - dev - redgpu/ezEngine

Code/Engine/RendererCore/Pipeline/RenderPipeline.h
177 строк7 KB
C-Core
Various fixes (#1986)
17 июл 2026, 13:00
17 июл 2026, 13:003f3df3b
#pragma once

#include <Foundation/Configuration/CVar.h>
#include <Foundation/Containers/DynamicArray.h>
#include <Foundation/Containers/HybridArray.h>
#include <Foundation/Strings/HashedString.h>
#include <Foundation/Types/SharedPtr.h>
#include <Foundation/Types/UniquePtr.h>
#include <RendererCore/Pipeline/ExtractedRenderData.h>

class ezProfilingId;
class ezView;
class ezCamera;
struct ezViewData;
class ezRenderPipelinePass;
class ezFrameDataProviderBase;
struct ezPermutationVar;
class ezDGMLGraph;
class ezFrustum;
class ezRasterizerView;
class ezRenderGraph;
struct ezRenderGraphRenderEvent;
class ezRenderGraphContext;

class EZ_RENDERERCORE_DLL ezRenderPipeline : public ezRefCounted
{
public:
  enum class PipelineState
  {
    Uninitialized,
    RebuildError,
    Initialized,
    RenderGraphBuilt,
  };

  ezRenderPipeline();
  ~ezRenderPipeline();

  void AddPass(ezUniquePtr<ezRenderPipelinePass>&& pPass);
  void RemovePass(ezRenderPipelinePass* pPass);
  void GetPasses(ezDynamicArray<const ezRenderPipelinePass*>& ref_passes) const;
  void GetPasses(ezDynamicArray<ezRenderPipelinePass*>& ref_passes);
  ezRenderPipelinePass* GetPassByName(const ezStringView& sPassName);
  ezHashedString GetViewName() const;

  bool Connect(ezRenderPipelinePass* pOutputNode, const char* szOutputPinName, ezRenderPipelinePass* pInputNode, const char* szInputPinName);
  bool Connect(ezRenderPipelinePass* pOutputNode, ezHashedString sOutputPinName, ezRenderPipelinePass* pInputNode, ezHashedString sInputPinName);
  bool Disconnect(ezRenderPipelinePass* pOutputNode, ezHashedString sOutputPinName, ezRenderPipelinePass* pInputNode, ezHashedString sInputPinName);

  const ezRenderPipelinePassConnection* GetInputConnection(const ezRenderPipelinePass* pPass, ezHashedString sInputPinName) const;
  const ezRenderPipelinePassConnection* GetOutputConnection(const ezRenderPipelinePass* pPass, ezHashedString sOutputPinName) const;

  void AddExtractor(ezUniquePtr<ezExtractor>&& pExtractor);
  void RemoveExtractor(ezExtractor* pExtractor);
  void GetExtractors(ezDynamicArray<const ezExtractor*>& ref_extractors) const;
  void GetExtractors(ezDynamicArray<ezExtractor*>& ref_extractors);
  ezExtractor* GetExtractorByName(const ezStringView& sExtractorName);

  template <typename T>
  EZ_ALWAYS_INLINE T* GetFrameDataProvider() const
  {
    return static_cast<T*>(GetFrameDataProvider(ezGetStaticRTTI<T>()));
  }

  const ezExtractedRenderData& GetRenderData() const;
  ezRenderDataBatchList GetRenderDataBatchesWithCategory(ezRenderData::Category category) const;

  /// Returns the texture barrier dependencies recorded during extraction for a specific category.
  ezArrayPtr<const ezTextureDependency> GetTextureDependenciesWithCategory(ezRenderData::Category category) const;

  /// Returns the buffer barrier dependencies recorded during extraction for a specific category.
  ezArrayPtr<const ezBufferDependency> GetBufferDependenciesWithCategory(ezRenderData::Category category) const;

  /// Adds a texture dependency to the current extraction frame's data.
  /// Must only be called during extraction.
  void AddViewDependency(ezGALTextureHandle hTexture, ezBitflags<ezGALResourceState> requiredState, ezBitflags<ezGALShaderStageFlags> stage = ezGALShaderStageFlags::Auto);

  /// Adds a buffer dependency to the current extraction frame's data.
  /// Must only be called during extraction.
  void AddViewDependency(ezGALBufferHandle hBuffer, ezBitflags<ezGALResourceState> requiredState, ezBitflags<ezGALShaderStageFlags> stage = ezGALShaderStageFlags::Auto);

  using RenderDataProcessor = ezDelegate<void(ezExtractedRenderData&)>;
  ezUInt32 AddRenderDataProcessor(RenderDataProcessor processor);

  /// \brief Creates a DGML graph of all passes and textures. Can be used to verify that no accidental temp textures are created due to poorly constructed pipelines or errors in code.
  void CreateDgmlGraph(ezDGMLGraph& ref_graph);

#if EZ_ENABLED(EZ_COMPILE_FOR_DEVELOPMENT)
  static ezCVarBool cvar_SpatialCullingVis;
#endif

  EZ_DISALLOW_COPY_AND_ASSIGN(ezRenderPipeline);

private:
  friend class ezRenderWorld;
  friend class ezView;

  /// \brief Returns whether the pipeline should be rendered. E.g. returns false if the associated world has been destroyed.
  bool ShouldRender() const;

  // \brief Rebuilds the render pipeline, e.g. sorting passes via dependencies and creating render targets.
  PipelineState Rebuild(const ezView& view);
  bool RebuildInternal(const ezView& view);
  bool RebuildRenderGraph(const ezViewData& viewData, const ezCamera& camera);
  bool SortPasses();
  bool AddRenderPasses(const ezViewData& viewData, const ezCamera& camera);
  bool UpdateTextureProviders();
  void SortExtractors();
  void UpdateViewData(const ezView& view, ezUInt32 uiDataIndex);

  void RemoveConnections(ezRenderPipelinePass* pPass);
  bool AreInputDescriptionsAvailable(const ezRenderPipelinePass* pPass, const ezHybridArray<ezRenderPipelinePass*, 32>& done) const;
  bool ArePassThroughInputsDone(const ezRenderPipelinePass* pPass, const ezHybridArray<ezRenderPipelinePass*, 32>& done) const;

  ezFrameDataProviderBase* GetFrameDataProvider(const ezRTTI* pRtti) const;

  void ExtractData(const ezView& view);
  void FindVisibleObjects(const ezView& view);

  void EnqueueRenderGraph(ezRenderContext* pRenderer);
  void UpdateRenderContext(ezRenderGraphContext& ctx);

  ezRasterizerView* PrepareOcclusionCulling(const ezFrustum& frustum, const ezView& view);
  void PreviewOcclusionBuffer(const ezRasterizerView& rasterizer, const ezView& view);

  void OnRenderEvent(const ezRenderGraphRenderEvent& e);

private: // Member data
  // Thread data
  ezThreadID m_CurrentExtractThread = (ezThreadID)0;
  ezThreadID m_CurrentRenderThread = (ezThreadID)0;

  // Pipeline render data
  ezExtractedRenderData m_Data[2];
  ezDynamicArray<const ezGameObject*> m_VisibleObjects;

#if EZ_ENABLED(EZ_COMPILE_FOR_DEVELOPMENT)
  ezTime m_AverageCullingTime;
#endif

  ezHashedString m_sName;
  ezUInt64 m_uiLastExtractionFrame = -1;
  ezUInt64 m_uiLastRenderFrame = -1;

  // Render pass graph data
  PipelineState m_PipelineState = PipelineState::Uninitialized;

  struct ConnectionData
  {
    // Inputs / outputs match the node pin indices. Value at index is nullptr if not connected.
    ezDynamicArray<ezRenderPipelinePassConnection*> m_Inputs;
    ezDynamicArray<ezRenderPipelinePassConnection*> m_Outputs;
  };
  ezDynamicArray<ezUniquePtr<ezRenderPipelinePass>> m_Passes;       ///< The passes present in the pipeline on no particular order.
  ezMap<const ezRenderPipelinePass*, ConnectionData> m_Connections; ///< Connections on each pass.
  ezSet<const ezRenderPipelineNodePin*> m_TextureProviderPins;

  /// Render Graph
  ezSharedPtr<ezRenderGraph> m_pRenderGraph;
  ezRenderViewContext m_RenderViewContext;
  ezUInt32 m_uiSettingsModificationCounter = 0;

  // Extractors
  ezDynamicArray<ezUniquePtr<ezExtractor>> m_Extractors;
  ezDynamicArray<ezUniquePtr<ezExtractor>> m_SortedExtractors;

  // Data Providers
  mutable ezDynamicArray<ezUniquePtr<ezFrameDataProviderBase>> m_DataProviders;
  mutable ezHashTable<const ezRTTI*, ezUInt32> m_TypeToDataProviderIndex;

  ezDynamicArray<RenderDataProcessor> m_RenderDataProcessors;

  ezDynamicArray<ezPermutationVar> m_PermutationVars;

  // Occlusion Culling
  ezGALTextureHandle m_hOcclusionDebugViewTexture;
};