Manager for low level resources. More...

#include <ResourceManager.h>

Public Member Functions
RenderTargetObject *	CreateRenderTarget (const std::wstring &name, const RenderTargetDescriptor &renderTargetDescriptor)
	Znajduje Loader pasujący do pliku podanego w parametrze. More...

RenderTargetObject *	AddRenderTarget (RenderTargetObject *renderTarget, const std::wstring &name)
	Dodaje renderTarget do ResourceManagera, jeżeli jeszcze nie istniał. More...

Geting existing resource
Gets resource if exist otherwise returns nullptr.
BlendingState *	GetBlendingState (const std::wstring &name)

RasterizerState *	GetRasterizerState (const std::wstring &name)

DepthStencilState *	GetDepthStencilState (const std::wstring &name)

BlendingState *	GetBlendingState (const BlendingInfo &info)

RasterizerState *	GetRasterizerState (const RasterizerStateInfo &info)

DepthStencilState *	GetDepthStencilState (const DepthStencilInfo &info)

RenderTargetObject *	GetRenderTarget (const std::wstring &name)
	Zwraca RenderTarget o podanej nazwie, jeżeli jest wczytany.

VertexShader *	GetVertexShader (const std::wstring &name)
	Zwraca vertex shader o podanej nazwie, jeżeli jest wczytany.

PixelShader *	GetPixelShader (const std::wstring &name)
	Zwraca pixel shader o podanej nazwie, jeżeli jest wczytany.

TextureObject *	GetTexture (const std::wstring &name)
	Zwraca teksturę o podanej nazwie, jeżeli jest wczytany.

BufferObject *	GetVertexBuffer (const std::wstring &name)
	Zwraca bufor wierzchołków o podanej nazwie, jeżeli jest wczytany.

BufferObject *	GetConstantBuffer (const std::wstring &name)
	Zwraca bufor stałych o podanej nazwie, jeżeli jest wczytany.

BufferObject *	GetIndexBuffer (const std::wstring &name)
	Zwraca bufor indeksów o podanej nazwie, jeżeli jest wczytany.

ShaderInputLayout *	GetLayout (const std::wstring &name)

Resource loading
Load assets from specified file. Functions protect from loading assets multiple times.
TextureObject *	LoadTexture (const std::wstring &fileName)
	Dodaje teksturę do ModelManagera, jeżeli jeszcze nie istniała. More...

VertexShader *	LoadVertexShader (const std::wstring &fileName, const std::string &shaderEntry)
	Dodaje vertex shader do ResourceManagera. Jeżeli obiekt już istniał, to nie jest tworzony nowy. More...

VertexShader *	LoadVertexShader (const std::wstring &fileName, const std::string &shaderEntry, ShaderInputLayout *layout, InputLayoutDescriptor layout_desc)
	Dodaje vertex shader do ResourceManagera. Jeżeli obiekt już istniał, to nie jest tworzony nowy. Tworzy też layout wierzchołka związany z tym shaderem i zwraca go w zmiennej layout. More...

PixelShader *	LoadPixelShader (const std::wstring &fileName, const std::string &shaderEntry)
	Dodaje pixel shader do ResourceManagera. Jeżeli obiekt już istniał, to nie jest tworzony nowy. More...

GeometryShader *	LoadGeometryShader (const std::wstring &fileName, const std::string &shaderEntry)

ControlShader *	LoadControlShader (const std::wstring &fileName, const std::string &shaderEntry)

EvaluationShader *	LoadEvaluationShader (const std::wstring &fileName, const std::string &shaderEntry)

Resource creation
You can create assets in code using these functions. Remember to give unique names for your assets. Engine uses convention, that all generated resources have :: before name, to distinguish them from assets loaded from files.
ResourcePtr< BufferObject >	CreateVertexBuffer (const std::wstring &name, const void *buffer, unsigned int element_size, unsigned int vert_count)
	Dodaje do ResourceManagera bufor wierzchołków. Jeżeli pod taką nazwą istnieje jakiś bufor, to zostanie zwrócony wskaźnik na niego. More...

ResourcePtr< BufferObject >	CreateVertexBuffer (const std::wstring &name, const VertexBufferInitData &data)
	Creates vetex buffer. More...

