Helper class that encapsulates vertex attribute functionality. More...

#include </home/chochlik/devel/oglplus/include/oglplus/vertex_attrib.hpp>

Inheritance diagram for oglplus::VertexAttribOps:

Public Member Functions
VertexAttribSlot	Location (void) const
	Returns the location of this vertex attribute in a program. More...

void	BindLocation (const ProgramOps &program, const String &identifier) const
	Bind the vertex attribute location. More...

void	Divisor (GLuint divisor) const
	Set the vertex attrib divisor. More...

Static Public Member Functions
static VertexAttribSlot	GetLocation (const ProgramOps &program, const String &identifier)
	Finds the vertex attribute location, throws on failure. More...

template<typename... ProgramOps_>
static VertexAttribSlot	GetCommonLocation (const GLchar *identifier, const ProgramOps &program, const ProgramOps_ &...programs)
	Returns vertex attr. location in multiple programs if it's consistent. More...

static bool	QueryLocation (const ProgramOps &program, const String &identifier, VertexAttribSlot &location)
	Queries the vertex attribute `location` in a program. More...

static _common_location_query	QueryCommonLocation (const String &identifier, VertexAttribSlot &location)
	Allows to query the vertex attribute `location` in multiple programs. More...

template<typename... ProgramOps_>
static bool	QueryCommonLocation (const GLchar *identifier, VertexAttribSlot &location, const ProgramOps &program, const ProgramOps_ &...programs)
	Queries the vertex attribute `location` in multiple programs. More...

Detailed Description

Helper class that encapsulates vertex attribute functionality.

Note: Do not use this class directly, use VertexAttrib instead.

See Also: VertexAttrib

Member Function Documentation

void oglplus::VertexAttribOps::BindLocation	(	const ProgramOps &	program,
		const String &	identifier
	)		const

Bind the vertex attribute location.

See Also: GetLocation; QueryLocation

Related OpenGL symbols:: glBindAttribLocation

References OGLPLUS_CHECK.

void oglplus::VertexAttribOps::Divisor ( GLuint divisor) const

Set the vertex attrib divisor.

Requires OpenGL 3.3.

Related OpenGL symbols:: glVertexAttribDivisor

References OGLPLUS_CHECK.

template<typename... ProgramOps_>

static VertexAttribSlot oglplus::VertexAttribOps::GetCommonLocation	(	const GLchar *	identifier,
		const ProgramOps &	program,
		const ProgramOps_ &...	programs
	)

static

Returns vertex attr. location in multiple programs if it's consistent.

Finds the location of the input vertex attribute specified by identifier in every program in programs. Throws Error if no such attribute exists or if it is not active in some of the programs or if the attribute has different locations in different programs. Otherwise returns the vertex attribute position.

   VertexArray vao;
   Buffer buf;
   Program prog1, prog2, prog3;
   // build the programs, load data into the buffer, ...
   vao.Bind();
   buffer.Bind(Buffer::Target::Array);
   try
   {
       VertexAttribArray attr(
           VertexAttribOps::GetCommonLocation(
               "Position",
               prog1,
               prog2,
               prog3
&          )
       );
       attr.Setup(n_per_vertex, DataType::Float);
       attr.Enable();
   }
   catch(Error& error)
   {
       // handle the error or bind the locations manually
   }

See Also: GetLocation; GetCommonLocation; QueryLocation; BindLocation

Related OpenGL symbols:: glGetAttribLocation

Examples:: oglplus/026_stencil_shadow.cpp, oglplus/030_cube_mapping.cpp, and oglplus/032_transitions.cpp.

static VertexAttribSlot oglplus::VertexAttribOps::GetLocation	(	const ProgramOps &	program,
		const String &	identifier
	)

static

Finds the vertex attribute location, throws on failure.

Finds the location of the input vertex attribute specified by identifier in a program. Throws if no such attribute exists or if it is not active. For a non-throwing version see QueryLocation().

See Also: GetCommonLocation; QueryLocation; BindLocation

Related OpenGL symbols:: glGetAttribLocation

VertexAttribSlot oglplus::VertexAttribOps::Location ( void ) const

Returns the location of this vertex attribute in a program.

See Also: GetLocation; GetCommonLocation; QueryLocation; BindLocation

Related OpenGL symbols:: glGetAttribLocation

static _common_location_query oglplus::VertexAttribOps::QueryCommonLocation	(	const String &	identifier,
		VertexAttribSlot &	location
	)

static

Allows to query the vertex attribute location in multiple programs.

This function returns a temporary object that allows to query the location of the specified identifier in several programs. The returned object has two functions called In and And which are equivalent and take a Program as the argument. Both these functions return in turn a new instance of the temporary which allows to check in another program, and so on. The temporary is also convertible to bool indicating whether a common location was found in all programs in the chain.

VertexArray vao;
Buffer buf;
Program prog1, prog2, prog3, prog4;
// build the programs, load data into the buffer, ...
vao.Bind();
buffer.Bind(Buffer::Target::Array);
VertexAttribSlot loc;
if(VertexAttribOps::QueryCommonLocation("Pos", loc)
.In(prog1).In(prog2).In(prog3).And(prog4)
)
{
    VertexAttribArray attr(location);
    attr.Setup(n_per_vertex, DataType::Float);
    attr.Enable();
}
else
{
    // handle the error or bind the locations manually
}

Note: Never store the resulting object in a named variable nor use it after the call to this overload of QueryCommonLocation has finished. Doing this causes undefined behavior.

See Also: GetLocation; GetCommonLocation; QueryLocation; BindLocation

Related OpenGL symbols:: glGetAttribLocation

template<typename... ProgramOps_>

static bool oglplus::VertexAttribOps::QueryCommonLocation	(	const GLchar *	identifier,
		VertexAttribSlot &	location,
		const ProgramOps &	program,
		const ProgramOps_ &...	programs
	)

static

Queries the vertex attribute location in multiple programs.

Finds the location of the input vertex attribute specified by identifier in every program in programs. Returns false if no such attribute exists or if it is not active in some of the programs or if the attribute has different locations in different programs. Otherwise stores the vertex attribute position in location and returns true.

See Also: GetLocation; GetCommonLocation; QueryLocation; BindLocation

Related OpenGL symbols:: glGetAttribLocation

static bool oglplus::VertexAttribOps::QueryLocation	(	const ProgramOps &	program,
		const String &	identifier,
		VertexAttribSlot &	location
	)

static

Queries the vertex attribute location in a program.

Finds the location of the input vertex attribute specified by identifier in a program. Returns false if no such attribute exists or if it is not active, otherwise stores the vertex attribute position in location and returns true. For a throwing version see GetLocation().

See Also: GetLocation; GetCommonLocation; QueryCommonLocation; BindLocation

Related OpenGL symbols:: glGetAttribLocation

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

/home/chochlik/devel/oglplus/include/oglplus/vertex_attrib.hpp

Public Member Functions

Static Public Member Functions

Detailed Description

Member Function Documentation