XII Release 0.1.0
Loading...
Searching...
No Matches
Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
xiiTexture2DResource Class Reference
Inheritance diagram for xiiTexture2DResource:
[legend]

Public Member Functions

XII_ALWAYS_INLINE xiiEnum< xiiGALResourceFormat > GetFormat () const
 
XII_ALWAYS_INLINE xiiUInt32 GetWidth () const
 
XII_ALWAYS_INLINE xiiUInt32 GetHeight () const
 
XII_ALWAYS_INLINE xiiEnum< xiiGALResourceDimension > GetType () const
 
xiiSharedPtr< xiiGALTexture > GetGALTexture () const
 
xiiSharedPtr< xiiGALSampler > GetGALSampler () const
 
- Public Member Functions inherited from xiiResource
XII_ALWAYS_INLINE xiiStringView GetResourceID () const
 Returns the unique ID that identifies this resource. On a file resource this might be a path. Can also be a GUID or any other scheme that uniquely identifies the resource.
 
XII_ALWAYS_INLINE xiiUInt64 GetResourceIDHash () const
 Returns the hash of the unique ID.
 
void SetResourceDescription (xiiStringView sDescription)
 The resource description allows to store an additional string that might be more descriptive during debugging, than the unique ID.
 
const xiiString & GetResourceDescription () const
 The resource description allows to store an additional string that might be more descriptive during debugging, than the unique ID.
 
const xiiString & GetResourceIdOrDescription () const
 The returns the resource description, if available, otherwise the resource ID.
 
XII_ALWAYS_INLINE xiiResourceState GetLoadingState () const
 Returns the current state in which this resource is in.
 
XII_ALWAYS_INLINE xiiUInt8 GetNumQualityLevelsDiscardable () const
 Returns the current maximum quality level that the resource could have.
 
XII_ALWAYS_INLINE xiiUInt8 GetNumQualityLevelsLoadable () const
 Returns how many quality levels the resource may additionally load.
 
float GetLoadingPriority (xiiTime now) const
 Returns the priority that is used by the resource manager to determine which resource to load next.
 
xiiResourcePriority GetPriority () const
 Returns the current resource priority.
 
void SetPriority (xiiResourcePriority priority)
 Changes the current resource priority.
 
XII_ALWAYS_INLINE const xiiBitflags< xiiResourceFlags > & GetBaseResourceFlags () const
 Returns the basic flags for the resource type. Mostly used the resource manager.
 
XII_ALWAYS_INLINE const MemoryUsage & GetMemoryUsage () const
 Returns the information about the current memory usage of the resource.
 
XII_ALWAYS_INLINE xiiTime GetLastAcquireTime () const
 Returns the time at which the resource was (tried to be) acquired last. If a resource is acquired using xiiResourceAcquireMode::PointerOnly, this does not update the last acquired time, since the resource is not acquired for full use.
 
XII_ALWAYS_INLINE xiiInt32 GetReferenceCount () const
 Returns the reference count of this resource.
 
XII_ALWAYS_INLINE const xiiTimestamp & GetLoadedFileModificationTime () const
 Returns the modification date of the file from which this resource was loaded.
 
XII_ALWAYS_INLINE xiiUInt32 GetCurrentResourceChangeCounter () const
 Returns the current value of the resource change counter. Can be used to detect whether the resource has changed since using it last time.
 
XII_ALWAYS_INLINE void IncResourceChangeCounter ()
 Allows to manually increase the resource change counter to signal that dependent code might need to update.
 
virtual void ResetResource ()
 If the resource has modifications from the original state, it should reset itself to that state now (or force a reload on itself).
 
void PrintHandleStackTraces ()
 Prints the stack-traces for all handles that currently reference this resource.
 
- Public Member Functions inherited from xiiReflectedClass
virtual const xiiRTTI * GetDynamicRTTI () const
 
bool IsInstanceOf (const xiiRTTI *pType) const
 Returns whether the type of this instance is of the given type or derived from it.
 
template<typename T>
XII_ALWAYS_INLINE bool IsInstanceOf () const
 Returns whether the type of this instance is of the given type or derived from it.
 

