Cogs.Core
Public Member Functions | Public Attributes | Private Attributes | List of all members
Cogs::BuffersD3D11 Struct Reference
Inheritance diagram for Cogs::BuffersD3D11:
Cogs::BuffersCommon Cogs::IBuffers

Public Member Functions

 BuffersD3D11 (struct GraphicsDeviceD3D11 *device)
 
void setDevice (const ResourcePointer< ID3D11Device > &device_set)
 
void initialize (struct ContextD3D11 *context_set, struct EffectsD3D11 *effects_set)
 
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.
 
VertexBufferHandle loadVertexBuffer (const void *vertexData, const size_t count, const VertexFormat &vertexFormat)
 Loads a new vertex buffer and populates it with the given data.
 
VertexBufferHandle loadVertexBuffer (const void *vertexData, const size_t count, VertexFormatHandle vertexFormatHandle)
 
void releaseVertexBuffer (VertexBufferHandle vertexBufferHandle)
 Release the vertex buffer with the given handle.
 
IndexBufferHandle loadIndexBuffer (const void *vertexData, const size_t count, const size_t indexSize)
 Loads a new index buffer and populates it with the given indexData.
 
void releaseIndexBuffer (IndexBufferHandle indexBufferHandle)
 Releases the index buffer with the given handle.
 
void retrieveSubBuffer (void *, BufferHandle, const size_t, const size_t)
 Retrieves the contents of a buffer.
 
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)
 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)
 Loads a new buffer using the given data to populate the buffer.
 
void releaseBuffer (BufferHandle bufferHandle)
 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 ()
 Releases all allocated buffer resources.
 
- Public Member Functions inherited from Cogs::BuffersCommon
virtual VertexFormatHandle createVertexFormat (const VertexElement *elements, size_t count) override
 
