KIGFX::VERTEX_MANAGER Class Reference

#include <vertex_manager.h>

Public Member Functions
	VERTEX_MANAGER (bool aCached)
	Constructor. More...
void	Map ()
	Function Map() maps vertex buffer. More...
void	Unmap ()
	Function Unmap() unmaps vertex buffer. More...
bool	Reserve (unsigned int aSize)
	Function Reserve() allocates space for vertices, so it will be used with subsequent Vertex() calls. More...
bool	Vertex (const VERTEX &aVertex)
	Function Vertex() adds a vertex with the given coordinates to the currently set item. More...
bool	Vertex (GLfloat aX, GLfloat aY, GLfloat aZ)
	Function Vertex() adds a vertex with the given coordinates to the currently set item. More...
bool	Vertices (const VERTEX aVertices[], unsigned int aSize)
	Function Vertices() adds one or more vertices to the currently set item. More...
void	Color (const COLOR4D &aColor)
	Function Color() changes currently used color that will be applied to newly added vertices. More...
void	Color (GLfloat aRed, GLfloat aGreen, GLfloat aBlue, GLfloat aAlpha)
	Function Color() changes currently used color that will be applied to newly added vertices. More...
void	Shader (GLfloat aShaderType, GLfloat aParam1=0.0f, GLfloat aParam2=0.0f, GLfloat aParam3=0.0f)
	Function Shader() changes currently used shader and its parameters that will be applied to newly added vertices. More...
void	Translate (GLfloat aX, GLfloat aY, GLfloat aZ)
	Function Translate() multiplies the current matrix by a translation matrix, so newly vertices will be translated by the given vector. More...
void	Rotate (GLfloat aAngle, GLfloat aX, GLfloat aY, GLfloat aZ)
	Function Rotate() multiplies the current matrix by a rotation matrix, so the newly vertices will be rotated by the given angles. More...
void	Scale (GLfloat aX, GLfloat aY, GLfloat aZ)
	Function Scale() multiplies the current matrix by a scaling matrix, so the newly vertices will be scaled by the given factors. More...
void	PushMatrix ()
	Function PushMatrix() pushes the current transformation matrix stack. More...
void	PopMatrix ()
	Function PopMatrix() pops the current transformation matrix stack. More...
void	SetItem (VERTEX_ITEM &aItem) const
	Function SetItem() sets an item to start its modifications. More...
void	FinishItem () const
	Function FinishItem() does the cleaning after adding an item. More...
void	FreeItem (VERTEX_ITEM &aItem) const
	Function FreeItem() frees the memory occupied by the item, so it is no longer stored in the container. More...
void	ChangeItemColor (const VERTEX_ITEM &aItem, const COLOR4D &aColor) const
	Function ChangeItemColor() changes the color of all vertices owned by an item. More...
void	ChangeItemDepth (const VERTEX_ITEM &aItem, GLfloat aDepth) const
	Function ChangeItemDepth() changes the depth of all vertices owned by an item. More...
VERTEX *	GetVertices (const VERTEX_ITEM &aItem) const
	Function GetVertices() returns a pointer to the vertices owned by an item. More...
const glm::mat4 &	GetTransformation () const
void	SetShader (SHADER &aShader) const
	Function SetShader() sets a shader program that is going to be used during rendering. More...
void	Clear () const
	Function Clear() removes all the stored vertices from the container. More...
void	BeginDrawing () const
	Function BeginDrawing() prepares buffers and items to start drawing. More...
void	DrawItem (const VERTEX_ITEM &aItem) const
	Function DrawItem() draws an item to the buffer. More...
void	EndDrawing () const
	Function EndDrawing() finishes drawing operations. More...

Protected Member Functions
void	putVertex (VERTEX &aTarget, GLfloat aX, GLfloat aY, GLfloat aZ) const
	Function putVertex() applies all transformation to the given coordinates and store them at the specified target. More...

