Provides render target management functionality. More...

#include <IRenderTargets.h>

Inheritance diagram for Cogs::IRenderTargets:

Public Member Functions
virtual void	annotate (RenderTargetHandle handle, const StringView &name)
	Associate a name with an object for use in graphics debugging.

virtual void	annotate (DepthStencilHandle handle, const StringView &name)
	Associate a name with an object for use in graphics debugging.

virtual RenderTargetHandle	createRenderTarget (TextureHandle textureHandle)
	Create a render target using the given texture to render into.

virtual RenderTargetHandle	createRenderTarget (TextureHandle *textureHandles, const size_t numTextureHandles)
	Create a multi render target (MRT) with using the given textures to render into.

virtual RenderTargetHandle	createRenderTarget (const RenderTargetViewDescription *renderTargetViews, const size_t numViews)=0
	Create a render target using the given view descriptions.

virtual RenderTargetHandle	createRenderTarget (const RenderTargetViewDescription *, const size_t, const MultiViewDescription &)

virtual void	releaseRenderTarget (RenderTargetHandle renderTargetHandle)=0
	Release the render target with the given renderTargetHandle.

virtual DepthStencilHandle	createDepthStencilTarget (const RenderTargetHandle handle)=0
	Creates a depth/stencil target to back the render target with the given handle.

virtual DepthStencilHandle	createDepthStencilTarget (const RenderTargetHandle handle, const TextureHandle textureHandle)=0
	Creates a depth/stencil target to back the render target with the given handle.

virtual DepthStencilHandle	createDepthStencilTarget (const RenderTargetHandle handle, const DepthStencilViewDescription &depthStencilView)=0
	Creates a depth stencil view using the given description.

virtual DepthStencilHandle	createDepthStencilTarget (const RenderTargetHandle, const DepthStencilViewDescription &, const MultiViewDescription &)

virtual void	releaseDepthStencilTarget (DepthStencilHandle depthStencilHandle)=0
	Release the depth target with the given depthStencilHandle.

virtual DepthStencilStateHandle	loadDepthStencilState (const DepthStencilState &depthStencilState)=0
	Load a depth stencil state object.

virtual void	releaseDepthStencilState (DepthStencilStateHandle handle)=0
	Release the depth stencil state with the given handle.

virtual RasterizerStateHandle	loadRasterizerState (const RasterizerState &rasterizerState)=0
	Load a rasterizer state object.

virtual void	releaseRasterizerState (RasterizerStateHandle handle)=0
	Release the rasterizer state with the given handle.

virtual BlendStateHandle	loadBlendState (const BlendState &blendState)=0
	Load a blend state object.

virtual BlendStateHandle	loadBlendState (const BlendState &blendStateColor, const BlendState &blendStateAlpha)
	Load a blend state object with separate blending for alpha channel.

virtual BlendStateHandle	loadBlendState (const BlendState &blendStateColor, const BlendState &blendStateAlpha, const uint32_t flags)

virtual BlendStateHandle	loadBlendState (const BlendState blendStateColor, const BlendState blendStateAlpha, const uint32_t numBlendStates, const uint32_t flags)

virtual void	releaseBlendState (BlendStateHandle handle)=0
	Release the blend state with the given handle.

virtual void	releaseResources ()=0
	Release all allocated render target resources.

Detailed Description

Provides render target management functionality.

Definition at line 58 of file IRenderTargets.h.

Member Function Documentation

◆ annotate() [1/2]

virtual void Cogs::IRenderTargets::annotate	(	DepthStencilHandle	handle,
		const StringView &	name
	)

inlinevirtual

Associate a name with an object for use in graphics debugging.

Reimplemented in Cogs::RenderTargetsD3D11, Cogs::RenderTargetsGL20, Cogs::RenderTargetsNull, and Cogs::RenderTargetsWebGPU.

Definition at line 68 of file IRenderTargets.h.

◆ annotate() [2/2]

virtual void Cogs::IRenderTargets::annotate	(	RenderTargetHandle	handle,
		const StringView &	name
	)

inlinevirtual

Associate a name with an object for use in graphics debugging.

Reimplemented in Cogs::RenderTargetsD3D11, Cogs::RenderTargetsGL20, Cogs::RenderTargetsNull, and Cogs::RenderTargetsWebGPU.

Definition at line 63 of file IRenderTargets.h.

◆ createDepthStencilTarget() [1/4]