ResourcePtr< BufferObject >	CreateIndexBuffer (const std::wstring &name, const void *buffer, unsigned int element_size, unsigned int vert_count)
	Dodaje do ResourceManagera bufor indeksów. Jeżeli pod taką nazwą istnieje jakiś bufor, to zostanie zwrócony wskaźnik na niego. More...

ResourcePtr< BufferObject >	CreateIndexBuffer (const std::wstring &name, const IndexBufferInitData &data)
	Vreates index buffer. More...

ResourcePtr< BufferObject >	CreateConstantsBuffer (const std::wstring &name, const void *buffer, unsigned int size)
	Dodaje do ResourceManagera bufor stałch dla shadera. Jeżeli pod taką nazwą istnieje jakiś bufor, to zostanie zwrócony wskaźnik na niego. More...

ResourcePtr< BufferObject >	CreateConstantsBuffer (const std::wstring &name, const ConstantBufferInitData &data)
	Creates constant buffer. More...

ResourcePtr< BlendingState >	CreateBlendingState (const std::wstring &name, const BlendingInfo &info)
	Created BlendingState object. More...

ResourcePtr< RasterizerState >	CreateRasterizerState (const std::wstring &name, const RasterizerStateInfo &info)
	Created RasterizerState object. More...

ResourcePtr< DepthStencilState >	CreateDepthStencilState (const std::wstring &name, const DepthStencilInfo &info)
	Created DepthStencilState object. More...

Listing resources
std::vector< ResourcePtr< BufferObject > >	ListVertexBuffers ()
	Listowanie buforów wierzchołków.

std::vector< ResourcePtr< BufferObject > >	ListIndexBuffers ()
	Listowanie buforów indeksów.

std::vector< ResourcePtr< BufferObject > >	ListConstantBuffers ()
	Listowanie buforów stałych.

std::vector< ResourcePtr< ShaderInputLayout > >	ListShaderLayouts ()
	Listowanie layoutów wierzchołków.

std::vector< ResourcePtr< TextureObject > >	ListTextures ()
	Listowanie tekstur.

std::vector< ResourcePtr< VertexShader > >	ListVertexShaders ()
	Listowanie vertex shaderów.

std::vector< ResourcePtr< PixelShader > >	ListPixelShaders ()
	Listowanie pixel shaderów.

std::vector< ResourcePtr< RenderTargetObject > >	ListRenderTargets ()
	Listowanie render targetów.

Protected Attributes
ResourceContainer< BlendingState >	m_blendingState
	BlendingState objects.

ResourceContainer< RasterizerState >	m_rasterizerState
	RasterizerState objects.

ResourceContainer< DepthStencilState >	m_depthStencilState
	DepthStencilState objects.

ResourceContainer< VertexShader >	m_vertexShader
	Vertex shaders.

ResourceContainer< PixelShader >	m_pixelShader
	Pixel shaders.

ResourceContainer< GeometryShader >	m_geometryShader
	Geometry shaders.

ResourceContainer< EvaluationShader >	m_evaluationShader
	Tesselation evaluation shaders.

ResourceContainer< ControlShader >	m_controlShaders
	Tesselation control shaders.

ResourceContainer< TextureObject >	m_texture
	Textures.

ResourceContainer< BufferObject >	m_vertexBuffer
	Vertex buffers.

ResourceContainer< BufferObject >	m_indexBuffer
	Index buffers.

ResourceContainer< BufferObject >	m_constantBuffer
	Shader constant buffers.

ResourceContainer< ShaderInputLayout >	m_vertexLayout
	Vertex layouts.

ResourceContainer< RenderTargetObject >	m_renderTarget
	Obiekty mogące służyć za render target.

Private Member Functions
virtual MemoryChunk	LoadTextureImpl (const filesystem::Path &filePath, TextureInfo &texInfo)
	Implementation of texture loading. More...

Detailed Description

Manager for low level resources.

Todo:: This class should implement generic high level asssets managment.

Member Function Documentation

RenderTargetObject * ResourceManager::AddRenderTarget	(	RenderTargetObject *	renderTarget,
		const std::wstring &	name
	)

Dodaje renderTarget do ResourceManagera, jeżeli jeszcze nie istniał.

