Uniform Buffer 上传的是字节。CPU 成员与 GLSL 变量同名、同类型,只能说明字段的含义相同,读取是否正确还取决于成员 offset、数组 stride 和矩阵 stride。最容易出错的是数组、三分量向量和嵌套结构。
OpenGL 中 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 偏移对齐限制。