《VulkanSceneGraph 1.1.16 源码深度解析》第二十五章 Mesh Shader 与间接绘制
25.0 先把规模和答案摆出来
第二十四章收尾时把镜头从「加速结构如何被构建并被 trace」移开,留下五个关于绘制侧的具体问题。本章逐一接住,先把答案的落点摆在这里,后面各节用源码把它撑开。
预告第一问:三个 mesh 函数指针对应哪些 Command 子类、record() 行号、帧期还是编译期?答案是三个帧期 Inherit<Command,...> 类:src/vsg/meshshaders/DrawMeshTasks.cpp:48 的 vkCmdDrawMeshTasksEXT 直收 groupCountX/Y/Z,src/vsg/meshshaders/DrawMeshTasksIndirect.cpp:77 的 vkCmdDrawMeshTasksIndirectEXT 先解引用 drawParameters->buffer,src/vsg/meshshaders/DrawMeshTasksIndirectCount.cpp:88 的 vkCmdDrawMeshTasksIndirectCountEXT 再多解一层 drawCount->buffer;三者走 Commands::compile / RecordTraversal 通用链,与第二十四章编译期 BuildAccelerationStructureCommand 不同源。25.3、25.4、25.6、25.16 展开。
预告第二问:VK_EXT_mesh_shader 与两个 EXT 结构是否只在补丁区定义而零启用、DeviceExtensions.cpp:44-47 有没有 supportsDeviceExtension 检查。答案是三者只由 include/vsg/vk/vulkan.h 的 #if VK_HEADER_VERSION < 231 补出,:45-47 三个 getProcAddr 无任何检查,与 :27-30、:50-79、:81 形成对照;feature 启用零命中,示例停在 DeviceFeatures.h:34 的 NV 注释。25.11、25.12、25.13 展开。
预告第三问:Mesh 是否引入第四条管线路径、是否复用第九章 viewID 分层与 setCurrentPipelineLayout?答案是没有;全库调用点仍三处(GraphicsPipeline.cpp:315、ComputePipeline.cpp:161、RayTracingPipeline.cpp:257),复用 BindGraphicsPipeline 与同一 Implementation;代价在 src/vsg/state/GraphicsPipeline.cpp:255 的 for (auto pipelineState : pipelineStates) 与 :257 的 pipelineState->apply,它把 VertexInputState / InputAssemblyState 一并送进 VkGraphicsPipelineCreateInfo,mesh 下不剔除。25.15 展开。
预告第四问:nodes/ 下 mesh / indirect 节点是否重写 read/write/compare、是否进 ObjectFactory、ResourceRequirements 是否统计参数缓冲?先纠命名:nodes/ 无 mesh 节点,命令分住 meshshaders/ 与 commands/;六命令全重写 read/write,src/vsg/io/ObjectFactory.cpp:257 起连着 add<vsg::Draw> / add<vsg::DrawIndirect> 注册,:321-323 另注册三个 mesh 类,全有 Visitor 桩,与第二十四章 RT 零注册相反;但 CollectResourceRequirements 对参数缓冲零统计,这半句与 RT 同源。25.1、25.8、25.16、25.17 展开。
预告第五问:maxMeshWorkGroupCount / maxMeshOutputVertices / maxMeshOutputPrimitives 是否只在 getProperties<T> 查询、drawCount / stride / maxDrawCount 有无越界防护。答案更彻底:第二十四章 RayTracingPipeline.cpp:171 还查了一次 RT 属性,VkPhysicalDeviceMeshShaderPropertiesEXT 的 getProperties<...>() 全库零调用;四个参数默认 0、无任何上界与对齐倍数校验。25.12、25.20 展开。
先给可复核的规模。include/vsg/commands/ 有 34 个头文件、1,685 行,src/vsg/commands/ 有 31 个实现文件、2,051 行;include/vsg/meshshaders/ 有 3 个头文件,src/vsg/meshshaders/ 有 3 个实现文件,六个文件合计 340 行。本章正面处理的 42 个文件行数逐个实测如下,角色列写的是本章具体取它的哪一段证据,不是「头文件 / 实现」这类复述:
| 文件 | 行数 | 本章角色 |
|---|---|---|
include/vsg/meshshaders/DrawMeshTasks.h | 39 | 三个 groupCount 默认值、无 compile 重载的帧期命令声明 |
include/vsg/meshshaders/DrawMeshTasksIndirect.h | 43 | drawParameters / drawCount / stride 三字段与三种构造 |
include/vsg/meshshaders/DrawMeshTasksIndirectCount.h | 42 | drawCount 是 BufferInfo 而非数量、maxDrawCount 上限 |
src/vsg/meshshaders/DrawMeshTasks.cpp | 49 | record():44-49 无空判调 vkCmdDrawMeshTasksEXT |
src/vsg/meshshaders/DrawMeshTasksIndirect.cpp | 78 | record():73-78、compile():65-71、read/write 截断 |
src/vsg/meshshaders/DrawMeshTasksIndirectCount.cpp | 89 | 双 BufferInfo 上传、record():84-89 六参顺序 |
include/vsg/commands/DrawIndirect.h | 44 | bufferInfo 命名、drawCount / stride 默认 0 |
include/vsg/commands/DrawIndexedIndirect.h | 44 | 与 DrawIndirect.h 逐字同型的字段布局 |
include/vsg/commands/DrawIndirectCommand.h | 51 | VkDrawIndirectCommand 的 POD 包装与 has_read_write |
include/vsg/commands/DrawIndexedIndirectCommand.h | 54 | vertexOffset 正确使用 int32_t 的 POD 包装 |
include/vsg/commands/Command.h | 33 | Inherit<Compilable, Command>、record() 纯虚 |
include/vsg/commands/Commands.h | 64 | Children 容器与 compile / record 双声明 |
src/vsg/commands/DrawIndirect.cpp | 100 | read():35-61 死代码、空指针、uint32_t 截断 |
src/vsg/commands/DrawIndexedIndirect.cpp | 100 | 与上一行逐字同型的第二处缺陷 |
src/vsg/commands/Commands.cpp | 66 | compile():52-58 / record():60-66 两条通用链 |
include/vsg/vk/DeviceExtensions.h | 70 | :47-49 三个 mesh 函数指针声明 |
src/vsg/vk/DeviceExtensions.cpp | 82 | :45-47 无条件取址、:27-30/50-81 有条件取址对照 |
include/vsg/vk/vulkan.h | 1231 | #if VK_HEADER_VERSION < 231 补丁区 :187-251 |
src/vsg/vk/Context.cpp | 599 | :406-588 上传链、#if 1 死代码、bufferInfosToCopy |
src/vsg/state/GraphicsPipeline.cpp | 326 | Implementation():226-268 无条件 apply 全部状态 |
include/vsg/vk/ResourceRequirements.h | 149 | :115-137 无绘制命令专用 apply 重载 |
src/vsg/vk/ResourceRequirements.cpp | 418 | :119-122 apply(Object) 只 traverse 的兜底 |
src/vsg/core/Visitor.cpp | 1156 | :953-961 三个 mesh apply 桩降级到 Command |
src/vsg/core/ConstVisitor.cpp | 1156 | :953-961 与 Visitor.cpp 对称的三个桩 |
src/vsg/io/ObjectFactory.cpp | 375 | :257-260/321-323 六个命令注册、:320 分节注释 |
include/vsg/all.h | 342 | :130-135 与 :340-342 两处物理分离的收录 |
src/vsg/app/CompileTraversal.cpp | 479 | :310-313 apply(Commands&) 通用编译分派 |
src/vsg/app/RecordTraversal.cpp | 704 | :531-545 帧期 Commands / Command 分派 |
include/vsg/nodes/Bin.h | 74 | :26-38 SortOrder / binNumber 收集后排序 |
include/vsg/nodes/DepthSorted.h | 53 | :31-43 把子图放进指定 bin 的 traverse |
真正决定本章结论的行比上表小得多:src/vsg/vk/DeviceExtensions.cpp:45-47 的裸 getProcAddr、三个 record() 的 vkCmdDrawMeshTasksEXT 系列、四处 readValue<uint32_t>、DrawIndirect 的 read()(src/vsg/commands/DrawIndirect.cpp:35-61)、reserve 与 bufferInfosToCopy(src/vsg/vk/Context.cpp:416-427)、CollectResourceRequirements 的 apply(const Object&)(src/vsg/vk/ResourceRequirements.cpp:119-122)、GraphicsPipeline 的 shaderStage->mask 与 pipelineStates(src/vsg/state/GraphicsPipeline.cpp:240-257),合计不到 400 行;其余是接口面。
25.0.1 本章的问题清单
按序回答:命名边界(25.1)、直接绘制基线(25.2)、Compilable 链上的编译/帧期分工(25.3)、三个 mesh record() 的未检查(25.4–25.6)、VkDeviceSize 截断(25.7)、DrawIndirect::read 死代码(25.8)、参数契约归属(25.9)、上传链死代码(25.10)、函数指针与扩展协商(25.11–25.13)、stage 位生成(25.14)、管线状态失效(25.15)、资源预估盲区(25.16)、注册分派(25.17)、CPU 侧盲区(25.18)、排序(25.19)、vkCmd* 矩阵(25.20)。
25.0.2 答案骨架
先把十条结论列在这里,读者可以带着结论去后面的源码里逐条核对。证据列写完整路径加行号,定性列区分「硬缺陷」与「设计取舍」,少数属于「接口边界」。
| # | 结论 | 主要证据 | 定性 |
|---|---|---|---|
| 1 | 三个 mesh 命令是标准帧期 Command,靠 Commands::compile / RecordTraversal::apply(const Command&) 通用链驱动;DrawMeshTasks 无 compile 重载,两个 Indirect 的 compile 只负责上传参数缓冲,与第二十四章编译期 BuildAccelerationStructureCommand 不同源 | src/vsg/commands/Commands.cpp:52-58、src/vsg/app/CompileTraversal.cpp:310-313、src/vsg/app/RecordTraversal.cpp:531-545、src/vsg/meshshaders/DrawMeshTasks.cpp:48 | 设计取舍 |
| 2 | 三个 mesh 函数指针无条件 getProcAddr,supportsDeviceExtension("VK_EXT_mesh_shader") 全库零命中;feature 结构零启用、properties 结构零查询,扩展协商、特性启用、函数取址三者彼此脱节 | src/vsg/vk/DeviceExtensions.cpp:45-47、include/vsg/vk/vulkan.h:191、include/vsg/vk/DeviceFeatures.h:34 | 硬缺陷 |
| 3 | Mesh 不引入第四条管线创建路径;setCurrentPipelineLayout 全库调用点仍为三处,GraphicsPipeline::Implementation 对所有 GraphicsPipelineStates 无条件 apply,mesh 下不自动剔除顶点输入与图元装配状态 | src/vsg/state/GraphicsPipeline.cpp:255-257、src/vsg/state/GraphicsPipeline.cpp:315、src/vsg/state/ComputePipeline.cpp:161、src/vsg/raytracing/RayTracingPipeline.cpp:257 | 设计取舍 |
| 4 | 六个命令全部重写 read/write、全部进 ObjectFactory、全部有 Visitor / ConstVisitor 的 apply 桩,与第二十四章 RT 类零注册相反;但 CollectResourceRequirements 对间接参数缓冲零统计,后半句与 RT 同源 | src/vsg/io/ObjectFactory.cpp:257-260、src/vsg/io/ObjectFactory.cpp:321-323、src/vsg/core/Visitor.cpp:953-961、src/vsg/vk/ResourceRequirements.cpp:119-122 | 接口边界 |
| 5 | VkPhysicalDeviceMeshShaderPropertiesEXT 的 getProperties<...>() 零调用,连第二十四章 RT 那一次属性查询都没有;groupCountX/Y/Z、drawCount、stride、maxDrawCount 全为 0 默认且无任何上界、对齐、倍数校验 | include/vsg/vk/PhysicalDevice.h:58-71、src/vsg/raytracing/RayTracingPipeline.cpp:171、include/vsg/meshshaders/DrawMeshTasks.h:33-35、include/vsg/commands/DrawIndirect.h:39-40 | 硬缺陷 |
| 6 | 三个 mesh record() 对 extensions 指针、drawParameters->buffer、drawCount->buffer 全无空判;扩展未启用或 compile 未跑时,帧期直接空指针调用或空指针解引用 | src/vsg/meshshaders/DrawMeshTasks.cpp:47-48、src/vsg/meshshaders/DrawMeshTasksIndirect.cpp:77、src/vsg/meshshaders/DrawMeshTasksIndirectCount.cpp:88 | 硬缺陷 |
| 7 | read/write 把 VkDeviceSize 型的 offset / range 按 readValue<uint32_t> / writeValue<uint32_t> 序列化,超过 4 GiB 的偏移与范围静默截断;DrawIndirect 的 read 入口 src/vsg/commands/DrawIndirect.cpp:35、写侧 src/vsg/commands/DrawIndirect.cpp:63 各留一处,mesh 与 commands 两侧共六处 | src/vsg/meshshaders/DrawMeshTasksIndirect.cpp:43-44、src/vsg/meshshaders/DrawMeshTasksIndirect.cpp:57-58、src/vsg/commands/DrawIndirect.cpp:35、src/vsg/commands/DrawIndirect.cpp:63 | 硬缺陷 |
| 8 | DrawIndirect::read 声明 ref_ptr<Buffer> buffer 却从不赋值,if (buffer) 恒假使 BufferInfo::create(buffer, offset, range) 成为死代码;默认构造下 bufferInfo 为空,readObject("buffer", bufferInfo->buffer) 先空指针解引用;精确行号见 25.8.3 的逐字摘录,DrawIndirect 的 read 入口在 src/vsg/commands/DrawIndirect.cpp:35 | src/vsg/commands/DrawIndirect.cpp:35 | 硬缺陷 |
| 9 | Context::createBufferAndTransferData 用 #if 1 / #else / #endif 把 :428-588 共 160 行旧上传实现变成死代码,末尾 src/vsg/vk/Context.cpp:588 的 #endif 之前还留着 copy(stagingBufferInfo, deviceBufferInfo) 与 stagingMemory->unmap();生效分支把 bufferInfoList 无条件 insert 进 bufferInfosToCopy,容器只增不减且每编译上下文重复追加 | src/vsg/vk/Context.cpp:416、src/vsg/vk/Context.cpp:419-420、src/vsg/vk/Context.cpp:428、src/vsg/vk/Context.cpp:588 | 硬缺陷 |
| 10 | stride 默认 0 且无最小值、4 字节倍数、上界校验;range = in_drawCount * in_stride 是两个 uint32_t 相乘后隐式提升为 VkDeviceSize,乘法本身已溢出;DrawIndexed::vertexOffset 声明 uint32_t 而 Vulkan 规范与 DrawIndexedIndirectCommand 用 int32_t | src/vsg/commands/DrawIndirect.cpp:29、include/vsg/commands/DrawIndirect.h:40、include/vsg/commands/DrawIndexed.h:48、include/vsg/commands/DrawIndexedIndirectCommand.h:27 | 硬缺陷 |
十条里第 2、5、6、7、8、9、10 条是硬缺陷,第 1、3 条是设计取舍,第 4 条是接口边界。按「命名 → 基线 → 命令 → 契约 → 缓冲 → 协商 → 编译 → 遍历」自底向上展开。
25.0.3 阅读路线
meshshaders/ 与 commands/ 清点 → Draw / DrawIndexed 基线 → Command / Commands 与两条驱动链 → 三个 mesh 命令 → read/write 截断 → DrawIndirect 对照 → 间接 POD → BufferInfo 与上传链 → DeviceExtensions → vulkan.h 补丁区 → DeviceFeatures → ShaderStage / ShaderSet → GraphicsPipeline → CollectResourceRequirements → ObjectFactory / Visitor → Intersector / ComputeBounds → Bin / DepthSorted → vkCmd* 矩阵。
25.1 命名边界澄清:meshshaders/ 与 commands/ 两处各放着什么
25.1.1 真实清点:六个命令类分住两个目录
find include src -iname '*mesh*' 的结果只有六个文件,全部落在 meshshaders/,没有一个落在 nodes/:
include/vsg/meshshaders/DrawMeshTasks.h
include/vsg/meshshaders/DrawMeshTasksIndirect.h
include/vsg/meshshaders/DrawMeshTasksIndirectCount.h
src/vsg/meshshaders/DrawMeshTasks.cpp
src/vsg/meshshaders/DrawMeshTasksIndirect.cpp
src/vsg/meshshaders/DrawMeshTasksIndirectCount.cpp
三个 mesh 头文件的公共形状可以从最短的一个看清:
// include/vsg/meshshaders/DrawMeshTasks.h:20-37
// DrawMeshTasks command encapsulates vkCmdDrawMeshTasksEXT call and associated parameters.
class VSG_DECLSPEC DrawMeshTasks : public Inherit<Command, DrawMeshTasks>
{
public:
DrawMeshTasks();
DrawMeshTasks(uint32_t in_groupCountX, uint32_t in_groupCountY, uint32_t in_groupCountZ);
void read(Input& input) override;
void write(Output& output) const override;
void record(CommandBuffer& commandBuffer) const override;
uint32_t groupCountX = 0;
uint32_t groupCountY = 0;
uint32_t groupCountZ = 0;
};
VSG_type_name(vsg::DrawMeshTasks);
DrawMeshTasksIndirect 的头文件与 DrawMeshTasksIndirectCount 的头文件在同一形状上多出 compile(Context&) override 与 ref_ptr<BufferInfo> 字段,前者一个 drawParameters,后者 drawParameters 与 drawCount 两个。头文件都 #include <vsg/state/BufferInfo.h>,唯独 DrawMeshTasks 的 include/vsg/meshshaders/DrawMeshTasks.h:15 只 #include <vsg/commands/Command.h>——纯帧期命令连缓冲类型都不需要,这是 25.3 判断它「无编译期动作」的第一处证据。
25.1.2 不存在的名字:grep 证据
$ grep -rIl '\bDrawMeshTasksIndirectCommand\b' include src
(无输出)
全库零命中。commands/ 里有 DrawIndirectCommand(include/vsg/commands/DrawIndirectCommand.h:22)与 DrawIndexedIndirectCommand(include/vsg/commands/DrawIndexedIndirectCommand.h:22)两个带 read/write 的 POD 结构体,meshshaders/ 里没有对应物。规范里那个 VkDrawMeshTasksIndirectCommandEXT 在 include/vsg/vk/vulkan.h:242-246 被手写成三个 uint32_t:
// include/vsg/vk/vulkan.h:242-246
typedef struct VkDrawMeshTasksIndirectCommandEXT {
uint32_t groupCountX;
uint32_t groupCountY;
uint32_t groupCountZ;
} VkDrawMeshTasksIndirectCommandEXT;
它收在 #if VK_HEADER_VERSION < 231 补丁区,只给旧 SDK 补类型;VSG 没有把它包装成 vsg::DrawMeshTasksIndirectCommand,没有 has_read_write 特化、没有 VSG_array 数组、没进 ObjectFactory。用户填参数缓冲只能自己按 groupCountX/Y/Z 的 12 字节布局写 Data。第二十四章处理 VkAccelerationStructureInstanceKHR 是「手写 struct 但不注册」,这里更退一步:连 VSG 侧 struct 都没有。
25.1.3 命令类全量行数表
绘制相关文件行数见 25.0 规模表,Command.h / Commands.h 是 25.3 的基类,两个 POD 头文件在 25.9 展开。
十个绘制类(四个直接、四个间接、两个 mesh 直接/间接再加一个 count)加两个基类容器共 18 个头、12 个实现。commands/ 目录整体 34 头 / 1,685 行、31 实现 / 2,051 行,绘制相关只占 297 头行与 292 实现行;meshshaders/ 340 行全部是本章主题。这个比例本身说明一件设计上的事:mesh 与间接绘制在 VSG 里是薄命令层,没有专用节点、没有专用遍历、没有专用资源预估,全部厚度压在「字段 + record() + 可选 compile()」三件事上。
25.2 Draw / DrawIndexed:第七章留下的两条基线
25.2.1 record() 内联在头文件,参数直接进 vkCmdDraw
// include/vsg/commands/Draw.h:39-47
void record(CommandBuffer& commandBuffer) const override
{
vkCmdDraw(commandBuffer, vertexCount, instanceCount, firstVertex, firstInstance);
}
uint32_t vertexCount = 0;
uint32_t instanceCount = 0;
uint32_t firstVertex = 0;
uint32_t firstInstance = 0;
// include/vsg/commands/DrawIndexed.h:40-49
void record(CommandBuffer& commandBuffer) const override
{
vkCmdDrawIndexed(commandBuffer, indexCount, instanceCount, firstIndex, vertexOffset, firstInstance);
}
uint32_t indexCount = 0;
uint32_t instanceCount = 0;
uint32_t firstIndex = 0;
uint32_t vertexOffset = 0;
uint32_t firstInstance = 0;
DrawIndexed.h:48 的 vertexOffset 声明为 uint32_t,而 vkCmdDrawIndexed 规范签名与 VkDrawIndexedIndirectCommand::vertexOffset 都是 int32_t(DrawIndexedIndirectCommand.h:27)。构造参数 DrawIndexed.h:28 倒是 int32_t in_vertexOffset,赋给 uint32_t 成员时负偏移被解释成接近 2³² 的大正数,record() 再传回期望 int32_t 的 Vulkan 函数,数值碰巧成立,但 read/write 按 uint32_t 序列化、compare 按无符号比较,语义已与规范分裂。POD 包装用对了 int32_t,命令类用错,是同一份规范被实现两遍且不一致的实证。
25.2.2 compare 用 compare_region 横跨连续成员
Draw.cpp / DrawIndexed.cpp 各自只做三件事:compare、read、write。
// src/vsg/commands/Draw.cpp:18-45
int Draw::compare(const Object& rhs_object) const
{
int result = Object::compare(rhs_object);
if (result != 0) return result;
const auto& rhs = static_cast<decltype(*this)>(rhs_object);
return compare_region(vertexCount, firstInstance, rhs.vertexCount);
}
void Draw::read(Input& input)
{
Command::read(input);
input.read("vertexCount", vertexCount);
input.read("instanceCount", instanceCount);
input.read("firstVertex", firstVertex);
input.read("firstInstance", firstInstance);
}
void Draw::write(Output& output) const
{
Command::write(output);
output.write("vertexCount", vertexCount);
output.write("instanceCount", instanceCount);
output.write("firstVertex", firstVertex);
output.write("firstInstance", firstInstance);
}
25.2.3 代价、边界与交叉引用
25.3 命令基类与两条驱动链:compile 与 record 各挂在哪
25.3.1 Command 继承 Compilable,默认 compile 是空函数
六个绘制命令的公共基类只有两处关键声明:
// include/vsg/commands/Command.h:15-31
#include <vsg/nodes/Compilable.h>
namespace vsg
{
class CommandBuffer;
/// Command base class for encapsulating vkCmd* calls and associated settings.
class VSG_DECLSPEC Command : public Inherit<Compilable, Command>
{
public:
Command() {}
Command(const Command& rhs, const CopyOp& copyop = {}) :
Inherit(rhs, copyop) {}
virtual void record(CommandBuffer& commandBuffer) const = 0;
};
VSG_type_name(vsg::Command);
} // namespace vsg
// include/vsg/nodes/Compilable.h:21-31
/// Base class for encapsulating nodes that have Vulkan objects associated with them that will need compiling during the compile traversal
class VSG_DECLSPEC Compilable : public Inherit<Node, Compilable>
{
public:
Compilable() {}
Compilable(const Compilable& rhs, const CopyOp& copyop = {}) :
Inherit(rhs, copyop) {}
virtual void compile(Context& /*context*/) {};
};
VSG_type_name(vsg::Compilable);
25.3.2 Commands::compile 与 Commands::record 两条对称循环
// include/vsg/commands/Commands.h:25-57
/// Commands is a command that acts as a container for other commands.
/// vsg::Commands is functionally equivalent to vsg::Group but is faster thanks to lower CPU overhead in applying
/// the state stack prior to vsg::Command calls.
class VSG_DECLSPEC Commands : public Inherit<Command, Commands>
{
public:
explicit Commands(size_t numChildren = 0);
template<class N, class V>
static void t_traverse(N& node, V& visitor)
{
for (auto& child : node.children) child->accept(visitor);
}
void traverse(Visitor& visitor) override { t_traverse(*this, visitor); }
void traverse(ConstVisitor& visitor) const override { t_traverse(*this, visitor); }
void traverse(RecordTraversal& visitor) const override { t_traverse(*this, visitor); }
int compare(const Object& rhs) const override;
void read(Input& input) override;
void write(Output& output) const override;
using Children = std::vector<ref_ptr<vsg::Command>>;
Children children;
void addChild(vsg::ref_ptr<Command> child)
{
children.push_back(child);
}
void compile(Context& context) override;
void record(CommandBuffer& commandBuffer) const override;
// src/vsg/commands/Commands.cpp:52-66
void Commands::compile(Context& context)
{
for (auto& command : children)
{
command->compile(context);
}
}
void Commands::record(CommandBuffer& commandBuffer) const
{
for (auto& command : children)
{
command->record(commandBuffer);
}
}
Commands 自身既是 Command(有 record)又是容器(Children 是 std::vector<ref_ptr<Command>>)。两个循环逐字对称:编译期 command->compile(context),帧期 command->record(commandBuffer),都不做类型判断、不做过滤、不检查返回值。compile 是虚函数分派,所以四个间接命令各自跳到自己的 compile() 上传缓冲,DrawMeshTasks 跳到空体;record 同理跳到各自的 record()。这解释了为什么 CompileTraversal 里没有 apply(const DrawMeshTasksIndirect&) 这类专用分派——命令的编译动作不靠访问者分派,靠容器循环里的虚调用。Commands.h:26-27 的注释还点出它比 Group 快的理由:录制前不必套一层状态栈。
25.3.3 两个挂点:CompileTraversal 与 RecordTraversal
// src/vsg/app/CompileTraversal.cpp:310-313
void CompileTraversal::apply(Commands& commands)
{
CPU_INSTRUMENTATION_L3_NC(instrumentation, "CompileTraversal Commands", COLOR_COMPILE);
for (auto& context : contexts)
{
commands.compile(*context);
}
}
// src/vsg/app/RecordTraversal.cpp:531-545
void RecordTraversal::apply(const Commands& commands)
{
GPU_INSTRUMENTATION_L3_NCO(instrumentation, *getCommandBuffer(), "Commands", COLOR_GPU, &commands);
state->record();
for (auto& command : commands.children)
{
command->record(*(state->_commandBuffer));
}
}
void RecordTraversal::apply(const Command& command)
{
GPU_INSTRUMENTATION_L3_NCO(instrumentation, *getCommandBuffer(), "Command", COLOR_GPU, &command);
//debug("Visiting Command");
state->record();
command.record(*(state->_commandBuffer));
}
编译侧的 for (auto& context : contexts) 有两层含义:每个 Context 代表一个设备 / 视图上下文(第九章 viewID 分层、第十二章多上下文编译),commands.compile(*context) 会被调用 N 次,N 等于 contexts.size();四个间接命令的 compile() 因此可能在一次编译遍历里重复执行,连到 25.10.3 的「bufferInfosToCopy 每上下文追加一次」。帧期侧 state->record() 先压第八章状态栈,再逐个子命令 record,mesh / 间接命令与前一条 BindGraphicsPipeline 共用同一份状态栈。
与第二十四章的对照可以钉在这里。Context 里放 RT 编译期命令的是另一个容器:
// include/vsg/vk/Context.h:130-132 / :153 / :155
std::vector<ref_ptr<Command>> commands;
BufferInfoList bufferInfosToCopy;
...
// RTX ray tracing
VkDeviceSize scratchBufferSize;
std::vector<ref_ptr<BuildAccelerationStructureCommand>> buildAccelerationStructureCommands;
bool createBufferAndTransferData(const BufferInfoList& bufferInfoList, VkBufferUsageFlags usage, VkSharingMode sharingMode);
commands(:130)是通用编译期命令队列,buildAccelerationStructureCommands(:153)是 RT 专用队列,两者并列但互不相干;bufferInfosToCopy(:132)是上传链的待拷列表。第二十四章 BuildAccelerationStructureCommand 进的是 :153、由 CompileManager 在编译期驱动;本章六个命令不进这两个容器里的任何一个,它们挂在场景图 Commands 节点的 children 上,由上面两条循环驱动。预告第一问「是否同源」的答案到此闭合:不同源,RT 是编译期旁路命令,mesh / 间接是标准帧期命令。
25.4 DrawMeshTasks:唯一没有 compile 的纯帧期 mesh 命令
25.4.1 构造与 read/write 只搬三个 uint32_t
// src/vsg/meshshaders/DrawMeshTasks.cpp:19-42
DrawMeshTasks::DrawMeshTasks()
{
}
DrawMeshTasks::DrawMeshTasks(uint32_t in_groupCountX, uint32_t in_groupCountY, uint32_t in_groupCountZ) :
groupCountX(in_groupCountX),
groupCountY(in_groupCountY),
groupCountZ(in_groupCountZ)
{
}
void DrawMeshTasks::read(Input& input)
{
input.read("groupCountX", groupCountX);
input.read("groupCountY", groupCountY);
input.read("groupCountZ", groupCountZ);
}
void DrawMeshTasks::write(Output& output) const
{
output.write("groupCountX", groupCountX);
output.write("groupCountY", groupCountY);
output.write("groupCountZ", groupCountZ);
}
默认构造是空体,三个成员靠类内初始化为 0(DrawMeshTasks.h:33-35);带参构造逐个赋值;read / write 严格对称,各三行,连 Command::read(input) / Command::write(output) 的基类调用都没有——对比 Draw.cpp:29 与 Draw.cpp:39 都先调 Command::read/write。这六个 mesh 家族的 read/write 全都不调基类(25.5、25.6、25.7 会看到同样写法),而 commands/ 侧的 Draw / DrawIndexed / DrawIndirect / DrawIndexedIndirect 全都调。第十八章序列化契约里基类调用负责读写对象公共键值,缺了它意味着 mesh 命令在带附加属性的流里少读一段;当前 Command 无自有字段(Compilable 一脉的 include/vsg/commands/Command.h:25 只有 Command() {}、:29 是纯虚 record),所以尚不致命,但这是两个目录各自为政的又一处实证。
25.4.2 record() 全文:三行,两个未检查的指针
// src/vsg/meshshaders/DrawMeshTasks.cpp:44-49
void DrawMeshTasks::record(vsg::CommandBuffer& commandBuffer) const
{
auto device = commandBuffer.getDevice();
auto extensions = device->getExtensions();
extensions->vkCmdDrawMeshTasksEXT(commandBuffer, groupCountX, groupCountY, groupCountZ);
}
逐分支推导:commandBuffer.getDevice()、device->getExtensions() 两行返回值都未判空,第三行直接 extensions->vkCmdDrawMeshTasksEXT(...),函数指针也未判空。vkCmdDrawMeshTasksEXT 默认值 nullptr(DeviceExtensions.h:47),只有 DeviceExtensions.cpp:45 的 getProcAddr 成功才赋值,而取址无条件、扩展启用无人检查(25.11)。触发条件具体:设备未启用 VK_EXT_mesh_shader 时指针保持 nullptr,任何一次 record 都是空函数指针调用、帧期崩溃,此前无日志无异常;groupCountX/Y/Z 是否为 0、是否超 maxMeshWorkGroupCount[3] 一律不查。参数对照 vulkan.h:248 四参逐字对应,commandBuffer 隐式转 VkCommandBuffer。
参数对照 include/vsg/vk/vulkan.h:248 的 PFN 声明:
// include/vsg/vk/vulkan.h:248
typedef void (VKAPI_PTR *PFN_vkCmdDrawMeshTasksEXT)(VkCommandBuffer commandBuffer, uint32_t groupCountX, uint32_t groupCountY, uint32_t groupCountZ);
25.4.3 代价、边界与交叉引用
DrawMeshTasks 的实现面是本章最小的:39 行头 + 49 行实现,compile 空、record 三行、构造平凡。代价全部在「不检查」上:扩展指针、设备指针、三个 groupCount 的合法范围,四道检查一道都没有。规避办法在调用方:构造前自己确认 device->supportsDeviceExtension("VK_EXT_mesh_shader")、自己把 VkPhysicalDeviceMeshShaderFeaturesEXT 挂进 DeviceFeatures、自己按 getProperties<VkPhysicalDeviceMeshShaderPropertiesEXT, ...>() 读回三个 maxMeshWorkGroupCount 分量做上界裁剪。框架一层都不代劳,这是 25.13 与 25.20 要展开的系统性缺口。
边界上还有一处:DrawMeshTasks 没有 compare 重写,Object::compare 只比类型名,两个 groupCount 不同的 DrawMeshTasks 在需要比较的场景(第十八章的对象去重、Commands::compare 的 compare_pointer_container)会被判为相等。第七章 Draw 至少用 compare_region 比了四个字段,这里连字段都不比。
25.5 DrawMeshTasksIndirect:单缓冲、三构造、compile 上传
25.5.1 三种构造与字段语义
// include/vsg/meshshaders/DrawMeshTasksIndirect.h:25-39
DrawMeshTasksIndirect();
DrawMeshTasksIndirect(ref_ptr<Data> data, uint32_t in_drawCount, uint32_t in_stride);
DrawMeshTasksIndirect(ref_ptr<Buffer> in_buffer, VkDeviceSize in_offset, uint32_t in_drawCount, uint32_t in_stride);
void read(Input& input) override;
void write(Output& output) const override;
void compile(Context& context) override;
void record(CommandBuffer& commandBuffer) const override;
ref_ptr<BufferInfo> drawParameters;
uint32_t drawCount = 0;
uint32_t stride = 0;
// src/vsg/meshshaders/DrawMeshTasksIndirect.cpp:18-35
DrawMeshTasksIndirect::DrawMeshTasksIndirect() :
drawParameters(BufferInfo::create())
{
}
DrawMeshTasksIndirect::DrawMeshTasksIndirect(ref_ptr<Data> data, uint32_t in_drawCount, uint32_t in_stride) :
drawParameters(BufferInfo::create(data)),
drawCount(in_drawCount),
stride(in_stride)
{
}
DrawMeshTasksIndirect::DrawMeshTasksIndirect(ref_ptr<Buffer> in_buffer, VkDeviceSize in_offset, uint32_t in_drawCount, uint32_t in_stride) :
drawParameters(BufferInfo::create(in_buffer, in_offset, in_drawCount * in_stride)),
drawCount(in_drawCount),
stride(in_stride)
{
}
三种构造对应三种数据来源,字段叫 drawParameters 而不是 commands/ 侧的 bufferInfo(include/vsg/commands/DrawIndirect.h:38)。默认构造主动创建了 BufferInfo::create(),这一点与 DrawIndirect.cpp:17-19 的空默认构造形成关键差异(25.7.3、25.8.3):mesh 版在 read() 里解引用 drawParameters->data 不会空指针,commands 版会。Data 构造把数据交给 BufferInfo,Buffer 构造直接给一个已有 VkBuffer 加 offset 与 range。
第三构造的 in_drawCount * in_stride 是本章第 6 处硬结论的落点:两个 uint32_t 在 32 位域内相乘后才隐式提升为 VkDeviceSize(include/vsg/state/BufferInfo.h:31 的 in_offset / in_range 形参),溢出发生在提升之前;range 被写成偏小值,compile() 按它分配后 GPU 按真实 drawCount × stride 读取即越界。同样表达式还在 DrawIndirect.cpp:29、DrawIndexedIndirect.cpp:29,是同一段代码复制三次。stride 默认 0(DrawMeshTasksIndirect.h:39),Vulkan 要求 4 的倍数且不小于对应 POD 尺寸(以本机 SDK 为准,25.12.4),框架无校验、无断言、无日志。
25.5.2 record() 与 vkCmdDrawMeshTasksIndirectEXT 五参
// src/vsg/meshshaders/DrawMeshTasksIndirect.cpp:73-78
void DrawMeshTasksIndirect::record(vsg::CommandBuffer& commandBuffer) const
{
auto device = commandBuffer.getDevice();
auto extensions = device->getExtensions();
extensions->vkCmdDrawMeshTasksIndirectEXT(commandBuffer, drawParameters->buffer->vk(commandBuffer.deviceID), drawParameters->offset, drawCount, stride);
}
对照补丁区声明:
// include/vsg/vk/vulkan.h:249
typedef void (VKAPI_PTR *PFN_vkCmdDrawMeshTasksIndirectEXT)(VkCommandBuffer commandBuffer, VkBuffer buffer, VkDeviceSize offset, uint32_t drawCount, uint32_t stride);
五个实参逐个对上:commandBuffer、drawParameters->buffer->vk(deviceID)、drawParameters->offset、drawCount、stride,与 vulkan.h:249 的 PFN 五参一一对应。相比 DrawMeshTasks.cpp:48 多了两级解引用 drawParameters->buffer->vk(...),却没有多任何一处空判:extensions、device、drawParameters、drawParameters->buffer 全未判空。触发条件比 25.4 更宽——除「扩展未启用」,还有「compile() 没跑」与「默认构造且没填 data / buffer」两种;默认构造给了 drawParameters 对象但其中 buffer 与 data 皆空,compile() 判据为假、什么也不做,record() 随即对空 buffer 调 vk(...)。drawParameters->offset 是 VkDeviceSize(BufferInfo.h:57),传给 VkDeviceSize offset 无损,问题出在序列化(25.7.1)。
25.5.3 compile():一次 createBufferAndTransferData
// src/vsg/meshshaders/DrawMeshTasksIndirect.cpp:65-71
void DrawMeshTasksIndirect::compile(Context& context)
{
if (!drawParameters->buffer && drawParameters->data)
{
createBufferAndTransferData(context, {drawParameters}, VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT, VK_SHARING_MODE_EXCLUSIVE);
}
}
VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT 是四个间接命令 compile() 的共同 usage,VK_SHARING_MODE_EXCLUSIVE 是共同 sharing mode。对比第五章 05-数据与资源.md 的顶点缓冲用 VK_BUFFER_USAGE_VERTEX_BUFFER_BIT | VK_BUFFER_USAGE_INDEX_BUFFER_BIT(BindVertexBuffers.cpp:102、Geometry.cpp:169),间接缓冲只带一个 bit,且 Context.cpp:410 的对齐计算只给 UNIFORM / STORAGE 取设备对齐,INDIRECT 落在 alignment = 4 的默认值上(25.10.4)。
25.6 DrawMeshTasksIndirectCount:两块 BufferInfo 与六参 record
25.6.1 字段语义:drawCount 是缓冲不是数量
// include/vsg/meshshaders/DrawMeshTasksIndirectCount.h:25-38
DrawMeshTasksIndirectCount();
DrawMeshTasksIndirectCount(ref_ptr<Data> in_bufferData, ref_ptr<Data> in_countBufferData, uint32_t in_maxDrawCount, uint32_t in_stride);
void read(Input& input) override;
void write(Output& output) const override;
void compile(Context& context) override;
void record(CommandBuffer& commandBuffer) const override;
ref_ptr<BufferInfo> drawParameters;
ref_ptr<BufferInfo> drawCount;
uint32_t maxDrawCount = 0;
uint32_t stride = 0;
// src/vsg/meshshaders/DrawMeshTasksIndirectCount.cpp:18-30
DrawMeshTasksIndirectCount::DrawMeshTasksIndirectCount() :
drawParameters(BufferInfo::create()),
drawCount(BufferInfo::create())
{
}
DrawMeshTasksIndirectCount::DrawMeshTasksIndirectCount(ref_ptr<Data> in_drawParametersData, ref_ptr<Data> in_countBufferData, uint32_t in_maxDrawCount, uint32_t in_stride) :
drawParameters(BufferInfo::create(in_drawParametersData)),
drawCount(BufferInfo::create(in_countBufferData)),
maxDrawCount(in_maxDrawCount),
stride(in_stride)
{
}
这个类最易误读的是字段名:drawCount 是 ref_ptr<BufferInfo>,装「本帧实际绘制次数」所在的计数缓冲;maxDrawCount 才是 uint32_t 上限。而 DrawIndirect.h:39 / DrawMeshTasksIndirect.h:38 的 drawCount 是 uint32_t 数量本身。同名不同义:键名一个是 "drawCount" 读进 uint32_t(DrawMeshTasksIndirect.cpp:47),一个是 "drawCount.data" / "drawCount.buffer" 读进 BufferInfo(DrawMeshTasksIndirectCount.cpp:42-47)。头文件构造形参 in_bufferData(:27)与实现 in_drawParametersData(.cpp:24)也不一致,是声明与定义各写一遍的手工痕迹。两块缓冲都要带 VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT,Vulkan 对 countBuffer 同样要求。
25.6.2 compile() 的 OR 触发:一个条件、两块缓冲
// src/vsg/meshshaders/DrawMeshTasksIndirectCount.cpp:76-82
void DrawMeshTasksIndirectCount::compile(Context& context)
{
if ((!drawParameters->buffer && drawParameters->data) || (!drawCount->buffer && drawCount->data))
{
createBufferAndTransferData(context, {drawParameters, drawCount}, VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT, VK_SHARING_MODE_EXCLUSIVE);
}
}
条件是两半的或:只要 drawParameters 或 drawCount 任一「有 data 无 buffer」,就把两块一起交给 createBufferAndTransferData。不对称在 25.10.3 展开:生效分支 Context.cpp:417 的 reserve 对整列表一视同仁,不区分「需新建」与「已有 buffer」。混合构造下(一块给现成 VkBuffer、另一块仍是 Data)已有缓冲那块被再次纳入分配与拷贝队列;requiresAllocation(BufferInfo.h:63-66)通常挡住重复分配,但 bufferInfosToCopy 的 insert(Context.cpp:420)不看该标志,两块都被追加,data 为空那块在 TransferTask 阶段无数据可拷。与 25.5.3 相同,返回值丢弃、无 else、无日志,maxDrawCount 与 stride 在 compile() 里完全不参与。
25.6.3 record() 六参与补丁区声明逐字对齐
// src/vsg/meshshaders/DrawMeshTasksIndirectCount.cpp:84-89
void DrawMeshTasksIndirectCount::record(vsg::CommandBuffer& commandBuffer) const
{
auto device = commandBuffer.getDevice();
auto extensions = device->getExtensions();
extensions->vkCmdDrawMeshTasksIndirectCountEXT(commandBuffer, drawParameters->buffer->vk(commandBuffer.deviceID), drawParameters->offset, drawCount->buffer->vk(commandBuffer.deviceID), drawCount->offset, maxDrawCount, stride);
}
// include/vsg/vk/vulkan.h:250
typedef void (VKAPI_PTR *PFN_vkCmdDrawMeshTasksIndirectCountEXT)(VkCommandBuffer commandBuffer, VkBuffer buffer, VkDeviceSize offset, VkBuffer countBuffer, VkDeviceSize countBufferOffset, uint32_t maxDrawCount, uint32_t stride);
七个形参对应七个实参(含 commandBuffer):buffer ← drawParameters->buffer->vk(deviceID),offset ← drawParameters->offset,countBuffer ← drawCount->buffer->vk(deviceID),countBufferOffset ← drawCount->offset,maxDrawCount ← maxDrawCount,stride ← stride。顺序与类型逐字对齐;drawCount->offset 被当作 countBufferOffset 用,把「BufferInfo 相对大缓冲的偏移」与「count 值在 countBuffer 内的偏移」混成一个量,用户把 count 写在非零偏移处时二者本需分别设置。空判方面与 25.4、25.5 同型且更密:extensions、device、两块 BufferInfo 及其 buffer 共六处可空对象一处未查;默认构造给了两个空 BufferInfo,compile() 的 OR 条件因两块都无 data 为假,record() 第一次解引用即崩。
25.7 read/write 契约:VkDeviceSize 被按 uint32_t 截断
25.7.1 mesh 侧:六处 readValue<uint32_t> / writeValue<uint32_t>
// src/vsg/meshshaders/DrawMeshTasksIndirect.cpp:37-63
void DrawMeshTasksIndirect::read(Input& input)
{
input.readObject("drawParameters.data", drawParameters->data);
if (!drawParameters->data)
{
input.read("drawParameters.buffer", drawParameters->buffer);
input.readValue<uint32_t>("drawParameters.offset", drawParameters->offset);
input.readValue<uint32_t>("drawParameters.range", drawParameters->range);
}
input.read("drawCount", drawCount);
input.read("stride", stride);
}
void DrawMeshTasksIndirect::write(Output& output) const
{
output.writeObject("drawParameters.data", drawParameters->data);
if (!drawParameters->data)
{
output.write("drawParameters.buffer", drawParameters->buffer);
output.writeValue<uint32_t>("drawParameters.offset", drawParameters->offset);
output.writeValue<uint32_t>("drawParameters.range", drawParameters->range);
}
output.write("drawCount", drawCount);
output.write("stride", stride);
}
25.7.2 commands 侧:同样的截断,多一层空 bufferInfo 分支
// src/vsg/commands/DrawIndirect.cpp:63-87
void DrawIndirect::write(Output& output) const
{
Command::write(output);
if (bufferInfo)
{
output.writeObject("data", bufferInfo->data);
if (!bufferInfo->data)
{
output.writeObject("buffer", bufferInfo->buffer);
output.writeValue<uint32_t>("offset", bufferInfo->offset);
output.writeValue<uint32_t>("range", bufferInfo->range);
}
}
else
{
output.writeObject("data", nullptr);
output.writeObject("buffer", nullptr);
output.writeValue<uint32_t>("offset", 0);
output.writeValue<uint32_t>("range", 0);
}
output.write("drawCount", drawCount);
output.write("stride", stride);
}
commands 侧先调 Command::write(output)(mesh 侧不调,25.4.1 已对照),再按 bufferInfo 是否为空分两支:非空时与 mesh 侧同型的「data 二选一」,空时写四个零值占位。output.writeValue<uint32_t>("offset", 0) 里的字面量 0 是 int,模板按 uint32_t 写出,与读侧 readValue<uint32_t> 对齐——写侧自己是一致的,错在与 VkDeviceSize 字段的类型不匹配。src/vsg/commands/DrawIndexedIndirect.cpp:63 的 void DrawIndexedIndirect::write 与这段代码逐字相同,只是类名替换。
read 侧的 Command::read(input) 之后是 25.8.3 要拆的死代码,但截断本身在 :51-52 已经定型:读回的两个 uint32_t 局部变量 offset / range(声明为 VkDeviceSize,:48-49)被 readValue<uint32_t> 填充,随后只在那个恒假的分支里传给 BufferInfo::create。也就是说,commands 侧这 6 处截断中的 4 处,落在一段永远不会执行的代码上(25.8.3);截断缺陷在 mesh 侧是活的,在 commands 侧被死代码掩盖了一半。
25.7.3 默认构造差异:mesh 创建 BufferInfo,commands 不创建
// src/vsg/meshshaders/DrawMeshTasksIndirect.cpp:18-21
DrawMeshTasksIndirect::DrawMeshTasksIndirect() :
drawParameters(BufferInfo::create())
{
}
// src/vsg/commands/DrawIndirect.cpp:17-19
DrawIndirect::DrawIndirect()
{
}
这一段是本章最容易被忽略、后果却最直接的分叉。mesh 侧默认构造把 drawParameters 初始化成有效但内容为空的 BufferInfo,read() 首行(:39)解引用安全;commands 侧默认构造空体,bufferInfo 是默认空 ref_ptr。而 DrawIndirect::read 的 else 分支 :50 直接写 input.readObject("buffer", bufferInfo->buffer)——当流里 "data" 为空(正是 write() 的 else 分支写出的形态),bufferInfo 仍为空,这一行就是空指针解引用。即 DrawIndirect 默认构造对象经 write() 再 read() 一轮会崩,DrawMeshTasksIndirect 不会;同一缺陷两个目录一处修了、一处没修,且无注释说明差别。
代价与边界:4 GiB 门槛对多数参数缓冲显得远,但死代码里 src/vsg/vk/Context.cpp:529 的 for (const auto& bufferInfo : bufferInfoList) 配合 :532 的 bufferInfo->offset += deviceBufferInfo->offset 会把 offset 改成池内偏移,一旦恢复旧分支语义即变;规避是把四处 uint32_t 改成 VkDeviceSize,需与第十八章版本协商一并考虑。
25.8 DrawIndirect / DrawIndexedIndirect:commands 侧对照与死代码
25.8.1 头文件:与 mesh 版同形,字段名不同
// include/vsg/commands/DrawIndirect.h:22-41
/// DrawIndirect command encapsulates vkCmdDrawIndirect call and associated settings.
class VSG_DECLSPEC DrawIndirect : public Inherit<Command, DrawIndirect>
{
public:
DrawIndirect();
DrawIndirect(ref_ptr<Data> data, uint32_t in_drawCount, uint32_t in_stride);
DrawIndirect(ref_ptr<Buffer> in_buffer, VkDeviceSize in_offset, uint32_t in_drawCount, uint32_t in_stride);
void read(Input& input) override;
void write(Output& output) const override;
void compile(Context& context) override;
void record(CommandBuffer& commandBuffer) const override;
ref_ptr<BufferInfo> bufferInfo;
uint32_t drawCount = 0;
uint32_t stride = 0;
};
把 25.5.1 的 DrawMeshTasksIndirect.h:22-40 并排看:继承、两个 Data/Buffer 构造、read/write/compile/record 四个重写、uint32_t drawCount / stride = 0 逐项一致,唯一实质差别是 bufferInfo 对 drawParameters 的命名,以及 include/vsg/vk/CommandBuffer.h 这一行额外 include(DrawIndirect.h:17,mesh 版靠 .cpp 里 include)。DrawIndexedIndirect.h:22-41 与 DrawIndirect.h 又是逐字同型,只换类名与注释里 vkCmdDrawIndexedIndirect。两个文件各 44 行,是四条间接命令里「重复度最高」的一对。
25.8.2 compile / record:核心函数不是扩展指针
// src/vsg/commands/DrawIndirect.cpp:89-100
void DrawIndirect::compile(Context& context)
{
if (!bufferInfo->buffer && bufferInfo->data)
{
createBufferAndTransferData(context, {bufferInfo}, VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT, VK_SHARING_MODE_EXCLUSIVE);
}
}
void DrawIndirect::record(CommandBuffer& commandBuffer) const
{
vkCmdDrawIndirect(commandBuffer, bufferInfo->buffer->vk(commandBuffer.deviceID), bufferInfo->offset, drawCount, stride);
}
compile() 与 DrawMeshTasksIndirect.cpp:65-71 逐字同型(只换 drawParameters→bufferInfo):同样的 !buffer && data 条件、同样的 VK_BUFFER_USAGE_INDIRECT_BUFFER_BIT | VK_SHARING_MODE_EXCLUSIVE 用法、同样的丢弃 bool 返回值。record() 的差别是调用对象:这里是 Vulkan 1.0 核心函数 vkCmdDrawIndirect,不经过 device->getExtensions(),因此没有 25.4 那类「扩展未启用 → 空函数指针」的风险;但 bufferInfo->buffer->vk(...) 的空判依旧缺席,默认构造或 compile 未跑时同样帧期崩溃。DrawIndexedIndirect.cpp:89-100 把 vkCmdDrawIndirect 换成 vkCmdDrawIndexedIndirect,其余不变。
这两条命令的 Vulkan 参数语义值得钉住:vkCmdDrawIndirect 从 buffer + offset 起按 stride 步长读 drawCount 个 VkDrawIndirectCommand,vkCmdDrawIndexedIndirect 读 VkDrawIndexedIndirectCommand;两者都没有 count 缓冲版本(25.20.2 全库零命中 vkCmdDrawIndirectCount / vkCmdDrawIndexedIndirectCount)。因此 drawCount 必须由 CPU 在构造时确定,GPU 侧不能像 DrawMeshTasksIndirectCount 那样自适应裁剪。
25.8.3 read() 里的死变量、恒假分支与空指针
// src/vsg/commands/DrawIndirect.cpp:35-61
void DrawIndirect::read(Input& input)
{
Command::read(input);
ref_ptr<Data> data;
input.read("data", data);
if (data)
{
bufferInfo = BufferInfo::create(data);
}
else
{
ref_ptr<Buffer> buffer;
VkDeviceSize offset = 0;
VkDeviceSize range = 0;
input.readObject("buffer", bufferInfo->buffer);
input.readValue<uint32_t>("offset", offset);
input.readValue<uint32_t>("range", range);
if (buffer)
{
bufferInfo = BufferInfo::create(buffer, offset, range);
}
}
input.read("drawCount", drawCount);
input.read("stride", stride);
}
25.9 间接参数 POD:两个有包装、一个没有
25.9.1 DrawIndirectCommand 与 DrawIndexedIndirectCommand
// include/vsg/commands/DrawIndirectCommand.h:21-49
/// Equivalent to VkDrawIndirectCommand that adds read/write support
struct DrawIndirectCommand
{
uint32_t vertexCount = 0;
uint32_t instanceCount = 0;
uint32_t firstVertex = 0;
uint32_t firstInstance = 0;
void read(vsg::Input& input)
{
input.read("vertexCount", vertexCount);
input.read("instanceCount", instanceCount);
input.read("firstVertex", firstVertex);
input.read("firstInstance", firstInstance);
}
void write(vsg::Output& output) const
{
output.write("vertexCount", vertexCount);
output.write("instanceCount", instanceCount);
output.write("firstVertex", firstVertex);
output.write("firstInstance", firstInstance);
}
};
template<>
constexpr bool has_read_write<DrawIndirectCommand>() { return true; }
VSG_array(DrawIndirectCommandArray, DrawIndirectCommand);
// include/vsg/commands/DrawIndexedIndirectCommand.h:21-52
/// Equivalent to VkDrawIndexedIndirectCommand that adds read/write support
struct DrawIndexedIndirectCommand
{
uint32_t indexCount = 0;
uint32_t instanceCount = 0;
uint32_t firstIndex = 0;
int32_t vertexOffset = 0;
uint32_t firstInstance = 0;
void read(vsg::Input& input)
{
input.read("indexCount", indexCount);
input.read("instanceCount", instanceCount);
input.read("firstIndex", firstIndex);
input.read("vertexOffset", vertexOffset);
input.read("firstInstance", firstInstance);
}
void write(vsg::Output& output) const
{
output.write("indexCount", indexCount);
output.write("instanceCount", instanceCount);
output.write("firstIndex", firstIndex);
output.write("vertexOffset", vertexOffset);
output.write("firstInstance", firstInstance);
}
};
template<>
constexpr bool has_read_write<DrawIndexedIndirectCommand>() { return true; }
VSG_array(DrawIndexedIndirectCommandArray, DrawIndexedIndirectCommand);
两个 struct 是纯 POD 加两个成员函数,不继承 Object,靠 has_read_write<T>() 特化(:46-47 / :49-50)告知第十八章的容器序列化「这个类型自带读写」,VSG_array 宏生成 DrawIndirectCommandArray / DrawIndexedIndirectCommandArray,两个数组类型进 ObjectFactory.cpp:121-122。DrawIndexedIndirectCommand.h:27 的 vertexOffset 用 int32_t,与 VkDrawIndexedIndirectCommand 规范一致;25.2.1 指出 DrawIndexed.h:48 用 uint32_t,同一规范字段在命令类与 POD 里被写成两种符号性。该头文件版权年是 2025(:5),其余绘制文件是 2018 / 2019,说明这个 POD 是新补的,与 DrawIndirectCommand.h 不是一次写成。
字段尺寸以本机 SDK 的 sizeof(VkDrawIndirectCommand) / sizeof(VkDrawIndexedIndirectCommand) 为准(25.12.4 给测量程序),本节只钉一件事:两个 struct 的成员顺序、类型、默认值与规范字段一一对应,是用户往 drawCount × stride 缓冲里填数据时唯一现成的 VSG 侧类型。
25.9.2 stride 契约全在调用方
四个间接命令的 stride 都是 uint32_t = 0(DrawIndirect.h:40、DrawIndexedIndirect.h:40、DrawMeshTasksIndirect.h:39、DrawMeshTasksIndirectCount.h:38),全库没有任何一处对它做「非零、4 的倍数、不小于对应 POD 尺寸」的校验。Vulkan 规范对 vkCmdDrawIndirect 的 stride 要求是 4 的倍数且不小于 sizeof(VkDrawIndirectCommand),对 mesh 的三参数命令要求是 4 的倍数且不小于 sizeof(VkDrawMeshTasksIndirectCommandEXT);stride = 0 在两者下都非法。read/write 会原样序列化这个 0,compile() 不看它,record() 原样透传。用户若不显式传 stride,构造出的对象在验证层下必然报错,在没开验证层的设备上则读取行为未定义。
drawCount × stride 的乘法(25.5.1)与 stride 的缺失校验是同一个缺口的两面:前者决定分配的 range,后者决定 GPU 读取步长,两者都不由框架对齐到设备要求。include/vsg/vk/vulkan.h:242-246 的 VkDrawMeshTasksIndirectCommandEXT 是三个 uint32_t,其 sizeof 是否与用户填的 stride 一致,同样无人核对(25.9.3)。
25.9.3 缺失的 DrawMeshTasksIndirectCommand
grep -rIl '\bDrawMeshTasksIndirectCommand\b' include src 零命中(25.1.2)。规范类型只在 vulkan.h 补丁区手写一次,没有 has_read_write 特化、没有 VSG_array 数组、没有进 ObjectFactory。于是 DrawIndirect 有 DrawIndirectCommandArray 可填、DrawIndexedIndirect 有 DrawIndexedIndirectCommandArray 可填,而 DrawMeshTasksIndirect / DrawMeshTasksIndirectCount 只能自己按 12 字节布局拼 Data;后者还需要一个只装 uint32_t count 的计数缓冲,同样无现成包装。这不是「功能少」可以概括的:它把 POD 布局、大小端、对齐的责任全推给调用方,类型系统不提示。第二十四章手写 VkGeometryInstance 位域 struct 是 25.9.3 的直接前身。
25.10 BufferInfo / Data / Array 与上传链
25.10.1 BufferInfo 的四个数据字段
// include/vsg/state/BufferInfo.h:26-66
/// BufferInfo encapsulates the settings that map to VkDescriptorBufferInfo
class VSG_DECLSPEC BufferInfo : public Inherit<Object, BufferInfo>
{
public:
BufferInfo();
explicit BufferInfo(Data* in_data);
BufferInfo(Buffer* in_buffer, VkDeviceSize in_offset, VkDeviceSize in_range, Data* in_data = nullptr);
...
explicit operator bool() const { return buffer.valid() && data.valid() && range != 0; }
ref_ptr<Buffer> buffer;
VkDeviceSize offset = 0;
VkDeviceSize range = 0;
ref_ptr<Data> data;
ref_ptr<BufferInfo> parent;
/// return true if the BufferInfo's has not been assigned a buffer or that buffer doesn't yet have device memory allocated for it.
bool requiresAllocation(uint32_t deviceID) const
{
return !buffer || buffer->getDeviceMemory(deviceID) == nullptr;
}
...
offset / range 是 VkDeviceSize(:57-58),这是 25.7 截断缺陷的类型依据;operator bool()(:54)要求 buffer、data、range != 0 三者同时成立,而四个 compile() 用的判据是 !buffer && data(25.5.3、25.8.2),比它宽松也不一致:compile 只要「有 data 没 buffer」就上传,operator bool() 却要求上传后 data 仍在且 range 非零。requiresAllocation(deviceID)(:63-66)是上传链判断是否需要显存的依据,parent(:60)服务于 staging 缓冲合并。Data / Array 的血缘在第五章:用户填进 BufferInfo 的 Data 通常是 DrawIndirectCommandArray 这类 Array 子类。
25.10.2 上传链的两跳:自由函数转发到 Context
// src/vsg/state/BufferInfo.cpp:217-221
// vsg::createBufferAndTransferData
bool vsg::createBufferAndTransferData(Context& context, const BufferInfoList& bufferInfoList, VkBufferUsageFlags usage, VkSharingMode sharingMode)
{
return context.createBufferAndTransferData(bufferInfoList, usage, sharingMode);
}
// include/vsg/vk/Context.h:147-155
ref_ptr<MemoryBufferPools> deviceMemoryBufferPools;
ref_ptr<MemoryBufferPools> stagingMemoryBufferPools;
ref_ptr<TransferTask> transferTask;
// RTX ray tracing
VkDeviceSize scratchBufferSize;
std::vector<ref_ptr<BuildAccelerationStructureCommand>> buildAccelerationStructureCommands;
bool createBufferAndTransferData(const BufferInfoList& bufferInfoList, VkBufferUsageFlags usage, VkSharingMode sharingMode);
四个 compile() 调 BufferInfo.h:100 声明的自由函数,实现只有一行转发(BufferInfo.cpp:219-221),逻辑在 Context::createBufferAndTransferData(Context.cpp:406);声明与实现分住 state/ 与 vk/,是第五章数据类型与第六章设备上下文的桥。grep -rIn "createBufferAndTransferData(context" include src 实测 15 行命中,扣除 BufferInfo.cpp:221 与 Context.h:155 两处非命令语境后,直接调用点 12 处:顶点/索引数据八处(BindIndexBuffer.cpp:106、BindVertexBuffers.cpp:102、Geometry.cpp:169、InstanceDraw.cpp:121、InstanceDrawIndexed.cpp:157、InstanceNode.cpp:136、VertexDraw.cpp:131、VertexIndexDraw.cpp:166),间接命令四处(DrawIndexedIndirect.cpp:93、DrawIndirect.cpp:93、DrawMeshTasksIndirect.cpp:69、DrawMeshTasksIndirectCount.cpp:80)。
25.10.3 #if 1 把 160 行变成死代码,生效分支只增不减
// src/vsg/vk/Context.cpp:406-427
bool Context::createBufferAndTransferData(const BufferInfoList& bufferInfoList, VkBufferUsageFlags usage, VkSharingMode sharingMode)
{
if (bufferInfoList.empty()) return false;
VkDeviceSize alignment = 4;
if (usage == VK_BUFFER_USAGE_UNIFORM_BUFFER_BIT)
alignment = device->getPhysicalDevice()->getProperties().limits.minUniformBufferOffsetAlignment;
else if (usage == VK_BUFFER_USAGE_STORAGE_BUFFER_BIT)
alignment = device->getPhysicalDevice()->getProperties().limits.minStorageBufferOffsetAlignment;
#if 1
if (VkResult result = deviceMemoryBufferPools->reserve(bufferInfoList, alignment, usage | VK_BUFFER_USAGE_TRANSFER_DST_BIT, sharingMode, VK_MEMORY_PROPERTY_DEVICE_LOCAL_BIT); result == VK_SUCCESS)
{
bufferInfosToCopy.reserve(bufferInfosToCopy.size() + bufferInfoList.size());
bufferInfosToCopy.insert(bufferInfosToCopy.end(), bufferInfoList.begin(), bufferInfoList.end());
return true;
}
else
{
return false;
}
#else
grep -n '#if 1\|#else\|#endif' src/vsg/vk/Context.cpp 给出 :416 / :428 / :588。:428-588 共 160 行旧实现被 #if 1 永久排除,其中留着 debug("... already all compiled")(:456)、warn("... does not support multiple parent BufferInfo")(:462)、Failure to assign memory to existing BufferInfo(:507)、Failure to assign Buffer(:522)、bufferInfo->offset += deviceBufferInfo->offset(:529)、if (transferTask)(:535)等诊断与修正逻辑。当前生效的只有 :417-427 十一行,把「已编译跳过」「多 parent 拒绝」「偏移修正」三道保护一起带走,与第二十四章 RayTracingPipeline.cpp:178-180 注释掉的 reserveBuffer 同型而体量大得多。
25.10.4 代价、边界与交叉引用
上传链把「编译期分配 + 帧期只读」做成隐式契约,四个 compile() 都丢弃 bool 返回值(25.5.3、25.6.2、25.8.2),record() 不检查 BufferInfo::operator bool(),中间任何一步失败都只在帧期以空指针或验证层报错暴露。DrawMeshTasksIndirectCount::compile 的 OR 条件把两块缓冲一起传进 reserve(25.6.2),与本节「生效分支对列表一视同仁」叠加,是混合构造下待拷列表带无效项的根因。
25.11 DeviceExtensions:三个函数指针与四种取址风格
25.11.1 声明:三个 nullptr 初值
// include/vsg/vk/DeviceExtensions.h:34-49
// VK_KHR_ray_tracing
PFN_vkCreateAccelerationStructureKHR vkCreateAccelerationStructureKHR = nullptr;
PFN_vkDestroyAccelerationStructureKHR vkDestroyAccelerationStructureKHR = nullptr;
PFN_vkGetAccelerationStructureDeviceAddressKHR vkGetAccelerationStructureDeviceAddressKHR = nullptr;
PFN_vkGetAccelerationStructureBuildSizesKHR vkGetAccelerationStructureBuildSizesKHR = nullptr;
PFN_vkCmdBuildAccelerationStructuresKHR vkCmdBuildAccelerationStructuresKHR = nullptr;
PFN_vkCreateRayTracingPipelinesKHR vkCreateRayTracingPipelinesKHR = nullptr;
PFN_vkGetRayTracingShaderGroupHandlesKHR vkGetRayTracingShaderGroupHandlesKHR = nullptr;
PFN_vkCmdTraceRaysKHR vkCmdTraceRaysKHR = nullptr;
PFN_vkGetBufferDeviceAddressKHR_Compatibility vkGetBufferDeviceAddressKHR = nullptr;
// VK_EXT_mesh_shader
PFN_vkCmdDrawMeshTasksEXT vkCmdDrawMeshTasksEXT = nullptr;
PFN_vkCmdDrawMeshTasksIndirectEXT vkCmdDrawMeshTasksIndirectEXT = nullptr;
PFN_vkCmdDrawMeshTasksIndirectCountEXT vkCmdDrawMeshTasksIndirectCountEXT = nullptr;
三个 mesh 指针夹在 RT 八个(:35-42)与扩展动态状态十二个(:52-63)之间,注释块 :46 单独标 VK_EXT_mesh_shader。所有指针初值 nullptr,DeviceExtensions 构造时才有机会被赋值;:66 另有一个 bool memory_budget = false 缓存扩展支持状态,是整类里唯一「是否支持」的布尔字段——没有 mesh_shader 对应的布尔。这意味着 record()(25.4.2)连一个可查的支持位都没有,只能盲调函数指针。
25.11.2 构造:三行无条件 getProcAddr
// src/vsg/vk/DeviceExtensions.cpp:27-47
// VK_KHR_create_renderpass2
if (device->supportsApiVersion(VK_API_VERSION_1_2))
device->getProcAddr(vkCreateRenderPass2, "vkCreateRenderPass2");
else if (device->getPhysicalDevice()->supportsDeviceExtension(VK_KHR_CREATE_RENDERPASS_2_EXTENSION_NAME))
device->getProcAddr(vkCreateRenderPass2, "vkCreateRenderPass2KHR");
// VK_KHR_ray_tracing
device->getProcAddr(vkCreateAccelerationStructureKHR, "vkCreateAccelerationStructureKHR");
...
device->getProcAddr(vkCmdTraceRaysKHR, "vkCmdTraceRaysKHR");
device->getProcAddr(vkGetBufferDeviceAddressKHR, "vkGetBufferDeviceAddressKHR");
// VK_EXT_mesh_shader
device->getProcAddr(vkCmdDrawMeshTasksEXT, "vkCmdDrawMeshTasksEXT");
device->getProcAddr(vkCmdDrawMeshTasksIndirectEXT, "vkCmdDrawMeshTasksIndirectEXT");
device->getProcAddr(vkCmdDrawMeshTasksIndirectCountEXT, "vkCmdDrawMeshTasksIndirectCountEXT");
同一个构造函数里能数出四种风格::27-30 先查 supportsApiVersion(VK_API_VERSION_1_2)、再查 supportsDeviceExtension(VK_KHR_CREATE_RENDERPASS_2_EXTENSION_NAME),两道门;:50-79 的扩展动态状态按 VK_API_VERSION_1_3 或 supportsDeviceExtension("VK_EXT_extended_dynamic_state") 二选一并区分核心名与 EXT 后缀名;:81 的 memory_budget 用 supportsApiVersion(1.1) && supportsDeviceExtension(...) 算出布尔;而 :33-40(RT 八个)、:42、:45-47(mesh 三个)是裸 getProcAddr,零前置检查。
grep -rIn 'supportsDeviceExtension("VK_EXT_mesh_shader")' include src 零命中;grep -rIn 'VK_EXT_mesh_shader' include src 只命中 include/vsg/vk/vulkan.h:189(补丁区定义)与 DeviceExtensions.h:46 的一行注释。也就是说扩展名在类型系统里存在,在协商逻辑里不存在。getProcAddr 取不到地址时(设备未启用该扩展),指针保持 :47-49 的 nullptr,25.4.2 的 record() 随即空调用。第六章 06-实例设备与上下文.md 那套「扩展名 → supportsDeviceExtension → 决定是否取址」的链条,在 mesh 三个函数上被整段跳过。
25.11.3 代价、边界与交叉引用
第二十四章 24-光线追踪.md 结论「RT 八个函数指针无条件取址、两个 feature 结构零启用」在 :33-40;本章 :45-47 是同一写法在绘制侧的第一次复现,且共用同一个 DeviceExtensions 对象。Device.cpp:113/117 只对 portability 与 memory_budget 做扩展检查,supportsDeviceExtension 实现(Device.cpp:208)本身没问题,问题在调用方没调;grep -rIn 'VK_EXT_mesh_shader\|MeshShaderFeatures\|meshShader\|taskShader' src/vsg/vk/Device.cpp include/vsg/vk/Device.h src/vsg/app/Viewer.cpp 零命中,证实框架不自动加扩展名也不自动置 feature。
规避路径有三步,缺一不可:创建设备前把 VK_EXT_mesh_shader 加进扩展列表;用 DeviceFeatures::get<VkPhysicalDeviceMeshShaderFeaturesEXT, ...>() 置 taskShader / meshShader;录制前确认三个指针非空。DeviceExtensions 没提供任何一步的封装。
25.12 vulkan.h 补丁区:手写宏、结构体、PFN
25.12.1 #if VK_HEADER_VERSION < 231 的边界
include/vsg/vk/vulkan.h 共 1,231 行,是本仓库自带的 Vulkan 头补丁(根 README.md:3 说明它按 Apache-2.0 单独授权)。mesh 相关定义集中在两个 #if 块:
// include/vsg/vk/vulkan.h:187-197 / :251(节选)
#if VK_HEADER_VERSION < 231
# define VK_EXT_mesh_shader 1
# define VK_EXT_MESH_SHADER_SPEC_VERSION 1
# define VK_EXT_MESH_SHADER_EXTENSION_NAME "VK_EXT_mesh_shader"
# define VK_SHADER_STAGE_TASK_BIT_EXT VkShaderStageFlagBits(0x00000040)
# define VK_SHADER_STAGE_MESH_BIT_EXT VkShaderStageFlagBits(0x00000080)
# define VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MESH_SHADER_FEATURES_EXT VkStructureType(1000202000)
# define VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MESH_SHADER_PROPERTIES_EXT VkStructureType(1000202001)
...
#endif
:187 的门槛是 VK_HEADER_VERSION < 231,:251 是对应 #endif。SDK 头版本 ≥ 231 时,整块由系统头提供;< 231 时由这个补丁补出。VK_SHADER_STAGE_TASK_BIT_EXT = 0x40、MESH_BIT_EXT = 0x80(:193-194)是标准位值,VK_EXT_MESH_SHADER_EXTENSION_NAME(:191)就是 25.11.3 里 supportsDeviceExtension 该用却没用的那个字符串。SPEC_VERSION 写成 1(:190),以本机 SDK 为准。
25.12.2 手写 features / properties / POD / PFN
// include/vsg/vk/vulkan.h:199-207 / :209-240 / :242-250(节选)
typedef struct VkPhysicalDeviceMeshShaderFeaturesEXT {
VkStructureType sType;
void* pNext;
VkBool32 taskShader;
VkBool32 meshShader;
VkBool32 multiviewMeshShader;
VkBool32 primitiveFragmentShadingRateMeshShader;
VkBool32 meshShaderQueries;
} VkPhysicalDeviceMeshShaderFeaturesEXT;
typedef struct VkPhysicalDeviceMeshShaderPropertiesEXT {
VkStructureType sType;
void* pNext;
uint32_t maxTaskWorkGroupTotalCount;
uint32_t maxTaskWorkGroupCount[3];
...
uint32_t maxMeshWorkGroupCount[3];
...
uint32_t maxMeshOutputVertices;
uint32_t maxMeshOutputPrimitives;
...
VkBool32 prefersCompactPrimitiveOutput;
} VkPhysicalDeviceMeshShaderPropertiesEXT;
typedef struct VkDrawMeshTasksIndirectCommandEXT {
uint32_t groupCountX;
uint32_t groupCountY;
uint32_t groupCountZ;
} VkDrawMeshTasksIndirectCommandEXT;
typedef void (VKAPI_PTR *PFN_vkCmdDrawMeshTasksEXT)(VkCommandBuffer commandBuffer, uint32_t groupCountX, uint32_t groupCountY, uint32_t groupCountZ);
VkPhysicalDeviceMeshShaderPropertiesEXT(:209-240)手写了 32 个字段,含 maxMeshWorkGroupCount[3](:220)、maxMeshOutputVertices(:228)、maxMeshOutputPrimitives(:229)等预告第五问点名的属性。字段排布与 pNext 类型以本机 SDK 头为准,补丁只是旧 SDK 兜底,本文档不写死任何 sizeof / offsetof 数值。VkDrawMeshTasksIndirectCommandEXT(:242-246)三个 uint32_t 是 25.9.3 唯一可用的布局依据;三个 PFN(:248-250)是 DeviceExtensions.h:47-49 声明的类型来源,也是 25.4.2 / 25.5.2 / 25.6.3 参数顺序的核对基准。
25.12.3 同名 structure type 宏定义了两次
// include/vsg/vk/vulkan.h:153-154 / :158(旧补丁块尾部)
#define VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MESH_SHADER_FEATURES_EXT VkStructureType(1000202000)
#define VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MESH_SHADER_PROPERTIES_EXT VkStructureType(1000202001)
#define VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MEMORY_BUDGET_PROPERTIES_EXT VkStructureType(1000237000)
#define VK_STRUCTURE_TYPE_VALIDATION_FEATURES_EXT VkStructureType(1000247000)
#endif
:153-154 与 :196-197 逐字重复定义同两个宏,值相同(1000202000 / 1000202001),预处理器允许完全相同重定义、编译器不报错。SDK ≥ 231 时 :196-197 整块不生效、:153-154 单独承担定义;< 231 时两块都生效、宏被定义两遍。补丁区被拆成「旧块补 structure type、新块补类型与 PFN」两截,中间隔着 :158 的 #endif 与 :165-186 的 barycentric 补丁,是逐版本叠的历史层。用户按该宏去 get<T, type>()(25.13)值一致所以可用,但重复本身说明这块没有统一维护者。
25.12.4 本机 SDK 测量程序
所有依赖本机 Vulkan SDK 与平台 ABI 的数值(sizeof(VkDrawIndirectCommand)、sizeof(VkDrawIndexedIndirectCommand)、sizeof(VkDrawMeshTasksIndirectCommandEXT)、offsetof 各字段、VK_HEADER_VERSION、VkPhysicalDeviceLimits::maxDrawIndirectCount、VkPhysicalDeviceMeshShaderPropertiesEXT 各上限)以本机 SDK 为准,不在本文档写死。下面这段程序在装有 Vulkan SDK 的机器上编译运行即可取回本报告所需全部数字,把 stride 与 drawCount 的上界校对放到本机完成:
// 本机测量程序:g++ -std=c++17 measure.cpp -lvulkan -o measure && ./measure
#include <vulkan/vulkan.h>
#include <cstdio>
#include <cstddef>
int main() {
printf("VK_HEADER_VERSION = %d\n", VK_HEADER_VERSION);
printf("sizeof(VkDrawIndirectCommand) = %zu\n", sizeof(VkDrawIndirectCommand));
printf("sizeof(VkDrawIndexedIndirectCommand) = %zu\n", sizeof(VkDrawIndexedIndirectCommand));
#ifdef VK_EXT_mesh_shader
printf("sizeof(VkDrawMeshTasksIndirectCommandEXT) = %zu\n", sizeof(VkDrawMeshTasksIndirectCommandEXT));
printf("offsetof(vertexOffset) = %zu\n", offsetof(VkDrawIndexedIndirectCommand, vertexOffset));
#endif
return 0;
}
物理设备上界另用 vsg::PhysicalDevice::getProperties<VkPhysicalDeviceMeshShaderPropertiesEXT, VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MESH_SHADER_PROPERTIES_EXT>()(include/vsg/vk/PhysicalDevice.h:58-71)取回后打印;这个模板全库只有第二十四章 RayTracingPipeline.cpp:171 用它查过 RT 属性,mesh 属性零调用(25.13.3、25.20.3)。
25.13 DeviceFeatures:get<T>() 能启用,框架一次都没调
25.13.1 模板机制与 NV 版注释
// include/vsg/vk/DeviceFeatures.h:32-51
/// get a Vulkan extension feature structure.
/// usage example :
/// auto& meshFeatures = features->get<VkPhysicalDeviceMeshShaderFeaturesNV, VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MESH_SHADER_FEATURES_NV>();
/// meshFeatures.meshShader = 1;
/// meshFeatures.taskShader = 1;
template<typename FeatureStruct, VkStructureType type>
FeatureStruct& get()
{
if (auto itr = _features.find(type); itr != _features.end()) return *reinterpret_cast<FeatureStruct*>(itr->second.first);
FeatureStruct* feature = new FeatureStruct{};
feature->sType = type;
feature->pNext = nullptr;
_features[type].first = reinterpret_cast<FeatureHeader*>(feature);
_features[type].second = [](FeatureHeader* ptr) { delete reinterpret_cast<FeatureStruct*>(ptr); };
return *feature;
}
get<T, type>() 按 VkStructureType 在 _features(:77)查表,未命中就 new 一个零初始化结构、填 sType / pNext、登记删除器,data()(:61-64)再把所有结构串成 pNext 链交给 VkDeviceCreateInfo。机制通用,用户可写 get<VkPhysicalDeviceMeshShaderFeaturesEXT, VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MESH_SHADER_FEATURES_EXT>() 并置 taskShader = 1 / meshShader = 1。但 :34 的注释示例用 NV 版结构名,grep -rIn 'FeaturesNV\|FEATURES_NV' include/vsg/vk/vulkan.h 零命中,补丁区只有 :199 的 EXT 版,照抄示例编译不过;与第二十四章 include/vsg/raytracing/TopLevelAccelerationStructure.h:26 的 struct VkGeometryInstance 手握 transform[12] 与 instanceId : 24 位域、注释停在 NV 命名是同一现象。
25.13.2 零启用与代价边界
grep -rIn 'VkPhysicalDeviceMeshShaderFeaturesEXT\|get<VkPhysicalDeviceMeshShader' src include 只命中 vulkan.h:199 的定义与 DeviceFeatures.h:34 的 NV 注释,Device.cpp / Viewer.cpp 里零调用。结论与 25.11.3 合流:扩展名不进 enabledExtensionNames、feature 结构不进 VkDeviceCreateInfo.pNext、函数指针无条件取址,三步全靠用户手工补齐,框架不代劳、不报错、不提示。data() 在无任何 feature 时返回 nullptr(:63 注释明说),所以「用户什么都没做」这条路径完全静默。
25.14 ShaderStage / ShaderSet:MESH / TASK 位无人生成
25.14.1 stage 能承载位值,compare 漏 mask
// src/vsg/state/ShaderStage.cpp:70-77 / :170-175 —— compare() 逐字段比 stage/module,漏 mask
if (result != 0) return result;
auto& rhs = static_cast<decltype(*this)>(rhs_object);
if ((result = compare_value(flags, rhs.flags))) return result;
if ((result = compare_value(stage, rhs.stage))) return result;
if ((result = compare_pointer(module, rhs.module))) return result;
if ((result = compare_value(entryPointName, rhs.entryPointName))) return result;
...
void ShaderStage::apply(Context& context, VkPipelineShaderStageCreateInfo& stageInfo) const
{
stageInfo.sType = VK_STRUCTURE_TYPE_PIPELINE_SHADER_STAGE_CREATE_INFO;
stageInfo.stage = stage;
stageInfo.module = module->vk(context.deviceID);
stageInfo.pName = entryPointName.c_str();
ShaderStage.h:40 的 stage 是 VkShaderStageFlagBits,足以承载 VK_SHADER_STAGE_MESH_BIT_EXT(vulkan.h:194);apply()(:173)把它原样填进 VkPipelineShaderStageCreateInfo::stage。从类型通道看 mesh / task stage 能被表示。这里要纠正一个易犯的断言:两个位并非只在补丁区定义——全局命中八行,除 vulkan.h:193-194 外还有 src/vsg/io/glsl.cpp:28-29 的 .mesh / .task 后缀映射与 src/vsg/utils/ShaderCompiler.cpp:156-157/240/244 的友好名和 glslang 环境,25.22 逐字摘录这条生成链。缺口在 ShaderSet:其 getShaderStages 不按 stage 位分派。compare() 逐字段比了 flags / stage / module / entryPointName / specializationConstants(:74-88),漏掉 mask(ShaderStage.h:36),这正是第九章结论 8 的实测位置。
25.14.2 variants 是通用编译开关,没有 mesh 变体
// src/vsg/utils/ShaderSet.cpp:254-282(节选)
ShaderStages ShaderSet::getShaderStages(ref_ptr<ShaderCompileSettings> scs)
{
if (auto itr = variants.find(scs); itr != variants.end())
{
return itr->second;
}
auto& new_stages = variants[scs];
for (auto& stage : stages)
{
if (vsg::compare_pointer(stage->module->hints, scs) == 0)
{
new_stages.push_back(stage);
}
else
{
auto new_stage = vsg::ShaderStage::create();
new_stage->flags = stage->flags;
new_stage->stage = stage->stage;
new_stage->module = ShaderModule::create(stage->module->source, scs);
...
getShaderStages(scs) 按 ShaderCompileSettings 里的 defines 生成变体,new_stage->stage = stage->stage(:274)原样复制 stage 位,不针对 mesh 特殊化;grep -n 'mesh\|Mesh\|MESH\|task\|Task\|TASK' src/vsg/utils/ShaderSet.cpp 零命中。defines 机制(getSuitableArrayState():224-247、createDescriptorSetLayout():536-548、compatiblePipelineLayout():558-573)是第十章的通用编译开关,与 stage 类型无关。结论:ShaderSet 没有 mesh 变体、没有 mesh 专用 define,用户要建 mesh 管线得自己拼 ShaderStages,ShaderCompileSettings 帮不上 stage 选择。
代价与交叉引用:第十章 10-着色器与ShaderSet.md 的 variants / defines 契约;第九章 09-管线对象.md 的 ShaderStage::compare 漏 mask;25.15 的 GraphicsPipeline 会把这些 ShaderStage 原样送进 vkCreateGraphicsPipelines,因此「能表示」与「能建成」之间还差一套用户自写的 shader 与状态裁剪。
25.15 GraphicsPipeline / PipelineLayout:mesh 下哪些字段失效
25.15.1 Implementation 对所有状态无条件 apply
// src/vsg/state/GraphicsPipeline.cpp:238-260
auto shaderStageCreateInfo = context.scratchMemory->allocate<VkPipelineShaderStageCreateInfo>(shaderStages.size());
uint32_t i = 0;
for (auto& shaderStage : shaderStages)
{
// check if ShaderStage is appropriate to assign to stageInfo
if ((context.mask & shaderStage->mask) != 0)
{
shaderStageCreateInfo[i].flags = 0;
shaderStageCreateInfo[i].pNext = nullptr;
shaderStage->apply(context, shaderStageCreateInfo[i]);
++i;
}
}
pipelineInfo.stageCount = i;
pipelineInfo.pStages = shaderStageCreateInfo;
for (auto pipelineState : pipelineStates)
{
pipelineState->apply(context, pipelineInfo);
}
VkResult result = vkCreateGraphicsPipelines(*device, VK_NULL_HANDLE, 1, &pipelineInfo, _device->getAllocationCallbacks(), &_pipeline);
25.15.2 没有第四条路径:setCurrentPipelineLayout 仍三处
// src/vsg/state/GraphicsPipeline.cpp:315
commandBuffer.setCurrentPipelineLayout(pipeline->layout);
grep -rIn 'setCurrentPipelineLayout' include src 的调用点恰三处:GraphicsPipeline.cpp:315、ComputePipeline.cpp:161、RayTracingPipeline.cpp:257(另有 CommandBuffer.h:60 声明与 CommandBuffer.cpp:56 实现)。mesh 命令复用 BindGraphicsPipeline(第九章 slot 0)与同一个 PipelineLayout,不引入第四条管线创建路径、不引入第四处布局绑定;viewID 分层(GraphicsPipeline.cpp:218)与 compile 复用判据(:175-182,第九章结论 4 的浅比较)在 mesh 下原样沿用,连缺陷一起继承。
代价与交叉引用:第九章 09-管线对象.md 的三层状态合并、viewID 分层、零 pipeline cache、浅 compare 四条结论在 mesh 下全部成立;第十章 10-着色器与ShaderSet.md 的 ShaderStage::apply 是 :247 的被调用方;第二十四章 24-光线追踪.md 的 RayTracingPipeline.cpp:257 是三处之一,构成三方对照的第四方缺席。
25.16 CompileTraversal / CollectResourceRequirements:命令走通用钩子,缓冲进不了预估
25.16.1 编译侧没有专用分派
CompileTraversal.cpp 全文的 apply 列表(:291/298/310/320/331/343/383/415)里没有绘制命令专用分派,grep -rIn 'apply(const Draw\|apply(const Command\|apply(const DrawIndirect' src/vsg/app/CompileTraversal.cpp 零命中,编译靠 25.3.3 的 Commands::compile 虚调用。这与第二十四章「对 RT 零专用分派」同形但后果不同:RT build 命令走 Context::buildAccelerationStructureCommands 旁路,mesh / 间接走标准 Compilable::compile 钩子,四个 compile() 确实上传缓冲,只是没有专门的分派函数。
25.16.2 资源统计盲区
ResourceRequirements 的真实路径是 include/vsg/vk/ResourceRequirements.h(149 行)与 src/vsg/vk/ResourceRequirements.cpp(418 行),不在 app/——用错目录会得出假的「零命中」。CollectResourceRequirements 的 apply 重载表(ResourceRequirements.h:115-137)覆盖 Object / ResourceHints / Node / StateCommand / DescriptorSet / Descriptor / DescriptorBuffer / DescriptorImage / PagedLOD / Light / RenderGraph / View / DepthSorted / Layer / Bin / Geometry / VertexDraw / VertexIndexDraw / BindVertexBuffers / BindIndexBuffer / InstanceNode / InstanceDraw / InstanceDrawIndexed 共 23 个,没有任何绘制命令的 apply。
// src/vsg/vk/ResourceRequirements.cpp:119-122 / :141-144
void CollectResourceRequirements::apply(const Object& object)
{
object.traverse(*this);
}
void CollectResourceRequirements::apply(const StateCommand& stateCommand)
{
if (stateCommand.slot > requirements.maxSlots.state) requirements.maxSlots.state = stateCommand.slot;
stateCommand.traverse(*this);
}
DrawIndirect / DrawMeshTasksIndirect 既不是 StateCommand 也不是那 23 类之一,只能落到 apply(const Object&)(:119-122)的 object.traverse(*this)。Command 继承 Node(25.3.1),Object::traverse 默认不遍历成员,drawParameters / bufferInfo 这些 ref_ptr<BufferInfo> 不是子对象、不会被访问,requirements.bufferInfos(ResourceRequirements.h:83)统计不到。唯一入口 apply(ref_ptr<BufferInfo>, BufferProperties)(:141)只被 BindVertexBuffers / Geometry 等调用。结论:间接参数缓冲在 CollectResourceRequirements 阶段是盲区,却在 compile() 阶段经 createBufferAndTransferData 真分配显存(25.10.3),预估与实际分配不在同一条统计链上。正确路径下 grep -n 'Acceleration\|RayTracing\|TraceRays' 零命中,证实第二十四章「全文 RT 零命中」用对路径后仍成立。
代价与交叉引用:第十二章 12-编译遍历.md 的 CollectResourceRequirements 与 ComputeNumDescriptorSets;第十七章 17-IO与资源管线.md 的 BufferInfo 预估;第二十四章 24-光线追踪.md 的双零命中结论。
25.17 注册与遍历:与第 24 章相反的一极
25.17.1 ObjectFactory 六命令全注册,分两段
// src/vsg/io/ObjectFactory.cpp:256-260 / :320-323
// commands
add<vsg::Draw>();
add<vsg::DrawIndirect>();
add<vsg::DrawIndexed>();
add<vsg::DrawIndexedIndirect>();
...
// mesh shading
add<vsg::DrawMeshTasks>();
add<vsg::DrawMeshTasksIndirect>();
add<vsg::DrawMeshTasksIndirectCount>();
六个命令全部进第十七章的类型表,:121-122 还注册了 DrawIndirectCommandArray / DrawIndexedIndirectCommandArray 两个数组类型。这与第二十四章 24-光线追踪.md 「ObjectFactory.cpp 对九个 RT 类零注册」正好相反:mesh / 间接命令能序列化回读,RT 类不能。预告第四问里「与本章双零命中的缺席是否同源」的答案是不同源,不能顺着通称写——本章缺席的只是 CollectResourceRequirements 这半边。
25.17.2 Visitor 三个桩、all.h 两段收录
// src/vsg/core/Visitor.cpp:953-961
void Visitor::apply(DrawMeshTasks& dmt)
{
apply(static_cast<Command&>(dmt));
}
void Visitor::apply(DrawMeshTasksIndirect& dmti)
{
apply(static_cast<Command&>(dmti));
}
void Visitor::apply(DrawMeshTasksIndirectCount& dmtic)
{
apply(static_cast<Command&>(dmtic));
}
ConstVisitor.cpp:953-961 逐字对称。三个桩都只做一件事:把具体类型降级成 Command& 再调通用 apply。任何自定义 Visitor 若不重写这三个 apply,访问 mesh 命令时拿不到 groupCountX / drawParameters 等具体字段,等价于「有分派、无语义」。include/vsg/all.h:130 的 #include <vsg/commands/Draw.h> 起收六个 commands/ 绘制头,:340-342 另收三个 meshshaders/ 头;src/vsg/core/ConstVisitor.cpp:953 的 ConstVisitor::apply(const DrawMeshTasks& dmt) 与 Visitor.cpp 逐字对称。加上 CMakeLists.txt、ObjectFactory.cpp、Visitor.cpp、ConstVisitor.cpp,新增一个 mesh 命令要同步改五处(25.1.3 已列)。
代价与交叉引用:第三章 03-Visitor体系与遍历语义.md 的 apply 分派;第十七章 17-IO与资源管线.md 的 ObjectFactory;第十八章 18-序列化格式.md;第二十四章 24-光线追踪.md 的零注册对照。
25.18 Intersector / ComputeBounds:CPU 侧对间接与 mesh 全盲
25.18.1 只认 Draw / DrawIndexed
// src/vsg/utils/ComputeBounds.cpp:215-222
void ComputeBounds::apply(const Draw& draw)
{
applyDraw(draw.firstVertex, draw.vertexCount, draw.firstInstance, draw.instanceCount);
}
void ComputeBounds::apply(const DrawIndexed& drawIndexed)
{
applyDrawIndexed(drawIndexed.firstIndex, drawIndexed.indexCount, drawIndexed.firstInstance, drawIndexed.vertexOffset, drawIndexed.instanceCount);
};
// src/vsg/utils/Intersector.cpp:232-243
void Intersector::apply(const Draw& draw)
{
PushPopNode ppn(_nodePath, &draw);
intersectDraw(draw.firstVertex, draw.vertexCount, draw.firstInstance, draw.instanceCount);
}
void Intersector::apply(const DrawIndexed& drawIndexed)
{
PushPopNode ppn(_nodePath, &drawIndexed);
intersectDrawIndexed(drawIndexed.firstIndex, drawIndexed.indexCount, drawIndexed.firstInstance, drawIndexed.instanceCount);
}
两个第二十三章的访问者各自只重载 apply(const Draw&) 与 apply(const DrawIndexed&)(ComputeBounds.h:63-64、Intersector.h:49-50),把 firstVertex / vertexCount / firstIndex / indexCount 这些 CPU 已知的常量交给 applyDraw* / intersectDraw* 去查顶点数组。grep -n 'DrawIndirect\|DrawMeshTasks\|Mesh\|Indirect' src/vsg/utils/ComputeBounds.cpp src/vsg/utils/Intersector.cpp 在 apply 层零命中(只有头文件 include 里的 DrawIndexed.h 字符串)。
25.18.2 CPU / GPU 绘制路径对比与代价边界
间接绘制的 drawCount / 顶点数写在 GPU 缓冲里,mesh 绘制的顶点由 task / mesh shader 在设备上生成,两者在 CPU 侧都没有可枚举的几何范围。ComputeBounds 因此无法为它们更新包围盒,Intersector 无法拾取,View 的视锥剔除、LOD / PagedLOD(第十九章)的距离判定,对这些命令全部退化为「按父节点包围盒处理或不处理」。这不是 bug,而是设计边界:第 23 章的求交链建立在「几何在 CPU 侧可见」的前提上,25.9 的间接 POD 把这个前提搬到了 GPU。代价是调用方必须自己给这些命令挂一个保守包围球(CullNode / ComputeBounds 的父节点),否则剔除与拾取会静默失效。
25.19 Bin / DepthSorted:排序对间接绘制意味着什么
25.19.1 收集后排序的状态栈
// include/vsg/nodes/Bin.h:26-42(节选)
enum SortOrder
{
NO_SORT,
ASCENDING,
DESCENDING
};
Bin(int32_t in_binNumber, SortOrder in_sortOrder);
int32_t binNumber = 0;
SortOrder sortOrder = NO_SORT;
...
void add(State* state, double value, const Node* node);
void traverse(RecordTraversal& visitor) const override;
std::vector<const StateCommand*> _stateCommands;
...
std::vector<Element> _elements;
Bin::add(State*, double value, const Node*) 把「状态栈快照 + 排序值 + 节点」收进 _elements,traverse(RecordTraversal&) 时按 sortOrder 排序再录;DepthSorted.h:31-43 用 binNumber 与 dsphere 把子图指派到指定 bin,traverse 只 child->accept(visitor)。第八章状态栈与 RecordTraversal::apply(const Bin&) 在 25.3.3 已接上:mesh / 间接命令作为 Command 也能进 bin,排序值取自 CPU 侧深度或包围球。
25.19.2 边界与交叉引用
对 DrawMeshTasksIndirectCount 这类命令,一个 bin 元素对应的实际绘制数由 GPU 计数缓冲决定,add() 时无法知道;半透明排序(第二十二章 DepthSorted 的典型用途)按单个 CPU 深度值排一次序,与 GPU 侧展开的 N 次绘制不是一一对应。框架不区分这两类元素,排序契约由调用方自己维护。---
25.20 全库 vkCmd* 绘制调用点统计与参数矩阵
25.20.1 七个调用点逐条实测
grep -rIn 'vkCmdDrawMeshTasksEXT\|vkCmdDrawMeshTasksIndirectEXT\|vkCmdDrawMeshTasksIndirectCountEXT\|vkCmdDrawIndirect\|vkCmdDrawIndexedIndirect\|vkCmdDraw(\|vkCmdDrawIndexed(' include src 的实现调用点(排除 *.h 注释与函数指针声明)共 11 行,其中本章七个命令各一次,四个第七章节点各一次。三个 EXT 指针的声明是参数核对基准:
// include/vsg/vk/vulkan.h:248-250
typedef void (VKAPI_PTR *PFN_vkCmdDrawMeshTasksEXT)(VkCommandBuffer commandBuffer, uint32_t groupCountX, uint32_t groupCountY, uint32_t groupCountZ);
typedef void (VKAPI_PTR *PFN_vkCmdDrawMeshTasksIndirectEXT)(VkCommandBuffer commandBuffer, VkBuffer buffer, VkDeviceSize offset, uint32_t drawCount, uint32_t stride);
typedef void (VKAPI_PTR *PFN_vkCmdDrawMeshTasksIndirectCountEXT)(VkCommandBuffer commandBuffer, VkBuffer buffer, VkDeviceSize offset, VkBuffer countBuffer, VkDeviceSize countBufferOffset, uint32_t maxDrawCount, uint32_t stride);
| 调用点 | 函数 | 参数序列 | 取址方式 |
|---|---|---|---|
include/vsg/commands/Draw.h:41 | vkCmdDraw | commandBuffer, vertexCount, instanceCount, firstVertex, firstInstance | 核心函数 |
include/vsg/commands/DrawIndexed.h:42 | vkCmdDrawIndexed | commandBuffer, indexCount, instanceCount, firstIndex, vertexOffset, firstInstance | 核心函数 |
src/vsg/commands/DrawIndirect.cpp:99 | vkCmdDrawIndirect | commandBuffer, buffer, offset, drawCount, stride | 核心函数 |
src/vsg/commands/DrawIndexedIndirect.cpp:99 | vkCmdDrawIndexedIndirect | commandBuffer, buffer, offset, drawCount, stride | 核心函数 |
src/vsg/meshshaders/DrawMeshTasks.cpp:48 | vkCmdDrawMeshTasksEXT | commandBuffer, groupCountX, groupCountY, groupCountZ | DeviceExtensions 指针 |
src/vsg/meshshaders/DrawMeshTasksIndirect.cpp:77 | vkCmdDrawMeshTasksIndirectEXT | commandBuffer, buffer, offset, drawCount, stride | DeviceExtensions 指针 |
src/vsg/meshshaders/DrawMeshTasksIndirectCount.cpp:88 | vkCmdDrawMeshTasksIndirectCountEXT | commandBuffer, buffer, offset, countBuffer, countBufferOffset, maxDrawCount, stride | DeviceExtensions 指针 |
另有四个节点直连调用:src/vsg/nodes/InstanceDraw.cpp:168、InstanceDrawIndexed.cpp:206、VertexDraw.cpp:150、VertexIndexDraw.cpp:188,都是 vkCmdDraw / vkCmdDrawIndexed 核心函数,属第七章范围,不与 DeviceExtensions 打交道。
25.20.2 count 版缺失与参数矩阵
grep -rIn 'vkCmdDrawIndirectCount\|vkCmdDrawIndexedIndirectCount' include src 零命中:普通间接绘制没有 count 缓冲版本,DrawIndirect / DrawIndexedIndirect 的 drawCount 只能由 CPU 定死;唯一带 count 的是 mesh 侧 DrawMeshTasksIndirectCount,对应 DeviceExtensions.cpp:47 的第三个指针。参数矩阵上,五个间接 / mesh 命令共有 buffer(VkBuffer)、offset(VkDeviceSize)、drawCount 或 maxDrawCount、stride(后两者 uint32_t);DrawMeshTasks 独有 groupCountX/Y/Z,DrawMeshTasksIndirectCount 独有 countBuffer / countBufferOffset。四类值全为 0 默认、全无上界校验(25.0.2 第 5、10 条)。
25.20.3 代价、边界与交叉引用
七个调用点里三个走 DeviceExtensions 指针、四个走核心函数,前者全都缺扩展检查与空判(25.4.2、25.5.2、25.6.3),后者只缺 buffer 空判(25.8.2)。VkPhysicalDeviceLimits::maxDrawIndirectCount、VkPhysicalDeviceMeshShaderPropertiesEXT::maxMeshWorkGroupCount[3] 一类上限以本机 SDK 为准(25.12.4 测量程序),本库零查询,零边界检查。规避:录制前用 getProperties<...>() 取回上限,对 groupCount* / drawCount / maxDrawCount / stride 逐项裁剪,并确认三个函数指针非空。
25.21 ExecuteCommands:二级命令缓冲先同步再录制
ExecuteCommands 是 25.3 里 Command 的另一个子类:不发 vkCmdDraw*,却在 record() 之前多一道帧同步。四段逐字摘录它的构造、连接、重置与录制,对照 mesh 三个 record() 的「零同步、零空判」。
// src/vsg/commands/ExecuteCommands.cpp:17-20
ExecuteCommands::ExecuteCommands() :
_latch(vsg::Latch::create(0))
{
}
初值为 0:没有连接任何 SecondaryCommandGraph 时,record() 里的 _latch->wait()(src/vsg/commands/ExecuteCommands.cpp:70)立即返回。
// src/vsg/commands/ExecuteCommands.cpp:31-35
void ExecuteCommands::connect(ref_ptr<SecondaryCommandGraph> commandGraph)
{
_commandGraphsAndBuffers.push_back(CommandGraphAndBuffer{commandGraph, {}});
commandGraph->_connect(this);
}
connect() 把 cb 留空,此刻还没有 VkCommandBuffer;这与 mesh 命令在 compile() 里立刻上传参数缓冲形成时序反差。
// src/vsg/commands/ExecuteCommands.cpp:37-47
void ExecuteCommands::reset()
{
std::scoped_lock lock(_mutex);
_latch->set(static_cast<int>(_commandGraphsAndBuffers.size()));
for (auto& entry : _commandGraphsAndBuffers)
{
entry.cb = {};
}
}
reset() 在持锁状态下先把 latch 设为连接数,再清空全部 cb;本章六个绘制命令全无 _mutex,也没有这层帧级重置。
// src/vsg/commands/ExecuteCommands.cpp:65
_latch->count_down();
completed() 无条件 count_down(),即便传入的 commandBuffer 为空也放行——空缓冲只跳过写入,不阻塞录制线程。
// src/vsg/commands/ExecuteCommands.cpp:79-82
if (!vk_commandBuffers.empty())
{
vkCmdExecuteCommands(commandBuffer, static_cast<uint32_t>(vk_commandBuffers.size()), vk_commandBuffers.data());
}
vkCmdExecuteCommands 是 Vulkan 1.0 核心函数,不经 DeviceExtensions,与 vkCmdDrawIndirect 同类;这里有一道 empty() 守卫;核心函数 vkCmdExecuteCommands 的调用点在 src/vsg/commands/ExecuteCommands.cpp:81,而 mesh 三个 record() 对空 drawParameters->buffer 一道都没有。
// include/vsg/commands/ExecuteCommands.h:48-51
mutable std::mutex _mutex;
ref_ptr<Latch> _latch;
std::vector<CommandGraphAndBuffer> _commandGraphsAndBuffers;
三个成员把线程同步、帧完成信号、缓冲集合压在同一个 Command 里;六个绘制命令没有一个带锁。
25.22 stage 位确有生成器:.mesh / .task 与 ShaderSet 的分界
25.14.1 的「无人生成」只适用于 ShaderSet,不适用于全库。三处逐字摘录显示后缀到 stage 位的映射与编译环境都已就位。
// src/vsg/io/glsl.cpp:28-29
{".mesh", VK_SHADER_STAGE_MESH_BIT_EXT},
{".task", VK_SHADER_STAGE_TASK_BIT_EXT},
静态表 s_extensionToStage(src/vsg/io/glsl.cpp:21)把文件后缀直接映射为 stage 位,.mesh / .task 源文件能产出 mesh / task 位。
// src/vsg/io/glsl.cpp:25-26
{".geom", VK_SHADER_STAGE_GEOMETRY_BIT},
{".frag", VK_SHADER_STAGE_FRAGMENT_BIT},
Geometry Shader 位与 mesh 位走同一张表,差别只有后缀;生成器是通用的,不是为 mesh 特设。
// src/vsg/utils/ShaderCompiler.cpp:156-157
case (VK_SHADER_STAGE_TASK_BIT_EXT): return "Task Shader";
case (VK_SHADER_STAGE_MESH_BIT_EXT): return "Mesh Shader";
诊断用的友好名分支存在,说明编译器能识别这两个 stage;缺口在 ShaderSet::getShaderStages 不按 stage 位分派。
// src/vsg/utils/ShaderCompiler.cpp:240-246
case (VK_SHADER_STAGE_TASK_BIT_EXT):
envStage = EShLangTask;
minTargetLanguageVersion = glslang::EShTargetSpv_1_4;
break;
case (VK_SHADER_STAGE_MESH_BIT_EXT):
envStage = EShLangMesh;
minTargetLanguageVersion = glslang::EShTargetSpv_1_4;
两个环境都要求 SPIR-V 1.4(src/vsg/utils/ShaderCompiler.cpp:244);这是 25.12 补丁区之外另一处未在正文出现的版本门槛,旧目标版本下 mesh / task 着色器编译不过。
25.23 nodes/ 直连命令:第七章调用点的逐字形态
第七章的四个节点把核心函数直接写进 record(),与命令对象封装同一 Vulkan 调用。四段摘录补上 25.20 只给了行号、没给原文的调用点。
// src/vsg/nodes/VertexIndexDraw.cpp:184-188
vkCmdBindVertexBuffers(cmdBuffer, firstBinding, static_cast<uint32_t>(vkd.vkBuffers.size()), vkd.vkBuffers.data(), vkd.offsets.data());
vkCmdBindIndexBuffer(cmdBuffer, indices->buffer->vk(commandBuffer.deviceID), indices->offset, indexType);
vkCmdDrawIndexed(cmdBuffer, indexCount, instanceCount, firstIndex, vertexOffset, firstInstance);
三个核心调用连发,中间的 vkCmdBindIndexBuffer(src/vsg/nodes/VertexIndexDraw.cpp:186)取 indices->buffer 未判空;同一 vkCmdDrawIndexed 在 DrawIndexed.h:42 又内联在命令类里,两种封装并存。
// src/vsg/nodes/InstanceDraw.cpp:165-168
vkCmdBindVertexBuffers(cmdBuffer, firstBinding, static_cast<uint32_t>(vkBuffers.size()), vkBuffers.data(), offsets.data());
// vsg::info("InstanceDraw::record(CommandBuffer& commandBuffer) vkCmdDraw vkBuffers.size() = ", vkBuffers.size(), ", vertexCount = ", vertexCount, ", instanceNode->instanceCount = ", instanceNode->instanceCount);
vkCmdDraw(cmdBuffer, vertexCount, instanceNode->instanceCount, firstVertex, instanceNode->firstInstance);
instanceCount 与 firstInstance 取自 instanceNode(src/vsg/nodes/InstanceDraw.cpp:168)而非节点自身,实例数据走另一条来源,与 Draw::instanceCount 的成员语义不同。
// src/vsg/nodes/Geometry.cpp:188-191 —— 接 :186 的 vkCmdBindIndexBuffer 后逐项 record
for (auto& command : commands)
{
command->record(commandBuffer);
}
Geometry 逐项 record 子命令,不判空、不过滤类型,与 Commands::record 的容器循环同构。
// include/vsg/nodes/Geometry.h:35-41
using DrawCommands = std::vector<ref_ptr<Command>>;
// settings
uint32_t firstBinding = 0;
BufferInfoList arrays;
ref_ptr<BufferInfo> indices;
DrawCommands commands;
DrawCommands 允许把 mesh 命令塞进 Geometry,但 Geometry::compile(:131-141)只对子命令逐个转发,不识别 DrawMeshTasks 的特殊性。
25.24 取址返回 bool,三个 mesh 调用全部丢弃
Device 的取址模板既有返回值也有 fallback,注释还写明未启用扩展时必为空;mesh 路径把两者都浪费了。
// include/vsg/vk/Device.h:66-76
/// for extension commands, vkGetDeviceProcAddr will always return nullptr if the extension is not enabled in vsg::Device creation.
template<typename T>
bool getProcAddr(T& procAddress, const char* pName, const char* pNameFallback = nullptr) const
{
procAddress = reinterpret_cast<T>(vkGetDeviceProcAddr(_device, pName));
if (procAddress) return true;
if (pNameFallback) procAddress = reinterpret_cast<T>(vkGetDeviceProcAddr(_device, pNameFallback));
return (procAddress);
}
getProcAddr(include/vsg/vk/Device.h:70)返回 bool 且支持备用名;DeviceExtensions.cpp:45-47 三行无条件调用全部丢弃返回值,也没有传 pNameFallback。
// src/vsg/vk/Device.cpp:208-212
bool Device::supportsDeviceExtension(const char* extensionName) const
{
auto compare = [&](const char* rhs) { return strcmp(extensionName, rhs) == 0; };
return (std::find_if(enabledExtensions.begin(), enabledExtensions.end(), compare) != enabledExtensions.end());
}
supportsDeviceExtension 遍历 enabledExtensions(src/vsg/vk/Device.cpp:211),实现正确、开销只是一次线性查找;mesh 路径完全没调它,缺的不是能力而是接线。
// src/vsg/vk/CommandBuffer.cpp:56-64
void CommandBuffer::setCurrentPipelineLayout(const PipelineLayout* pipelineLayout)
{
VkPipelineLayout newLayout = pipelineLayout->vk(deviceID);
if (_currentPipelineLayout != newLayout)
{
// have to assume that all DescriptorSets will need to be rebound.
state->dirtyStateStacks();
_currentPipelineLayout = newLayout;
布局切换会 dirtyStateStacks(),所以 25.15 三处绑定对 mesh 仍生效;mesh 命令靠 BindGraphicsPipeline 间接吃到状态栈失效。
25.25 排序的真正落点:Bin::traverse 与 DepthSorted::traverse
25.19 只给出 Bin.h 的字段,这里补上排序发生的位置与 DepthSorted 的透传语义。
// src/vsg/nodes/Bin.cpp:115-124
switch (sortOrder)
{
case (ASCENDING):
std::sort(_binElements.begin(), _binElements.end(), [](const KeyIndex& lhs, const KeyIndex& rhs) { return lhs.first < rhs.first; });
break;
case (DESCENDING):
std::sort(_binElements.begin(), _binElements.end(), [](const KeyIndex& lhs, const KeyIndex& rhs) { return rhs.first < lhs.first; });
break;
case (NO_SORT):
break;
std::sort 只比较 KeyIndex::first(src/vsg/nodes/Bin.cpp:118),即 CPU 侧一个 double;GPU 计数决定次数的绘制在这里仍只占一个元素。
// include/vsg/nodes/DepthSorted.h:41-43 —— bound/binNumber 由遍历器消费,自身只透传 child
void traverse(Visitor& visitor) override { child->accept(visitor); }
void traverse(ConstVisitor& visitor) const override { child->accept(visitor); }
void traverse(RecordTraversal& visitor) const override { child->accept(visitor); }
三个 traverse 都只是透传给 child;binNumber 与 bound 由遍历器在别处消费,DepthSorted 自身不录制任何绘制命令。
25.26 ConstVisitor 对称桩与资源预估的兜底
// src/vsg/core/ConstVisitor.cpp:953-962
void ConstVisitor::apply(const DrawMeshTasks& dmt)
{
apply(static_cast<const Command&>(dmt));
}
void ConstVisitor::apply(const DrawMeshTasksIndirect& dmti)
{
apply(static_cast<const Command&>(dmti));
}
void ConstVisitor::apply(const DrawMeshTasksIndirectCount& dmtic)
{
apply(static_cast<const Command&>(dmtic));
三个桩与 Visitor 逐字对称,都降级到 const Command&(src/vsg/core/ConstVisitor.cpp:955);CollectResourceRequirements 没重写它们,于是落到 apply(const Object&)。
// src/vsg/vk/ResourceRequirements.cpp:124-136
bool CollectResourceRequirements::checkForResourceHints(const Object& object)
{
auto resourceHints = object.getObject<ResourceHints>("ResourceHints");
if (resourceHints)
{
apply(*resourceHints);
return true;
}
else
{
return false;
}
}
兜底路径只查 "ResourceHints" 附加对象;间接命令的 drawParameters 不是 ResourceHints,所以挂了 hints 也统计不到参数缓冲。
// include/vsg/vk/CommandBuffer.h:60-63
void setCurrentPipelineLayout(const PipelineLayout* pipelineLayout);
VkPipelineLayout getCurrentPipelineLayout() const { return _currentPipelineLayout; }
VkShaderStageFlags getCurrentPushConstantStageFlags() const { return _currentPushConstantStageFlags; }
三个接口把布局与 push constant stage 暴露给遍历器,mesh 命令复用它们,无需第四处布局绑定。
数字表与源码索引
按文件分组,每条给 完整路径:行区间 与本章从该区间读出的结论;行号区间以 cat -n / grep -n 实测为准。
include/vsg/meshshaders/ 与 src/vsg/meshshaders/
include/vsg/meshshaders/DrawMeshTasks.h:21-36—Inherit<Command, DrawMeshTasks>,无compile、无compare,三个uint32_t默认 0。include/vsg/meshshaders/DrawMeshTasksIndirect.h:25-39—drawParameters/drawCount/stride,三构造加compile重写。include/vsg/meshshaders/DrawMeshTasksIndirectCount.h:25-38—drawCount是BufferInfo,maxDrawCount才是数量上限。src/vsg/meshshaders/DrawMeshTasks.cpp:44-49—record()两处未判空指针、一处未判空函数指针。src/vsg/meshshaders/DrawMeshTasksIndirect.cpp:30-35—in_drawCount * in_stride在 32 位域内相乘后才提升为VkDeviceSize。src/vsg/meshshaders/DrawMeshTasksIndirect.cpp:37-63—read/write把VkDeviceSize按uint32_t读写,4 处截断。src/vsg/meshshaders/DrawMeshTasksIndirect.cpp:65-71—compile()的!buffer && data判据、丢弃bool返回值。src/vsg/meshshaders/DrawMeshTasksIndirectCount.cpp:32-74— 两组缓冲的read/write,共 8 处uint32_t截断。src/vsg/meshshaders/DrawMeshTasksIndirectCount.cpp:76-82— OR 触发却把两块BufferInfo一起传进上传链。src/vsg/meshshaders/DrawMeshTasksIndirectCount.cpp:84-89— 六参record()与vulkan.h:250逐字对齐,六处空判缺席。
include/vsg/commands/ 与 src/vsg/commands/
include/vsg/commands/Draw.h:39-47/DrawIndexed.h:40-49—record()内联在头文件,核心函数直连;DrawIndexed.h:48的vertexOffset是uint32_t。src/vsg/commands/Draw.cpp:18-25/DrawIndexed.cpp:18-25—compare_region横跨连续成员,当前布局无 padding 才成立。include/vsg/commands/DrawIndirectCommand.h:21-49/DrawIndexedIndirectCommand.h:21-52— 两个带has_read_write的 POD,后者vertexOffset用int32_t。src/vsg/commands/DrawIndirect.cpp:17-19— 空默认构造,bufferInfo保持空ref_ptr。src/vsg/commands/DrawIndirect.cpp:35-61—ref_ptr<Buffer> buffer死变量、if (buffer)恒假、:50空指针解引用。src/vsg/commands/DrawIndirect.cpp:89-100/DrawIndexedIndirect.cpp:89-100—compile逐字同型、record无buffer空判。include/vsg/commands/Command.h:22-29的Inherit<Compilable, Command>让record()纯虚;include/vsg/nodes/Compilable.h:22-29同一Compilable基类给compile()空体默认实现。src/vsg/commands/Commands.cpp:52-66—compile与record两条对称循环,无类型过滤。
include/vsg/vk/ 与 src/vsg/vk/
include/vsg/vk/DeviceExtensions.h:47-49/:66— 三个nullptr初值指针,唯一布尔是memory_budget。src/vsg/vk/DeviceExtensions.cpp:27-30/:45-47/:50-81— 有条件取址与裸getProcAddr的四种风格对照。include/vsg/vk/vulkan.h:153-154/:187-251— 重复定义的 structure type 宏与#if VK_HEADER_VERSION < 231补丁区。include/vsg/vk/vulkan.h:199-250— 手写 features / properties /VkDrawMeshTasksIndirectCommandEXT/ 三个 PFN。include/vsg/vk/DeviceFeatures.h:32-51—get<T,type>()模板,:34注释用 NV 版结构名。include/vsg/vk/PhysicalDevice.h:58-71—getProperties<T>()模板,全库唯一使用在RayTracingPipeline.cpp:171。include/vsg/state/BufferInfo.h:54的operator bool()要求buffer.valid()、data.valid()与range != 0,同窗口还有copyDataToBuffer两重载与parent;src/vsg/state/BufferInfo.cpp:217-221是上传链两跳转发。src/vsg/vk/Context.cpp:406-427/:428-588—alignment = 4、#if 1生效分支、#else160 行死代码、:419-420只增不减追加。include/vsg/vk/ResourceRequirements.h:115-141/src/vsg/vk/ResourceRequirements.cpp:119-122— 23 个apply重载无绘制命令、apply(Object)只traverse。
其余目录
include/vsg/state/ShaderStage.h:36-48/src/vsg/state/ShaderStage.cpp:70-91/:170-175—specializationConstants与stage逐字段比较、mask漏掉,stage原样填进stageInfo。src/vsg/utils/ShaderSet.cpp:254-282— 通用variants机制,无 mesh 专用 define。src/vsg/state/GraphicsPipeline.cpp:238-260/:315— 状态无条件apply、零 pipeline cache、三处setCurrentPipelineLayout之一。src/vsg/app/CompileTraversal.cpp:310-313/src/vsg/app/RecordTraversal.cpp:531-545— 编译期与帧期两条通用挂点。src/vsg/io/ObjectFactory.cpp:121-122/:256-260/:320-323— 六个命令与两个数组类型全注册。src/vsg/core/Visitor.cpp:953-961/src/vsg/core/ConstVisitor.cpp:953-961— 三个 meshapply桩降级到Command。include/vsg/all.h:130-135/:340-342—commands/与meshshaders/两段物理分离收录。src/vsg/utils/ComputeBounds.cpp:215-222/src/vsg/utils/Intersector.cpp:232-243— 只处理Draw/DrawIndexed。include/vsg/nodes/Bin.h:26-42/include/vsg/nodes/DepthSorted.h:31-43— 收集后排序与子图指派。src/vsg/nodes/VertexDraw.cpp:150/InstanceDraw.cpp:168/VertexIndexDraw.cpp:188/InstanceDrawIndexed.cpp:206— 四个第七章节点直连核心函数。
可复现验证
以下命令在仓库根目录 VulkanSceneGraph-1.1.16 直接运行,注释写明期望结果。
# 期望:6 行,全部在 meshshaders/,总 340 行;nodes/ 无 mesh 文件
find include src -iname '*mesh*' | sort && wc -l include/vsg/meshshaders/* src/vsg/meshshaders/*
# 期望:两条 grep 均无输出(DrawMeshTasksIndirectCommand 与两个 count 核心函数不存在)
grep -rIl '\bDrawMeshTasksIndirectCommand\b' include src
grep -rIn 'vkCmdDrawIndirectCount\|vkCmdDrawIndexedIndirectCount' include src
# 期望:三个 EXT 调用各 1 行、两个 indirect 各 1 行、Draw/DrawIndexed 内联各 1 行
grep -rIn 'vkCmdDrawMeshTasksEXT(\|vkCmdDrawMeshTasksIndirectEXT(\|vkCmdDrawMeshTasksIndirectCountEXT(\|vkCmdDrawIndirect(\|vkCmdDrawIndexedIndirect(' src include
# 期望:45-47 为裸 getProcAddr;字符串 VK_EXT_mesh_shader 的 supportsDeviceExtension 零命中
sed -n '27,47p' src/vsg/vk/DeviceExtensions.cpp
grep -rIn 'supportsDeviceExtension("VK_EXT_mesh_shader")' include src
# 期望:四处以上 readValue<uint32_t>/writeValue<uint32_t> 命中 offset 或 range
grep -rIn 'readValue<uint32_t>("\|writeValue<uint32_t>("' src/vsg/commands/Draw*.cpp src/vsg/meshshaders/*.cpp
# 期望:看到第 47 行 buffer 声明、第 50 行 bufferInfo->buffer、第 53 行 if (buffer)、第 55 行 create
sed -n '35,61p' src/vsg/commands/DrawIndirect.cpp | cat -n
# 期望:#if 1 / #else / #endif 分别在 416 / 428 / 588;ObjectFactory 六个命令注册行号 257-260 与 321-323
grep -n '#if 1\|#else\|#endif' src/vsg/vk/Context.cpp | head
grep -n 'add<vsg::Draw\|// mesh shading' src/vsg/io/ObjectFactory.cpp
# 期望:正确路径下 RT 与绘制命令零命中;第 26 章标题一行命中 docs/series/README.md:91
grep -n 'Acceleration\|RayTracing\|DrawIndirect\|DrawMeshTasks' include/vsg/vk/ResourceRequirements.h src/vsg/vk/ResourceRequirements.cpp
grep -n '平台与生态' docs/series/README.md
# 期望:字符数在 80000-100000、围栏数为偶数、无追加标记残留
python -c "s=open('docs/series/25-MeshShader与间接绘制.md',encoding='utf-8').read(); print(len(s), s.count(chr(96)*3)%2, ('<!-- APP'+'END -->') in s)"
陷阱表与批判性结论
| 陷阱 | 位置(完整路径:行号) | 触发条件 | 后果 | 规避 |
|---|---|---|---|---|
| 扩展指针空调用 | src/vsg/meshshaders/DrawMeshTasks.cpp:48 | 设备未启用 VK_EXT_mesh_shader | 帧期空函数指针调用崩溃 | 录制前确认三个指针非空并启用扩展 |
| 参数缓冲空解引用 | src/vsg/meshshaders/DrawMeshTasksIndirect.cpp:77 | 默认构造或 compile 未跑 | drawParameters->buffer 为空时崩溃 | 构造即给合法 Data 或 Buffer |
| 双缓冲空解引用 | src/vsg/meshshaders/DrawMeshTasksIndirectCount.cpp:88 | 两块 BufferInfo 任一未就绪 | 帧期空指针 | 编译后逐块校验 buffer.valid() |
range 乘法溢出 | src/vsg/commands/DrawIndirect.cpp:29 | drawCount × stride 超 2³² | 分配范围偏小、GPU 读越界 | 用 VkDeviceSize 显式乘 |
VkDeviceSize 截断 | src/vsg/meshshaders/DrawMeshTasksIndirect.cpp:43 | 偏移或范围超 4 GiB | 序列化回读静默变小 | 改 readValue<VkDeviceSize> |
| 恒假分支死代码 | src/vsg/commands/DrawIndirect.cpp:53 | 任何一次 buffer 型回读 | BufferInfo::create 不执行、offset/range 丢失 | 把 readObject 读进局部 buffer |
默认构造空 bufferInfo | DrawIndirect 的 read 入口 src/vsg/commands/DrawIndirect.cpp:35,空解引用在 :50 | write 的空分支回读 | bufferInfo->buffer 空指针 | 默认构造即 BufferInfo::create() |
vertexOffset 符号性 | include/vsg/commands/DrawIndexed.h:48 | 负顶点偏移 | 命令类与规范/POD 类型不一致 | 统一为 int32_t |
stride 为 0 | include/vsg/commands/DrawIndirect.h:40 | 未显式传 stride | 验证层报错或读取未定义 | 构造时按本机 sizeof 填合法值 |
| 160 行死代码 | src/vsg/vk/Context.cpp:428 | 任何一次上传 | 「已编译跳过」等三道保护失效 | 删除 #if 1 旧分支或恢复早退 |
| 只增不减容器 | src/vsg/vk/Context.cpp:420 | 多 Context 重复编译 | 待拷列表带重复/无效项 | 追加前按 requiresAllocation 去重 |
| 资源预估盲区 | src/vsg/vk/ResourceRequirements.cpp:119 | 场景含间接命令 | 参数缓冲不进 requirements.bufferInfos | 为命令加 apply 重载登记 BufferInfo |
| CPU 求交全盲 | src/vsg/utils/Intersector.cpp:232 | 拾取间接/mesh 绘制 | 无法求交、剔除退化 | 父节点挂保守包围球 |
| 无条件取址 | src/vsg/vk/DeviceExtensions.cpp:45 | 设备不支持该扩展 | 指针保持 nullptr 且无警告 | 加 supportsDeviceExtension 门 |
| 特性零启用 | include/vsg/vk/DeviceFeatures.h:34 | 用户未手工置位 | 管线创建失败或设备行为未定义 | get<...EXT>() 置 taskShader/meshShader |
| 二级命令无缓冲 | vkCmdExecuteCommands,src/vsg/commands/ExecuteCommands.cpp:81 | 所有 SecondaryCommandGraph 都没有 cb | 核心调用被 empty() 跳过、绘制静默缺失 | 确认子图已连接并完成录制 |
| Mesh 目标版本 | minTargetLanguageVersion,src/vsg/utils/ShaderCompiler.cpp:244 | glslang 目标低于 SPIR-V 1.4 | mesh / task 着色器编译失败 | 提升目标语言版本 |
| stage 位不进变体 | s_extensionToStage,src/vsg/io/glsl.cpp:21 | 源文件用 .mesh / .task 后缀 | 位能生成但 ShaderSet 不按位分派 | 自建 ShaderStages 再绑定 |
| 取址返回值丢弃 | getProcAddr,include/vsg/vk/Device.h:70 | 扩展未启用、取址失败 | 返回的 false 被忽略、空指针进 record() | 检查返回值并传 pNameFallback |
| 布局切换重绑 | dirtyStateStacks,src/vsg/vk/CommandBuffer.cpp:62 | PipelineLayout 前后不同 | 全部描述符集被标脏、mesh 下仍触发 | 按 viewID 检查状态栈 |
三条批判性结论
第一,1.1.16 把 VK_EXT_mesh_shader 做成「扩展名、特性结构、属性结构、函数指针、命令对象」五者各自独立、没有一层负责对齐的链,第二十四章 RT 的同类问题不是被修复而是被原样重演。 DeviceExtensions.cpp:45-47 三个裸 getProcAddr 与 :33-40 八个 RT 取址共用同一写法,supportsDeviceExtension("VK_EXT_mesh_shader") 全库零命中;vulkan.h:187-251 手写了四组定义,DeviceFeatures.h:34 的示例却停在 NV 版结构名,feature 启用与 properties 的 getProperties<...>() 查询双双为零,连第二十四章 RayTracingPipeline.cpp:171 那一次属性查询都没有。后果是三个 record()(25.4.2、25.5.2、25.6.3)在扩展未启用时退化为空函数指针调用,在属性超限时又把 groupCountX/Y/Z、drawCount、maxDrawCount、stride 原样透传。用户必须手工完成「加扩展名 → 置 feature → 查属性 → 校验指针 → 裁剪参数」五步,漏一步就崩,框架一句提示都不给。同一份 DeviceExtensions.cpp 里 :27-30、:50-79、:81 三处都写对了协商逻辑,说明作者知道正确写法,只是没有把它应用到 mesh 三个函数上。
第二,本章把第九、十八、二十四章反复出现的「序列化契约破口」收束到一个可对照的双目录样本:meshshaders/ 与 commands/ 各写一套 read/write,一处修了默认构造、一处没修,一处截断是活的、一处被死代码掩盖。 DrawMeshTasksIndirect.cpp:18-21 默认构造主动 BufferInfo::create(),DrawIndirect.cpp:17-19 却是空体,于是 DrawIndirect::read 在 :50 对空 bufferInfo 解引用;:47 的 ref_ptr<Buffer> buffer 从不赋值、:53 的 if (buffer) 恒假、:55 的重建分支是死代码,:51-52 的 uint32_t 截断因此落在永不执行的代码上;mesh 侧 DrawMeshTasksIndirect.cpp:43-44/57-58 与 DrawMeshTasksIndirectCount.cpp:39/47/58/68 共 12 处截断是活的。两组类都重写 read/write、都进 ObjectFactory.cpp:257-260/321-323、都有 Visitor 桩,看似契约齐全,实际是四份手抄、四种偏差。第二十四章 DescriptorAccelerationStructure 的 src/vsg/raytracing/DescriptorAccelerationStructure.cpp:29 只清空 _accelerationStructures、漏序列化整个列表,第九章 ShaderStage::compare 漏 mask,本章是类型选窄加分支永不进入;共同点是没有复用统一的序列化与比较基类,每加一个类就重抄一遍,改一处漏三处。
第三,编译期上传、资源预估、CPU 求交、Bin 排序四条链在六个命令上没有一层负责对齐:缓冲真被分配了,却既不进资源预估,也不进包围盒与拾取,排序仍按单个 CPU 深度值处理 GPU 展开的 N 次绘制。 compile() 经 createBufferAndTransferData → Context.cpp:417 的 reserve 真分配设备本地显存,:419-420 把 bufferInfoList 无条件追加进 bufferInfosToCopy,而 CollectResourceRequirements 的 23 个 apply(ResourceRequirements.h:115-137)无绘制命令入口,apply(const Object&)(ResourceRequirements.cpp:119-122)只 traverse、够不到 ref_ptr<BufferInfo> 成员;ComputeBounds / Intersector 只认 Draw / DrawIndexed(ComputeBounds.cpp:215-222、Intersector.cpp:232-243);Bin::add(State*, double, const Node*)(include/vsg/nodes/Bin.h:42,同窗口 binNumber / sortOrder 决定排序)按一个值收一个元素,与 DrawMeshTasksIndirectCount 由计数缓冲决定的绘制数不一一对应。框架完全可以在 CollectResourceRequirements 加 apply(const Command&) 登记 BufferInfo,也可以让用户挂保守包围球并写进文档,但 1.1.16 两者都没做。第二十四章把 RT 的缺席归结为「责任落在调用方自律」,本章更具体:责任落在五步手动扩展配置、四份手工序列化、三种 CPU 侧补偿上,文档没有说清楚。
四条可核验的硬结论
其一,三个 mesh record() 的崩溃不是「扩展没开」的泛泛而论,而是一条可定位到具体返回值的断链。 include/vsg/vk/Device.h:70 的 getProcAddr 返回 bool,同文件 :68 的注释写明「扩展未启用时 vkGetDeviceProcAddr 必返回 nullptr」,模板还提供 pNameFallback 备用名;而 src/vsg/vk/DeviceExtensions.cpp:45-47 三行裸调用既丢弃返回的 bool,也不传备用名。三个函数指针保持 nullptr 后,src/vsg/meshshaders/DrawMeshTasks.cpp:48 直接把它当函数地址调用,另外两个 record() 再叠两级 BufferInfo 空解引用。对比 src/vsg/commands/ExecuteCommands.cpp:79-82:同样发 Vulkan 核心调用,却先 _latch->wait() 同步、再用 if (!vk_commandBuffers.empty()) 守卫。能力在框架里,接线不在。
其二,mesh / task 的 stage 位有生成器,先前「零命中」的断言只在你查 ShaderSet 时成立。 src/vsg/io/glsl.cpp:28-29 把 .mesh / .task 后缀映射进 s_extensionToStage,src/vsg/utils/ShaderCompiler.cpp:156-157 给出友好名,:244 把 MESH 位接到 EShLangMesh 并要求 SPIR-V 1.4。全局八行命中里只有两行是 vulkan.h:193-194 的宏定义。所以真正缺口是 src/vsg/utils/ShaderSet.cpp:254-282 的 getShaderStages 按 ShaderCompileSettings 生成变体时,只复制 new_stage->stage = stage->stage,没有 mesh 专用 define 或 stage 分派;「能编译」与「能通过 ShaderSet 建出 mesh 管线」是两件事。
其三,ExecuteCommands 证明同目录的 Command 子类完全可以做对空判与同步,问题在 mesh 命令没抄这套写法。 它的 reset() 在 std::scoped_lock 下把 _latch 设为连接数并清空全部 cb,completed() 以 count_down() 放行,record() 先 wait() 再收集非空 cb,最后才调 vkCmdExecuteCommands。六个绘制命令没有一个 _mutex,也没有 wait():它们把「缓冲是否已就绪」的判定推给调用方,而 CreateBufferAndTransferData 的 bool 又被四个 compile() 丢弃。两套写法共享同一个 Command 基类,差异不在类型系统,而在实现纪律。
其四,资源预估的兜底路径结构性地够不到间接参数缓冲,加 hints 也绕不过去。 src/vsg/vk/ResourceRequirements.cpp:124-136 的 checkForResourceHints 只查 object.getObject<ResourceHints>("ResourceHints");间接命令的参数在 ref_ptr<BufferInfo> 成员 drawParameters / bufferInfo 里,既不是 ResourceHints 附加对象,也不是 Object::traverse 会访问的子节点。于是 apply(const Object&) 的 object.traverse(*this) 对它们无能为力,而 compile() 却经 Context.cpp:417 真分配了显存。预估与分配走的是两条数据统计链,这是本章与第 24 章「责任落在调用方」最不同的一处:框架有统一的 BufferInfo 类型,却没在Visitor 层登记它。
下章预告
下一章对齐 docs/series/README.md:91 的表格行「第 26 章 平台与生态:win32/xcb/macOS/iOS/Android/Harmony」,核心模块 platform/,要回答的问题是「窗口与表面如何抽象」。本章七个绘制调用点全部落在 command buffer 层,grep -rIn 'DrawMeshTasks\|DrawIndirect' include/vsg/platform src/vsg/platform 零命中——绘制命令在平台层之下,平台层只管窗口、表面与事件,这层分界是下一章的起点。第二十四章末尾从 RT 移到绘制,本章从绘制移到落地,先给六个具体问题:
- 第 1 章
01-全景与底色.md:167说include/vsg/platform/下按win32/xcb/macos/ios/android/harmony六个平台各有一个*_Window.cpp实现同一套Window接口;下一章要实测六个文件的真实存在性、wc -l行数,以及CMakeLists.txt里:193、:203那两段按平台条件追加SOURCES的分支,与本章commands/34 头 / 31 实现的目录清点做同一手法的核对。 - 本章 25.11 证实
DeviceExtensions在win32/xcb等不同实例扩展集合下无条件取三个 mesh 函数指针;下一章要查Window创建VkSurfaceKHR时各平台分别启用哪些 instance extension(VK_KHR_win32_surface/VK_KHR_xcb_surface/VK_MVK_macos_surface等),这些扩展名是否也像VK_EXT_mesh_shader一样只在补丁区定义、有没有对应的supportsInstanceExtension检查,与第六章实例扩展协商如何对应。 - 本章 25.15 证实
GraphicsPipeline按viewID分实现、由CompileTraversal在编译期注入RenderPass/ViewportState;下一章要看窗口extent2D、VkSurfaceCapabilitiesKHR、VK_PRESENT_MODE_*与交换链重建如何沿第十三章视图、第十五章提交与呈现、第十六章同步原语一路传到WindowResizeHandler(第九章:211的两条重建路径),六个平台在这条链上各改了哪一段。 - 本章 25.16 证实
CollectResourceRequirements对间接命令零专用分派;下一章要类比检查多平台、多deviceID/ 多窗口场景下Context的contexts容器(CompileTraversal.cpp:310-313的循环)如何被填充,平台相关对象是否像本章 mesh 命令一样「有注册、无预估」,还是另有一套窗口资源统计。 - 本章 25.12.4 把 ABI 与属性数值交给本机 SDK 测量程序;下一章要给一个跨平台
sizeof/offsetof/ 宏开关(VK_USE_PLATFORM_WIN32_KHR等)的测量清单,明确哪些数字依赖本机平台 SDK、哪些依赖窗口系统 ABI,避免把任一平台的字节数写死。 - 本章 25.17 指出新增一个 mesh 命令要同步改
all.h/ObjectFactory.cpp/Visitor.cpp/ConstVisitor.cpp/CMakeLists.txt五处;下一章要数清新增一个平台需要同步改几处(CMake 条件、Window::create工厂、all.h、平台宏),并对比两种扩展成本,回答「窗口与表面如何抽象」在 1.1.16 里究竟是一套接口还是六个#ifdef分支。
下一章把镜头从「新一代几何管线如何被接入命令图并被间接驱动」移到「这套命令图最终落在哪块窗口与表面上」,看 platform/ 在同样的扩展协商、条件编译、资源统计约束下回答落地侧的边界。