Inheritance diagram for Cogs::BuffersGL20:

Public Member Functions
VertexBufferHandle	loadVertexBuffer (const void *data, const size_t count, const VertexFormat &format) override
	Loads a new vertex buffer and populates it with the given data.

VertexBufferHandle	loadVertexBuffer (const void *data, const size_t count, VertexFormatHandle formatHandle) override

void	releaseVertexBuffer (VertexBufferHandle vertexBufferHandle) override
	Release the vertex buffer with the given handle.

IndexBufferHandle	loadIndexBuffer (const void *data, const size_t count, const size_t indexSize) override
	Loads a new index buffer and populates it with the given indexData.

void	releaseIndexBuffer (IndexBufferHandle indexBufferHandle) override
	Releases the index buffer with the given handle.

InputLayoutHandle	loadInputLayout (const VertexFormatHandle *vertexFormats, const size_t count, EffectHandle effectHandle) override
	Loads a new input layout to map vertex flow between vertex buffers with the given vertexFormats to effects using the vertex layout of the given effectHandle.

void	releaseInputLayout (InputLayoutHandle vertexFormatHandle) override
	Releases the input layout with the given inputLayoutHandle.

BufferHandle	loadBuffer (const void *data, const size_t size, Usage::EUsage usage, uint32_t accessMode, uint32_t bindFlags, uint32_t stride=0) override
	Loads a new buffer using the given data to populate the buffer.

void	retrieveSubBuffer (void *data, BufferHandle source, const size_t offset, const size_t size) override
	Retrieves the contents of a buffer.

void	releaseBuffer (BufferHandle bufferHandle) override
	Releases the buffer with the given bufferHandle.

void *	getNativeHandle (BufferHandle bufferHandle) override
	Get the device-specific handle (D3D buffer pointer, OpenGL buffer ID etc) associated with the given buffer handle.

void	releaseResources () override
	Releases all allocated buffer resources.

void	annotate (BufferHandle handle, const StringView &name) override
	Associate a name with an object for use in graphics debugging.

void	annotate (VertexBufferHandle handle, const StringView &name) override
	Associate a name with an object for use in graphics debugging.

Public Member Functions inherited from Cogs::BuffersCommon
virtual VertexFormatHandle	createVertexFormat (const VertexElement *elements, size_t count) override

virtual const VertexFormat *	getVertexFormat (VertexFormatHandle handle) override

virtual VertexArrayObjectHandle	loadVertexArrayObject (const EffectHandle effectHandle, const VertexBufferHandle vertexBufferHandles, const size_t vertexBufferCount, const VertexFormat const vertexFormats=nullptr, const uint32_t vertexBufferStrides=nullptr, const uint32_t *vertexBufferOffsets=nullptr, const IndexBufferHandle indexBufferHandle=IndexBufferHandle::NoHandle, uint32_t indexBufferStride=0) override

virtual void	releaseVertexArrayObject (VertexArrayObjectHandle) override

virtual void	annotate (BufferHandle handle, const StringView &name)
	Associate a name with an object for use in graphics debugging.

virtual void	annotate (VertexBufferHandle handle, const StringView &name)
	Associate a name with an object for use in graphics debugging.

virtual VertexBufferHandle	loadVertexBuffer (const void *vertexData, const size_t count, const VertexFormat &vertexFormat)=0
	Loads a new vertex buffer and populates it with the given data.

virtual VertexBufferHandle	loadVertexBuffer (const void *vertexData, const size_t count, VertexFormatHandle vertexFormatHandle)=0

virtual void	releaseVertexBuffer (VertexBufferHandle vertexBufferHandle)=0
	Release the vertex buffer with the given handle.

virtual IndexBufferHandle	loadIndexBuffer (const void *indexData, const size_t count, const size_t indexSize)=0
	Loads a new index buffer and populates it with the given indexData.

virtual void	releaseIndexBuffer (IndexBufferHandle indexBufferHandle)=0
	Releases the index buffer with the given handle.

