KiCad PCB EDA Suite
KIGFX::VERTEX_MANAGER Class Reference

Class to control vertex container and GPU with possibility of emulating old-style OpenGL 1.0 state machine using modern OpenGL methods. More...

#include <vertex_manager.h>

Public Member Functions

 VERTEX_MANAGER (bool aCached)
 
void Map ()
 Map vertex buffer. More...
 
void Unmap ()
 Unmap vertex buffer. More...
 
bool Reserve (unsigned int aSize)
 Allocate space for vertices, so it will be used with subsequent Vertex() calls. More...
 
bool Vertex (const VERTEX &aVertex)
 Add a vertex with the given coordinates to the currently set item. More...
 
bool Vertex (GLfloat aX, GLfloat aY, GLfloat aZ)
 Add a vertex with the given coordinates to the currently set item. More...
 
bool Vertex (const VECTOR2D &aXY, GLfloat aZ)
 Add a vertex with the given coordinates to the currently set item. More...
 
bool Vertices (const VERTEX aVertices[], unsigned int aSize)
 Add one or more vertices to the currently set item. More...
 
void Color (const COLOR4D &aColor)
 Changes currently used color that will be applied to newly added vertices. More...
 
void Color (GLfloat aRed, GLfloat aGreen, GLfloat aBlue, GLfloat aAlpha)
 Change 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)
 Change currently used shader and its parameters that will be applied to newly added vertices. More...
 
void Translate (GLfloat aX, GLfloat aY, GLfloat aZ)
 Multiply 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)
 Multiply 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)
 Multiply the current matrix by a scaling matrix, so the newly vertices will be scaled by the given factors. More...
 
void PushMatrix ()
 Push the current transformation matrix stack. More...
 
void PopMatrix ()
 Pop the current transformation matrix stack. More...
 
void SetItem (VERTEX_ITEM &aItem) const
 Set an item to start its modifications. More...
 
void FinishItem () const
 Clean after adding an item. More...
 
void FreeItem (VERTEX_ITEM &aItem) const
 Free 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
 Change the color of all vertices owned by an item. More...
 
void ChangeItemDepth (const VERTEX_ITEM &aItem, GLfloat aDepth) const
 Change the depth of all vertices owned by an item. More...
 
VERTEXGetVertices (const VERTEX_ITEM &aItem) const
 Return a pointer to the vertices owned by an item. More...
 
const glm::mat4 & GetTransformation () const
 
void SetShader (SHADER &aShader) const
 Set a shader program that is going to be used during rendering. More...
 
void Clear () const
 Remove all the stored vertices from the container. More...
 
void BeginDrawing () const
 Prepare buffers and items to start drawing. More...
 
void DrawItem (const VERTEX_ITEM &aItem) const
 Draw an item to the buffer. More...
 
void EndDrawing () const
 Finish drawing operations. More...
 
void EnableDepthTest (bool aEnabled)
 Enable/disable Z buffer depth test. More...
 

Protected Member Functions

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

Protected Attributes

std::shared_ptr< VERTEX_CONTAINERm_container
 Container for vertices, may be cached or noncached. More...
 
std::shared_ptr< GPU_MANAGERm_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...
 
VERTEXm_reserved
 Currently reserved chunk to store vertices. More...
 
unsigned int m_reservedSpace
 Currently available reserved space. More...
 

Detailed Description

Class to control vertex container and GPU with possibility of emulating old-style OpenGL 1.0 state machine using modern OpenGL methods.

Definition at line 53 of file vertex_manager.h.

Constructor & Destructor Documentation

◆ VERTEX_MANAGER()

VERTEX_MANAGER::VERTEX_MANAGER ( bool  aCached)
Parameters
aCachedsays 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 42 of file vertex_manager.cpp.

