企业官网建设流程全解析

第 8 章 命令与状态管理

本章定位：Vulkan 是「命令驱动」的 API。本章讲清 VSG 如何用Command/StateCommand/StateGroup把 Vulkan 的状态绑定（管线、描述符、顶点缓冲）优雅地挂到场景图上。

8.1 本章目标

• 理解vsg::Command与vsg::StateCommand的角色；
• 掌握vsg::StateGroup的「压栈/弹栈」语义；
• 认识常用的状态命令：BindGraphicsPipeline/BindDescriptorSet(s)/BindVertexBuffers等；
• 会用「底层路径」手动拼一个带状态的StateGroup（不依赖GraphicsPipelineConfigurator）。

8.2 前置准备

• 第 6 章（场景图节点）与第 7 章（几何体）已读；
• 了解 Vulkan 的vkCmdBindPipeline/vkCmdBindDescriptorSets基本概念。

8.3Command：可录制的原子操作

vsg::Command（Inherit<Object, Command>）是能被录进CommandBuffer的原子操作，关键两个方法：

• compile(Context&)：编译期准备 Vulkan 对象；
• record(CommandBuffer&)：录制期写出vkCmdXxx调用。

vsg::Commands是Command的容器（类似Group但专装命令，CPU 开销更低），用addChild(ref_ptr<Command>)添加子命令。常见命令：Draw/DrawIndexed/BindGraphicsPipeline/BindDescriptorSet(s)/BindVertexBuffers/BindIndexBuffer。

8.4StateCommand与状态栈

vsg::StateCommand（Inherit<Command, StateCommand>）是「带状态语义」的命令，多一个slot字段，用于在录制时按槽位（slot）组织状态栈：

• slot=0通常是BindGraphicsPipeline；
• slot=1通常是BindDescriptorSet(s)；
• 顶点/索引绑定命令也占用各自 slot。

状态栈的意义：进入StateGroup时把它的stateCommands压栈，遇到Command（如Draw）时应用栈顶状态；离开StateGroup时弹出。于是同一个管线/描述符只需声明一次，就能作用于整棵子树。

8.5StateGroup：状态与子图的结合点

StateGroup继承自Group，额外有：

• StateCommands stateCommands：本组要施加的状态命令列表；
• add(ref_ptr<StateCommand>)：追加一条状态命令；
• children：子图（继承自Group）。

auto stateGroup = vsg::StateGroup::create(); stateGroup->add(vsg::BindGraphicsPipeline::create(pipeline)); // slot 0 stateGroup->add(vsg::BindDescriptorSet::create( // slot 1 VK_PIPELINE_BIND_POINT_GRAPHICS, pipelineLayout, 0, descriptorSet)); stateGroup->addChild(geometry);

RecordTraversal碰到StateGroup时：先 push 所有stateCommands→ 遍历children（录制 Draw 时自动应用这些状态）→ 离开时 pop。

第 5 章里GraphicsPipelineConfigurator::copyTo(stateGroup)干的，正是上面的add(BindGraphicsPipeline)——只是它连PipelineLayout、顶点输入等一起塞好了。

8.6 常用状态命令一览

此外，所有GraphicsPipelineState子类（顶点输入、光栅化、混合、深度模板、多重采样等）也都是状态，会在管线创建时合并进GraphicsPipeline，而非运行时逐条vkCmd*。

8.7 底层路径示例：手动拼装带状态的 StateGroup

下面不使用GraphicsPipelineConfigurator，直接展示状态如何落地（管线pipeline与pipelineLayout的创建见第 9 章）：

// 假设已建好 pipeline / pipelineLayout / descriptorSet / geometry auto stateGroup = vsg::StateGroup::create(); // 状态 1：绑定图形管线 stateGroup->add(vsg::BindGraphicsPipeline::create(pipeline)); // 状态 2：绑定描述符集（uniform / 纹理） stateGroup->add(vsg::BindDescriptorSet::create( VK_PIPELINE_BIND_POINT_GRAPHICS, pipelineLayout, 0, // firstSet descriptorSet)); // 子树：几何体（内部自动 BindVertexBuffers / BindIndexBuffer） stateGroup->addChild(geometry);

下面给出一个完整可运行的 C++ 示例，把「创建pipeline/pipelineLayout/descriptorSet」到「组装StateGroup与Geometry」串成一条完整流程（着色器编译与交换链等细节见第 9、10 章）：