Note: Funkcja nie dodaje odwołania do obiektu, bo nie zakłada, że ktoś go od razu użyje. W każdym miejscu, gdzie zostanie przypisany zwrócony obiekt, należy pamiętać o dodaniu odwołania oraz skasowaniu go, gdy obiekt przestanie być używany.; Jeżeli renderTarget już istniał (jego nazwa), to ten podany w parametrze nie zostanie dodany. Oznacza to, że za jego zwolnienie odpowiada ten, kto go stworzył. Trzeba zawsze sprawdzić czy zwrócona wartość jest tym samym co podaliśmy.

Todo:: Nie może tak zostać, że ktoś dodaje renderTarget i musi sprawdzić czy nie dostał innego. Nie można też zmuszać kogoś do zwalniania pamięci po renderTargecie. Wogóle dodawanie renderTargetów musi się odbywać jakoś inaczej. Najlepiej, żeby były one tworzone przez ResourceManager, ale wtedy trzeba wymyśleć sposób dodawania renderTargetu związanego z buforem okna.

Parameters

[in]	renderTarget	renderTarget, który ma zostać dodany.
[in]	name	Nazwa renderTargetu. Do materiału będzie można się odwołać podając ciąg znaków

Returns: Zwraca wskaźnik na dodany renderTarget.

ResourcePtr< BlendingState > ResourceManager::CreateBlendingState	(	const std::wstring &	name,
		const BlendingInfo &	info
	)

Created BlendingState object.

Returns: If object named name exist, returns nullptr.

ResourcePtr< BufferObject > ResourceManager::CreateConstantsBuffer	(	const std::wstring &	name,
		const void *	buffer,
		unsigned int	size
	)

Dodaje do ResourceManagera bufor stałch dla shadera. Jeżeli pod taką nazwą istnieje jakiś bufor, to zostanie zwrócony wskaźnik na niego.

Note: Funkcja nie dodaje odwołania do obiektu, bo nie zakłada, że ktoś go od razu użyje. W każdym miejscu, gdzie zostanie przypisany zwrócony obiekt, należy pamiętać o dodaniu odwołania oraz skasowaniu go, gdy obiekt przestanie być używany.

Parameters

[in]	name	Nazwa bufora, po której można się będzie odwołać.
[in]	buffer	Wskaźnik na bufor z danym, które mają być przeniesione do bufora DirectXowego.
[in]	size	Rozmiar bufora.

Returns: Dodany bufor indeksów. Zwraca nullptr, jeżeli nie udało się stworzyć bufora.

ResourcePtr< BufferObject > ResourceManager::CreateConstantsBuffer	(	const std::wstring &	name,
		const ConstantBufferInitData &	data
	)

Creates constant buffer.

Returns: Returns buffer or nullptr if name already exists or buffer creation failed.

ResourcePtr< DepthStencilState > ResourceManager::CreateDepthStencilState	(	const std::wstring &	name,
		const DepthStencilInfo &	info
	)

Created DepthStencilState object.

Returns: If object named name exist, returns nullptr.

ResourcePtr< BufferObject > ResourceManager::CreateIndexBuffer	(	const std::wstring &	name,
		const void *	buffer,
		unsigned int	elementSize,
		unsigned int	vertCount
	)

Dodaje do ResourceManagera bufor indeksów. Jeżeli pod taką nazwą istnieje jakiś bufor, to zostanie zwrócony wskaźnik na niego.

Note: Funkcja nie dodaje odwołania do obiektu, bo nie zakłada, że ktoś go od razu użyje. W każdym miejscu, gdzie zostanie przypisany zwrócony obiekt, należy pamiętać o dodaniu odwołania oraz skasowaniu go, gdy obiekt przestanie być używany.

Parameters

[in]	name	Nazwa bufora, po której można się będzie odwołać.
[in]	buffer	Wskaźnik na bufor z danym, które mają być przeniesione do bufora DirectXowego.
[in]	elementSize	Rozmiar pojedynczego elementu w buforze.
[in]	vertCount	Liczba wierzchołków/indeksów w buforze.

Returns: Dodany bufor indeksów. Zwraca nullptr, jeżeli nie udało się stworzyć bufora.

ResourcePtr< BufferObject > ResourceManager::CreateIndexBuffer	(	const std::wstring &	name,
		const IndexBufferInitData &	data
	)