Protected Attributes
std::shared_ptr< VERTEX_CONTAINER >	m_container
	Container for vertices, may be cached or noncached. More...
std::shared_ptr< GPU_MANAGER >	m_gpu
	GPU manager for data transfers and drawing operations. More...
bool	m_noTransform
	State machine variables True in case there is no need to transform vertices. More...
glm::mat4	m_transform
	Currently used transform matrix. More...
std::stack< glm::mat4 >	m_transformStack
	Stack of transformation matrices, used for Push/PopMatrix. More...
GLubyte	m_color [COLOR_STRIDE]
	Currently used color. More...
GLfloat	m_shader [SHADER_STRIDE]
	Currently used shader and its parameters. More...
VERTEX *	m_reserved
	Currently reserved chunk to store vertices. More...
unsigned int	m_reservedSpace
	Currently available reserved space. More...

Detailed Description

Definition at line 50 of file vertex_manager.h.

Constructor & Destructor Documentation

VERTEX_MANAGER::VERTEX_MANAGER

(

bool

aCached

)

Constructor.

Parameters

aCached

says if vertices should be cached in GPU or system memory. For data that does not change every frame, it is better to store vertices in GPU memory.

Definition at line 40 of file vertex_manager.cpp.

References i, m_container, m_gpu, m_shader, KIGFX::VERTEX_CONTAINER::MakeContainer(), KIGFX::GPU_MANAGER::MakeManager(), and KIGFX::SHADER_STRIDE.

                                             :
    m_noTransform( true ), m_transform( 1.0f ), m_reserved( NULL ), m_reservedSpace( 0 )
{
    m_container.reset( VERTEX_CONTAINER::MakeContainer( aCached ) );
    m_gpu.reset( GPU_MANAGER::MakeManager( m_container.get() ) );

    // There is no shader used by default
    for( unsigned int i = 0; i < SHADER_STRIDE; ++i )
        m_shader[i] = 0.0f;
}

Member Function Documentation

void VERTEX_MANAGER::BeginDrawing

(

)

const

Function BeginDrawing() prepares buffers and items to start drawing.

Definition at line 233 of file vertex_manager.cpp.

References m_gpu.

Referenced by KIGFX::OPENGL_GAL::BeginDrawing(), and GetTransformation().

{
    m_gpu->BeginDrawing();
}

void VERTEX_MANAGER::ChangeItemColor	(	const VERTEX_ITEM &	aItem,
		const COLOR4D &	aColor
	)		const

Function ChangeItemColor() changes the color of all vertices owned by an item.

Parameters

aItem	is the item to change.
aColor	is the new color to be applied.

Definition at line 175 of file vertex_manager.cpp.

References KIGFX::VERTEX::a, KIGFX::COLOR4D::a, KIGFX::VERTEX::b, KIGFX::COLOR4D::b, KIGFX::VERTEX::g, KIGFX::COLOR4D::g, KIGFX::VERTEX_ITEM::GetOffset(), KIGFX::VERTEX_ITEM::GetSize(), i, m_container, KIGFX::VERTEX::r, and KIGFX::COLOR4D::r.

Referenced by KIGFX::OPENGL_GAL::ChangeGroupColor(), and PopMatrix().

{
    unsigned int size   = aItem.GetSize();
    unsigned int offset = aItem.GetOffset();

    VERTEX* vertex = m_container->GetVertices( offset );

    for( unsigned int i = 0; i < size; ++i )
    {
        vertex->r = aColor.r * 255.0;
        vertex->g = aColor.g * 255.0;
        vertex->b = aColor.b * 255.0;
        vertex->a = aColor.a * 255.0;
        vertex++;
    }

    m_container->SetDirty();
}

void VERTEX_MANAGER::ChangeItemDepth	(	const VERTEX_ITEM &	aItem,
		GLfloat	aDepth
	)		const

Function ChangeItemDepth() changes the depth of all vertices owned by an item.

