Uniform Buffer 上传的是字节。CPU 成员与 GLSL 变量同名、同类型,只能说明字段的含义相同,读取是否正确还取决于成员 offset、数组 stride 和矩阵 stride。最容易出错的是数组、三分量向量和嵌套结构。

OpenGL 中 UBO 怎样被多个程序复用

UBO 共享数据示意

原笔记用缓冲区示意图说明,将 per-frame 的相机等变量组成 uniform block 后,可让多个程序读同一个缓冲区。

在 shader 里定义 uniform block。程序侧分配缓冲区并上传字节,然后将 程序中 uniform block 的索引 映射到 上下文中的 binding point。最后把缓冲区绑定到这个点。不同程序的 block index 可能不同,共用 binding point 和一致的块布局即可复用数据。

layout(std140) uniform CameraBlock {
    mat4 viewMatrix;
    mat4 projectionMatrix;
};
GLuint ubo;
glGenBuffers(1, &ubo);
glBindBuffer(GL_UNIFORM_BUFFER, ubo);
glBufferData(GL_UNIFORM_BUFFER, sizeof(cameraData), &cameraData, GL_DYNAMIC_DRAW);
 
GLuint blockIndex = glGetUniformBlockIndex(program, "CameraBlock");
if (blockIndex != GL_INVALID_INDEX) {
    glUniformBlockBinding(program, blockIndex, 0);
    glBindBufferBase(GL_UNIFORM_BUFFER, 0, ubo);
}

GLSL 支持 layout(std140, binding = 0) 时,可以在 shader 里指定 binding point。每帧数据更新可用 glBufferSubData、映射或分配环形缓冲区。后三者何时需要同步,取决于更新策略和 GPU 是否还在读取该区域。

原例逐字段计算 std140

按 32 位标量计算。先把当前 offset 向上对齐到成员的基础对齐,再按其实际存储量推进。数组和矩阵还要单独看 stride,结构体的对齐由成员的最大对齐向上补到至少 vec4 对齐,并在末尾满足结构体数组的步长要求。

成员类别常见 std140 规则
float、int、bool基础对齐 4 字节。GLSL bool 的缓冲存储也按 4 字节表示
vec2基础对齐 8 字节
vec3、vec4基础对齐 16 字节。vec3 的三个分量占 12 字节,后续成员的位置还要看其自身规则
标量或向量数组元素对齐向上补到至少 16 字节,所以 float[3] 步长为 16
默认列主矩阵按列向量数组布局,mat4 的四列各占一个 16 字节槽
layout(std140) uniform ExampleBlock {
    float value;       // offset 0
    vec3 vector;       // offset 16
    mat4 matrix;       // 列起点 32、48、64、80
    float values[3];   // 元素起点 96、112、128
    bool boolean;      // offset 144
    int integer;       // offset 148
};

下面是和这组 offset 对应的 CPU 表示。矩阵内容按 shader 所需的列主顺序填充。用独特的字段值上传,按 shader 中的字段逐个验证,能定位“前面几个值对、从数组开始全错”的 stride 问题。

#include <cstddef>
#include <cstdint>
 
struct alignas(16) FloatSlot {
    float value;
};
 
struct alignas(16) ExampleBlockStd140 {
    float value;
    alignas(16) float vector[3];
    alignas(16) float matrix[4][4];
    FloatSlot values[3];
    std::uint32_t boolean;
    std::int32_t integer;
};
 
static_assert(sizeof(FloatSlot) == 16);
static_assert(offsetof(ExampleBlockStd140, vector) == 16);
static_assert(offsetof(ExampleBlockStd140, matrix) == 32);
static_assert(offsetof(ExampleBlockStd140, values) == 96);
static_assert(offsetof(ExampleBlockStd140, boolean) == 144);
static_assert(offsetof(ExampleBlockStd140, integer) == 148);
static_assert(sizeof(ExampleBlockStd140) == 160);

shared、packed 与 Vulkan 布局

OpenGL 的 shared 允许实现选择布局,可在相同声明的块之间共享。packed 允许编译器移除未使用成员,应用需要针对链接后的程序反射。对 OpenGL 可通过反射取成员 offset、数组和矩阵 stride 以及矩阵排列。Vulkan 看 SPIR-V 的 Offset、ArrayStride、MatrixStride。在 Vulkan 的 UBO 上使用 std430 风格布局时,还要核对并启用 uniformBufferStandardLayout。

成员 offset 按块内布局计算。块作为缓冲的一个子范围绑定时,整个子范围的起点仍须符合 GL_UNIFORM_BUFFER_OFFSET_ALIGNMENT 或 Vulkan 的 UBO 偏移对齐限制。

参考

来源