42 :
43 m_noTransform( true ),
44 m_transform( 1.0f ),
45 m_reserved( nullptr ),
47{
50
51 // There is no shader used by default
52 for( unsigned int i = 0; i < SHADER_STRIDE; ++i )
53 m_shader[i] = 0.0f;
54}
static GPU_MANAGER * MakeManager(VERTEX_CONTAINER *aContainer)
Definition: gpu_manager.cpp:48
static VERTEX_CONTAINER * MakeContainer(bool aCached)
Return a pointer to a new container of an appropriate type.
bool m_noTransform
State machine variables True in case there is no need to transform vertices.
glm::mat4 m_transform
Currently used transform matrix.
unsigned int m_reservedSpace
Currently available reserved space.
VERTEX * m_reserved
Currently reserved chunk to store vertices.
GLfloat m_shader[SHADER_STRIDE]
Currently used shader and its parameters.
std::shared_ptr< GPU_MANAGER > m_gpu
GPU manager for data transfers and drawing operations.
std::shared_ptr< VERTEX_CONTAINER > m_container
Container for vertices, may be cached or noncached.
static constexpr size_t SHADER_STRIDE
Definition: vertex_common.h:81

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

Member Function Documentation

◆ BeginDrawing()

void VERTEX_MANAGER::BeginDrawing ( ) const

Prepare buffers and items to start drawing.

Definition at line 243 of file vertex_manager.cpp.

244{
245 m_gpu->BeginDrawing();
246}

References m_gpu.

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

◆ ChangeItemColor()

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

Change the color of all vertices owned by an item.

Parameters
aItemis the item to change.
aColoris the new color to be applied.

Definition at line 185 of file vertex_manager.cpp.

186{
187 unsigned int size = aItem.GetSize();
188 unsigned int offset = aItem.GetOffset();
189
190 VERTEX* vertex = m_container->GetVertices( offset );
191
192 for( unsigned int i = 0; i < size; ++i )
193 {
194 vertex->r = aColor.r * 255.0;
195 vertex->g = aColor.g * 255.0;
196 vertex->b = aColor.b * 255.0;
197 vertex->a = aColor.a * 255.0;
198 vertex++;
199 }
200
201 m_container->SetDirty();
202}
double r
Red component.
Definition: color4d.h:384
double g
Green component.
Definition: color4d.h:385
double a
Alpha component.
Definition: color4d.h:387
double b
Blue component.
Definition: color4d.h:386
unsigned int GetOffset() const
Return data offset in the container.
Definition: vertex_item.h:68
unsigned int GetSize() const
Return information about number of vertices stored.
Definition: vertex_item.h:58

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

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

◆ ChangeItemDepth()

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

Change the depth of all vertices owned by an item.

Parameters
aItemis the item to change.
aDepthis the new color to be applied.

Definition at line 205 of file vertex_manager.cpp.

206{
207 unsigned int size = aItem.GetSize();
208 unsigned int offset = aItem.GetOffset();
209
210 VERTEX* vertex = m_container->GetVertices( offset );
211
212 for( unsigned int i = 0; i < size; ++i )
213 {
214 vertex->z = aDepth;
215 vertex++;
216 }
217
218 m_container->SetDirty();
219}

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

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

◆ Clear()

void VERTEX_MANAGER::Clear ( ) const

Remove all the stored vertices from the container.

Definition at line 237 of file vertex_manager.cpp.

238{
239 m_container->Clear();
240}

References m_container.

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

◆ Color() [1/2]

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

◆ Color() [2/2]

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

Change currently used color that will be applied to newly added vertices.

It is the equivalent of glColor4f() function.

Parameters
aRedis the red component of the new color.
aGreenis the green component of the new color.
aBlueis the blue component of the new color.
aAlphais the alpha component of the new color.

Definition at line 158 of file vertex_manager.h.

159 {
160 m_color[0] = aRed * 255.0;
161 m_color[1] = aGreen * 255.0;
162 m_color[2] = aBlue * 255.0;
163 m_color[3] = aAlpha * 255.0;
164 }

References m_color.

◆ DrawItem()

void VERTEX_MANAGER::DrawItem ( const VERTEX_ITEM aItem) const

