LiteFX::Rendering::IDescriptorSet Class Reference

The interface for a descriptor set. More...

#include <rendering_api.hpp>

Inherited by LiteFX::Rendering::DescriptorSet< IDirectX12Buffer, IDirectX12Image, IDirectX12Sampler, IDirectX12AccelerationStructure >, LiteFX::Rendering::DescriptorSet< IVulkanBuffer, IVulkanImage, IVulkanSampler, IVulkanAccelerationStructure >, and LiteFX::Rendering::DescriptorSet< TBuffer, TImage, TSampler, TAccelerationStructure >.

Public Member Functions
virtual	~IDescriptorSet () noexcept=default
void	update (UInt32 binding, const IBuffer &buffer, UInt32 bufferElement=0, UInt32 elements=0, UInt32 firstDescriptor=0) const
	Updates one or more buffer descriptors within the current descriptor set.
void	update (UInt32 binding, const IImage &texture, UInt32 descriptor=0, UInt32 firstLevel=0, UInt32 levels=0, UInt32 firstLayer=0, UInt32 layers=0) const
	Updates one or more texture descriptors within the current descriptor set.
void	update (UInt32 binding, const ISampler &sampler, UInt32 descriptor=0) const
	Updates one or more sampler descriptors within the current descriptor set.
void	update (UInt32 binding, const IAccelerationStructure &accelerationStructure, UInt32 descriptor=0) const
	Updates an acceleration structure within the current descriptor set.

Protected Member Functions
	IDescriptorSet () noexcept=default
	IDescriptorSet (const IDescriptorSet &)=default
	IDescriptorSet (IDescriptorSet &&) noexcept=default
IDescriptorSet &	operator= (const IDescriptorSet &)=default
IDescriptorSet &	operator= (IDescriptorSet &&) noexcept=default

Detailed Description

The interface for a descriptor set.

Constructor & Destructor Documentation

IDescriptorSet() [1/3]

LiteFX::Rendering::IDescriptorSet::IDescriptorSet ( )

protecteddefaultnoexcept

IDescriptorSet() [2/3]

LiteFX::Rendering::IDescriptorSet::IDescriptorSet ( const IDescriptorSet & )

protecteddefault

IDescriptorSet() [3/3]

LiteFX::Rendering::IDescriptorSet::IDescriptorSet ( IDescriptorSet && )

protecteddefaultnoexcept

~IDescriptorSet()

virtual LiteFX::Rendering::IDescriptorSet::~IDescriptorSet ( )

virtualdefaultnoexcept

Member Function Documentation

operator=() [1/2]

IDescriptorSet & LiteFX::Rendering::IDescriptorSet::operator= ( const IDescriptorSet & )

protecteddefault

operator=() [2/2]

IDescriptorSet & LiteFX::Rendering::IDescriptorSet::operator= ( IDescriptorSet && )

protecteddefaultnoexcept

update() [1/4]

void LiteFX::Rendering::IDescriptorSet::update ( UInt32 binding, const IAccelerationStructure & accelerationStructure, UInt32 descriptor = 0 ) const

inline

Updates an acceleration structure within the current descriptor set.

Parameters

binding	The acceleration structure binding point.
accelerationStructure	The acceleration structure to write to the descriptor set.
descriptor	The index of the descriptor in the descriptor array to bind the acceleration structure to.

update() [2/4]

void LiteFX::Rendering::IDescriptorSet::update ( UInt32 binding, const IBuffer & buffer, UInt32 bufferElement = 0, UInt32 elements = 0, UInt32 firstDescriptor = 0 ) const

inline

Updates one or more buffer descriptors within the current descriptor set.

Parameters

binding	The buffer binding point.
buffer	The buffer to write to the descriptor set.
bufferElement	The index of the first element in the buffer to bind to the descriptor set.
elements	The number of elements from the buffer to bind to the descriptor set. A value of 0 binds all available elements, starting at bufferElement .
firstDescriptor	The index of the first descriptor in the descriptor array to update.

update() [3/4]

void LiteFX::Rendering::IDescriptorSet::update ( UInt32 binding, const IImage & texture, UInt32 descriptor = 0, UInt32 firstLevel = 0, UInt32 levels = 0, UInt32 firstLayer = 0, UInt32 layers = 0 ) const

inline

Updates one or more texture descriptors within the current descriptor set.

The exact representation of the level and layer parameters depends on the dimension of the provided texture, as well as the type of the descriptor identified by the binding parameter.

If the texture itself is not an array (i.e. the number of layers equals 1), the parameters firstLayer and layers are ignored.

The descriptor type dictates, how mip-maps can be provided. If the descriptor type identifies a writable texture, the firstLevel parameter specifies the mip-map level to write to (or read from). Multiple levels are not allowed in this case, so the levels parameter is ignored. Instead, you have to bind them to separate descriptors. Furthermore, the firstLayer and layers parameter can be used to specify the number of depth or W-slices of a writable 3D texture or the side(s) of a cube map.

Parameters

binding	The texture binding point.
texture	The texture to write to the descriptor set.
descriptor	The index of the descriptor in the descriptor array to bind the texture to.
firstLevel	The index of the first mip-map level to bind.
levels	The number of mip-map levels to bind. A value of 0 binds all available levels, starting at firstLevel .
firstLayer	The index of the first layer to bind.
layers	The number of layers to bind. A value of 0 binds all available layers, starting at firstLayer .

update() [4/4]

void LiteFX::Rendering::IDescriptorSet::update ( UInt32 binding, const ISampler & sampler, UInt32 descriptor = 0 ) const

inline

Updates one or more sampler descriptors within the current descriptor set.

Parameters

binding	The sampler binding point.
sampler	The sampler to write to the descriptor set.
descriptor	The index of the descriptor in the descriptor array to bind the sampler to.