virtual const VertexFormatgetVertexFormat (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 VertexFormatgetVertexFormat (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

SafeResourceMap< BufferHandle, BufferD3D11buffers
 
size_t bufferMemoryConsumption = 0
 
SafeResourceMap< InputLayoutHandle, InputLayoutD3D11inputLayouts
 

Private Attributes

ResourcePointer< ID3D11Device > device
 
ContextD3D11context = nullptr
 
EffectsD3D11effects = nullptr
 

Detailed Description

Definition at line 58 of file BuffersD3D11.h.

Constructor & Destructor Documentation

◆ BuffersD3D11()

Cogs::BuffersD3D11::BuffersD3D11 ( struct GraphicsDeviceD3D11 device)

Definition at line 60 of file BuffersD3D11.cpp.

Member Function Documentation

◆ annotate() [1/2]

void Cogs::BuffersD3D11::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 67 of file BuffersD3D11.cpp.

References Cogs::Handle_t< Type, Convertible >::handle.

◆ annotate() [2/2]

void Cogs::BuffersD3D11::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 88 of file BuffersD3D11.cpp.

References Cogs::Handle_t< Type, Convertible >::handle.

◆ getNativeHandle()

void * Cogs::BuffersD3D11::getNativeHandle ( BufferHandle  bufferHandle)
overridevirtual

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

Parameters
bufferHandleValid handle to a previously created buffer object.
Returns
Native handle

Implements Cogs::IBuffers.

Definition at line 426 of file BuffersD3D11.cpp.

◆ initialize()

void Cogs::BuffersD3D11::initialize ( struct ContextD3D11 context_set,
struct EffectsD3D11 effects_set 
)
inline

Definition at line 67 of file BuffersD3D11.h.

◆ loadBuffer()

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

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

Parameters
dataPointer to data used to populate the buffer. Must be at least size number of bytes.
sizeSize of the buffer to create in bytes.
usageUsage flags for the buffer. Specifies how the buffer is intended to be used.
accessModeAccess mode flags for the buffer. Specifies how the buffer can be accessed at a later time.
bindFlagsBinding 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 318 of file BuffersD3D11.cpp.

References Cogs::BindFlags::ConstantBuffer, Cogs::BindFlags::IndexBuffer, Cogs::Handle_t< BufferTag >::InvalidHandle, Cogs::BindFlags::RawBuffer, Cogs::AccessMode::Read, Cogs::BindFlags::StructuredBuffer, Cogs::BindFlags::StructuredBufferWithCounter, Cogs::BindFlags::VertexBuffer, and Cogs::AccessMode::Write.

◆ loadIndexBuffer()

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

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
indexDataPointer to index data in memory, or nullptr to initialize an empty index buffer.
countNumber of indexes given.
indexSizeSize of an index in bytes.
Returns
Handle to the loaded index buffer, InvalidHandle if the operation failed.

Implements Cogs::IBuffers.

Definition at line 132 of file BuffersD3D11.cpp.

References Cogs::Usage::Dynamic, Cogs::BindFlags::IndexBuffer, and Cogs::AccessMode::Write.

◆ loadInputLayout()

Cogs::InputLayoutHandle Cogs::BuffersD3D11::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
vertexFormatsPointer to an array of pointers to vertex formats. One for each vertex buffer that in sum describes total vertex data.
countNumber of vertex formats given.
effectHandleHandle 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 150 of file BuffersD3D11.cpp.

References Cogs::VertexFormat::elements, Cogs::VertexElement::format, Cogs::Direct3D11::Formats, Cogs::VertexElement::inputType, Cogs::InstanceMatrix, Cogs::VertexElement::instanceStep, Cogs::Handle_t< InputLayoutTag >::InvalidHandle, Cogs::VertexElement::offset, Cogs::VertexElement::semantic, Cogs::VertexElement::semanticIndex, and Cogs::VertexData.

◆ loadVertexBuffer() [1/2]

Cogs::VertexBufferHandle Cogs::BuffersD3D11::loadVertexBuffer ( const void *  vertexData,
const size_t  count,
const VertexFormat vertexFormat 
)
virtual

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
vertexDataPointer to vertex data in memory, or nullptr to initialize an empty vertex buffer.
countNumber of vertexes in the vertex data.
vertexFormatFormat 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 107 of file BuffersD3D11.cpp.

References Cogs::Usage::Dynamic, Cogs::VertexFormat::elements, Cogs::BindFlags::VertexBuffer, and Cogs::AccessMode::Write.

◆ loadVertexBuffer() [2/2]

Cogs::VertexBufferHandle Cogs::BuffersD3D11::loadVertexBuffer ( const void *  vertexData,
const size_t  count,
VertexFormatHandle  vertexFormatHandle 
)
virtual

Implements Cogs::IBuffers.

Definition at line 122 of file BuffersD3D11.cpp.

◆ releaseBuffer()

void Cogs::BuffersD3D11::releaseBuffer ( BufferHandle  bufferHandle)
virtual

Releases the buffer with the given bufferHandle.

Parameters
bufferHandleValid handle to a previously created buffer.

Implements Cogs::IBuffers.

Definition at line 416 of file BuffersD3D11.cpp.

◆ releaseIndexBuffer()

void Cogs::BuffersD3D11::releaseIndexBuffer ( IndexBufferHandle  indexBufferHandle)
virtual

Releases the index buffer with the given handle.

Parameters
indexBufferHandleValid handle to a previously created index buffer.

Implements Cogs::IBuffers.

Definition at line 145 of file BuffersD3D11.cpp.

◆ releaseInputLayout()

void Cogs::BuffersD3D11::releaseInputLayout ( InputLayoutHandle  inputLayoutHandle)
virtual

Releases the input layout with the given inputLayoutHandle.

Parameters
inputLayoutHandleValid handle to a previously created index buffer.

Implements Cogs::IBuffers.

Definition at line 267 of file BuffersD3D11.cpp.

◆ releaseResources()

void Cogs::BuffersD3D11::releaseResources ( )
virtual

Releases all allocated buffer resources.

Implements Cogs::IBuffers.

Definition at line 431 of file BuffersD3D11.cpp.

◆ releaseVertexBuffer()

void Cogs::BuffersD3D11::releaseVertexBuffer ( VertexBufferHandle  vertexBufferHandle)
virtual

Release the vertex buffer with the given handle.

The data is removed from GPU memory.

Parameters
vertexBufferHandleValid handle to a previously created vertex buffer.

Implements Cogs::IBuffers.

Definition at line 127 of file BuffersD3D11.cpp.

◆ retrieveSubBuffer()

void Cogs::BuffersD3D11::retrieveSubBuffer ( void *  data,
BufferHandle  source,
const  offset,
const  size 
)
inlinevirtual

Retrieves the contents of a buffer.

Parameters
dataPointer to where the data should be stored.
offsetThe offset in bytes inside the buffer from where to retrieve data.
sizeThe number of bytes to retrieve from the buffer.

Implements Cogs::IBuffers.

Definition at line 84 of file BuffersD3D11.h.

◆ setDevice()

void Cogs::BuffersD3D11::setDevice ( const ResourcePointer< ID3D11Device > &  device_set)
inline

Definition at line 62 of file BuffersD3D11.h.

Member Data Documentation

◆ bufferMemoryConsumption

size_t Cogs::BuffersD3D11::bufferMemoryConsumption = 0

Definition at line 97 of file BuffersD3D11.h.

◆ buffers

SafeResourceMap<BufferHandle, BufferD3D11> Cogs::BuffersD3D11::buffers

Definition at line 96 of file BuffersD3D11.h.

◆ context

ContextD3D11* Cogs::BuffersD3D11::context = nullptr
private

Definition at line 104 of file BuffersD3D11.h.

◆ device

ResourcePointer<ID3D11Device> Cogs::BuffersD3D11::device
private

Definition at line 102 of file BuffersD3D11.h.

◆ effects

EffectsD3D11* Cogs::BuffersD3D11::effects = nullptr
private

Definition at line 105 of file BuffersD3D11.h.

◆ inputLayouts

SafeResourceMap<InputLayoutHandle, InputLayoutD3D11> Cogs::BuffersD3D11::inputLayouts

Definition at line 99 of file BuffersD3D11.h.


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