WebGLRenderingContext：getUniformLocation() 方法

program

要查找指定 uniform 变量的 WebGLProgram。

name

指定要返回其位置的 uniform 变量名称的字符串。名称中不能有任何空格，并且您不能使用此函数获取以保留字符串 "gl_" 开头的任何 uniform 的位置，因为这些是 WebGL 层的内部内容。

可能的值对应于 getActiveUniform 返回的 uniform 名称；请参阅该函数以了解声明的 uniform 如何映射到 uniform 位置名称的详细信息。

此外，对于声明为数组的 uniform，以下名称也有效：

• 不带 [0] 后缀的 uniform 名称。例如，arrayUniform 返回的位置等效于 arrayUniform[0] 的位置。
• 使用整数索引的 uniform 名称。例如，arrayUniform[2] 返回的位置将直接指向 arrayUniform uniform 的第三个条目。

一个 WebGLUniformLocation 值，指示命名变量的位置（如果存在）。如果指定的变量不存在，则返回 null。

WebGLUniformLocation 是一个不透明值，用于唯一标识 uniform 变量在 GPU 内存中的位置。有了这个值，您可以调用其他 WebGL 方法来访问 uniform 变量的值。

可能会发生以下错误；要检查 getUniformLocation() 返回后的错误，请调用 getError()。

GL_INVALID_VALUE

program 参数不是 WebGL 生成的值或对象。

GL_INVALID_OPERATION

program 参数与 WebGL 生成的 GLSL 程序不对应，或者指定的程序尚未成功链接。

在此示例中，摘自文章 基本的二维 WebGL 动画示例 中的 animateScene() 方法，获取着色器程序中三个 uniform 的位置，然后设置每个 uniform 的值。

gl.useProgram(shaderProgram);

uScalingFactor = gl.getUniformLocation(shaderProgram, "uScalingFactor");
uGlobalColor = gl.getUniformLocation(shaderProgram, "uGlobalColor");
uRotationVector = gl.getUniformLocation(shaderProgram, "uRotationVector");

gl.uniform2fv(uScalingFactor, currentScale);
gl.uniform2fv(uRotationVector, currentRotation);
gl.uniform4fv(uGlobalColor, [0.1, 0.7, 0.2, 1.0]);

将当前着色器程序设置为 shaderProgram 后，此代码获取三个 uniform "uScalingFactor"、"uGlobalColor" 和 "uRotationVector"，每个 uniform 调用一次 getUniformLocation()。

然后设置三个 uniform 的值。

• uScalingFactor uniform（一个 2 分量顶点）接收来自变量 currentScale 的水平和垂直缩放因子。
• uRotationVector uniform 设置为变量 currentRotation 的内容。它也是一个 2 分量顶点。
• 最后，uGlobalColor uniform 设置为颜色 [0.1, 0.7, 0.2, 1.0]，此 4 分量向量中的分量分别表示红色、绿色、蓝色和 alpha 的值。

完成此操作后，下次调用着色函数时，它们自己的名为 uScalingFactor、uGlobalColor 和 uRotationVector 的变量都将具有 JavaScript 代码提供的值。

• WebGLRenderingContext.getAttribLocation()
• WebGLRenderingContext.getActiveUniform()
• WebGLUniformLocation