Parameters

aItem	is the item to change.
aDepth	is the new color to be applied.

Definition at line 195 of file vertex_manager.cpp.

References KIGFX::VERTEX_ITEM::GetOffset(), KIGFX::VERTEX_ITEM::GetSize(), i, m_container, and KIGFX::VERTEX::z.

Referenced by KIGFX::OPENGL_GAL::ChangeGroupDepth(), and PopMatrix().

{
    unsigned int size   = aItem.GetSize();
    unsigned int offset = aItem.GetOffset();

    VERTEX* vertex = m_container->GetVertices( offset );

    for( unsigned int i = 0; i < size; ++i )
    {
        vertex->z = aDepth;
        vertex++;
    }

    m_container->SetDirty();
}

void VERTEX_MANAGER::Clear

(

)

const

Function Clear() removes all the stored vertices from the container.

Definition at line 227 of file vertex_manager.cpp.

References m_container.

Referenced by KIGFX::OPENGL_GAL::BeginDrawing(), KIGFX::OPENGL_GAL::ClearCache(), and GetTransformation().

{
    m_container->Clear();
}

void KIGFX::VERTEX_MANAGER::Color ( const COLOR4D &  aColor )

inline

Function Color() changes currently used color that will be applied to newly added vertices.

Parameters

aColor

is the new color.

Definition at line 129 of file vertex_manager.h.

References KIGFX::COLOR4D::a, KIGFX::COLOR4D::b, KIGFX::COLOR4D::g, m_color, and KIGFX::COLOR4D::r.

Referenced by KIGFX::OPENGL_GAL::BitmapText(), KIGFX::OPENGL_GAL::DrawArc(), KIGFX::OPENGL_GAL::DrawArcSegment(), KIGFX::OPENGL_GAL::drawBitmapOverbar(), KIGFX::OPENGL_GAL::DrawCircle(), KIGFX::OPENGL_GAL::DrawLine(), KIGFX::OPENGL_GAL::drawPolygon(), KIGFX::OPENGL_GAL::drawPolyline(), KIGFX::OPENGL_GAL::DrawRectangle(), KIGFX::OPENGL_GAL::DrawSegment(), KIGFX::OPENGL_GAL::drawSemiCircle(), and KIGFX::OPENGL_GAL::drawTriangulatedPolyset().

    {
        m_color[0] = aColor.r * 255.0;
        m_color[1] = aColor.g * 255.0;
        m_color[2] = aColor.b * 255.0;
        m_color[3] = aColor.a * 255.0;
    }

void KIGFX::VERTEX_MANAGER::Color ( GLfloat  aRed, GLfloat  aGreen, GLfloat  aBlue, GLfloat  aAlpha  )

inline

Function Color() changes currently used color that will be applied to newly added vertices.

It is the equivalent of glColor4f() function.

Parameters

aRed	is the red component of the new color.
aGreen	is the green component of the new color.
aBlue	is the blue component of the new color.
aAlpha	is the alpha component of the new color.

Definition at line 146 of file vertex_manager.h.

References m_color.

    {
        m_color[0] = aRed   * 255.0;
        m_color[1] = aGreen * 255.0;
        m_color[2] = aBlue  * 255.0;
        m_color[3] = aAlpha * 255.0;
    }

void VERTEX_MANAGER::DrawItem

(

const VERTEX_ITEM &

aItem

)

const

Function DrawItem() draws an item to the buffer.

Parameters

aItem

is the item to be drawn.

Definition at line 239 of file vertex_manager.cpp.

References KIGFX::VERTEX_ITEM::GetOffset(), KIGFX::VERTEX_ITEM::GetSize(), and m_gpu.

Referenced by KIGFX::OPENGL_GAL::DrawGroup(), and GetTransformation().

{
    int size = aItem.GetSize();
    int offset = aItem.GetOffset();

    m_gpu->DrawIndices( offset, size );
}