Draw an item to the buffer.

Parameters
aItemis the item to be drawn.

Definition at line 249 of file vertex_manager.cpp.

250{
251 m_gpu->DrawIndices( &aItem );
252}

References m_gpu.

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

◆ EnableDepthTest()

void VERTEX_MANAGER::EnableDepthTest ( bool  aEnabled)

Enable/disable Z buffer depth test.

Definition at line 295 of file vertex_manager.cpp.

296{
297 m_gpu->EnableDepthTest( aEnabled );
298}

References m_gpu.

Referenced by KIGFX::OPENGL_GAL::DrawGrid(), and KIGFX::OPENGL_GAL::EnableDepthTest().

◆ EndDrawing()

void VERTEX_MANAGER::EndDrawing ( ) const

Finish drawing operations.

Definition at line 255 of file vertex_manager.cpp.

256{
257 m_gpu->EndDrawing();
258}

References m_gpu.

Referenced by KIGFX::OPENGL_GAL::DrawGrid(), KIGFX::OPENGL_GAL::EndDiffLayer(), KIGFX::OPENGL_GAL::EndDrawing(), and KIGFX::OPENGL_GAL::StartDiffLayer().

◆ FinishItem()

void VERTEX_MANAGER::FinishItem ( ) const

Clean after adding an item.

Definition at line 171 of file vertex_manager.cpp.

172{
173 assert( m_reservedSpace == 0 && m_reserved == nullptr );
174
175 m_container->FinishItem();
176}

References m_container, m_reserved, and m_reservedSpace.

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

◆ FreeItem()

void VERTEX_MANAGER::FreeItem ( VERTEX_ITEM aItem) const

Free the memory occupied by the item, so it is no longer stored in the container.

Parameters
aItemis the item to be freed

Definition at line 179 of file vertex_manager.cpp.

180{
181 m_container->Delete( &aItem );
182}

References m_container.

Referenced by KIGFX::VERTEX_ITEM::~VERTEX_ITEM().

◆ GetTransformation()

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

Definition at line 311 of file vertex_manager.h.

312 {
313 return m_transform;
314 }

References m_transform.

Referenced by KIGFX::OPENGL_GAL::DrawBitmap(), and KIGFX::OPENGL_GAL::drawLineQuad().

◆ GetVertices()

VERTEX * VERTEX_MANAGER::GetVertices ( const VERTEX_ITEM aItem) const

Return a pointer to the vertices owned by an item.

Parameters
aItemis 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 222 of file vertex_manager.cpp.

223{
224 if( aItem.GetSize() == 0 )
225 return nullptr; // The item is not stored in the container
226
227 return m_container->GetVertices( aItem.GetOffset() );
228}

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

Referenced by KIGFX::VERTEX_ITEM::GetVertices().

◆ Map()

void VERTEX_MANAGER::Map ( )

Map vertex buffer.

Definition at line 57 of file vertex_manager.cpp.

58{
59 m_container->Map();
60}

References m_container.

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

◆ PopMatrix()

void KIGFX::VERTEX_MANAGER::PopMatrix ( )
inline

Pop the current transformation matrix stack.

It is the equivalent of the glPopMatrix() function.

Definition at line 252 of file vertex_manager.h.

253 {
254 wxASSERT( !m_transformStack.empty() );
255
257 m_transformStack.pop();
258
259 if( m_transformStack.empty() )
260 {
261 // We return back to the identity matrix, thus no vertex transformation is needed
262 m_noTransform = true;
263 }
264 }
std::stack< glm::mat4 > m_transformStack
Stack of transformation matrices, used for Push/PopMatrix.

References m_noTransform, m_transform, and m_transformStack.

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

◆ PushMatrix()

void KIGFX::VERTEX_MANAGER::PushMatrix ( )
inline

Push the current transformation matrix stack.

It is the equivalent of the glPushMatrix() function.

Definition at line 239 of file vertex_manager.h.

