Vertex Buffer Object - is a general storage object for vertex attributes (position, normal, color). Notice that you should use OpenGl_IndexBuffer specialization for array of indices. More...

#include <OpenGl_VertexBuffer.hxx>

Inheritance diagram for OpenGl_VertexBuffer:

[legend]

Public Member Functions
	OpenGl_VertexBuffer ()
	Create uninitialized VBO. More...

virtual	~OpenGl_VertexBuffer ()
	Destroy object. More...

virtual GLenum	GetTarget () const

bool	IsValid () const

GLuint	GetComponentsNb () const

GLsizei	GetElemsNb () const

GLenum	GetDataType () const

GLubyte *	GetDataOffset () const

virtual bool	Create (const Handle< OpenGl_Context > &theGlCtx)
	Creates VBO name (id) if not yet generated. Data should be initialized by another method. More...

virtual void	Release (OpenGl_Context *theGlCtx)
	Destroy object - will release GPU memory if any. More...

virtual void	Bind (const Handle< OpenGl_Context > &theGlCtx) const
	Bind this VBO. More...

virtual void	Unbind (const Handle< OpenGl_Context > &theGlCtx) const
	Unbind this VBO. More...

bool	Init (const Handle< OpenGl_Context > &theGlCtx, const GLuint theComponentsNb, const GLsizei theElemsNb, const GLfloat *theData)
	Notice that VBO will be unbound after this call. More...

bool	Init (const Handle< OpenGl_Context > &theGlCtx, const GLuint theComponentsNb, const GLsizei theElemsNb, const GLuint *theData)
	Notice that VBO will be unbound after this call. More...

bool	Init (const Handle< OpenGl_Context > &theGlCtx, const GLuint theComponentsNb, const GLsizei theElemsNb, const GLushort *theData)
	Notice that VBO will be unbound after this call. More...

bool	Init (const Handle< OpenGl_Context > &theGlCtx, const GLuint theComponentsNb, const GLsizei theElemsNb, const GLubyte *theData)
	Notice that VBO will be unbound after this call. More...

bool	SubData (const Handle< OpenGl_Context > &theGlCtx, const GLsizei theElemFrom, const GLsizei theElemsNb, const GLfloat *theData)
	Notice that VBO will be unbound after this call. Function replaces portion of data within this VBO using glBufferSubData(). The VBO should be initialized before call. More...

bool	SubData (const Handle< OpenGl_Context > &theGlCtx, const GLsizei theElemFrom, const GLsizei theElemsNb, const GLuint *theData)
	Notice that VBO will be unbound after this call. Function replaces portion of data within this VBO using glBufferSubData(). The VBO should be initialized before call. More...

bool	SubData (const Handle< OpenGl_Context > &theGlCtx, const GLsizei theElemFrom, const GLsizei theElemsNb, const GLushort *theData)
	Notice that VBO will be unbound after this call. Function replaces portion of data within this VBO using glBufferSubData(). The VBO should be initialized before call. More...

bool	SubData (const Handle< OpenGl_Context > &theGlCtx, const GLsizei theElemFrom, const GLsizei theElemsNb, const GLubyte *theData)
	Notice that VBO will be unbound after this call. Function replaces portion of data within this VBO using glBufferSubData(). The VBO should be initialized before call. More...

void	BindVertexAttrib (const Handle< OpenGl_Context > &theGlCtx, const GLuint theAttribLoc) const
	Bind this VBO to active GLSL program. More...

void	UnbindVertexAttrib (const Handle< OpenGl_Context > &theGlCtx, const GLuint theAttribLoc) const
	Unbind any VBO from active GLSL program. More...

void	BindAttribute (const Handle< OpenGl_Context > &theCtx, const Graphic3d_TypeOfAttribute theMode) const
	Bind this VBO and enable specified attribute in OpenGl_Context::ActiveProgram() or FFP. More...

void	UnbindAttribute (const Handle< OpenGl_Context > &theCtx, const Graphic3d_TypeOfAttribute theMode) const
	Unbind this VBO and disable specified attribute in OpenGl_Context::ActiveProgram() or FFP. More...

