#include <noncached_container.h>

Inheritance diagram for KIGFX::NONCACHED_CONTAINER:

Public Member Functions
	NONCACHED_CONTAINER (unsigned int aSize=DEFAULT_SIZE)
	Construct a non-cached container object.

virtual	~NONCACHED_CONTAINER ()

bool	IsCached () const override
	Return true if the container caches vertex data in RAM or video memory.

virtual void	SetItem (VERTEX_ITEM *aItem) override
	Set the item for the further actions.

virtual VERTEX *	Allocate (unsigned int aSize) override
	Return allocated space for the requested number of vertices associated with the current item (set with SetItem()).

void	Delete (VERTEX_ITEM *aItem) override
	Erase the data related to an item.

virtual void	Clear () override
	Remove all data stored in the container and restores its original state.

virtual unsigned int	GetSize () const override
	Return amount of vertices currently stored in the container.

virtual void	Map ()
	Prepare the container for vertices updates.

virtual void	Unmap ()
	Finish the vertices updates stage.

virtual void	FinishItem ()
	Clean up after adding an item.

VERTEX *	GetAllVertices () const
	Return pointer to the vertices stored in the container.

virtual VERTEX *	GetVertices (unsigned int aOffset) const
	Return vertices stored at the specific offset.

bool	IsDirty () const
	Return information about the container cache state.

void	SetDirty ()
	Set the dirty flag, so vertices in the container are going to be reuploaded to the GPU on the next frame.

void	ClearDirty ()
	Clear the dirty flag to prevent reuploading vertices to the GPU memory.

Static Public Member Functions
static VERTEX_CONTAINER *	MakeContainer (bool aCached)
	Return a pointer to a new container of an appropriate type.

Protected Member Functions
unsigned int	usedSpace () const
	Return size of the used memory space.

Protected Attributes
unsigned int	m_freePtr
	< Index of the free first space where a vertex can be stored

unsigned int	m_freeSpace
	Current container size, expressed in vertices.

unsigned int	m_currentSize
	Store the initial size, so it can be resized to this on Clear()

unsigned int	m_initialSize
	Actual storage memory.

VERTEX *	m_vertices

bool	m_failed

bool	m_dirty
	Default initial size of a container (expressed in vertices)

Static Protected Attributes
static constexpr unsigned int	DEFAULT_SIZE = 1048576

Detailed Description

Definition at line 41 of file noncached_container.h.

Constructor & Destructor Documentation

◆ NONCACHED_CONTAINER()

NONCACHED_CONTAINER::NONCACHED_CONTAINER ( unsigned int aSize = DEFAULT_SIZE )

Construct a non-cached container object.

Parameters

aSize is the size of the cache.

Exceptions

bad_alloc exception if memory allocation fails.

Definition at line 39 of file noncached_container.cpp.

References KIGFX::VERTEX_CONTAINER::m_vertices.

◆ ~NONCACHED_CONTAINER()

NONCACHED_CONTAINER::~NONCACHED_CONTAINER ( )

virtual

Definition at line 55 of file noncached_container.cpp.

References KIGFX::VERTEX_CONTAINER::m_vertices.

Member Function Documentation

◆ Allocate()

VERTEX * NONCACHED_CONTAINER::Allocate ( unsigned int aSize )

overridevirtual

Return allocated space for the requested number of vertices associated with the current item (set with SetItem()).

The allocated space is added at the end of the chunk used by the current item and may serve to store new vertices.

Parameters

aSize is the number of vertices to be allocated.

Returns: Pointer to the allocated space or NULL in case of failure.

Implements KIGFX::VERTEX_CONTAINER.

Definition at line 68 of file noncached_container.cpp.

References KIGFX::VERTEX_CONTAINER::m_currentSize, m_freePtr, KIGFX::VERTEX_CONTAINER::m_freeSpace, and KIGFX::VERTEX_CONTAINER::m_vertices.

◆ Clear()

void NONCACHED_CONTAINER::Clear ( )

overridevirtual

Remove all data stored in the container and restores its original state.

Implements KIGFX::VERTEX_CONTAINER.

Definition at line 98 of file noncached_container.cpp.

References KIGFX::VERTEX_CONTAINER::m_currentSize, m_freePtr, and KIGFX::VERTEX_CONTAINER::m_freeSpace.

◆ ClearDirty()

void KIGFX::VERTEX_CONTAINER::ClearDirty ( )

inlineinherited

