Material instance manager handles creation, processing and lifetime for MaterialInstance resources. More...

#include <MaterialManager.h>

Inheritance diagram for Cogs::Core::MaterialInstanceManager:

Public Member Functions
	MaterialInstanceManager (Context *context)
	Constructs a MaterialInstanceManager in the given context.

	~MaterialInstanceManager ()
	Destructs the MaterialInstanceManager.

void	initialize () override
	Initialize the MaterialInstanceManager.

void	initializeDefaultMaterialInstance ()

MaterialInstanceHandle	createMaterialInstance (const MaterialHandle &material)
	Create a new MaterialInstance from the Material given held by material.

MaterialInstanceHandle	getMaterialInstance (const StringView &name)

ActivationResult	handleActivation (MaterialInstanceHandle handle, MaterialInstance *resource) override
	Overridden to handle activation of MaterialInstances, updating the resource in the renderer.

void	handleDeletion (MaterialInstance *resource) override
	Overridden to handle material instance deletion, removing the resource from the renderer.

int	getUpdateQuota () const override

Public Member Functions inherited from Cogs::Core::ResourceManager< MaterialInstance, ResourceLoadInfoBase >
	ResourceManager (Context *context, Collections::ElementOffset capacity=1024)
	Constructs a resource manager with the given context.

	~ResourceManager () override
	Destructs a resource manager, provided for destruction via base pointer.

void	clear () override
	Clear the resource manager, cleaning up resources held by member handles.

void	clearSwapping () override
	Clear the swap queue, ensuring indirect resource references are released.

ResourceHandle	create ()
	Create a new resource.

ResourceHandle	release (ResourceId resourceId)

ResourceHandle	loadResource (ResourceLoadInfoBase *loadInfo)

ResourceProxy	createLocked ()
	Creates a new resource, but returns a ResourceProxy for thread safe editing instead of a handle to the actual resource.

ResourceProxy	lock (const ResourceHandle &handle)
	Takes the handle given and returns a resource proxy to edit the contents of the held resource safely on other threads than the main thread.

void	unlockProxy (const ResourceHandle &handle, const ResourceHandle &proxy)
	Unlock the given resource proxy.

ResourceHandle	generateHandle (ResourceBase *resource)
	Generate a handle to the given resource.

virtual void	handleLoad (ResourceLoadInfoBase *)
	Handler for resource loading.

virtual void	handleFailedLoad (const ResourceLoadInfoBase *)
	Handler for failed resource loads using the given loadInfo.

virtual ActivationResult	handleActivation (ResourceHandle, MaterialInstance *)
	Handler for activation of resources.

virtual void	handleDeletion (MaterialInstance *)
	Handler for deletion of resources.

MaterialInstance *	get (const ResourceHandleBase &handle)
	Resolve the given handle to a resource.

void	processSwapping () override
	Process queued swap operations, exchanging resource contents of the destination resources by those indicated in the operation data.

ResourceHandle	getHandle (const ResourceId id) const
	Get a resource handle to the resource with the given id.

void	registerLoader (IResourceLoader< MaterialInstance, ResourceLoadInfoBase > *loader)
	Register a resource loader capable of handling resources of the template type.

void	destroyLoadInfoInternal (ResourceLoadInfoBase *loadInfo) override

ResourceLoadInfoBase *	createLoadInfo ()

Public Member Functions inherited from Cogs::Core::ResourceManagerBase
	ResourceManagerBase (Context *context)

void	initialize () override

void	clear () override

void	reportLeaks (std::string_view typeName)

std::string	getReport ()
	Return a string with current resource usage.

bool	checkPreloaded (ResourceLoadInfoBase *loadInfo)

ResourceHandleBase	releaseInternal (ResourceId resourceId)
	Releases a resourceId -> ResourceHandle mapping.

ResourceHandleBase	loadResourceInternal (ResourceLoadInfoBase *loadInfo)
	Load a resource using the given loadInfo.

void	processLoading () final
	Process loading resources.

void	setProcessed (ResourceLoadInfoBase *loadInfo, bool swapping=false)
	Signal the resource being loaded as done loading and ready for activation etc.