Static Public Member Functions

static void FillOutDescriptor (xiiTexture2DResourceDescriptor &ref_td, const xiiImage *pImage, bool bSRGB, xiiUInt32 uiNumMipLevels, xiiUInt32 &out_uiMemoryUsed, xiiHybridArray< xiiGALTextureSubResourceData, 32 > &ref_initData)
 
- Static Public Member Functions inherited from xiiNoBase
static const xiiRTTI * GetStaticRTTI ()
 

Protected Member Functions

virtual xiiResourceLoadDesc UnloadData (Unload WhatToUnload) override
 Requests the resource to unload another quality level. If bFullUnload is true, the resource should unload all data, because it is going to be deleted afterwards.
 
virtual xiiResourceLoadDesc UpdateContent (xiiStreamReader *Stream) override
 Called whenever more data for the resource is available. The resource must read the stream to update it's data.
 
virtual void UpdateMemoryUsage (MemoryUsage &out_NewMemoryUsage) override
 This function must be overridden by all resource types.
 
 xiiTexture2DResource (DoUpdate ResourceUpdateThread)
 
- Protected Member Functions inherited from xiiResource
 xiiResource (DoUpdate ResourceUpdateThread, xiiUInt8 uiQualityLevelsLoadable)
 Default constructor.
 
virtual ~xiiResource ()
 virtual destructor.
 
MemoryUsage & ModifyMemoryUsage ()
 Non-const version for resources that want to write this variable directly.
 
void SetIsReloadable (bool bIsReloadable)
 Call this to specify whether a resource is reloadable.
 
void SetHasLoadingFallback (bool bHasLoadingFallback)
 Used internally by the code injection macros.
 

Protected Attributes

xiiUInt8 m_uiLoadedTextures = 0
 
xiiSharedPtr< xiiGALTexture > m_pGALTexture [2]
 
xiiUInt32 m_uiMemoryGPU [2] = {0, 0}
 
xiiEnum< xiiGALResourceDimension > m_Type = xiiGALResourceDimension::Undefined
 
xiiEnum< xiiGALResourceFormat > m_Format = xiiGALResourceFormat::Unknown
 
xiiUInt32 m_uiWidth = 0
 
xiiUInt32 m_uiHeight = 0
 
xiiSharedPtr< xiiGALSampler > m_pSampler
 

Additional Inherited Members

- Public Types inherited from xiiResource
enum class  DoUpdate { OnMainThread , OnAnyThread , OnGraphicsResourceThreads }
 
- Public Attributes inherited from xiiResource
xiiEvent< const xiiResourceEvent &, xiiMutex > m_ResourceEvents
 
- Static Public Attributes inherited from xiiResource
static DoUpdate UpdateGraphicsResource = xiiResource::DoUpdate::OnAnyThread
 
- Protected Types inherited from xiiResource
enum class  Unload { AllQualityLevels , OneQualityLevel }
 

Member Function Documentation

◆ UnloadData()

xiiResourceLoadDesc xiiTexture2DResource::UnloadData ( Unload WhatToUnload)
overrideprotectedvirtual

Requests the resource to unload another quality level. If bFullUnload is true, the resource should unload all data, because it is going to be deleted afterwards.

Implements xiiResource.

Reimplemented in xiiRenderToTexture2DResource.

◆ UpdateContent()

xiiResourceLoadDesc xiiTexture2DResource::UpdateContent ( xiiStreamReader * pStream)
overrideprotectedvirtual

Called whenever more data for the resource is available. The resource must read the stream to update it's data.

pStream may be nullptr in case the resource data could not be found.

Implements xiiResource.

Reimplemented in xiiRenderToTexture2DResource.

◆ UpdateMemoryUsage()

void xiiTexture2DResource::UpdateMemoryUsage ( MemoryUsage & out_NewMemoryUsage)
overrideprotectedvirtual

This function must be overridden by all resource types.

It has to compute the memory used by this resource. It is called by the resource manager whenever the resource's data has been loaded or unloaded.

Implements xiiResource.

Reimplemented in xiiRenderToTexture2DResource.

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