Public Member Functions inherited from OpenGl_Resource
	OpenGl_Resource ()
	Empty constructor. More...

virtual	~OpenGl_Resource ()
	Destructor. Inheritors should call Clean (NULL) within it. More...

Public Member Functions inherited from Standard_Transient
	Standard_Transient ()
	Empty constructor. More...

	Standard_Transient (const Standard_Transient &)
	Copy constructor – does nothing. More...

Standard_Transient &	operator= (const Standard_Transient &)
	Assignment operator, needed to avoid copying reference counter. More...

virtual	~Standard_Transient ()
	Destructor must be virtual. More...

virtual void	Delete () const
	Memory deallocator for transient classes. More...

virtual const Handle_Standard_Type &	DynamicType () const
	Returns a type information object about this object. More...

Standard_Boolean	IsInstance (const Handle_Standard_Type &theType) const
	Returns a true value if this is an instance of Type. More...

Standard_Boolean	IsInstance (const Standard_CString theTypeName) const
	Returns a true value if this is an instance of TypeName. More...

Standard_Boolean	IsKind (const Handle_Standard_Type &theType) const
	Returns true if this is an instance of Type or an instance of any class that inherits from Type. Note that multiple inheritance is not supported by OCCT RTTI mechanism. More...

Standard_Boolean	IsKind (const Standard_CString theTypeName) const
	Returns true if this is an instance of TypeName or an instance of any class that inherits from TypeName. Note that multiple inheritance is not supported by OCCT RTTI mechanism. More...

virtual Handle_Standard_Transient	This () const
	Returns a Handle which references this object. Must never be called to objects created in stack. More...

Standard_Integer	GetRefCount () const
	Get the reference counter of this object. More...

Static Public Attributes
static const GLuint	NO_BUFFER = 0
	Helpful constants. More...

advanced methods
virtual bool	init (const Handle< OpenGl_Context > &theGlCtx, const GLuint theComponentsNb, const GLsizei theElemsNb, const void *theData, const GLenum theDataType, const GLsizei theStride)
	Initialize buffer with new data. More...

bool	init (const Handle< OpenGl_Context > &theGlCtx, const GLuint theComponentsNb, const GLsizei theElemsNb, const void *theData, const GLenum theDataType)
	Initialize buffer with new data. More...

virtual bool	subData (const Handle< OpenGl_Context > &theGlCtx, const GLsizei theElemFrom, const GLsizei theElemsNb, const void *theData, const GLenum theDataType)
	Update part of the buffer with new data. More...

static size_t	sizeOfGlType (const GLenum theType)

static void	bindAttribute (const Handle< OpenGl_Context > &theGlCtx, const Graphic3d_TypeOfAttribute theMode, const GLint theNbComp, const GLenum theDataType, const GLsizei theStride, const GLvoid *theOffset)
	Setup array pointer - either for active GLSL program OpenGl_Context::ActiveProgram() or for FFP using bindFixed() when no program bound. More...

static void	unbindAttribute (const Handle< OpenGl_Context > &theGlCtx, const Graphic3d_TypeOfAttribute theMode)
	Disable GLSL array pointer - either for active GLSL program OpenGl_Context::ActiveProgram() or for FFP using unbindFixed() when no program bound. More...

methods for interleaved attributes array
GLubyte *	myOffset
	offset to data More...

GLuint	myBufferId
	VBO name (index) More...

GLuint	myComponentsNb
	Number of components per generic vertex attribute, must be 1, 2, 3, or 4. More...

GLsizei	myElemsNb
	Number of vertex attributes / number of vertices. More...

GLenum	myDataType
	Data type (GL_FLOAT, GL_UNSIGNED_INT, GL_UNSIGNED_BYTE etc.) More...

virtual bool	HasColorAttribute () const

virtual bool	HasNormalAttribute () const

virtual void	BindAllAttributes (const Handle< OpenGl_Context > &theGlCtx) const
	Bind all vertex attributes to active program OpenGl_Context::ActiveProgram() or for FFP. Default implementation does nothing. More...