Clear the dirty flag to prevent reuploading vertices to the GPU memory.

Definition at line 152 of file vertex_container.h.

References KIGFX::VERTEX_CONTAINER::m_dirty.

Referenced by KIGFX::GPU_CACHED_MANAGER::EndDrawing().

◆ Delete()

void KIGFX::NONCACHED_CONTAINER::Delete ( VERTEX_ITEM * aItem )

inlineoverridevirtual

Erase the data related to an item.

Parameters

aItem is the item to be erased.

Implements KIGFX::VERTEX_CONTAINER.

Definition at line 65 of file noncached_container.h.

◆ FinishItem()

virtual void KIGFX::VERTEX_CONTAINER::FinishItem ( )

inlinevirtualinherited

Clean up after adding an item.

Reimplemented in KIGFX::CACHED_CONTAINER.

Definition at line 78 of file vertex_container.h.

◆ GetAllVertices()

VERTEX * KIGFX::VERTEX_CONTAINER::GetAllVertices ( ) const

inlineinherited

Return pointer to the vertices stored in the container.

Definition at line 107 of file vertex_container.h.

References KIGFX::VERTEX_CONTAINER::m_vertices.

Referenced by KIGFX::GPU_NONCACHED_MANAGER::EndDrawing().

◆ GetSize()

virtual unsigned int KIGFX::NONCACHED_CONTAINER::GetSize ( ) const

inlineoverridevirtual

Return amount of vertices currently stored in the container.

Reimplemented from KIGFX::VERTEX_CONTAINER.

Definition at line 71 of file noncached_container.h.

References m_freePtr.

◆ GetVertices()

virtual VERTEX * KIGFX::VERTEX_CONTAINER::GetVertices ( unsigned int aOffset ) const

inlinevirtualinherited

Return vertices stored at the specific offset.

Parameters

aOffset is the offset.

Definition at line 117 of file vertex_container.h.

References KIGFX::VERTEX_CONTAINER::m_vertices.

◆ IsCached()

bool KIGFX::NONCACHED_CONTAINER::IsCached ( ) const

inlineoverridevirtual

Return true if the container caches vertex data in RAM or video memory.

Otherwise it is a single batch draw which is later discarded.

Implements KIGFX::VERTEX_CONTAINER.

Definition at line 53 of file noncached_container.h.

◆ IsDirty()

bool KIGFX::VERTEX_CONTAINER::IsDirty ( ) const

inlineinherited

Return information about the container cache state.

Returns: True in case the vertices have to be reuploaded.

Definition at line 135 of file vertex_container.h.

References KIGFX::VERTEX_CONTAINER::m_dirty.

◆ MakeContainer()

VERTEX_CONTAINER * VERTEX_CONTAINER::MakeContainer ( bool aCached )

staticinherited

Return a pointer to a new container of an appropriate type.

Definition at line 42 of file vertex_container.cpp.

Referenced by KIGFX::VERTEX_MANAGER::VERTEX_MANAGER().

◆ Map()

virtual void KIGFX::VERTEX_CONTAINER::Map ( )

inlinevirtualinherited

Prepare the container for vertices updates.

Reimplemented in KIGFX::CACHED_CONTAINER_GPU, KIGFX::CACHED_CONTAINER_RAM, and KIGFX::CACHED_CONTAINER.

Definition at line 61 of file vertex_container.h.

◆ SetDirty()

void KIGFX::VERTEX_CONTAINER::SetDirty ( )

inlineinherited

Set the dirty flag, so vertices in the container are going to be reuploaded to the GPU on the next frame.

Definition at line 144 of file vertex_container.h.

References KIGFX::VERTEX_CONTAINER::m_dirty.

◆ SetItem()

void NONCACHED_CONTAINER::SetItem ( VERTEX_ITEM * aItem )

overridevirtual

Set the item for the further actions.

Parameters

aItem is the item or NULL in case of finishing the item.

Implements KIGFX::VERTEX_CONTAINER.

Definition at line 61 of file noncached_container.cpp.

◆ Unmap()

virtual void KIGFX::VERTEX_CONTAINER::Unmap ( )

inlinevirtualinherited

Finish the vertices updates stage.

Reimplemented in KIGFX::CACHED_CONTAINER_GPU, KIGFX::CACHED_CONTAINER_RAM, and KIGFX::CACHED_CONTAINER.

Definition at line 66 of file vertex_container.h.

◆ usedSpace()