#include <vsg/all.h> // 1. 创建 DescriptorSetLayout 与 PipelineLayout auto descriptorSetLayout = vsg::DescriptorSetLayout::create( vsg::DescriptorSetLayoutBindings{ {0, VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER, 1, VK_SHADER_STAGE_VERTEX_BIT, nullptr} // binding 0：uniform 缓冲 }); auto pipelineLayout = vsg::PipelineLayout::create( vsg::DescriptorSetLayouts{descriptorSetLayout}); // set 0 使用上面的布局 // 2. 创建 DescriptorSet 并绑定 uniform 缓冲 auto descriptorSet = vsg::DescriptorSet::create( descriptorSetLayout, vsg::Descriptors{vsg::DescriptorBuffer::create( uniformBuffer, 0, VK_WHOLE_SIZE)}); // 绑定到 binding 0 // 3. 创建 GraphicsPipeline（着色器见第 9 章） auto shaderSet = vsg::ShaderSet::create(vsg::paths::shaders()); shaderSet->add(vsg::ShaderStage::create(VK_SHADER_STAGE_VERTEX_BIT, "main", "shaders/vert.vert")); shaderSet->add(vsg::ShaderStage::create(VK_SHADER_STAGE_FRAGMENT_BIT, "main", "shaders/frag.frag")); auto pipeline = vsg::GraphicsPipeline::create( vsg::GraphicsPipelineStates{ vsg::VertexInputState::create(), vsg::InputAssemblyState::create(), vsg::RasterizationState::create(), vsg::ColorBlendState::create(), vsg::DepthStencilState::create()}, shaderSet, pipelineLayout); // 4. 创建 Geometry（内部自动生成 BindVertexBuffers / BindIndexBuffer） auto geometry = vsg::Geometry::create(); geometry->arrays.push_back(vsg::vec3Array::create(vertices)); // 顶点坐标 geometry->arrays.push_back(vsg::vec3Array::create(normals)); // 法线 geometry->indices = vsg::uintArray::create(indices); // 索引 // 5. 组装 StateGroup：把状态命令挂到场景图上 auto stateGroup = vsg::StateGroup::create(); stateGroup->add(vsg::BindGraphicsPipeline::create(pipeline)); // slot 0：绑定管线 stateGroup->add(vsg::BindDescriptorSet::create( // slot 1：绑定描述符集 VK_PIPELINE_BIND_POINT_GRAPHICS, pipelineLayout, 0, descriptorSet)); stateGroup->addChild(geometry); // 子树：几何体 // 6. 挂到场景根节点，交给 RecordTraversal 录制 auto scene = vsg::Group::create(); scene->addChild(stateGroup);

对比「便捷路径」（第 5 章）：

auto pipelineConfig = vsg::GraphicsPipelineConfigurator::create(shaderSet); pipelineConfig->enableArray("inPosition", VK_VERTEX_INPUT_RATE_VERTEX, sizeof(vsg::vec3), VK_FORMAT_R32G32B32_SFLOAT); pipelineConfig->init(); pipelineConfig->copyTo(stateGroup); // 等价于上面的 add(BindGraphicsPipeline) + 设置 pipelineStates stateGroup->addChild(geometry);

两条路径最终效果一致；便捷路径适合常规网格，底层路径适合需要精细控制管线状态的场景。

8.8 常见问题

8.9 小结

• Command是可录制的原子操作；StateCommand带slot，组织成状态栈；
• StateGroup的stateCommands对子树「压栈—录制—弹栈」，是场景图与 Vulkan 状态的桥梁；
• 常用状态命令：BindGraphicsPipeline(slot0)、BindDescriptorSet(s)(slot1)、BindVertexBuffers/IndexBuffer（多由Geometry自动生成）；
• 便捷路径（GraphicsPipelineConfigurator::copyTo）与底层路径最终等价。

8.10 延伸阅读与下一章预告

• 第 9 章《着色器与管线》：如何真正创建pipeline/pipelineLayout/ShaderModule；
• 第 10 章《描述符与资源绑定》：descriptorSet从哪来、BindDescriptorSet怎么填；
• 第 12 章《RenderGraph 与 CommandGraph》：这些Command最终如何被录进CommandBuffer。