virtual DepthStencilHandle Cogs::IRenderTargets::createDepthStencilTarget ( const RenderTargetHandle handle )

pure virtual

Creates a depth/stencil target to back the render target with the given handle.

The dimensions of the render target are matched and a suitable depth format for the graphics device is chosen.

Parameters

handle Valid handle to a render target to create depth target backing for.

Returns: Handle to the newly created depth target, InvalidHandle if the operation failed.

Implemented in Cogs::RenderTargetsD3D12, Cogs::RenderTargetsD3D11, Cogs::RenderTargetsGL20, Cogs::RenderTargetsGLES30, Cogs::RenderTargetsVK, Cogs::RenderTargetsWebGPU, and Cogs::RenderTargetsNull.

◆ createDepthStencilTarget() [2/4]

virtual DepthStencilHandle Cogs::IRenderTargets::createDepthStencilTarget	(	const RenderTargetHandle	handle,
		const DepthStencilViewDescription &	depthStencilView
	)

pure virtual

Creates a depth stencil view using the given description.

Parameters

handle	Valid handle to a render target to create depth target backing for.
depthStencilView	Depth stencil view description.

Returns: Handle to the newly created depth stencil target, InvalidHandle if the operation failed.

Implemented in Cogs::RenderTargetsD3D11, Cogs::RenderTargetsD3D12, Cogs::RenderTargetsGL20, Cogs::RenderTargetsGLES30, Cogs::RenderTargetsVK, Cogs::RenderTargetsWebGPU, and Cogs::RenderTargetsNull.

References Cogs::Handle_t< DepthStencilTag >::InvalidHandle.

◆ createDepthStencilTarget() [3/4]

virtual DepthStencilHandle Cogs::IRenderTargets::createDepthStencilTarget	(	const RenderTargetHandle	handle,
		const TextureHandle	textureHandle
	)

pure virtual

Creates a depth/stencil target to back the render target with the given handle.

The texture with the given textureHandle is used as backing for the depth target. The texture must be of a format that supports depth values, and be flagged for use as a depth texture.

Parameters

handle	Valid handle to a render target to create depth target backing for.
textureHandle	Valid handle to a texture to use as backing to render depth values to.

Returns: Handle to the newly created depth stencil target, InvalidHandle if the operation failed.

Implemented in Cogs::RenderTargetsD3D12, Cogs::RenderTargetsD3D11, Cogs::RenderTargetsGL20, Cogs::RenderTargetsGLES30, Cogs::RenderTargetsVK, Cogs::RenderTargetsWebGPU, and Cogs::RenderTargetsNull.

◆ createDepthStencilTarget() [4/4]

virtual DepthStencilHandle Cogs::IRenderTargets::createDepthStencilTarget	(	const	RenderTargetHandle,
		const DepthStencilViewDescription &	,
		const MultiViewDescription &
	)

inlinevirtual

Definition at line 153 of file IRenderTargets.h.

◆ createRenderTarget() [1/4]

virtual RenderTargetHandle Cogs::IRenderTargets::createRenderTarget	(	const RenderTargetViewDescription *	,
		const	size_t,
		const MultiViewDescription &
	)

inlinevirtual

Definition at line 110 of file IRenderTargets.h.

◆ createRenderTarget() [2/4]

virtual RenderTargetHandle Cogs::IRenderTargets::createRenderTarget	(	const RenderTargetViewDescription *	renderTargetViews,
		const size_t	numViews
	)

pure virtual

Create a render target using the given view descriptions.

Parameters

renderTargetViews	Pointer to an array of render target view descriptions.
numViews	Number of views in the array pointed to by renderTargetViews.

Returns: Handle to a render target, InvalidHandle if the operation failed.

Implemented in Cogs::RenderTargetsNull, Cogs::RenderTargetsD3D11, Cogs::RenderTargetsD3D12, Cogs::RenderTargetsGL20, Cogs::RenderTargetsGLES30, Cogs::RenderTargetsVK, and Cogs::RenderTargetsWebGPU.

References Cogs::Handle_t< RenderTargetTag >::InvalidHandle.

◆ createRenderTarget() [3/4]

virtual RenderTargetHandle Cogs::IRenderTargets::createRenderTarget	(	TextureHandle *	textureHandles,
		const size_t	numTextureHandles
	)

inlinevirtual

Create a multi render target (MRT) with using the given textures to render into.

Parameters

textureHandles	Pointer to an array of valid texture handles to textures to use as render textures for the render target.
numTextureHandles	Number of textures to use as targets in the MRT.