virtual void	BindPositionAttribute (const Handle< OpenGl_Context > &theGlCtx) const
	Bind vertex position attribute only. Default implementation does nothing. More...

virtual void	UnbindAllAttributes (const Handle< OpenGl_Context > &theGlCtx) const
	Unbind all vertex attributes. Default implementation does nothing. More...

Detailed Description

Vertex Buffer Object - is a general storage object for vertex attributes (position, normal, color). Notice that you should use OpenGl_IndexBuffer specialization for array of indices.

Constructor & Destructor Documentation

OpenGl_VertexBuffer::OpenGl_VertexBuffer ( )

Create uninitialized VBO.

virtual OpenGl_VertexBuffer::~OpenGl_VertexBuffer ( )

virtual

Destroy object.

Member Function Documentation

virtual void OpenGl_VertexBuffer::Bind ( const Handle< OpenGl_Context > & theGlCtx ) const

virtual

Bind this VBO.

Reimplemented in OpenGl_VertexBufferCompat.

virtual void OpenGl_VertexBuffer::BindAllAttributes ( const Handle< OpenGl_Context > & theGlCtx ) const

virtual

Bind all vertex attributes to active program OpenGl_Context::ActiveProgram() or for FFP. Default implementation does nothing.

void OpenGl_VertexBuffer::BindAttribute	(	const Handle< OpenGl_Context > &	theCtx,
		const Graphic3d_TypeOfAttribute	theMode
	)		const

inline

Bind this VBO and enable specified attribute in OpenGl_Context::ActiveProgram() or FFP.

Parameters

theGlCtx	- handle to bound GL context;
theMode	- array mode (GL_VERTEX_ARRAY, GL_NORMAL_ARRAY, GL_COLOR_ARRAY, GL_INDEX_ARRAY, GL_TEXTURE_COORD_ARRAY).

static void OpenGl_VertexBuffer::bindAttribute	(	const Handle< OpenGl_Context > &	theGlCtx,
		const Graphic3d_TypeOfAttribute	theMode,
		const GLint	theNbComp,
		const GLenum	theDataType,
		const GLsizei	theStride,
		const GLvoid *	theOffset
	)

static

Setup array pointer - either for active GLSL program OpenGl_Context::ActiveProgram() or for FFP using bindFixed() when no program bound.

virtual void OpenGl_VertexBuffer::BindPositionAttribute ( const Handle< OpenGl_Context > & theGlCtx ) const

virtual

Bind vertex position attribute only. Default implementation does nothing.

void OpenGl_VertexBuffer::BindVertexAttrib	(	const Handle< OpenGl_Context > &	theGlCtx,
		const GLuint	theAttribLoc
	)		const

Bind this VBO to active GLSL program.

virtual bool OpenGl_VertexBuffer::Create ( const Handle< OpenGl_Context > & theGlCtx )

virtual

Creates VBO name (id) if not yet generated. Data should be initialized by another method.

Reimplemented in OpenGl_TextureBufferArb, and OpenGl_VertexBufferCompat.

GLuint OpenGl_VertexBuffer::GetComponentsNb ( ) const

inline

Returns: the number of components per generic vertex attribute.

GLubyte* OpenGl_VertexBuffer::GetDataOffset ( ) const

inline

Returns: offset to data, NULL by default

GLenum OpenGl_VertexBuffer::GetDataType ( ) const

inline

Returns: data type of each component in the array.

GLsizei OpenGl_VertexBuffer::GetElemsNb ( ) const

inline

Returns: number of vertex attributes / number of vertices.

virtual GLenum OpenGl_VertexBuffer::GetTarget ( ) const

virtual

Reimplemented in OpenGl_TextureBufferArb, and OpenGl_IndexBuffer.

virtual bool OpenGl_VertexBuffer::HasColorAttribute ( ) const

virtual

Returns: true if buffer contains per-vertex color attribute

virtual bool OpenGl_VertexBuffer::HasNormalAttribute ( ) const

virtual

Returns: true if buffer contains per-vertex normal attribute