void	activateResources () final

virtual void	processDeletion () override
	Process resources pending deallocation.

void	fillDeletionQueue (std::vector< ResourceBase * > &deletion)

void	destroyLocked (ResourceBase *resource)

void	safeDestroy (ResourceBase *resource)

ResourceId	getNextResourceId () override
	Get the next unique resource id.

void	resourceChanged (ResourceBase *resource) override

void	resourceDeleted (ResourceBase *resource) override

void	setResourceId (ResourceBase *resource, ResourceId id) override
	Assign the given id to a previously created resource.

void	queueResource (ResourceLoadInfoBase *loadInfo)
	Re-queue the given loadInfo to defer loading to the next time the processLoading() phase is performed.

virtual void	handleLoadInternal (ResourceLoadInfoBase *loadInfo)=0

virtual ActivationResult	handleActivationInternal (ResourceHandleBase r, ResourceBase *resource)=0

virtual void	handleDeletionInternal (ResourceBase *resource)=0

virtual void	handleFailedLoadInternal (ResourceLoadInfoBase *loadInfo)=0

virtual void	destroyLoadInfoInternal (ResourceLoadInfoBase *loadInfo)=0

virtual bool	shouldAutoReload () const

virtual bool	shouldMergeBySource () const

virtual void	handleReload (ResourceHandleBase)

std::vector< ResourceBase * >	getAllocatedResources () const

ResourceHandleBase	getOrCreate (ResourceId id)

ResourceHandleBase	getByName (std::string_view name) const

ResourceHandleBase	getBySource (std::string_view source) const

ResourceHandleBase	createResource ()

virtual ResourceBase *	createInternal ()=0

virtual void	destroyInternal (ResourceBase *resource)=0

virtual void	destroyInternalLocked (ResourceBase *resource)=0

ResourceHandleBase	generateHandle (ResourceBase *resource)

void	clearUpdated ()

virtual int	getUpdateQuota () const

size_t	updatedResourceCount ()

size_t	orphanedResourceCount ()

size_t	allocatedResourceCount ()

virtual void	initialize ()=0

virtual void	clear ()=0

virtual void	clearSwapping ()=0

virtual void	processLoading ()=0

virtual void	processSwapping ()=0

virtual void	activateResources ()=0

virtual void	processDeletion ()=0

virtual void	resourceChanged (ResourceBase *resource)=0

virtual void	resourceDeleted (ResourceBase *resource)=0

virtual ResourceId	getNextResourceId ()=0

virtual void	setResourceId (ResourceBase *resource, ResourceId id)=0

Additional Inherited Members
Public Types inherited from Cogs::Core::ResourceManager< MaterialInstance, ResourceLoadInfoBase >
using	ResourceHandle = ResourceHandle_t< MaterialInstance >
	Type of handle used to hold resources.

using	ResourceProxy = ResourceProxy< MaterialInstance, ResourceManager >
	Type of resource proxy objects, specialized on the type of resource.

Protected Member Functions inherited from Cogs::Core::ResourceManager< MaterialInstance, ResourceLoadInfoBase >
MaterialInstance *	createInternal () override

void	destroyInternal (ResourceBase *resource) override

void	handleLoadInternal (ResourceLoadInfoBase *loadInfo) override

ActivationResult	handleActivationInternal (ResourceHandleBase r, ResourceBase *resource) override

void	handleDeletionInternal (ResourceBase *resource) override

void	handleFailedLoadInternal (ResourceLoadInfoBase *loadInfo) override

IResourceLoader< MaterialInstance, ResourceLoadInfoBase > *	findLoader (const ResourceLoadInfoBase *loadInfo)
	Find a loader capable of loading the resource given by loadInfo.

Protected Member Functions inherited from Cogs::Core::ResourceManagerBase
ResourceHandleBase	getResourceHandle (ResourceId id) const
	Get existing resource handle.

bool	isValidResource (ResourceId id) const
	Check if resource handle points to.

virtual void	postProcessLoading ()
	Hook for resource managers to run code at the tail of processLoading.