virtual VertexArrayObjectHandle	loadVertexArrayObject (const EffectHandle effectHandle, const VertexBufferHandle vertexBufferHandles, const size_t vertexBufferCount, const VertexFormat const vertexFormats=nullptr, const uint32_t vertexBufferStrides=nullptr, const uint32_t *vertexBufferOffsets=nullptr, const IndexBufferHandle indexBufferHandle=IndexBufferHandle::NoHandle, uint32_t indexBufferStride=0)=0
	Create a vertex array object that encapsulates binding of a set of vertex buffers and an optional index buffer.

virtual void	releaseVertexArrayObject (VertexArrayObjectHandle vertexArrayObjectHandle)=0
	Releases the vertex array object with the given handle.

virtual InputLayoutHandle	loadInputLayout (const VertexFormatHandle *vertexFormats, const size_t count, EffectHandle effectHandle)=0
	Loads a new input layout to map vertex flow between vertex buffers with the given vertexFormats to effects using the vertex layout of the given effectHandle.

virtual void	releaseInputLayout (InputLayoutHandle inputLayoutHandle)=0
	Releases the input layout with the given inputLayoutHandle.

virtual BufferHandle	loadBuffer (const void *data, const size_t size, Usage::EUsage usage, uint32_t accessMode, uint32_t bindFlags, uint32_t stride=0)=0
	Loads a new buffer using the given data to populate the buffer.

virtual VertexFormatHandle	createVertexFormat (const VertexElement *elements, size_t count)=0

virtual const VertexFormat *	getVertexFormat (VertexFormatHandle handle)=0

virtual void	retrieveSubBuffer (void *data, BufferHandle source, const size_t offset, const size_t size)=0
	Retrieves the contents of a buffer.

virtual void	releaseBuffer (BufferHandle bufferHandle)=0
	Releases the buffer with the given bufferHandle.

virtual void *	getNativeHandle (BufferHandle bufferHandle)=0
	Get the device-specific handle (D3D buffer pointer, OpenGL buffer ID etc) associated with the given buffer handle.

virtual void	releaseResources ()=0
	Releases all allocated buffer resources.

Public Attributes
ResourceMap< BufferHandle, BufferGL20 >	buffers

size_t	bufferMemoryConsumption = 0

ResourceMap< InputLayoutHandle, InputLayoutGL20 >	inputLayouts

Detailed Description

Definition at line 35 of file BuffersGL20.h.

Member Function Documentation

◆ annotate() [1/2]

void Cogs::BuffersGL20::annotate	(	BufferHandle	handle,
		const StringView &	name
	)

overridevirtual

Associate a name with an object for use in graphics debugging.

Reimplemented from Cogs::IBuffers.

Definition at line 228 of file BuffersGL20.cpp.

References Cogs::StringView::data(), and Cogs::StringView::size().

◆ annotate() [2/2]

void Cogs::BuffersGL20::annotate	(	VertexBufferHandle	handle,
		const StringView &	name
	)

overridevirtual

Associate a name with an object for use in graphics debugging.

Reimplemented from Cogs::IBuffers.

Definition at line 238 of file BuffersGL20.cpp.

References Cogs::StringView::data(), and Cogs::StringView::size().

◆ getNativeHandle()

void * Cogs::BuffersGL20::getNativeHandle ( BufferHandle bufferHandle )

inlineoverridevirtual

Get the device-specific handle (D3D buffer pointer, OpenGL buffer ID etc) associated with the given buffer handle.

Parameters

bufferHandle Valid handle to a previously created buffer object.

Returns: Native handle

Implements Cogs::IBuffers.

Definition at line 52 of file BuffersGL20.h.

◆ loadBuffer()

Cogs::BufferHandle Cogs::BuffersGL20::loadBuffer	(	const void *	data,
		const size_t	size,
		Usage::EUsage	usage,
		uint32_t	accessMode,
		uint32_t	bindFlags,
		uint32_t	stride = `0`
	)