240 {
242
243 // Every transformation starts with PushMatrix
244 m_noTransform = false;
245 }

References m_noTransform, m_transform, and m_transformStack.

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

◆ putVertex()

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

Apply all transformation to the given coordinates and store them at the specified target.

Parameters
aTargetis the place where the new vertex is going to be stored (it has to be allocated first).
aXis the X coordinate of the new vertex.
aYis the Y coordinate of the new vertex.
aZis the Z coordinate of the new vertex.

Definition at line 261 of file vertex_manager.cpp.

262{
263 // Modify the vertex according to the currently used transformations
264 if( m_noTransform )
265 {
266 // Simply copy coordinates, when the transform matrix is the identity matrix
267 aTarget.x = aX;
268 aTarget.y = aY;
269 aTarget.z = aZ;
270 }
271 else
272 {
273 // Apply transformations
274 glm::vec4 transVertex( aX, aY, aZ, 1.0f );
275 transVertex = m_transform * transVertex;
276
277 aTarget.x = transVertex.x;
278 aTarget.y = transVertex.y;
279 aTarget.z = transVertex.z;
280 }
281
282 // Apply currently used color
283 aTarget.r = m_color[0];
284 aTarget.g = m_color[1];
285 aTarget.b = m_color[2];
286 aTarget.a = m_color[3];
287
288 // Apply currently used shader
289 for( unsigned int j = 0; j < SHADER_STRIDE; ++j )
290 {
291 aTarget.shader[j] = m_shader[j];
292 }
293}
GLfloat shader[4]
Definition: vertex_common.h:64

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 Vertex(), and Vertices().

◆ Reserve()

bool VERTEX_MANAGER::Reserve ( unsigned int  aSize)

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

Parameters
aSizeis the number of vertices that should be available in the reserved space.
Returns
True if successful, false otherwise.

Definition at line 69 of file vertex_manager.cpp.

70{
71 if( !aSize )
72 return true;
73
74 assert( m_reservedSpace == 0 && m_reserved == nullptr );
75
76 // flag to avoid hanging by calling DisplayError too many times:
77 static bool show_err = true;
78
79 m_reserved = m_container->Allocate( aSize );
80
81 if( m_reserved == nullptr )
82 {
83 if( show_err )
84 {
85 DisplayError( nullptr, wxT( "VERTEX_MANAGER::Reserve: Vertex allocation error" ) );
86 show_err = false;
87 }
88
89 return false;
90 }
91
92 m_reservedSpace = aSize;
93
94 return true;
95}
void DisplayError(wxWindow *aParent, const wxString &aText, int aDisplayTime)
Display an error or warning message box with aMessage.
Definition: confirm.cpp:280

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

Referenced by KIGFX::OPENGL_GAL::BitmapText(), KIGFX::OPENGL_GAL::DrawArc(), KIGFX::OPENGL_GAL::drawBitmapChar(), KIGFX::OPENGL_GAL::drawBitmapOverbar(), KIGFX::OPENGL_GAL::drawCircle(), KIGFX::OPENGL_GAL::drawFilledSemiCircle(), KIGFX::OPENGL_GAL::DrawGlyph(), KIGFX::OPENGL_GAL::DrawGlyphs(), KIGFX::OPENGL_GAL::DrawRectangle(), KIGFX::OPENGL_GAL::drawSegment(), KIGFX::OPENGL_GAL::drawSegmentChain(), KIGFX::OPENGL_GAL::drawStrokedSemiCircle(), KIGFX::OPENGL_GAL::drawTriangulatedPolyset(), and KIGFX::OPENGL_GAL::reserveLineQuads().

◆ Rotate()

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

Multiply 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
aAngleis the angle of rotation, in radians.
aXis a multiplier for the X axis
aYis a multiplier for the Y axis
aZis a multiplier for the Z axis.

Definition at line 214 of file vertex_manager.h.

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

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().

◆ Scale()

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

