Open 3D Engine Atom Gem API Reference
23.05.0
O3DE is an open-source, fully-featured, high-fidelity, modular 3D engine for building games and simulations, available to every industry.
|
#include <Resource.h>
Inherits AZ::RHI::DeviceObject.
Inherited by AZ::RHI::Buffer, AZ::RHI::Image, AZ::RHI::Query, and AZ::RHI::ShaderResourceGroup.
Public Member Functions | |
AZ_RTTI (Resource,"{9D02CDAC-80EB-4B77-8E62-849AC6E69206}", DeviceObject) | |
bool | IsAttachment () const |
Returns whether the resource is currently an attachment on a frame graph. | |
void | Shutdown () overridefinal |
Shuts down the buffer by detaching it from its parent pool. | |
const ResourcePool * | GetPool () const |
ResourcePool * | GetPool () |
uint32_t | GetVersion () const |
virtual void | ReportMemoryUsage (MemoryStatisticsBuilder &builder) const =0 |
Reports memory usage of this image to the memory statistics builder. | |
const FrameAttachment * | GetFrameAttachment () const |
Returns the frame attachment associated with this image (if it exists). | |
void | InvalidateViews () |
bool | IsInResourceCache (const ImageViewDescriptor &imageViewDescriptor) |
Returns true if the ResourceView is in the cache. | |
bool | IsInResourceCache (const BufferViewDescriptor &bufferViewDescriptor) |
void | EraseResourceView (ResourceView *resourceView) const |
Removes the provided ResourceView from the cache. | |
![]() | |
AZ_RTTI (DeviceObject,"{17D34F71-944C-4AF5-9823-627474C4C0A6}", Object) | |
bool | IsInitialized () const |
Returns whether the device object is initialized. | |
Device & | GetDevice () const |
![]() | |
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 | |
Ptr< ImageView > | GetResourceView (const ImageViewDescriptor &imageViewDescriptor) const |
Returns view based on the descriptor. | |
Ptr< BufferView > | GetResourceView (const BufferViewDescriptor &bufferViewDescriptor) const |
![]() | |
void | Init (Device &device) |
The derived class should call this method to assign the device. | |
![]() | |
void | add_ref () const |
void | release () const |
Friends | |
class | FrameAttachment |
class | ResourcePool |
Additional Inherited Members | |
![]() | |
AZStd::atomic_int | m_useCount = 0 |
ResourceBase is a base class for pooled RHI resources (Image / Buffer / ShaderResourceGroup, etc). It provides some common lifecycle management semantics. Resource creation is separate from initialization. Resources are created separate from any pool, but its backing platform data is associated at initialization time on a specific pool.
const ResourcePool* AZ::RHI::Resource::GetPool | ( | ) | const |
Returns the parent pool this resource is registered on. Since resource creation is separate from initialization, this will be null until the resource is registered on a pool.
uint32_t AZ::RHI::Resource::GetVersion | ( | ) | const |
Returns the version number. This number is monotonically increased anytime new platform memory is assigned to the resource. Any dependent resource is valid so long as the version numbers match.
void AZ::RHI::Resource::InvalidateViews | ( | ) |
Invalidates all views referencing this resource. Invalidation is handled implicitly on a Shutdown / Init cycle from the pool. For example, it is safe to create a resource, create a view to that resource, and then Shutdown / Re-Init the resource. InvalidateViews is called to synchronize views (and shader resource groups which hold them) to the new data.
Platform back-ends which invalidate GPU-specific data on the resource without an explicit shutdown / re-initialization will need to call this method explicitly.