unsigned int KIGFX::VERTEX_CONTAINER::usedSpace ( ) const

inlineprotectedinherited

Return size of the used memory space.

Returns: Size of the used memory space (expressed as a number of vertices). Free space left in the container, expressed in vertices

Definition at line 165 of file vertex_container.h.

References KIGFX::VERTEX_CONTAINER::m_currentSize, and KIGFX::VERTEX_CONTAINER::m_freeSpace.

Referenced by KIGFX::CACHED_CONTAINER::defragment(), KIGFX::CACHED_CONTAINER_GPU::defragmentResize(), KIGFX::CACHED_CONTAINER_RAM::defragmentResize(), and KIGFX::CACHED_CONTAINER_GPU::defragmentResizeMemcpy().

Member Data Documentation

◆ DEFAULT_SIZE

constexpr unsigned int KIGFX::VERTEX_CONTAINER::DEFAULT_SIZE = 1048576

staticconstexprprotectedinherited

Definition at line 187 of file vertex_container.h.

◆ m_currentSize

unsigned int KIGFX::VERTEX_CONTAINER::m_currentSize

protectedinherited

Store the initial size, so it can be resized to this on Clear()

Definition at line 174 of file vertex_container.h.

◆ m_dirty

bool KIGFX::VERTEX_CONTAINER::m_dirty

protectedinherited

Default initial size of a container (expressed in vertices)

Definition at line 184 of file vertex_container.h.

Referenced by KIGFX::CACHED_CONTAINER::Allocate(), KIGFX::VERTEX_CONTAINER::ClearDirty(), KIGFX::CACHED_CONTAINER_RAM::defragmentResize(), KIGFX::VERTEX_CONTAINER::IsDirty(), KIGFX::VERTEX_CONTAINER::SetDirty(), and KIGFX::CACHED_CONTAINER_RAM::Unmap().

◆ m_failed

bool KIGFX::VERTEX_CONTAINER::m_failed

protectedinherited

Definition at line 183 of file vertex_container.h.

Referenced by KIGFX::CACHED_CONTAINER::Allocate(), and KIGFX::CACHED_CONTAINER::Clear().

◆ m_freePtr

unsigned int KIGFX::NONCACHED_CONTAINER::m_freePtr

protected

< Index of the free first space where a vertex can be stored

Definition at line 80 of file noncached_container.h.

Referenced by Allocate(), Clear(), and GetSize().

◆ m_freeSpace

unsigned int KIGFX::VERTEX_CONTAINER::m_freeSpace

protectedinherited

Current container size, expressed in vertices.

Definition at line 171 of file vertex_container.h.

Referenced by KIGFX::CACHED_CONTAINER::addFreeChunk(), Allocate(), KIGFX::CACHED_CONTAINER::Clear(), Clear(), KIGFX::CACHED_CONTAINER_GPU::defragmentResize(), KIGFX::CACHED_CONTAINER_RAM::defragmentResize(), KIGFX::CACHED_CONTAINER_GPU::defragmentResizeMemcpy(), KIGFX::CACHED_CONTAINER::Delete(), KIGFX::CACHED_CONTAINER::reallocate(), KIGFX::CACHED_CONTAINER::test(), and KIGFX::VERTEX_CONTAINER::usedSpace().

◆ m_initialSize

unsigned int KIGFX::VERTEX_CONTAINER::m_initialSize

protectedinherited

Actual storage memory.

Definition at line 177 of file vertex_container.h.

Referenced by KIGFX::CACHED_CONTAINER::Delete().

◆ m_vertices

VERTEX* KIGFX::VERTEX_CONTAINER::m_vertices

protectedinherited

Definition at line 180 of file vertex_container.h.

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

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ NONCACHED_CONTAINER()

◆ ~NONCACHED_CONTAINER()

Member Function Documentation

◆ Allocate()

◆ Clear()

◆ ClearDirty()

◆ Delete()

◆ FinishItem()

◆ GetAllVertices()

◆ GetSize()

◆ GetVertices()

◆ IsCached()

◆ IsDirty()

◆ MakeContainer()

◆ Map()

◆ SetDirty()

◆ SetItem()

◆ Unmap()

◆ usedSpace()

Member Data Documentation

◆ DEFAULT_SIZE

◆ m_currentSize

◆ m_dirty

◆ m_failed

◆ m_freePtr

◆ m_freeSpace

◆ m_initialSize

◆ m_vertices