Returns: Handle to the newly created render target, InvalidHandle if the operation failed.

Definition at line 88 of file IRenderTargets.h.

References createRenderTarget(), Cogs::RenderTargetViewDescription::layerIndex, Cogs::RenderTargetViewDescription::levelIndex, Cogs::RenderTargetViewDescription::numLayers, and Cogs::RenderTargetViewDescription::texture.

◆ createRenderTarget() [4/4]

virtual RenderTargetHandle Cogs::IRenderTargets::createRenderTarget ( TextureHandle textureHandle )

inlinevirtual

Create a render target using the given texture to render into.

Parameters

textureHandle Valid handle to a texture to use as render texture for the render target.

Returns: Handle to the newly created render target, InvalidHandle if the operation failed.

Definition at line 76 of file IRenderTargets.h.

References createRenderTarget().

Referenced by createRenderTarget().

◆ loadBlendState() [1/4]

virtual BlendStateHandle Cogs::IRenderTargets::loadBlendState ( const BlendState & blendState )

pure virtual

Load a blend state object.

Parameters

blendState Blend state object to load.

Returns: Handle to the newly loaded blend state object, InvalidHandle if the operation failed.

Implemented in Cogs::RenderTargetsD3D12, Cogs::RenderTargetsD3D11, Cogs::RenderTargetsNull, Cogs::RenderTargetsGL20, Cogs::RenderTargetsGLES30, Cogs::RenderTargetsVK, and Cogs::RenderTargetsWebGPU.

◆ loadBlendState() [2/4]

virtual BlendStateHandle Cogs::IRenderTargets::loadBlendState	(	const BlendState &	blendStateColor,
		const BlendState &	blendStateAlpha
	)

inlinevirtual

Load a blend state object with separate blending for alpha channel.

Parameters

blendStateColor	Blend state object for the color channels to load.
blendStateAlpha	Blend state object for the alpha channel to load.

Returns: Handle to the newly loaded blend state object, InvalidHandle if the operation failed.

Reimplemented in Cogs::RenderTargetsNull, Cogs::RenderTargetsD3D11, Cogs::RenderTargetsD3D12, Cogs::RenderTargetsGL20, Cogs::RenderTargetsGLES30, and Cogs::RenderTargetsWebGPU.

Definition at line 210 of file IRenderTargets.h.

References loadBlendState().

Referenced by loadBlendState().

◆ loadBlendState() [3/4]

virtual BlendStateHandle Cogs::IRenderTargets::loadBlendState	(	const BlendState &	blendStateColor,
		const BlendState &	blendStateAlpha,
		const uint32_t	flags
	)

inlinevirtual

Definition at line 212 of file IRenderTargets.h.

◆ loadBlendState() [4/4]

virtual BlendStateHandle Cogs::IRenderTargets::loadBlendState	(	const BlendState *	blendStateColor,
		const BlendState *	blendStateAlpha,
		const uint32_t	numBlendStates,
		const uint32_t	flags
	)

inlinevirtual

Definition at line 214 of file IRenderTargets.h.

◆ loadDepthStencilState()

virtual DepthStencilStateHandle Cogs::IRenderTargets::loadDepthStencilState ( const DepthStencilState & depthStencilState )

pure virtual

Load a depth stencil state object.

Parameters

depthStencilState Depth stencil state object to load.

Returns: Handle to the newly loaded depth stencil state object, InvalidHandle if the operation failed.

Implemented in Cogs::RenderTargetsD3D12, Cogs::RenderTargetsD3D11, Cogs::RenderTargetsNull, Cogs::RenderTargetsGL20, Cogs::RenderTargetsGLES30, Cogs::RenderTargetsVK, and Cogs::RenderTargetsWebGPU.

Referenced by Cogs::Core::Volumetric::OctRenderer::initialize().

◆ loadRasterizerState()

virtual RasterizerStateHandle Cogs::IRenderTargets::loadRasterizerState ( const RasterizerState & rasterizerState )

pure virtual

Load a rasterizer state object.

Parameters

rasterizerState Rasterizer state object to load.

Returns: Handle to the newly loaded rasterizer state object, InvalidHandle if the operation failed.

Implemented in Cogs::RenderTargetsD3D12, Cogs::RenderTargetsD3D11, Cogs::RenderTargetsNull, Cogs::RenderTargetsGL20, Cogs::RenderTargetsGLES30, Cogs::RenderTargetsVK, and Cogs::RenderTargetsWebGPU.