overridevirtual

Loads a new buffer using the given data to populate the buffer.

Parameters

data	Pointer to data used to populate the buffer. Must be at least size number of bytes.
size	Size of the buffer to create in bytes.
usage	Usage flags for the buffer. Specifies how the buffer is intended to be used.
accessMode	Access mode flags for the buffer. Specifies how the buffer can be accessed at a later time.
bindFlags	Binding flags specifying how the buffer can be bound to the pipeline at a later state.

Returns: Handle to a new buffer, InvalidHandle if no buffer could be created with the given parameters.

See also: Usage, AccessMode, BindFlags

Implements Cogs::IBuffers.

Definition at line 88 of file BuffersGL20.cpp.

References Cogs::BindFlags::ConstantBuffer, Cogs::Usage::Default, Cogs::Usage::Dynamic, Cogs::BindFlags::IndexBuffer, Cogs::BindFlags::RawBuffer, Cogs::AccessMode::Read, Cogs::MapMode::Read, Cogs::Usage::Staging, Cogs::Usage::Static, Cogs::BindFlags::StructuredBuffer, Cogs::BindFlags::StructuredBufferWithCounter, Cogs::BindFlags::VertexBuffer, and Cogs::AccessMode::Write.

◆ loadIndexBuffer()

Cogs::IndexBufferHandle Cogs::BuffersGL20::loadIndexBuffer	(	const void *	indexData,
		const size_t	count,
		const size_t	indexSize
	)

overridevirtual

Loads a new index buffer and populates it with the given indexData.

The size of the buffer (if given) must be at least indexSize * count.

Parameters

indexData	Pointer to index data in memory, or nullptr to initialize an empty index buffer.
count	Number of indexes given.
indexSize	Size of an index in bytes.

Returns: Handle to the loaded index buffer, InvalidHandle if the operation failed.

Implements Cogs::IBuffers.

Definition at line 52 of file BuffersGL20.cpp.

References Cogs::MapMode::Read.

◆ loadInputLayout()

Cogs::InputLayoutHandle Cogs::BuffersGL20::loadInputLayout	(	const VertexFormatHandle *	vertexFormats,
		const size_t	count,
		EffectHandle	effectHandle
	)

overridevirtual

Loads a new input layout to map vertex flow between vertex buffers with the given vertexFormats to effects using the vertex layout of the given effectHandle.

Parameters

vertexFormats	Pointer to an array of pointers to vertex formats. One for each vertex buffer that in sum describes total vertex data.
count	Number of vertex formats given.
effectHandle	Handle to a valid effect containing a valid vertex shader. The input requirements of the vertex shader is used to specify the flow of vertex data from the vertex buffer(s) specified by vertexFormats into the shader stage.

Returns: Handle to a new input layout object, InvalidHandle if no valid input layout could be created.

Implements Cogs::IBuffers.

Definition at line 70 of file BuffersGL20.cpp.

◆ loadVertexBuffer() [1/2]

Cogs::VertexBufferHandle Cogs::BuffersGL20::loadVertexBuffer	(	const void *	vertexData,
		const size_t	count,
		const VertexFormat &	vertexFormat
	)

overridevirtual

Loads a new vertex buffer and populates it with the given data.

The size of the buffer (if given) must be at least the size of a vertex in the given vertexFormat times count.

Parameters

vertexData	Pointer to vertex data in memory, or nullptr to initialize an empty vertex buffer.
count	Number of vertexes in the vertex data.
vertexFormat	Format of the vertexes in the given memory buffer.

Returns: Handle to the loaded vertex buffer, InvalidHandle if the operation failed.

Implements Cogs::IBuffers.

Definition at line 42 of file BuffersGL20.cpp.

References Cogs::VertexFormat::elements.

◆ loadVertexBuffer() [2/2]

Cogs::VertexBufferHandle Cogs::BuffersGL20::loadVertexBuffer	(	const void *	data,
		const size_t	count,
		VertexFormatHandle	formatHandle
	)

