Pyglet下glVertexAttribPointer配置uint顶点属性无渲染效果的问题

异常现象 #

基于Pyglet实现四叉树LOD系统时，将四叉树叶子节点编码为无符号整数存入顶点缓冲区，计划在顶点着色器中解码这些整数完成节点坐标转换。当前配置下无任何渲染输出，将顶点属性绑定的类型参数从GL_UNSIGNED_INT改为GL_FLOAT后可得到符合预期的渲染结果，但缓冲区实际存储的是无符号整数编码，与着色器中声明的in uint输入类型不匹配。

根因定位 #

• 错误来自顶点属性绑定的API选择错误：针对顶点着色器中声明为整数类型的输入变量，不能使用通用浮点属性绑定接口glVertexAttribPointer
• glVertexAttribPointer的工作逻辑是：从缓冲区读取指定类型的数据，自动将其转换为32位浮点数，再传入顶点着色器。即使传入GL_UNSIGNED_INT作为类型参数，它也会将读取到的无符号整数值转换为对应大小的浮点数，无法匹配着色器中in uint的整数输入通道，造成属性读取失败
• 修改为GL_FLOAT后可渲染的现象属于歪打正着：此时函数会将缓冲区中的uint比特位直接解释为float值，再隐式转换为整数传入着色器，虽然能跑出结果，但数值解释逻辑完全错误，只是碰巧解码后的坐标落在了可视范围内

正确修复方案 #

• 缓冲区数据上传、绘制调用、着色器解码逻辑本身不存在问题，仅需替换属性绑定的接口即可
• 针对整数类型的顶点属性，必须使用专门的整数属性绑定接口glVertexAttribIPointer，该接口会将缓冲区的整数数据无转换地传入对应的整数属性通道
• 修正后的属性绑定代码：

# 移除原有glVertexAttribPointer调用，替换为以下配置
glEnableVertexAttribArray(0)
glVertexAttribIPointer(
    0,  # 属性索引，与着色器layout(location=0)对应
    1,  # 每个属性的分量数
    GL_UNSIGNED_INT,  # 缓冲区存储的原始数据类型
    0,  # 顶点数据间的步长
    0   # 缓冲区内的偏移量
)

注意OpenGL顶点属性绑定的规则：着色器中声明为int/uint类型的顶点输入，必须通过glVertexAttribIPointer绑定；声明为double类型的输入必须通过glVertexAttribLPointer绑定，混用glVertexAttribPointer会触发类型不匹配的未定义行为。

内容的提问来源于stack exchange，提问作者user13683975