大网数据广告活动
Web 标准与前端开发

WebGLRenderingContext.getUniform()

· 52CE 我爱测

WebGLWebGL API 的 `WebGLRenderingContext.getUniform()` 方法返回指定位置的全局变量的值。

WebGLWebGL API 的 WebGLRenderingContext.getUniform() 方法返回指定位置的全局变量的值。

语法

getUniform(program, location)

参数

  • program
    • : 包含全局变量的一个WebGLProgram。
  • location
    • : 包含要获取的全局变量位置的 WebGLUniformLocation 对象。

返回值

返回的类型取决于全局变量的类型:

<table class="standard-table"> <thead> <tr> <th scope="col">变量类型(着色器内)</th> <th scope="col">返回值类型</th> </tr> </thead> <tbody> <tr> <th colspan="2">在 WebGL 1 中支持的</th> </tr> <tr> <td><code>boolean</code></td> <td>GLBoolean</td> </tr> <tr> <td><code>int</code></td> <td>GLint</td> </tr> <tr> <td><code>float</code></td> <td>GLfloat</td> </tr> <tr> <td><code>vec2</code></td> <td>Float32Array (with 2 elements)</td> </tr> <tr> <td><code>ivec2</code></td> <td>Int32Array (with 2 elements)</td> </tr> <tr> <td><code>bvec2</code></td> <td> Array of GLBoolean (with 2 elements) </td> </tr> <tr> <td><code>vec3</code></td> <td>Float32Array (with 3 elements)</td> </tr> <tr> <td><code>ivec3</code></td> <td>Int32Array (with 3 elements)</td> </tr> <tr> <td><code>bvec3</code></td> <td> Array of GLBoolean (with 3 elements) </td> </tr> <tr> <td><code>vec4</code></td> <td>Float32Array (with 4 elements)</td> </tr> <tr> <td><code>ivec4</code></td> <td>Int32Array (with 4 elements)</td> </tr> <tr> <td><code>bvec4</code></td> <td> Array of GLBoolean (with 4 elements) </td> </tr> <tr> <td><code>mat2</code></td> <td>Float32Array (with 4 elements)</td> </tr> <tr> <td><code>mat3</code></td> <td>Float32Array (with 9 elements)</td> </tr> <tr> <td><code>mat4</code></td> <td>Float32Array (with 16 elements)</td> </tr> <tr> <td><code>sampler2D</code></td> <td>GLint</td> </tr> <tr> <td><code>samplerCube</code></td> <td>GLint</td> </tr> <tr> <th colspan="2">在 WebGL 2 中新增支持的</th> </tr> <tr> <td><code>uint</code></td> <td>GLuint</td> </tr> <tr> <td><code>uvec2</code></td> <td>Uint32Array (with 2 elements)</td> </tr> <tr> <td><code>uvec3</code></td> <td>Uint32Array (with 3 elements)</td> </tr> <tr> <td><code>uvec4</code></td> <td>Uint32Array (with 4 elements)</td> </tr> <tr> <td><code>mat2x3</code></td> <td>Float32Array (with 6 elements)</td> </tr> <tr> <td><code>mat2x4</code></td> <td>Float32Array (with 8 elements)</td> </tr> <tr> <td><code>mat3x2</code></td> <td>Float32Array (with 6 elements)</td> </tr> <tr> <td><code>mat3x4</code></td> <td>Float32Array (with 12 elements)</td> </tr> <tr> <td><code>mat4x2</code></td> <td>Float32Array (with 8 elements)</td> </tr> <tr> <td><code>mat4x3</code></td> <td>Float32Array (with 12 elements)</td> </tr> <tr> <td>any sampler type</td> <td>GLint</td> </tr> </tbody> </table>

示例

var loc = gl.getUniformLocation(program, "u_foobar");
gl.getUniform(program, loc);

//code in vertex-shader
//...
//uniform mat4 uNormalMatrix;
//...
//gl.getUniform(program,gl.getUniformLocation(program,"uNormalMatrix"))
//>Float32Array(16) [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]

规范

浏览器兼容性

相关链接

  • WebGLUniformLocation
  • WebGLRenderingContext.getActiveUniform()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。