overridevirtual

Implements Cogs::IBuffers.

Definition at line 21 of file BuffersGL20.cpp.

◆ releaseBuffer()

void Cogs::BuffersGL20::releaseBuffer ( BufferHandle bufferHandle )

overridevirtual

Releases the buffer with the given bufferHandle.

Parameters

bufferHandle Valid handle to a previously created buffer.

Implements Cogs::IBuffers.

Definition at line 185 of file BuffersGL20.cpp.

◆ releaseIndexBuffer()

void Cogs::BuffersGL20::releaseIndexBuffer ( IndexBufferHandle indexBufferHandle )

overridevirtual

Releases the index buffer with the given handle.

Parameters

indexBufferHandle Valid handle to a previously created index buffer.

Implements Cogs::IBuffers.

Definition at line 65 of file BuffersGL20.cpp.

◆ releaseInputLayout()

void Cogs::BuffersGL20::releaseInputLayout ( InputLayoutHandle inputLayoutHandle )

overridevirtual

Releases the input layout with the given inputLayoutHandle.

Parameters

inputLayoutHandle Valid handle to a previously created index buffer.

Implements Cogs::IBuffers.

Definition at line 83 of file BuffersGL20.cpp.

◆ releaseResources()

void Cogs::BuffersGL20::releaseResources ( )

overridevirtual

Releases all allocated buffer resources.

Implements Cogs::IBuffers.

Definition at line 204 of file BuffersGL20.cpp.

◆ releaseVertexBuffer()

void Cogs::BuffersGL20::releaseVertexBuffer ( VertexBufferHandle vertexBufferHandle )

overridevirtual

Release the vertex buffer with the given handle.

The data is removed from GPU memory.

Parameters

vertexBufferHandle Valid handle to a previously created vertex buffer.

Implements Cogs::IBuffers.

Definition at line 47 of file BuffersGL20.cpp.

◆ retrieveSubBuffer()

void Cogs::BuffersGL20::retrieveSubBuffer	(	void *	data,
		BufferHandle	source,
		const size_t	offset,
		const size_t	size
	)

overridevirtual

Retrieves the contents of a buffer.

Parameters

data	Pointer to where the data should be stored.
offset	The offset in bytes inside the buffer from where to retrieve data.
size	The number of bytes to retrieve from the buffer.

Implements Cogs::IBuffers.

Definition at line 166 of file BuffersGL20.cpp.

Member Data Documentation

◆ bufferMemoryConsumption

size_t Cogs::BuffersGL20::bufferMemoryConsumption = 0

Definition at line 60 of file BuffersGL20.h.

◆ buffers

ResourceMap<BufferHandle, BufferGL20> Cogs::BuffersGL20::buffers

Definition at line 59 of file BuffersGL20.h.

◆ inputLayouts

ResourceMap<InputLayoutHandle, InputLayoutGL20> Cogs::BuffersGL20::inputLayouts

Definition at line 62 of file BuffersGL20.h.

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

D:/a/1/s/Cogs/Cogs.Rendering/Source/OpenGL20/BuffersGL20.h
D:/a/1/s/Cogs/Cogs.Rendering/Source/OpenGL20/BuffersGL20.cpp

Public Member Functions

Public Attributes

Detailed Description

Member Function Documentation

◆ annotate() [1/2]

◆ annotate() [2/2]

◆ getNativeHandle()

◆ loadBuffer()

◆ loadIndexBuffer()

◆ loadInputLayout()

◆ loadVertexBuffer() [1/2]

◆ loadVertexBuffer() [2/2]

◆ releaseBuffer()

◆ releaseIndexBuffer()

◆ releaseInputLayout()

◆ releaseResources()

◆ releaseVertexBuffer()

◆ retrieveSubBuffer()

Member Data Documentation

◆ bufferMemoryConsumption

◆ buffers

◆ inputLayouts