GLES3.0中文API-glBindAttribLocation

名称

glBindAttribLocation - 将通用顶点属性索引与命名属性变量相关联

C规范

void glBindAttribLocation（GLuint program,

                                              GLuint index,

                                              const GLchar *name）;

参数

program

指定要在其中建立关联的程序对象的句柄。

index

指定要绑定的通用顶点属性的索引。

name

指定一个以空终止符结尾的字符串，其中包含要绑定索引的顶点着色器属性变量的名称。

描述

glBindAttribLocation用于将程序指定的程序对象中的用户定义属性变量与通用顶点属性索引相关联。用户定义的属性变量的名称作为名称中的空终止字符串传递。要绑定到此变量的通用顶点属性索引由index指定。当程序成为当前状态的一部分时，通过通用顶点属性索引提供的值将修改由name指定的用户定义属性变量的值。

如果name引用矩阵属性变量，则index引用矩阵的第一列。然后，对于mat2类型的矩阵，其他矩阵列自动绑定到位置index + 1; index + 1和index + 2表示mat3类型的矩阵;对于mat4类型的矩阵，index + 1，index + 2和index + 3。

此命令使顶点着色器可以使用属性变量的描述性名称，而不是编号为0到GL_MAX_VERTEX_ATTRIBS -1的泛型变量。发送到每个通用属性索引的值是当前状态的一部分，就像标准顶点属性（如颜色，法线和顶点位置）一样。如果通过调用glUseProgram使不同的程序对象成为当前的程序，则跟踪通用顶点属性，使得新程序对象中的属性也将观察到相同的值，这些属性也绑定到索引。

可以通过调用glBindAttribLocation随时显式分配程序对象的属性变量名称到通用属性索引绑定。在调用glLinkProgram之前，属性绑定不会生效。成功链接程序对象后，通用属性的索引值保持固定（并且可以查询它们的值），直到发生下一个链接命令。

不允许应用程序使用此命令绑定任何标准OpenGL顶点属性，因为它们在需要时自动绑定。在程序对象链接之后发生的任何属性绑定在下次链接程序对象之前不会生效。

注意

可以在任何顶点着色器对象绑定到指定程序对象之前调用glBindAttribLocation。也允许将通用属性索引绑定到从未在顶点着色器中使用的属性变量名称。

如果以前绑定了name，则该信息将丢失。因此，您不能将一个用户定义的属性变量绑定到多个索引，但您可以将多个用户定义的属性变量绑定到同一索引。

允许应用程序将多个用户定义的属性变量绑定到相同的通用顶点属性索引。这称为aliasing（别名），仅当可执行程序中只有一个别名属性处于活动状态时，或者如果没有通过着色器的路径消耗属于同一位置的一组属性的多个属性时，才允许使用别名。允许编译器和链接器假定没有进行别名，并且可以自由地使用仅在没有别名的情况下工作的优化。不需要OpenGL实现来进行错误检查以检测别名。由于无法绑定标准属性，因此无法使用常规属性对通用属性进行别名（通用属性0除外）。

调用glLinkProgram时，链接器将绑定未显式绑定的活动属性。可以通过调用glGetAttribLocation来查询分配的位置。

调用glBindAttribLocation时，OpenGL会复制名称字符串，因此应用程序可以在函数返回后立即释放其名称字符串的副本。

错误

GL_INVALID_VALUE：index>=GL_MAX_VERTEX_ATTRIBS

GL_INVALID_OPERATION：name以保留前缀“gl_”开头

GL_INVALID_VALUE：program不是OpenGL生成的值

GL_INVALID_OPERATION：program不是程序对象

相关Gets
glGet 参数GL_MAX_VERTEX_ATTRIBS

glGetActiveAttrib 参数program

glGetAttribLocation 参数program和name

glIsProgram

另见

glDisableVertexAttribArray，glEnableVertexAttribArray，glUseProgram，glVertexAttrib，glVertexAttribPointer

版权

https://www.khronos.org/registry/OpenGL-Refpages/es3.0/html/glBindAttribLocation.xhtml