Protected Attributes inherited from Cogs::Core::ResourceManager< MaterialInstance, ResourceLoadInfoBase >
Mutex	swapMutex

Collections::Pool< MaterialInstance >	resources

std::vector< IResourceLoader< MaterialInstance, ResourceLoadInfoBase > * >	loaders

std::deque< SwapOperation >	swapQueue

ResourceHandle	defaultResource

Protected Attributes inherited from Cogs::Core::ResourceManagerBase
std::unique_ptr< ResourceManagerBaseStorage >	storage

Context *	context = nullptr

ResourceTypes	resourceType = ResourceTypes::Unknown

Detailed Description

Material instance manager handles creation, processing and lifetime for MaterialInstance resources.

Definition at line 112 of file MaterialManager.h.

Constructor & Destructor Documentation

◆ MaterialInstanceManager()

Cogs::Core::MaterialInstanceManager::MaterialInstanceManager ( Context * context )

inline

Constructs a MaterialInstanceManager in the given context.

Definition at line 116 of file MaterialManager.h.

◆ ~MaterialInstanceManager()

Cogs::Core::MaterialInstanceManager::~MaterialInstanceManager ( )

Destructs the MaterialInstanceManager.

Definition at line 1038 of file MaterialManager.cpp.

Member Function Documentation

◆ createMaterialInstance()

Cogs::Core::MaterialInstanceHandle Cogs::Core::MaterialInstanceManager::createMaterialInstance ( const MaterialHandle & material )

Create a new MaterialInstance from the Material given held by material.

The created MaterialInstance will have all properties and values set to the defaults indicated in the parent Material.

Parameters

material Handle to a valid material.

Returns: A handle to the newly created material instance.

Definition at line 1055 of file MaterialManager.cpp.

References Cogs::Core::ResourceHandle_t< ResourceType >::resolve().

◆ getMaterialInstance()

Cogs::Core::MaterialInstanceHandle Cogs::Core::MaterialInstanceManager::getMaterialInstance ( const StringView & name )

Definition at line 1070 of file MaterialManager.cpp.

◆ getUpdateQuota()

int Cogs::Core::MaterialInstanceManager::getUpdateQuota ( ) const

overridevirtual

Reimplemented from Cogs::Core::ResourceManagerBase.

Definition at line 1085 of file MaterialManager.cpp.

◆ handleActivation()

Cogs::Core::ActivationResult Cogs::Core::MaterialInstanceManager::handleActivation	(	MaterialInstanceHandle	handle,
		MaterialInstance *	resource
	)

overridevirtual

Overridden to handle activation of MaterialInstances, updating the resource in the renderer.

Reimplemented from Cogs::Core::ResourceManager< MaterialInstance, ResourceLoadInfoBase >.

Definition at line 1075 of file MaterialManager.cpp.

◆ handleDeletion()

void Cogs::Core::MaterialInstanceManager::handleDeletion ( MaterialInstance * resource )

overridevirtual

Overridden to handle material instance deletion, removing the resource from the renderer.

Reimplemented from Cogs::Core::ResourceManager< MaterialInstance, ResourceLoadInfoBase >.

Definition at line 1080 of file MaterialManager.cpp.

◆ initialize()

void Cogs::Core::MaterialInstanceManager::initialize ( )

overridevirtual

Initialize the MaterialInstanceManager.

Implements Cogs::Core::IResourceManager.

Definition at line 1043 of file MaterialManager.cpp.

◆ initializeDefaultMaterialInstance()

void Cogs::Core::MaterialInstanceManager::initializeDefaultMaterialInstance ( )

Definition at line 1050 of file MaterialManager.cpp.

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

Source/Resources/MaterialManager.h
Source/Resources/MaterialManager.cpp

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ MaterialInstanceManager()

◆ ~MaterialInstanceManager()

Member Function Documentation

◆ createMaterialInstance()

◆ getMaterialInstance()

◆ getUpdateQuota()

◆ handleActivation()

◆ handleDeletion()

◆ initialize()

◆ initializeDefaultMaterialInstance()