Vreates index buffer.

Returns: Returns buffer or nullptr if name already exists or buffer creation failed.

ResourcePtr< RasterizerState > ResourceManager::CreateRasterizerState	(	const std::wstring &	name,
		const RasterizerStateInfo &	info
	)

Created RasterizerState object.

Returns: If object named name exist, returns nullptr.

RenderTargetObject * ResourceManager::CreateRenderTarget	(	const std::wstring &	name,
		const RenderTargetDescriptor &	renderTargetDescriptor
	)

Znajduje Loader pasujący do pliku podanego w parametrze.

Parameters

[in] path Ścieżka do pliku, dla której szukamy loadera.

Returns: Wskaźnik na odpowiedni loader lub nullptr, jeżeli nie znaleziono pasującego. Tworzy nowy render target.

Funkcja dodaje stworzony obiekt do tablicy m_renderTarget. Jeżeli tekstury bufora colorów, głębokości i stencilu nie są nullptrami, to i one są dodawane do tablicy m_texture.

Tekstury te mają nazwy jak render target + dodany jest człon

::color
::depth
::stencil

Todo:: Przy dodawaniu tekstur nie jest sprawdzane czy one już istnieją. Trzeba albo to sprawdzać, albo zapewnić np. jakąś polityką nazewnictwa, że w ten sposób nie nadpisujemy istniejącej tekstury.

Parameters

[in]	name	Nazwa identyfikująca render target.
[in]	renderTargetDescriptor	Deskryptor opisujący parametry render targetu.

Returns: Zwraca stworzony obiekt lub nullptr w przypadku niepowodzenia. Jeżeli render target już istniał, to zwracany jest istniejący obiekt.

ResourcePtr< BufferObject > ResourceManager::CreateVertexBuffer	(	const std::wstring &	name,
		const void *	buffer,
		unsigned int	elementSize,
		unsigned int	vertCount
	)

Dodaje do ResourceManagera bufor wierzchołków. Jeżeli pod taką nazwą istnieje jakiś bufor, to zostanie zwrócony wskaźnik na niego.

Note: Funkcja nie dodaje odwołania do obiektu, bo nie zakłada, że ktoś go od razu użyje. W każdym miejscu, gdzie zostanie przypisany zwrócony obiekt, należy pamiętać o dodaniu odwołania oraz skasowaniu go, gdy obiekt przestanie być używany.

Parameters

[in]	name	Nazwa bufora, po której można się będzie odwołać.
[in]	buffer	Wskaźnik na bufor z danym, które mają być przeniesione do bufora DirectXowego.
[in]	elementSize	Rozmiar pojedynczego elementu w buforze.
[in]	vertCount	Liczba wierzchołków/indeksów w buforze.

Returns: Dodany bufor wierzchołków. Zwraca nullptr, jeżeli nie udało się stworzyć bufora.

ResourcePtr< BufferObject > ResourceManager::CreateVertexBuffer	(	const std::wstring &	name,
		const VertexBufferInitData &	data
	)

Creates vetex buffer.

Returns: Returns buffer or nullptr if name already exists or buffer creation failed.

ShaderInputLayout* ResourceManager::GetLayout ( const std::wstring & name )

inline

Zwraca layout o podanej nazwie.

PixelShader * ResourceManager::LoadPixelShader	(	const std::wstring &	fileName,
		const std::string &	shaderEntry
	)

Dodaje pixel shader do ResourceManagera. Jeżeli obiekt już istniał, to nie jest tworzony nowy.

Note: Funkcja nie dodaje odwołania do obiektu, bo nie zakłada, że ktoś go od razu użyje. W każdym miejscu, gdzie zostanie przypisany zwrócony obiekt, należy pamiętać o dodaniu odwołania oraz skasowaniu go, gdy obiekt przestanie być używany.

Parameters

[in]	fileName	Nazwa pliku, w którym znajduje się pixel shader.
[in]	shaderEntry	Nazwa funkcji od której ma się zacząć wykonywanie shadera.

Returns: Zwraca obiekt dodanego shadera. Zwraca nullptr, jeżeli shadera nie udało się skompilować.

TextureObject * ResourceManager::LoadTexture ( const std::wstring & fileName )

Dodaje teksturę do ModelManagera, jeżeli jeszcze nie istniała.

