GLES2.0中文API-glGetActiveAttrib

名称

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

glIsProgram

另见

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/.

Android,OpenGL ES,图形学