bool OpenGl_VertexBuffer::Init	(	const Handle< OpenGl_Context > &	theGlCtx,
		const GLuint	theComponentsNb,
		const GLsizei	theElemsNb,
		const GLfloat *	theData
	)

inline

Notice that VBO will be unbound after this call.

Parameters

theComponentsNb	- specifies the number of components per generic vertex attribute; must be 1, 2, 3, or 4;
theElemsNb	- elements count;
theData	- pointer to GLfloat data (vertices/normals etc.).

bool OpenGl_VertexBuffer::Init	(	const Handle< OpenGl_Context > &	theGlCtx,
		const GLuint	theComponentsNb,
		const GLsizei	theElemsNb,
		const GLuint *	theData
	)

inline

Notice that VBO will be unbound after this call.

Parameters

theComponentsNb	- specifies the number of components per generic vertex attribute; must be 1, 2, 3, or 4;
theElemsNb	- elements count;
theData	- pointer to GLuint data (indices etc.).

bool OpenGl_VertexBuffer::Init	(	const Handle< OpenGl_Context > &	theGlCtx,
		const GLuint	theComponentsNb,
		const GLsizei	theElemsNb,
		const GLushort *	theData
	)

inline

Notice that VBO will be unbound after this call.

Parameters

theComponentsNb	- specifies the number of components per generic vertex attribute; must be 1, 2, 3, or 4;
theElemsNb	- elements count;
theData	- pointer to GLushort data (indices etc.).

bool OpenGl_VertexBuffer::Init	(	const Handle< OpenGl_Context > &	theGlCtx,
		const GLuint	theComponentsNb,
		const GLsizei	theElemsNb,
		const GLubyte *	theData
	)

inline

Notice that VBO will be unbound after this call.

Parameters

theComponentsNb	- specifies the number of components per generic vertex attribute; must be 1, 2, 3, or 4;
theElemsNb	- elements count;
theData	- pointer to GLubyte data (indices/colors etc.).

virtual bool OpenGl_VertexBuffer::init	(	const Handle< OpenGl_Context > &	theGlCtx,
		const GLuint	theComponentsNb,
		const GLsizei	theElemsNb,
		const void *	theData,
		const GLenum	theDataType,
		const GLsizei	theStride
	)

virtual

Initialize buffer with new data.

Reimplemented in OpenGl_VertexBufferCompat.

bool OpenGl_VertexBuffer::init	(	const Handle< OpenGl_Context > &	theGlCtx,
		const GLuint	theComponentsNb,
		const GLsizei	theElemsNb,
		const void *	theData,
		const GLenum	theDataType
	)

inline

Initialize buffer with new data.

bool OpenGl_VertexBuffer::IsValid ( ) const

inline

Returns: true if current object was initialized

virtual void OpenGl_VertexBuffer::Release ( OpenGl_Context * theGlCtx )

virtual

Destroy object - will release GPU memory if any.

Implements OpenGl_Resource.

Reimplemented in OpenGl_TextureBufferArb, and OpenGl_VertexBufferCompat.

static size_t OpenGl_VertexBuffer::sizeOfGlType ( const GLenum theType )

inlinestatic

Returns: size of specified GL type

bool OpenGl_VertexBuffer::SubData	(	const Handle< OpenGl_Context > &	theGlCtx,
		const GLsizei	theElemFrom,
		const GLsizei	theElemsNb,
		const GLfloat *	theData
	)

inline

Notice that VBO will be unbound after this call. Function replaces portion of data within this VBO using glBufferSubData(). The VBO should be initialized before call.

Parameters

theElemFrom	- element id from which replace buffer data (>=0);
theElemsNb	- elements count (theElemFrom + theElemsNb <= GetElemsNb());
theData	- pointer to GLfloat data.

bool OpenGl_VertexBuffer::SubData	(	const Handle< OpenGl_Context > &	theGlCtx,
		const GLsizei	theElemFrom,
		const GLsizei	theElemsNb,
		const GLuint *	theData
	)

inline

Notice that VBO will be unbound after this call. Function replaces portion of data within this VBO using glBufferSubData(). The VBO should be initialized before call.