void VERTEX_MANAGER::EndDrawing

(

)

const

Function EndDrawing() finishes drawing operations.

Definition at line 248 of file vertex_manager.cpp.

References m_gpu.

Referenced by KIGFX::OPENGL_GAL::EndDrawing(), and GetTransformation().

{
    m_gpu->EndDrawing();
}

void VERTEX_MANAGER::FinishItem

(

)

const

Function FinishItem() does the cleaning after adding an item.

Definition at line 163 of file vertex_manager.cpp.

References m_container.

Referenced by KIGFX::OPENGL_GAL::EndGroup(), and PopMatrix().

{
    m_container->FinishItem();
}

void VERTEX_MANAGER::FreeItem

(

VERTEX_ITEM &

aItem

)

const

Function FreeItem() frees the memory occupied by the item, so it is no longer stored in the container.

Parameters

aItem

is the item to be freed

Definition at line 169 of file vertex_manager.cpp.

References m_container.

Referenced by PopMatrix(), and KIGFX::VERTEX_ITEM::~VERTEX_ITEM().

{
    m_container->Delete( &aItem );
}

const glm::mat4& KIGFX::VERTEX_MANAGER::GetTransformation ( ) const

inline

Definition at line 300 of file vertex_manager.h.

References BeginDrawing(), Clear(), DrawItem(), EndDrawing(), m_transform, putVertex(), and SetShader().

Referenced by KIGFX::OPENGL_GAL::drawLineQuad().

    {
        return m_transform;
    }

VERTEX * VERTEX_MANAGER::GetVertices

(

const VERTEX_ITEM &

aItem

)

const

Function GetVertices() returns a pointer to the vertices owned by an item.

Parameters

aItem

is the owner of vertices that are going to be returned.

Returns

Pointer to the vertices or NULL if the item is not stored at the container.

Definition at line 212 of file vertex_manager.cpp.

References KIGFX::VERTEX_ITEM::GetOffset(), KIGFX::VERTEX_ITEM::GetSize(), and m_container.

Referenced by KIGFX::VERTEX_ITEM::GetVertices(), and PopMatrix().

{
    if( aItem.GetSize() == 0 )
        return NULL; // The item is not stored in the container

    return m_container->GetVertices( aItem.GetOffset() );
}

void VERTEX_MANAGER::Map

(

)

Function Map() maps vertex buffer.

Definition at line 52 of file vertex_manager.cpp.

References m_container.

Referenced by KIGFX::OPENGL_GAL::BeginUpdate().

{
    m_container->Map();
}

void KIGFX::VERTEX_MANAGER::PopMatrix ( )

inline

Function PopMatrix() pops the current transformation matrix stack.

It is the equivalent of the glPopMatrix() function.

Definition at line 236 of file vertex_manager.h.

References ChangeItemColor(), ChangeItemDepth(), FinishItem(), FreeItem(), GetVertices(), m_noTransform, m_transform, m_transformStack, and SetItem().

Referenced by KIGFX::OPENGL_GAL::Restore().

    {
        wxASSERT( !m_transformStack.empty() );

        m_transform = m_transformStack.top();
        m_transformStack.pop();

        if( m_transformStack.empty() )
        {
            // We return back to the identity matrix, thus no vertex transformation is needed
            m_noTransform = true;
        }
    }

void KIGFX::VERTEX_MANAGER::PushMatrix ( )

inline

Function PushMatrix() pushes the current transformation matrix stack.

It is the equivalent of the glPushMatrix() function.

Definition at line 223 of file vertex_manager.h.

References m_noTransform, m_transform, and m_transformStack.

Referenced by KIGFX::OPENGL_GAL::Save().

    {
        m_transformStack.push( m_transform );

        // Every transformation starts with PushMatrix
        m_noTransform = false;
    }

