名称
glGetUniform - 返回统一变量的值
C规范
void glGetUniformfv( GLuint program,
GLint location,
GLfloat *params);
void glGetUniformiv( GLuint program,
GLint location,
GLint *params);
参数
program
指定要查询的程序对象。
location
指定要查询的统一变量的位置。
params
返回指定的统一变量的值。
描述
glGetUniform以params形式返回指定统一变量的值。由location指定的统一变量的类型确定返回的值的数量。如果将着色器变量在着色器中定义为boolean,int或float,则将返回单个值。如果将其定义为vec2,ivec2或bvec2,则将返回两个值。如果将其定义为vec3,ivec3或bvec3,则将返回三个值,依此类推。要查询存储在声明为数组的统一变量中的值,请为数组的每个元素调用glGetUniform。要查询存储在声明为结构的统一变量中的值,请为结构中的每个字段调用glGetUniform。声明为矩阵的统一变量的值将按列主要顺序返回。
在程序对象链接之前,不知道分配给统一变量的位置。发生链接后,命令glGetUniformLocation可用于获取统一变量的位置。然后可以将此位置值传递给glGetUniform,以查询统一变量的当前值。成功链接程序对象后,统一变量的索引值保持不变,直到发生下一个链接命令。如果链接成功,则只能在链接后查询统一变量值。
注意
如果生成错误,则不会更改params的内容。
错误
GL_INVALID_VALUE:program不是OpenGL生成的值。
GL_INVALID_OPERATION:program不是程序对象。
GL_INVALID_OPERATION:程序尚未成功链接。
GL_INVALID_OPERATION:location不对应于指定程序对象的有效统一变量位置。
相关Gets
glGetActiveUniform 参数program和活动统一变量的索引。
glGetProgramiv 参数GL_ACTIVE_UNIFORMS或GL_ACTIVE_UNIFORM_MAX_LENGTH。
glGetUniformLocation 参数program和统一变量的名称。
glIsProgram
另见
glCreateProgram,glLinkProgram,glUniform
版权
https://www.khronos.org/registry/OpenGL-Refpages/es3.0/html/glGetUniform.xhtml