Note: Funkcja nie dodaje odwołania do obiektu, bo nie zakłada, że ktoś go od razu użyje. W każdym miejscu, gdzie zostanie przypisany zwrócony obiekt, należy pamiętać o dodaniu odwołania oraz skasowaniu go, gdy obiekt przestanie być używany.

Parameters

[in] fileName Ścieżka do tekstury

Returns: Zwraca wskaźnik na dodaną teksturę lub nullptr, jeżeli nie dało się wczytać.

MemoryChunk ResourceManager::LoadTextureImpl	(	const filesystem::Path &	filePath,
		TextureInfo &	texInfo
	)

privatevirtual

Implementation of texture loading.

This is hack function. Resource manager have no texture loading function beacause it needs separate library for this. Derived classes will implement it, but in future this must change. ResourceManager must be fully operational class. Otherwise GUI won't load textures.

VertexShader * ResourceManager::LoadVertexShader	(	const std::wstring &	fileName,
		const std::string &	shaderEntry
	)

Dodaje vertex shader do ResourceManagera. Jeżeli obiekt już istniał, to nie jest tworzony nowy.

Note: Funkcja nie dodaje odwołania do obiektu, bo nie zakłada, że ktoś go od razu użyje. W każdym miejscu, gdzie zostanie przypisany zwrócony obiekt, należy pamiętać o dodaniu odwołania oraz skasowaniu go, gdy obiekt przestanie być używany.

Parameters

[in]	fileName	Nazwa pliku, w którym znajduje się vertex shader.
[in]	shaderEntry	Nazwa funkcji od której ma się zacząć wykonywanie shadera.

Returns: Zwraca obiekt dodanego shadera. Zwraca nullptr, jeżeli shadera nie udało się skompilować.

VertexShader * ResourceManager::LoadVertexShader	(	const std::wstring &	fileName,
		const std::string &	shaderEntry,
		ShaderInputLayout **	layout,
		InputLayoutDescriptor *	layoutDesc
	)

Dodaje vertex shader do ResourceManagera. Jeżeli obiekt już istniał, to nie jest tworzony nowy. Tworzy też layout wierzchołka związany z tym shaderem i zwraca go w zmiennej layout.

Jeżeli vertex shader wcześniej istniał, to stworzenie layoutu wymaga ponownego skompilowania shadera. Shader taki jest potem kasowany i nie zostaje zdublowany w ResourceManagerze, ale niepotrzebna praca zostaje włożona. Jest więc zadaniem programisty, żeby do takich rzeczy dochodziło jak najrzadziej.

Note: Funkcja nie dodaje odwołania do obiektu, bo nie zakłada, że ktoś go od razu użyje. W każdym miejscu, gdzie zostanie przypisany zwrócony obiekt, należy pamiętać o dodaniu odwołania oraz skasowaniu go, gdy obiekt przestanie być używany.

Parameters

[in]	fileName	Nazwa pliku, w którym znajduje się vertex shader.
[in]	shaderEntry	Nazwa funkcji od której ma się zacząć wykonywanie shadera.
[out]	layout	W zmiennej umieszczany jest wskaźnik na layout wierzchołka. Nawet jeżeli shader się nie skompilował, to pole może mieć wartość inną niż nullptr. Dzieje się tak wtedy, gdy layout istniał już wcześniej.

Attention: Jeżeli vertex shader wcześniej istniał, to stworzenie layoutu wymaga ponownego skompilowania shadera. Shader taki jest potem kasowany i nie zostaje zdublowany w ResourceManagerze, ale niepotrzebna praca zostaje włożona. Jest więc zadaniem programisty, żeby do takich rzeczy dochodziło jak najrzadziej.

Parameters

[in] layoutDesc Deskryptor opisujacy tworzony layout.

Returns: Zwraca obiekt dodanego shadera. Zwraca nullptr, jeżeli shadera nie udało się skompilować.

Todo:: Ten kod to jakiś totalny shit. Jak komuś się będzie nudziło kiedyś (ha ha), to może niech poprawi.

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

ResourceManager/ResourceManager.h
ResourceManager/ResourceManager.cpp

Public Member Functions

Protected Attributes

Private Member Functions

Detailed Description

Member Function Documentation