名称
glGetActiveAttrib - 激活纹理单元
C规范
void glGetActiveAttrib( GLuint program,
GLuint index,
GLsizei bufSize,
GLsizei *length,
GLint *size,
GLenum *type,
GLchar *name);
参数
program
指定要查询的程序对象。
index
指定要查询的属性变量的索引。
bufSize
指定允许OpenGL在由name指示的字符缓冲区中写入的最大字符数。
length
如果传递NULL以外的值,则返回由name指示的字符串中的OpenGL实际写入的字符数(不包括空终止符)。
size
返回属性变量的尺寸大小。
type
返回属性变量的数据类型。
name
返回包含属性变量名称的以null结尾的字符串。
描述
glGetActiveAttrib返回有关程序指定的program对象中的活动属性变量的信息。可以通过使用值GL_ACTIVE_ATTRIBUTES调用glGetProgramiv来获取活动属性的数量。索引的值为0将选择第一个活动属性变量。索引的允许值范围从0到活动属性变量数减1。
属性变量具有任意名称,并通过编号的通用顶点属性获取其值。如果在链接操作期间确定属性变量可以在程序执行期间被访问,则该属性变量被认为是活动的。因此,程序之前应该是调用glLinkProgram的目标,但它没有必要成功链接。
可以通过调用值为GL_ACTIVE_ATTRIBUTE_MAX_LENGTH的glGetProgramiv来获取在程序中存储最长属性变量名所需的字符缓冲区的大小。此值应用于分配足够大小的缓冲区来存储返回的属性名称。该字符缓冲区的大小在bufSize中传递,并且在该名称中传递指向该字符缓冲区的指针。
glGetActiveAttrib返回index指示的属性变量的名称,将其存储在name指定的字符缓冲区中。返回的字符串将以null结尾。写入此缓冲区的实际字符数以长度形式返回,并且此计数不包括空终止字符。如果不需要返回字符串的长度,则可以在length参数中传递NULL值。
type参数将返回指向属性变量数据类型的指针。可以返回符号常量GL_FLOAT,GL_FLOAT_VEC2,GL_FLOAT_VEC3,GL_FLOAT_VEC4,GL_FLOAT_MAT2,GL_FLOAT_MAT3或GL_FLOAT_MAT4。 size参数将返回属性的大小,以type中返回的类型为单位。
此函数将返回尽可能多的有关指定活动属性变量的信息。如果没有可用信息,则长度为0,name为空字符串。如果在失败的链接操作后调用此函数,则可能发生这种情况。如果发生错误,则返回值length,size,type和name将不会被修改。
错误
GL_INVALID_VALUE:program不是OpenGL生成的值
GL_INVALID_OPERATION:program不是程序对象
GL_INVALID_VALUE:index>=程序中活动属性变量的数量
GL_INVALID_VALUE:bufSize<0
相关Gets
glGet 参数GL_MAX_VERTEX_ATTRIBS
glGetProgramiv 参数GL_ACTIVE_ATTRIBUTES或GL_ACTIVE_ATTRIBUTE_MAX_LENGTH
另见
glBindAttribLocation,glGetActiveUniform,glLinkProgram,glVertexAttrib,glVertexAttribPointer
版权
https://www.khronos.org/registry/OpenGL-Refpages/es2.0/xhtml/glGetActiveAttrib.xml
https://blog.csdn.net/flycatdeng
Copyright © 1991-2006 Silicon Graphics, Inc.本文档的许可是根据SGI Free Software B License.详见http://oss.sgi.com/projects/FreeB/.