Vulkan Descriptor 把 shader 要访问的逻辑槽位连接到具体缓冲区、图像视图或采样器。设计时把绑定接口和每次绘制实际使用的资源分开考虑,并按 GPU 完成时机管理集合与资源。
原引擎笔记的重构起点
原笔记从 OpenGL 中两个 shader 共享 view、projection 和 worldTime 的例子出发。旧结构由 shader 管理器准备集合布局、渲染过程创建 Pipeline Layout、Renderer 在帧内获取并更新集合。接口定义和帧资源更新跨越几个位置,容易只对上其中一层。可以把调用顺序明确为「声明布局 → 预留 pool 容量 → 分配和写入 set → 按帧绑定」。

原笔记中的 layout 使用图。图形管线创建时先确定可绑定的资源接口。

原笔记的描述符示意。集合布局声明槽位,分配后的集合将槽位指向具体 Buffer、Image View 或 Sampler。
| Vulkan 对象 | 要核对的数据 |
|---|---|
VkDescriptorSetLayout | binding 编号、descriptor type、count 和使用阶段 |
VkPipelineLayout | set 布局按编号排列,push constant 范围独立声明 |
VkDescriptorPool | 同时满足 maxSets 与每类描述符的容量 |
VkDescriptorSet | 由指定布局和 pool 分配。update 只填写具体资源信息 |
同一个 binding 怎样经过 GLSL 与 Vulkan
layout(std140, set = 0, binding = 0) uniform FrameBlock {
mat4 view;
mat4 projection;
} frameData;
layout(set = 1, binding = 0) uniform sampler2D materialTexture;以两个在途帧为例,set 0 对应一个 binding 为 0、类型为 VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER 的 layout。Pipeline Layout 的第 0 项使用这个 layout,第 1 项使用材质 layout。原笔记中 Builder 封装的是填充这些字段的过程。
VkDescriptorSetLayoutBinding cameraBinding{};
cameraBinding.binding = 0;
cameraBinding.descriptorType = VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER;
cameraBinding.descriptorCount = 1;
cameraBinding.stageFlags = VK_SHADER_STAGE_VERTEX_BIT;
VkDescriptorPoolSize cameraPoolSize{};
cameraPoolSize.type = VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER;
cameraPoolSize.descriptorCount = framesInFlight; // 每帧槽一份创建 pool 时还要设置足够的 maxSets。分配出每帧槽的 set 后,写入本帧 UBO 的 handle、offset、range。材质若也用这个 pool,另计 COMBINED_IMAGE_SAMPLER 类型的容量和集合数。
VkDescriptorBufferInfo cameraInfo{frameUniformBuffer, frameOffset, sizeof(FrameData)};
VkWriteDescriptorSet write{};
write.sType = VK_STRUCTURE_TYPE_WRITE_DESCRIPTOR_SET;
write.dstSet = frameSet;
write.dstBinding = 0;
write.descriptorCount = 1;
write.descriptorType = VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER;
write.pBufferInfo = &cameraInfo;
vkUpdateDescriptorSets(device, 1, &write, 0, nullptr);写入结构中引用的 cameraInfo 在 update 返回之前需要有效。frameUniformBuffer 和它指向的字节在 GPU 使用期间都要保持有效。只要 descriptor 指向的缓冲区和范围保持固定,帧内更新可以只更新缓冲内容。记录命令时调用 vkCmdBindDescriptorSets,用与当前管线兼容的 Pipeline Layout 和正确的 firstSet。
管理不同频率的资源
- 相机常量按帧槽更新。复用一个槽前,等保护该槽上一次 GPU 访问的 fence 或 timeline 值。
- 材质集合通常在多次绘制间复用。替换图片时,旧 view、sampler 和对应 set 的回收要等相关提交完成。
- 临时集合可从每帧池分配,等待帧完成后批量重置。没有设置允许单独释放的 pool flag 时,选择重置池或随池销毁。
- 对动态偏移 UBO,同时看基准 offset、动态 offset、有效 range 和设备对齐。若启用
UPDATE_AFTER_BIND,按对应 descriptor type、binding flag 和 pool flag 的规则操作。
调试时从 pipeline 的 set/binding 沿实际命令追到分配 layout、写入的 buffer 或 view 和帧槽归属。用 validation layer 找到非法绑定,再检查 UBO 的字节布局和 CPU 写入范围。
相关
- Uniform Buffer 的内存布局 校验 descriptor 指向的缓冲区内部字节布局。