◆ releaseBlendState()

virtual void Cogs::IRenderTargets::releaseBlendState ( BlendStateHandle handle )

pure virtual

Release the blend state with the given handle.

Parameters

handle Valid handle to a blend state object.

Implemented in Cogs::RenderTargetsNull, Cogs::RenderTargetsWebGPU, Cogs::RenderTargetsD3D12, Cogs::RenderTargetsD3D11, Cogs::RenderTargetsGL20, Cogs::RenderTargetsGLES30, and Cogs::RenderTargetsVK.

◆ releaseDepthStencilState()

virtual void Cogs::IRenderTargets::releaseDepthStencilState ( DepthStencilStateHandle handle )

pure virtual

Release the depth stencil state with the given handle.

Parameters

handle Valid handle to a depth stencil state object.

Implemented in Cogs::RenderTargetsNull, Cogs::RenderTargetsWebGPU, Cogs::RenderTargetsD3D12, Cogs::RenderTargetsD3D11, Cogs::RenderTargetsGL20, Cogs::RenderTargetsGLES30, and Cogs::RenderTargetsVK.

◆ releaseDepthStencilTarget()

virtual void Cogs::IRenderTargets::releaseDepthStencilTarget ( DepthStencilHandle depthStencilHandle )

pure virtual

Release the depth target with the given depthStencilHandle.

Parameters

depthStencilHandle Valid handle to a previously created depth/stencil target.

Implemented in Cogs::RenderTargetsNull, Cogs::RenderTargetsGL20, Cogs::RenderTargetsGLES30, Cogs::RenderTargetsVK, Cogs::RenderTargetsD3D12, Cogs::RenderTargetsD3D11, and Cogs::RenderTargetsWebGPU.

◆ releaseRasterizerState()

virtual void Cogs::IRenderTargets::releaseRasterizerState ( RasterizerStateHandle handle )

pure virtual

Release the rasterizer state with the given handle.

Parameters

handle Valid handle to a rasterizer state object.

Implemented in Cogs::RenderTargetsD3D12, Cogs::RenderTargetsD3D11, Cogs::RenderTargetsGL20, Cogs::RenderTargetsGLES30, Cogs::RenderTargetsVK, Cogs::RenderTargetsNull, and Cogs::RenderTargetsWebGPU.

◆ releaseRenderTarget()

virtual void Cogs::IRenderTargets::releaseRenderTarget ( RenderTargetHandle renderTargetHandle )

pure virtual

Release the render target with the given renderTargetHandle.

Parameters

renderTargetHandle Valid handle to a previously created render target.

Implemented in Cogs::RenderTargetsD3D11, Cogs::RenderTargetsD3D12, Cogs::RenderTargetsWebGPU, Cogs::RenderTargetsNull, Cogs::RenderTargetsGL20, Cogs::RenderTargetsGLES30, and Cogs::RenderTargetsVK.

◆ releaseResources()

virtual void Cogs::IRenderTargets::releaseResources ( )

pure virtual

Release all allocated render target resources.

Implemented in Cogs::RenderTargetsD3D12, Cogs::RenderTargetsD3D11, Cogs::RenderTargetsNull, Cogs::RenderTargetsGL20, Cogs::RenderTargetsGLES30, Cogs::RenderTargetsVK, and Cogs::RenderTargetsWebGPU.

The documentation for this struct was generated from the following file:

D:/a/1/s/Cogs/Cogs.Rendering/Source/IRenderTargets.h

Public Member Functions

Detailed Description

Member Function Documentation

◆ annotate() [1/2]

◆ annotate() [2/2]

◆ createDepthStencilTarget() [1/4]

◆ createDepthStencilTarget() [2/4]

◆ createDepthStencilTarget() [3/4]

◆ createDepthStencilTarget() [4/4]

◆ createRenderTarget() [1/4]

◆ createRenderTarget() [2/4]

◆ createRenderTarget() [3/4]

◆ createRenderTarget() [4/4]

◆ loadBlendState() [1/4]

◆ loadBlendState() [2/4]

◆ loadBlendState() [3/4]

◆ loadBlendState() [4/4]

◆ loadDepthStencilState()

◆ loadRasterizerState()

◆ releaseBlendState()

◆ releaseDepthStencilState()

◆ releaseDepthStencilTarget()

◆ releaseRasterizerState()

◆ releaseRenderTarget()

◆ releaseResources()