webgl2 方法解析: getUniformBlockIndex()

getUniformBlockIndex() 是 WebGL2 中的一个方法，用于获取统一变量块(Uniform Block)的索引位置。

功能描述

getUniformBlockIndex() 方法用于查询着色器程序中特定统一变量块的索引位置。统一变量块是 GLSL 中一组统一变量的集合，类似于 C 语言中的结构体。

方法签名

GLuint WebGL2RenderingContext.getUniformBlockIndex(program, uniformBlockName);

参数说明

• program: 包含统一变量块的 WebGL 程序对象
• uniformBlockName: 字符串，指定要查询的统一变量块的名称

返回值

• 返回指定统一变量块的索引值
• 如果指定的统一变量块不存在，则返回 WebGL2RenderingContext.INVALID_INDEX (即 0xFFFFFFFF)

使用示例

// 获取统一变量块索引
const uniformBlockIndex = gl.getUniformBlockIndex(program, "LightBlock");
​
if (uniformBlockIndex === gl.INVALID_INDEX) {
    console.error("统一变量块不存在");
} else {
    // 使用该索引进行后续操作，如绑定到绑定点
    gl.uniformBlockBinding(program, uniformBlockIndex, bindingPoint);
}

相关概念

• 统一变量块(Uniform Block) : GLSL 中的一种数据结构，用于组织多个相关的统一变量
• 统一缓冲区对象(UBO) : 存储统一变量块数据的缓冲区对象
• 绑定点(Binding Point) : 统一变量块与缓冲区对象之间的连接点

注意事项

0. 此方法仅在 WebGL2 中可用，WebGL1 不支持
1. 统一变量块名称必须与着色器代码中声明的完全匹配
2. 在使用前需要确保程序已成功链接