void VERTEX_MANAGER::putVertex ( VERTEX &  aTarget, GLfloat  aX, GLfloat  aY, GLfloat  aZ  ) const

protected

Function putVertex() applies all transformation to the given coordinates and store them at the specified target.

Parameters

aTarget	is the place where the new vertex is going to be stored (it has to be allocated first).
aX	is the X coordinate of the new vertex.
aY	is the Y coordinate of the new vertex.
aZ	is the Z coordinate of the new vertex.

Definition at line 254 of file vertex_manager.cpp.

References KIGFX::VERTEX::a, KIGFX::VERTEX::b, KIGFX::VERTEX::g, m_color, m_noTransform, m_shader, m_transform, KIGFX::VERTEX::r, KIGFX::VERTEX::shader, KIGFX::SHADER_STRIDE, KIGFX::VERTEX::x, KIGFX::VERTEX::y, and KIGFX::VERTEX::z.

Referenced by GetTransformation(), Vertex(), and Vertices().

{
    // Modify the vertex according to the currently used transformations
    if( m_noTransform )
    {
        // Simply copy coordinates, when the transform matrix is the identity matrix
        aTarget.x = aX;
        aTarget.y = aY;
        aTarget.z = aZ;
    }
    else
    {
        // Apply transformations
        glm::vec4 transVertex( aX, aY, aZ, 1.0f );
        transVertex = m_transform * transVertex;

        aTarget.x = transVertex.x;
        aTarget.y = transVertex.y;
        aTarget.z = transVertex.z;
    }

    // Apply currently used color
    aTarget.r = m_color[0];
    aTarget.g = m_color[1];
    aTarget.b = m_color[2];
    aTarget.a = m_color[3];

    // Apply currently used shader
    for( unsigned int j = 0; j < SHADER_STRIDE; ++j )
    {
        aTarget.shader[j] = m_shader[j];
    }
}

bool VERTEX_MANAGER::Reserve

(

unsigned int

aSize

)

Function Reserve() allocates space for vertices, so it will be used with subsequent Vertex() calls.

Parameters

aSize

is the number of vertices that should be available in the reserved space.

Returns

True if successful, false otherwise.

Definition at line 64 of file vertex_manager.cpp.

References DisplayError(), m_container, m_reserved, and m_reservedSpace.

Referenced by KIGFX::OPENGL_GAL::DrawArc(), KIGFX::OPENGL_GAL::drawBitmapChar(), KIGFX::OPENGL_GAL::drawBitmapOverbar(), KIGFX::OPENGL_GAL::DrawCircle(), KIGFX::OPENGL_GAL::drawFilledSemiCircle(), KIGFX::OPENGL_GAL::drawLineQuad(), KIGFX::OPENGL_GAL::DrawRectangle(), and KIGFX::OPENGL_GAL::drawStrokedSemiCircle().

{
    assert( m_reservedSpace == 0 && m_reserved == NULL );

    // flag to avoid hanging by calling DisplayError too many times:
    static bool show_err = true;

    m_reserved = m_container->Allocate( aSize );

    if( m_reserved == NULL )
    {
        if( show_err )
        {
            DisplayError( NULL, wxT( "VERTEX_MANAGER::Reserve: Vertex allocation error" ) );
            show_err = false;
        }

        return false;
    }

    m_reservedSpace = aSize;

    return true;
}

void KIGFX::VERTEX_MANAGER::Rotate ( GLfloat  aAngle, GLfloat  aX, GLfloat  aY, GLfloat  aZ  )

inline

Function Rotate() multiplies the current matrix by a rotation matrix, so the newly vertices will be rotated by the given angles.

It is the equivalent of the glRotatef() function.

Parameters

aAngle	is the angle of rotation, in radians.
aX	is a multiplier for the X axis
aY	is a multiplier for the Y axis
aZ	is a multiplier for the Z axis.

Definition at line 199 of file vertex_manager.h.

References m_transform.

Referenced by KIGFX::OPENGL_GAL::BitmapText(), KIGFX::OPENGL_GAL::drawFilledSemiCircle(), KIGFX::OPENGL_GAL::DrawSegment(), KIGFX::OPENGL_GAL::drawStrokedSemiCircle(), and KIGFX::OPENGL_GAL::Rotate().

    {
        m_transform = glm::rotate( m_transform, aAngle, glm::vec3( aX, aY, aZ ) );
    }

void KIGFX::VERTEX_MANAGER::Scale ( GLfloat  aX, GLfloat  aY, GLfloat  aZ  )

inline

Function Scale() multiplies the current matrix by a scaling matrix, so the newly vertices will be scaled by the given factors.

It is the equivalent of the glScalef() function.

Parameters

aX	is the X axis scaling factor.
aY	is the Y axis scaling factor.
aZ	is the Z axis scaling factor.

Definition at line 213 of file vertex_manager.h.

References m_transform, and scale.

Referenced by KIGFX::OPENGL_GAL::BitmapText(), and KIGFX::OPENGL_GAL::Scale().

    {
        m_transform = glm::scale( m_transform, glm::vec3( aX, aY, aZ ) );
    }

void VERTEX_MANAGER::SetItem

(

VERTEX_ITEM &

aItem

)

const

Function SetItem() sets an item to start its modifications.

After calling the function it is possible to add vertices using function Add().

Parameters

aItem

is the item that is going to store vertices in the container.

Definition at line 157 of file vertex_manager.cpp.

References m_container.

Referenced by PopMatrix(), and KIGFX::VERTEX_ITEM::VERTEX_ITEM().

{
    m_container->SetItem( &aItem );
}

void VERTEX_MANAGER::SetShader

(

SHADER &

aShader

)

const

Function SetShader() sets a shader program that is going to be used during rendering.

Parameters

aShader

is the object containing compiled and linked shader program.

Definition at line 221 of file vertex_manager.cpp.

References m_gpu.

Referenced by GetTransformation(), and KIGFX::OPENGL_GAL::init().

{
    m_gpu->SetShader( aShader );
}

void KIGFX::VERTEX_MANAGER::Shader ( GLfloat  aShaderType, GLfloat  aParam1 = 0.0f, GLfloat  aParam2 = 0.0f, GLfloat  aParam3 = 0.0f  )

inline

Function Shader() changes currently used shader and its parameters that will be applied to newly added vertices.

Parameters depend on shader, for more information have a look at shaders source code.

See also

SHADER_TYPE

Parameters

aShaderType	is the a shader type to be applied.
aParam1	is the optional parameter for a shader.
aParam2	is the optional parameter for a shader.
aParam3	is the optional parameter for a shader.

Definition at line 166 of file vertex_manager.h.

References m_shader.

Referenced by KIGFX::OPENGL_GAL::DrawArc(), KIGFX::OPENGL_GAL::drawBitmapChar(), KIGFX::OPENGL_GAL::drawBitmapOverbar(), KIGFX::OPENGL_GAL::DrawCircle(), KIGFX::OPENGL_GAL::drawFilledSemiCircle(), KIGFX::OPENGL_GAL::drawLineQuad(), KIGFX::OPENGL_GAL::drawPolygon(), KIGFX::OPENGL_GAL::DrawRectangle(), KIGFX::OPENGL_GAL::drawStrokedSemiCircle(), and KIGFX::OPENGL_GAL::drawTriangulatedPolyset().

    {
        m_shader[0] = aShaderType;
        m_shader[1] = aParam1;
        m_shader[2] = aParam2;
        m_shader[3] = aParam3;
    }

void KIGFX::VERTEX_MANAGER::Translate ( GLfloat  aX, GLfloat  aY, GLfloat  aZ  )

inline

Function Translate() multiplies the current matrix by a translation matrix, so newly vertices will be translated by the given vector.

It is the equivalent of the glTranslatef() function.

Parameters

aX	is the X coordinate of a translation vector.
aY	is the X coordinate of a translation vector.
aZ	is the X coordinate of a translation vector.

Definition at line 184 of file vertex_manager.h.

References m_transform.

Referenced by KIGFX::OPENGL_GAL::BitmapText(), KIGFX::OPENGL_GAL::DrawArc(), KIGFX::OPENGL_GAL::DrawArcSegment(), KIGFX::OPENGL_GAL::drawFilledSemiCircle(), KIGFX::OPENGL_GAL::DrawSegment(), KIGFX::OPENGL_GAL::drawStrokedSemiCircle(), and KIGFX::OPENGL_GAL::Translate().

    {
        m_transform = glm::translate( m_transform, glm::vec3( aX, aY, aZ ) );
    }

void VERTEX_MANAGER::Unmap

(

)

Function Unmap() unmaps vertex buffer.

Definition at line 58 of file vertex_manager.cpp.

References m_container.

Referenced by KIGFX::OPENGL_GAL::EndUpdate().

{
    m_container->Unmap();
}

bool KIGFX::VERTEX_MANAGER::Vertex ( const VERTEX &  aVertex )

inline

Function Vertex() adds a vertex with the given coordinates to the currently set item.

Color & shader parameters stored in aVertex are ignored, instead color & shader set by Color() and Shader() functions are used. Vertex coordinates will have the current transformation matrix applied.

Parameters

aVertex

contains vertex coordinates.

Returns

True if successful, false otherwise.

Definition at line 92 of file vertex_manager.h.

References Vertices(), KIGFX::VERTEX::x, KIGFX::VERTEX::y, and KIGFX::VERTEX::z.

Referenced by KIGFX::OPENGL_GAL::DrawArc(), KIGFX::OPENGL_GAL::drawBitmapChar(), KIGFX::OPENGL_GAL::drawBitmapOverbar(), KIGFX::OPENGL_GAL::DrawCircle(), KIGFX::OPENGL_GAL::drawFilledSemiCircle(), KIGFX::OPENGL_GAL::drawLineQuad(), KIGFX::OPENGL_GAL::DrawRectangle(), KIGFX::OPENGL_GAL::drawStrokedSemiCircle(), KIGFX::OPENGL_GAL::drawTriangulatedPolyset(), and VertexCallback().

    {
        return Vertex( aVertex.x, aVertex.y, aVertex.z );
    }

bool VERTEX_MANAGER::Vertex	(	GLfloat	aX,
		GLfloat	aY,
		GLfloat	aZ
	)

Function Vertex() adds a vertex with the given coordinates to the currently set item.

Vertex coordinates will have the current transformation matrix applied.

Parameters

aX	is the X coordinate of the new vertex.
aY	is the Y coordinate of the new vertex.
aZ	is the Z coordinate of the new vertex.

Returns

True if successful, false otherwise.

Definition at line 90 of file vertex_manager.cpp.

References DisplayError(), m_container, m_reserved, m_reservedSpace, and putVertex().

{
    // flag to avoid hanging by calling DisplayError too many times:
    static bool show_err = true;

    // Obtain the pointer to the vertex in the currently used container
    VERTEX* newVertex;

    if( m_reservedSpace > 0 )
    {
        newVertex = m_reserved++;
        --m_reservedSpace;

        if( m_reservedSpace == 0 )
            m_reserved = NULL;
    }
    else
    {
        newVertex = m_container->Allocate( 1 );
    }

    if( newVertex == NULL )
    {
        if( show_err )
        {
            DisplayError( NULL, wxT( "VERTEX_MANAGER::Vertex: Vertex allocation error" ) );
            show_err = false;
        }

        return false;
    }

    putVertex( *newVertex, aX, aY, aZ );

    return true;
}

bool VERTEX_MANAGER::Vertices	(	const VERTEX	aVertices[],
		unsigned int	aSize
	)

Function Vertices() adds one or more vertices to the currently set item.

It takes advantage of allocating memory in advance, so should be faster than adding vertices one by one. Color & shader parameters stored in aVertices are ignored, instead color & shader set by Color() and Shader() functions are used. All the vertex coordinates will have the current transformation matrix applied.

Parameters

aVertices	contains vertices to be added
aSize	is the number of vertices to be added.

Returns

True if successful, false otherwise.

Definition at line 128 of file vertex_manager.cpp.

References DisplayError(), i, m_container, and putVertex().

Referenced by Vertex().

{
    // flag to avoid hanging by calling DisplayError too many times:
    static bool show_err = true;

    // Obtain pointer to the vertex in currently used container
    VERTEX* newVertex = m_container->Allocate( aSize );

    if( newVertex == NULL )
    {
        if( show_err )
        {
            DisplayError( NULL, wxT( "VERTEX_MANAGER::Vertices: Vertex allocation error" ) );
            show_err = false;
        }

        return false;
    }

    // Put vertices in already allocated memory chunk
    for( unsigned int i = 0; i < aSize; ++i )
    {
        putVertex( newVertex[i], aVertices[i].x, aVertices[i].y, aVertices[i].z );
    }

    return true;
}

Member Data Documentation

GLubyte KIGFX::VERTEX_MANAGER::m_color[COLOR_STRIDE]

protected

Currently used color.

Definition at line 364 of file vertex_manager.h.

Referenced by Color(), and putVertex().

std::shared_ptr<VERTEX_CONTAINER> KIGFX::VERTEX_MANAGER::m_container

protected

Container for vertices, may be cached or noncached.

Definition at line 352 of file vertex_manager.h.

Referenced by ChangeItemColor(), ChangeItemDepth(), Clear(), FinishItem(), FreeItem(), GetVertices(), Map(), Reserve(), SetItem(), Unmap(), Vertex(), VERTEX_MANAGER(), and Vertices().

std::shared_ptr<GPU_MANAGER> KIGFX::VERTEX_MANAGER::m_gpu

protected

GPU manager for data transfers and drawing operations.

Definition at line 354 of file vertex_manager.h.

Referenced by BeginDrawing(), DrawItem(), EndDrawing(), SetShader(), and VERTEX_MANAGER().

bool KIGFX::VERTEX_MANAGER::m_noTransform

protected

State machine variables True in case there is no need to transform vertices.

Definition at line 358 of file vertex_manager.h.

Referenced by PopMatrix(), PushMatrix(), and putVertex().

VERTEX* KIGFX::VERTEX_MANAGER::m_reserved

protected

Currently reserved chunk to store vertices.

Definition at line 369 of file vertex_manager.h.

Referenced by Reserve(), and Vertex().

unsigned int KIGFX::VERTEX_MANAGER::m_reservedSpace

protected

Currently available reserved space.

Definition at line 372 of file vertex_manager.h.

Referenced by Reserve(), and Vertex().

GLfloat KIGFX::VERTEX_MANAGER::m_shader[SHADER_STRIDE]

protected

Currently used shader and its parameters.

Definition at line 366 of file vertex_manager.h.

Referenced by putVertex(), Shader(), and VERTEX_MANAGER().

glm::mat4 KIGFX::VERTEX_MANAGER::m_transform

protected

Currently used transform matrix.

Definition at line 360 of file vertex_manager.h.

Referenced by GetTransformation(), PopMatrix(), PushMatrix(), putVertex(), Rotate(), Scale(), and Translate().

std::stack<glm::mat4> KIGFX::VERTEX_MANAGER::m_transformStack

protected

Stack of transformation matrices, used for Push/PopMatrix.

Definition at line 362 of file vertex_manager.h.

Referenced by PopMatrix(), and PushMatrix().

---

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

• vertex_manager.h
• vertex_manager.cpp