Open 3D Engine Atom Gem API Reference 23.10.0
O3DE is an open-source, fully-featured, high-fidelity, modular 3D engine for building games and simulations, available to every industry.
AZ::RHI::ShaderResourceGroupPool Class Reference

#include <ShaderResourceGroupPool.h>

Inherits AZ::RHI::ResourcePool.

Inherited by AZ::DX12::ShaderResourceGroupPool, AZ::Metal::ShaderResourceGroupPool, AZ::Null::ShaderResourceGroupPool, and AZ::Vulkan::ShaderResourceGroupPool.

Public Member Functions

 AZ_RTTI (ShaderResourceGroupPool, "{9AAB5A85-4063-4BAE-9A9C-E25640F18FFA}", ResourcePool)
 
ResultCode Init (Device &device, const ShaderResourceGroupPoolDescriptor &descriptor)
 Initializes the shader resource group pool.
 
ResultCode InitGroup (ShaderResourceGroup &srg)
 
ResultCode CompileGroup (ShaderResourceGroup &shaderResourceGroup, const ShaderResourceGroupData &shaderResourceGroupData)
 Compile Shader Resource Group with the associated ShaderResourceGroupData.
 
const ShaderResourceGroupPoolDescriptorGetDescriptor () const override
 Returns the descriptor passed at initialization time.
 
const ShaderResourceGroupLayoutGetLayout () const
 Returns the SRG layout used when initializing the pool.
 
void CompileGroupsBegin ()
 
void CompileGroupsEnd ()
 Ends compilation of the pool. Must be preceeded by a CompileGroupsBegin() call.
 
void CompileGroupsForInterval (Interval interval)
 Compiles an interval [min, max) of groups.
 
uint32_t GetGroupsToCompileCount () const
 Returns the total number of groups that need to be compiled.
 
bool HasConstants () const
 Returns whether layout in this pool has constants.
 
bool HasImageGroup () const
 Returns whether groups in this pool have an image table.
 
bool HasBufferGroup () const
 Returns whether groups in this pool have a buffer table.
 
bool HasSamplerGroup () const
 Returns whether groups in this pool have a sampler table.
 
- Public Member Functions inherited from AZ::RHI::ResourcePool
 AZ_RTTI (ResourcePool, "{757EB674-25DC-4D00-9808-D3DAF33A4EFE}", DeviceObject)
 
void Shutdown () override final
 Shuts down the pool. This method will shutdown all resources associated with the pool.
 
template<typename ResourceType >
void ForEach (AZStd::function< void(ResourceType &)> callback)
 
template<typename ResourceType >
void ForEach (AZStd::function< void(const ResourceType &)> callback) const
 
uint32_t GetResourceCount () const
 Returns the number of resources in the pool.
 
ResourcePoolResolverGetResolver ()
 Returns the resolver for this pool.
 
const ResourcePoolResolverGetResolver () const
 
virtual const ResourcePoolDescriptorGetDescriptor () const =0
 Returns the resource pool descriptor.
 
const HeapMemoryUsageGetHeapMemoryUsage (HeapMemoryLevel heapMemoryLevel) const
 Returns the memory used by this pool for a specific heap type.
 
const PoolMemoryUsageGetMemoryUsage () const
 Returns the memory used by this pool.
 
- Public Member Functions inherited from AZ::RHI::DeviceObject
 AZ_RTTI (DeviceObject, "{17D34F71-944C-4AF5-9823-627474C4C0A6}", Object)
 
bool IsInitialized () const
 Returns whether the device object is initialized.
 
DeviceGetDevice () const
 
- Public Member Functions inherited from AZ::RHI::Object
 AZ_RTTI (Object, "{E43378F1-2331-4173-94B8-990ED20E6003}")
 
void SetName (const Name &name)
 Sets the name of the object.
 
const Name & GetName () const
 Returns the name set on the object by SetName.
 
uint32_t use_count ()
 Returns the current use count of the object.
 

Protected Member Functions

void ComputeFragmentation () const override
 
- Protected Member Functions inherited from AZ::RHI::ResourcePool
void OnFrameBegin () override
 
void OnFrameCompile () override
 
void OnFrameEnd () override
 
void SetResolver (AZStd::unique_ptr< ResourcePoolResolver > &&resolvePolicy)
 
virtual void ComputeFragmentation () const =0
 
ResultCode Init (Device &device, const ResourcePoolDescriptor &descriptor, const PlatformMethod &initMethod)
 
ResultCode InitResource (Resource *resource, const PlatformMethod &initResourceMethod)
 
bool ValidateIsRegistered (const Resource *resource) const
 
bool ValidateIsUnregistered (const Resource *resource) const
 
bool ValidateIsInitialized () const
 Validates that the resource pool is initialized and ready to service requests.
 
bool ValidateNotProcessingFrame () const
 Validates that we are not in the frame processing phase.
 
- Protected Member Functions inherited from AZ::RHI::DeviceObject
void Init (Device &device)
 The derived class should call this method to assign the device.
 
void Shutdown () override
 Clears the current bound device to null.
 
- Protected Member Functions inherited from AZ::RHI::Object
void add_ref () const
 
void release () const
 

Friends

class ShaderResourceGroup
 

Additional Inherited Members

- Protected Types inherited from AZ::RHI::ResourcePool
using PlatformMethod = AZStd::function< RHI::ResultCode()>
 A simple functor that returns a result code.
 
- Protected Attributes inherited from AZ::RHI::ResourcePool
PoolMemoryUsage m_memoryUsage
 
- Protected Attributes inherited from AZ::RHI::Object
AZStd::atomic_int m_useCount = 0
 

Detailed Description

The platform-independent base class for ShaderResourceGroupPools. Platforms should inherit from this class to implement platform-dependent pooling of shader resource groups.

Member Function Documentation

◆ CompileGroupsBegin()

void AZ::RHI::ShaderResourceGroupPool::CompileGroupsBegin ( )

Begins compilation of the pool. Cannot be called recursively.

Parameters
groupsToCompileCountif non-null, is assigned to the number of groups needing to be compiled.

◆ ComputeFragmentation()

void AZ::RHI::ShaderResourceGroupPool::ComputeFragmentation ( ) const
inlineoverrideprotectedvirtual

Compute the memory fragmentation for each constituent heap and store the results in m_memoryUsage. This method is invoked when memory statistics gathering is active.

Implements AZ::RHI::ResourcePool.

◆ GetDescriptor()

const ShaderResourceGroupPoolDescriptor & AZ::RHI::ShaderResourceGroupPool::GetDescriptor ( ) const
overridevirtual

Returns the descriptor passed at initialization time.

Implements AZ::RHI::ResourcePool.

◆ InitGroup()

ResultCode AZ::RHI::ShaderResourceGroupPool::InitGroup ( ShaderResourceGroup srg)

Initializes the resource group and associates it with the pool. The resource group must be updated on this pool.


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