Multiply 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
aXis the X axis scaling factor.
aYis the Y axis scaling factor.
aZis the Z axis scaling factor.

Definition at line 229 of file vertex_manager.h.

230 {
231 m_transform = glm::scale( m_transform, glm::vec3( aX, aY, aZ ) );
232 }
const int scale

References m_transform, and scale.

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

◆ SetItem()

void VERTEX_MANAGER::SetItem ( VERTEX_ITEM aItem) const

Set an item to start its modifications.

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

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

Definition at line 165 of file vertex_manager.cpp.

166{
167 m_container->SetItem( &aItem );
168}

References m_container.

Referenced by KIGFX::VERTEX_ITEM::VERTEX_ITEM().

◆ SetShader()

void VERTEX_MANAGER::SetShader ( SHADER aShader) const

Set a shader program that is going to be used during rendering.

Parameters
aShaderis the object containing compiled and linked shader program.

Definition at line 231 of file vertex_manager.cpp.

232{
233 m_gpu->SetShader( aShader );
234}

References m_gpu.

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

◆ Shader()

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

Change 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
aShaderTypeis the a shader type to be applied.
aParam1is the optional parameter for a shader.
aParam2is the optional parameter for a shader.
aParam3is the optional parameter for a shader.

Definition at line 179 of file vertex_manager.h.

181 {
182 m_shader[0] = aShaderType;
183 m_shader[1] = aParam1;
184 m_shader[2] = aParam2;
185 m_shader[3] = aParam3;
186 }

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::DrawGlyph(), KIGFX::OPENGL_GAL::DrawGlyphs(), KIGFX::OPENGL_GAL::drawLineQuad(), KIGFX::OPENGL_GAL::drawPolygon(), KIGFX::OPENGL_GAL::DrawRectangle(), KIGFX::OPENGL_GAL::drawStrokedSemiCircle(), and KIGFX::OPENGL_GAL::drawTriangulatedPolyset().

◆ Translate()

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

Multiply 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
aXis the X coordinate of a translation vector.
aYis the X coordinate of a translation vector.
aZis the X coordinate of a translation vector.

Definition at line 198 of file vertex_manager.h.

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

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().

◆ Unmap()

void VERTEX_MANAGER::Unmap ( )

Unmap vertex buffer.

Definition at line 63 of file vertex_manager.cpp.

64{
65 m_container->Unmap();
66}

References m_container.

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

◆ Vertex() [1/3]

bool KIGFX::VERTEX_MANAGER::Vertex ( const VECTOR2D aXY,
GLfloat  aZ 
)
inline

Add a vertex with the given coordinates to the currently set item.

Vertex coordinates will have the current transformation matrix applied.

Parameters
aXYare the XY coordinates of the new vertex.
aZis the Z coordinate of the new vertex.
Returns
True if successful, false otherwise.

Definition at line 116 of file vertex_manager.h.

117 {
118 return Vertex( aXY.x, aXY.y, aZ );
119 }
bool Vertex(const VERTEX &aVertex)
Add a vertex with the given coordinates to the currently set item.

References Vertex(), VECTOR2< T >::x, and VECTOR2< T >::y.

◆ Vertex() [2/3]

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

Add 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
aVertexcontains vertex coordinates.
Returns
True if successful, false otherwise.

Definition at line 90 of file vertex_manager.h.

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

References Vertex(), 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::DrawGlyph(), KIGFX::OPENGL_GAL::DrawGlyphs(), KIGFX::OPENGL_GAL::drawLineQuad(), KIGFX::OPENGL_GAL::DrawRectangle(), KIGFX::OPENGL_GAL::drawStrokedSemiCircle(), KIGFX::OPENGL_GAL::drawTriangulatedPolyset(), Vertex(), and VertexCallback().

◆ Vertex() [3/3]

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

Add a vertex with the given coordinates to the currently set item.

Vertex coordinates will have the current transformation matrix applied.

