ezEngine Release 26.3
Loading...
Searching...
No Matches
ezTonemapPass Class Reference

#include <TonemapPass.h>

Inheritance diagram for ezTonemapPass:

Public Member Functions

virtual bool GetRenderTargetDescriptions (const ezView &view, const ezArrayPtr< ezGALTextureCreationDescription *const > inputs, ezArrayPtr< ezGALTextureCreationDescription > outputs) override
 For a given input pin configuration, provide the output configuration of this node. Outputs is already resized to the number of output pins.
 
virtual void Execute (const ezRenderViewContext &renderViewContext, const ezArrayPtr< ezRenderPipelinePassConnection *const > inputs, const ezArrayPtr< ezRenderPipelinePassConnection *const > outputs) override
 Render into outputs. Both inputs and outputs are passed in with actual texture handles. Disconnected pins have a nullptr value in the passed in arrays. You can now create views and render target setups on the fly and fill the output targets with data.
 
virtual ezResult Serialize (ezStreamWriter &inout_stream) const override
 
virtual ezResult Deserialize (ezStreamReader &inout_stream) override
 
- Public Member Functions inherited from ezRenderPipelinePass
 ezRenderPipelinePass (const char *szName, bool bIsStereoAware=false)
 
void SetName (const char *szName)
 Sets the name of the pass.
 
const char * GetName () const
 returns the name of the pass.
 
bool IsStereoAware () const
 True if the render pipeline pass can handle stereo cameras correctly.
 
virtual ezGALTextureHandle QueryTextureProvider (const ezRenderPipelineNodePin *pPin, const ezGALTextureCreationDescription &desc)
 
virtual void InitRenderPipelinePass (const ezArrayPtr< ezRenderPipelinePassConnection *const > inputs, const ezArrayPtr< ezRenderPipelinePassConnection *const > outputs)
 After GetRenderTargetDescriptions was called successfully for each pass, this function is called with the inputs and outputs for review. Disconnected pins have a nullptr value in the passed in arrays. This is the time to create additional resources that are not covered by the pins automatically, e.g. a picking texture or eye adaptation buffer.
 
virtual void ExecuteInactive (const ezRenderViewContext &renderViewContext, const ezArrayPtr< ezRenderPipelinePassConnection *const > inputs, const ezArrayPtr< ezRenderPipelinePassConnection *const > outputs)
 
virtual void ReadBackProperties (ezView *pView)
 Allows for the pass to write data back using ezView::SetRenderPassReadBackProperty. E.g. picking results etc.
 
void RenderDataWithCategory (const ezRenderViewContext &renderViewContext, ezRenderData::Category category)
 
EZ_ALWAYS_INLINE ezRenderPipelineGetPipeline ()
 
EZ_ALWAYS_INLINE const ezRenderPipelineGetPipeline () const
 
- Public Member Functions inherited from ezRenderPipelineNode
void InitializePins ()
 
ezHashedString GetPinName (const ezRenderPipelineNodePin *pPin) const
 
const ezRenderPipelineNodePinGetPinByName (const char *szName) const
 
const ezRenderPipelineNodePinGetPinByName (ezHashedString sName) const
 
const ezArrayPtr< const ezRenderPipelineNodePin *const > GetInputPins () const
 
const ezArrayPtr< const ezRenderPipelineNodePin *const > GetOutputPins () const
 
- Public Member Functions inherited from ezReflectedClass
virtual const ezRTTIGetDynamicRTTI () const
 
bool IsInstanceOf (const ezRTTI *pType) const
 Returns whether the type of this instance is of the given type or derived from it.
 
template<typename T >
EZ_ALWAYS_INLINE bool IsInstanceOf () const
 Returns whether the type of this instance is of the given type or derived from it.
 

Protected Member Functions

 EZ_ADD_RESOURCEHANDLE_ACCESSORS (VignettingTexture, m_hVignettingTexture)
 Vignette texture.
 
 EZ_ADD_RESOURCEHANDLE_ACCESSORS (LUT1Texture, m_hLUT1)
 Primary color grading LUT.
 
 EZ_ADD_RESOURCEHANDLE_ACCESSORS (LUT2Texture, m_hLUT2)
 Secondary color grading LUT.
 

Protected Attributes

ezRenderPipelineNodeInputPin m_PinColorInput
 HDR color input to tonemap.
 
ezRenderPipelineNodeInputPin m_PinBloomInput
 Optional bloom texture to add.
 
ezRenderPipelineNodeOutputPin m_PinOutput
 LDR output after tonemapping.
 
ezTexture2DResourceHandle m_hVignettingTexture
 Vignetting effect texture.
 
ezTexture2DResourceHandle m_hNoiseTexture
 Film grain noise texture.
 
ezTexture3DResourceHandle m_hLUT1
 First 3D lookup table for color grading.
 
ezTexture3DResourceHandle m_hLUT2
 Second 3D lookup table for color grading.
 
ezColor m_MoodColor
 Mood color tint.
 
float m_fMoodStrength
 Strength of mood color effect.
 
float m_fSaturation
 Color saturation multiplier.
 
float m_fContrast
 Contrast adjustment.
 
float m_fLut1Strength
 Blend strength for first LUT.
 
float m_fLut2Strength
 Blend strength for second LUT.
 
float m_fWhitePoint
 White point for tone curve.
 
ezConstantBufferStorageHandle m_hConstantBuffer
 Constant buffer for tonemap parameters.
 
ezShaderResourceHandle m_hShader
 Tonemap shader.
 

Additional Inherited Members

- Static Public Member Functions inherited from ezNoBase
static const ezRTTIGetStaticRTTI ()
 

Detailed Description

Render pass that applies tonemapping and color grading to HDR images.

Converts high dynamic range color values to display-ready output by applying exposure adjustment, color grading via lookup tables, saturation, contrast, and optional effects like vignetting and mood color. Combines with bloom if provided.

Member Function Documentation

◆ Deserialize()

ezResult ezTonemapPass::Deserialize ( ezStreamReader inout_stream)
overridevirtual

Reimplemented from ezRenderPipelinePass.

◆ Execute()

void ezTonemapPass::Execute ( const ezRenderViewContext renderViewContext,
const ezArrayPtr< ezRenderPipelinePassConnection *const >  inputs,
const ezArrayPtr< ezRenderPipelinePassConnection *const >  outputs 
)
overridevirtual

Render into outputs. Both inputs and outputs are passed in with actual texture handles. Disconnected pins have a nullptr value in the passed in arrays. You can now create views and render target setups on the fly and fill the output targets with data.

Implements ezRenderPipelinePass.

◆ GetRenderTargetDescriptions()

bool ezTonemapPass::GetRenderTargetDescriptions ( const ezView view,
const ezArrayPtr< ezGALTextureCreationDescription *const >  inputs,
ezArrayPtr< ezGALTextureCreationDescription outputs 
)
overridevirtual

For a given input pin configuration, provide the output configuration of this node. Outputs is already resized to the number of output pins.

Implements ezRenderPipelinePass.

◆ Serialize()

ezResult ezTonemapPass::Serialize ( ezStreamWriter inout_stream) const
overridevirtual

Reimplemented from ezRenderPipelinePass.


The documentation for this class was generated from the following files: