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

Code/Engine/RendererCore/Pipeline/Declarations.h
149 строк5 KB
Sanakan8472
Added resource bindings to extractors (#1976)
03 июл 2026, 17:05
03 июл 2026, 17:0551b63b9
#pragma once

#include <Core/World/Declarations.h>
#include <Foundation/Reflection/Reflection.h>
#include <RendererCore/RendererCoreDLL.h>
#include <RendererFoundation/Descriptors/Descriptors.h>
#include <RendererFoundation/Shader/BindGroup.h>
class ezCamera;
class ezExtractedRenderData;
class ezExtractor;
class ezView;
class ezRenderer;
class ezRenderData;
class ezRenderDataManager;
class ezRenderDataBatch;
class ezRenderPipeline;
class ezRenderPipelinePass;
class ezRenderContext;
class ezDebugRendererContext;

struct ezRenderPipelineNodePin;
struct ezRenderPipelinePassConnection;
struct ezViewData;

namespace ezInternal
{
  struct RenderDataCache;

  struct RenderDataCacheEntry
  {
    EZ_DECLARE_POD_TYPE();

    const ezRenderData* m_pRenderData = nullptr;
    ezUInt16 m_uiCategory = 0;
    ezUInt16 m_uiComponentIndex = 0;
    ezUInt16 m_uiPartIndex = 0;

    EZ_ALWAYS_INLINE bool operator==(const RenderDataCacheEntry& other) const { return m_pRenderData == other.m_pRenderData && m_uiCategory == other.m_uiCategory && m_uiComponentIndex == other.m_uiComponentIndex && m_uiPartIndex == other.m_uiPartIndex; }

    // Cache entries need to be sorted by component index and then by part index
    EZ_ALWAYS_INLINE bool operator<(const RenderDataCacheEntry& other) const
    {
      if (m_uiComponentIndex == other.m_uiComponentIndex)
        return m_uiPartIndex < other.m_uiPartIndex;

      return m_uiComponentIndex < other.m_uiComponentIndex;
    }
  };
} // namespace ezInternal

class EZ_RENDERERCORE_DLL ezRenderViewContext : public ezReflectedClass
{
  EZ_ADD_DYNAMIC_REFLECTION(ezRenderViewContext, ezReflectedClass);
  // Updates global constants and encoder with the viewport information of the view data.
  void UpdateViewport() const;

  const ezRenderPipeline* m_pPipeline = nullptr;
  const ezCamera* m_pCamera = nullptr;
  const ezViewData* m_pViewData = nullptr;
  ezRenderContext* m_pRenderContext = nullptr;

  const ezDebugRendererContext* m_pWorldDebugContext = nullptr;
  const ezDebugRendererContext* m_pViewDebugContext = nullptr;
};

using ezViewId = ezGenericId<24, 8>;

class ezViewHandle
{
  EZ_DECLARE_HANDLE_TYPE(ezViewHandle, ezViewId);

  friend class ezRenderWorld;
};

/// \brief HashHelper implementation so view handles can be used as key in a hashtable.
template <>
struct ezHashHelper<ezViewHandle>
{
  EZ_ALWAYS_INLINE static ezUInt32 Hash(ezViewHandle value) { return value.GetInternalID().m_Data * 2654435761U; }

  EZ_ALWAYS_INLINE static bool Equal(ezViewHandle a, ezViewHandle b) { return a == b; }
};

/// \brief Usage hint of a camera/view.
struct EZ_RENDERERCORE_DLL ezCameraUsageHint
{
  using StorageType = ezUInt8;

  enum Enum
  {
    None,         ///< No hint, camera may not be used, at all.
    MainView,     ///< The main camera from which the scene gets rendered. There should only be one camera with this hint.
    EditorView,   ///< The editor view shall be rendered from this camera.
    RenderTarget, ///< The camera is used to render to a render target.
    Culling,      ///< This camera should be used for culling only. Usually culling is done from the main view, but with a dedicated culling camera, one can debug the culling system.
    Shadow,       ///< This camera is used for rendering shadow maps.
    Reflection,   ///< This camera is used for rendering reflections.
    Thumbnail,    ///< This camera should be used for rendering a scene thumbnail when exporting from the editor.

    ENUM_COUNT,

    Default = None,
  };
};

EZ_DECLARE_REFLECTABLE_TYPE(EZ_RENDERERCORE_DLL, ezCameraUsageHint);

/// Declares that a texture needs to be in a specific resource state when a render category is rendered.
/// Recorded during extraction, applied during rendering to ensure correct barriers. m_uiCategory is the raw value of the ezRenderData::Category this dependency belongs to. View-level dependencies ignore the category value.
struct ezTextureDependency
{
  EZ_DECLARE_POD_TYPE();
  ezGALTextureHandle m_hTexture;
  ezBitflags<ezGALResourceState> m_RequiredState;
  ezBitflags<ezGALShaderStageFlags> m_Stage;
  ezUInt16 m_uiCategory = 0xFFFF;
};

/// Declares that a buffer needs to be in a specific resource state when a render category is rendered.
/// Recorded during extraction, applied during rendering to ensure correct barriers. m_uiCategory is the raw value of the ezRenderData::Category this dependency belongs to. View-level dependencies ignore the category value.
struct ezBufferDependency
{
  EZ_DECLARE_POD_TYPE();
  ezGALBufferHandle m_hBuffer;
  ezBitflags<ezGALResourceState> m_RequiredState;
  ezBitflags<ezGALShaderStageFlags> m_Stage;
  ezUInt16 m_uiCategory = 0xFFFF;
};

struct ezTextureBinding
{
  EZ_DECLARE_POD_TYPE();
  ezTempHashedString m_sSlotName;
  ezTextureBindGroupItem m_Texture;
};

struct ezBufferBinding
{
  EZ_DECLARE_POD_TYPE();
  ezTempHashedString m_sSlotName;
  ezGALBufferBindGroupItem m_Buffer;
};

struct ezSamplerBinding
{
  EZ_DECLARE_POD_TYPE();
  ezTempHashedString m_sSlotName;
  ezSamplerBindGroupItem m_Sampler;
};