Parameters
aXis the X coordinate of the new vertex.
aYis the Y coordinate of the new vertex.
aZis the Z coordinate of the new vertex.
Returns
True if successful, false otherwise.

Definition at line 98 of file vertex_manager.cpp.

99{
100 // flag to avoid hanging by calling DisplayError too many times:
101 static bool show_err = true;
102
103 // Obtain the pointer to the vertex in the currently used container
104 VERTEX* newVertex;
105
106 if( m_reservedSpace > 0 )
107 {
108 newVertex = m_reserved++;
110
111 if( m_reservedSpace == 0 )
112 m_reserved = nullptr;
113 }
114 else
115 {
116 newVertex = m_container->Allocate( 1 );
117
118 if( newVertex == nullptr )
119 {
120 if( show_err )
121 {
122 DisplayError( nullptr, wxT( "VERTEX_MANAGER::Vertex: Vertex allocation error" ) );
123 show_err = false;
124 }
125
126 return false;
127 }
128 }
129
130 putVertex( *newVertex, aX, aY, aZ );
131
132 return true;
133}
void putVertex(VERTEX &aTarget, GLfloat aX, GLfloat aY, GLfloat aZ) const
Apply all transformation to the given coordinates and store them at the specified target.

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

◆ Vertices()

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

Add 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
aVerticescontains vertices to be added.
aSizeis the number of vertices to be added.
Returns
True if successful, false otherwise.

Definition at line 136 of file vertex_manager.cpp.

137{
138 // flag to avoid hanging by calling DisplayError too many times:
139 static bool show_err = true;
140
141 // Obtain pointer to the vertex in currently used container
142 VERTEX* newVertex = m_container->Allocate( aSize );
143
144 if( newVertex == nullptr )
145 {
146 if( show_err )
147 {
148 DisplayError( nullptr, wxT( "VERTEX_MANAGER::Vertices: Vertex allocation error" ) );
149 show_err = false;
150 }
151
152 return false;
153 }
154
155 // Put vertices in already allocated memory chunk
156 for( unsigned int i = 0; i < aSize; ++i )
157 {
158 putVertex( newVertex[i], aVertices[i].x, aVertices[i].y, aVertices[i].z );
159 }
160
161 return true;
162}

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

Member Data Documentation

◆ m_color

GLubyte KIGFX::VERTEX_MANAGER::m_color[COLOR_STRIDE]
protected

Currently used color.

Definition at line 375 of file vertex_manager.h.

Referenced by Color(), and putVertex().

◆ m_container

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

Container for vertices, may be cached or noncached.

Definition at line 363 of file vertex_manager.h.

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

◆ m_gpu

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

GPU manager for data transfers and drawing operations.

Definition at line 365 of file vertex_manager.h.

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

◆ m_noTransform

bool KIGFX::VERTEX_MANAGER::m_noTransform
protected

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

Definition at line 369 of file vertex_manager.h.

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

◆ m_reserved

VERTEX* KIGFX::VERTEX_MANAGER::m_reserved
protected

Currently reserved chunk to store vertices.

Definition at line 380 of file vertex_manager.h.

Referenced by FinishItem(), Reserve(), and Vertex().

◆ m_reservedSpace

unsigned int KIGFX::VERTEX_MANAGER::m_reservedSpace
protected

Currently available reserved space.

Definition at line 383 of file vertex_manager.h.

Referenced by FinishItem(), Reserve(), and Vertex().

◆ m_shader

GLfloat KIGFX::VERTEX_MANAGER::m_shader[SHADER_STRIDE]
protected

Currently used shader and its parameters.

Definition at line 377 of file vertex_manager.h.

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

◆ m_transform

glm::mat4 KIGFX::VERTEX_MANAGER::m_transform
protected

Currently used transform matrix.

Definition at line 371 of file vertex_manager.h.

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

◆ m_transformStack

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

Stack of transformation matrices, used for Push/PopMatrix.

Definition at line 373 of file vertex_manager.h.

Referenced by PopMatrix(), and PushMatrix().


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