GLES3.0中文API-glGetUniform

名称

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