Parameters

theElemFrom	element id from which replace buffer data (>=0);
theElemsNb	elements count (theElemFrom + theElemsNb <= GetElemsNb());
theData	pointer to GLuint data.

bool OpenGl_VertexBuffer::SubData	(	const Handle< OpenGl_Context > &	theGlCtx,
		const GLsizei	theElemFrom,
		const GLsizei	theElemsNb,
		const GLushort *	theData
	)

inline

Notice that VBO will be unbound after this call. Function replaces portion of data within this VBO using glBufferSubData(). The VBO should be initialized before call.

Parameters

theElemFrom	element id from which replace buffer data (>=0);
theElemsNb	elements count (theElemFrom + theElemsNb <= GetElemsNb());
theData	pointer to GLushort data.

bool OpenGl_VertexBuffer::SubData	(	const Handle< OpenGl_Context > &	theGlCtx,
		const GLsizei	theElemFrom,
		const GLsizei	theElemsNb,
		const GLubyte *	theData
	)

inline

Notice that VBO will be unbound after this call. Function replaces portion of data within this VBO using glBufferSubData(). The VBO should be initialized before call.

Parameters

theElemFrom	element id from which replace buffer data (>=0);
theElemsNb	elements count (theElemFrom + theElemsNb <= GetElemsNb());
theData	pointer to GLubyte data.

virtual bool OpenGl_VertexBuffer::subData	(	const Handle< OpenGl_Context > &	theGlCtx,
		const GLsizei	theElemFrom,
		const GLsizei	theElemsNb,
		const void *	theData,
		const GLenum	theDataType
	)

virtual

Update part of the buffer with new data.

Reimplemented in OpenGl_VertexBufferCompat.

virtual void OpenGl_VertexBuffer::Unbind ( const Handle< OpenGl_Context > & theGlCtx ) const

virtual

Unbind this VBO.

Reimplemented in OpenGl_VertexBufferCompat.

virtual void OpenGl_VertexBuffer::UnbindAllAttributes ( const Handle< OpenGl_Context > & theGlCtx ) const

virtual

Unbind all vertex attributes. Default implementation does nothing.

void OpenGl_VertexBuffer::UnbindAttribute	(	const Handle< OpenGl_Context > &	theCtx,
		const Graphic3d_TypeOfAttribute	theMode
	)		const

inline

Unbind this VBO and disable specified attribute in OpenGl_Context::ActiveProgram() or FFP.

Parameters

theCtx	handle to bound GL context
theMode	array mode

static void OpenGl_VertexBuffer::unbindAttribute	(	const Handle< OpenGl_Context > &	theGlCtx,
		const Graphic3d_TypeOfAttribute	theMode
	)

static

Disable GLSL array pointer - either for active GLSL program OpenGl_Context::ActiveProgram() or for FFP using unbindFixed() when no program bound.

void OpenGl_VertexBuffer::UnbindVertexAttrib	(	const Handle< OpenGl_Context > &	theGlCtx,
		const GLuint	theAttribLoc
	)		const

Unbind any VBO from active GLSL program.

Field Documentation

GLuint OpenGl_VertexBuffer::myBufferId

protected

VBO name (index)

GLuint OpenGl_VertexBuffer::myComponentsNb

protected

Number of components per generic vertex attribute, must be 1, 2, 3, or 4.

GLenum OpenGl_VertexBuffer::myDataType

protected

Data type (GL_FLOAT, GL_UNSIGNED_INT, GL_UNSIGNED_BYTE etc.)

GLsizei OpenGl_VertexBuffer::myElemsNb

protected

Number of vertex attributes / number of vertices.

GLubyte* OpenGl_VertexBuffer::myOffset

protected

offset to data

const GLuint OpenGl_VertexBuffer::NO_BUFFER = 0

static

Helpful constants.

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

OpenGl_VertexBuffer.hxx

OpenGl_VertexBuffer Class Reference

Public Member Functions

Static Public Attributes

advanced methods

methods for interleaved attributes array

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Field Documentation