《VulkanSceneGraph 1.1.16 源码深度解析》第二十五章 Mesh Shader 与间接绘制

0 阅读1小时+

《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.h39三个 groupCount 默认值、无 compile 重载的帧期命令声明
include/vsg/meshshaders/DrawMeshTasksIndirect.h43drawParameters / drawCount / stride 三字段与三种构造
include/vsg/meshshaders/DrawMeshTasksIndirectCount.h42drawCount 是 BufferInfo 而非数量、maxDrawCount 上限
src/vsg/meshshaders/DrawMeshTasks.cpp49record():44-49 无空判调 vkCmdDrawMeshTasksEXT
src/vsg/meshshaders/DrawMeshTasksIndirect.cpp78record():73-78、compile():65-71、read/write 截断
src/vsg/meshshaders/DrawMeshTasksIndirectCount.cpp89双 BufferInfo 上传、record():84-89 六参顺序
include/vsg/commands/DrawIndirect.h44bufferInfo 命名、drawCount / stride 默认 0
include/vsg/commands/DrawIndexedIndirect.h44与 DrawIndirect.h 逐字同型的字段布局
include/vsg/commands/DrawIndirectCommand.h51VkDrawIndirectCommand 的 POD 包装与 has_read_write
include/vsg/commands/DrawIndexedIndirectCommand.h54vertexOffset 正确使用 int32_t 的 POD 包装
include/vsg/commands/Command.h33Inherit<Compilable, Command>、record() 纯虚
include/vsg/commands/Commands.h64Children 容器与 compile / record 双声明
src/vsg/commands/DrawIndirect.cpp100read():35-61 死代码、空指针、uint32_t 截断
src/vsg/commands/DrawIndexedIndirect.cpp100与上一行逐字同型的第二处缺陷
src/vsg/commands/Commands.cpp66compile():52-58 / record():60-66 两条通用链
include/vsg/vk/DeviceExtensions.h70:47-49 三个 mesh 函数指针声明
src/vsg/vk/DeviceExtensions.cpp82:45-47 无条件取址、:27-30/50-81 有条件取址对照
include/vsg/vk/vulkan.h1231#if VK_HEADER_VERSION < 231 补丁区 :187-251
src/vsg/vk/Context.cpp599:406-588 上传链、#if 1 死代码、bufferInfosToCopy
src/vsg/state/GraphicsPipeline.cpp326Implementation():226-268 无条件 apply 全部状态
include/vsg/vk/ResourceRequirements.h149:115-137 无绘制命令专用 apply 重载
src/vsg/vk/ResourceRequirements.cpp418:119-122 apply(Object) 只 traverse 的兜底
src/vsg/core/Visitor.cpp1156:953-961 三个 mesh apply 桩降级到 Command
src/vsg/core/ConstVisitor.cpp1156:953-961 与 Visitor.cpp 对称的三个桩
src/vsg/io/ObjectFactory.cpp375:257-260/321-323 六个命令注册、:320 分节注释
include/vsg/all.h342:130-135 与 :340-342 两处物理分离的收录
src/vsg/app/CompileTraversal.cpp479:310-313 apply(Commands&) 通用编译分派
src/vsg/app/RecordTraversal.cpp704:531-545 帧期 Commands / Command 分派
include/vsg/nodes/Bin.h74:26-38 SortOrder / binNumber 收集后排序
include/vsg/nodes/DepthSorted.h53: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硬缺陷
3Mesh 不引入第四条管线创建路径;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接口边界
5VkPhysicalDeviceMeshShaderPropertiesEXT 的 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硬缺陷
7read/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硬缺陷
8DrawIndirect::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:35src/vsg/commands/DrawIndirect.cpp:35硬缺陷
9Context::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硬缺陷
10stride 默认 0 且无最小值、4 字节倍数、上界校验;range = in_drawCount * in_stride 是两个 uint32_t 相乘后隐式提升为 VkDeviceSize,乘法本身已溢出;DrawIndexed::vertexOffset 声明 uint32_t 而 Vulkan 规范与 DrawIndexedIndirectCommand 用 int32_tsrc/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:41vkCmdDrawcommandBuffer, vertexCount, instanceCount, firstVertex, firstInstance核心函数
include/vsg/commands/DrawIndexed.h:42vkCmdDrawIndexedcommandBuffer, indexCount, instanceCount, firstIndex, vertexOffset, firstInstance核心函数
src/vsg/commands/DrawIndirect.cpp:99vkCmdDrawIndirectcommandBuffer, buffer, offset, drawCount, stride核心函数
src/vsg/commands/DrawIndexedIndirect.cpp:99vkCmdDrawIndexedIndirectcommandBuffer, buffer, offset, drawCount, stride核心函数
src/vsg/meshshaders/DrawMeshTasks.cpp:48vkCmdDrawMeshTasksEXTcommandBuffer, groupCountX, groupCountY, groupCountZDeviceExtensions 指针
src/vsg/meshshaders/DrawMeshTasksIndirect.cpp:77vkCmdDrawMeshTasksIndirectEXTcommandBuffer, buffer, offset, drawCount, strideDeviceExtensions 指针
src/vsg/meshshaders/DrawMeshTasksIndirectCount.cpp:88vkCmdDrawMeshTasksIndirectCountEXTcommandBuffer, buffer, offset, countBuffer, countBufferOffset, maxDrawCount, strideDeviceExtensions 指针

另有四个节点直连调用: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 生效分支、#else 160 行死代码、: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 — 三个 mesh apply 桩降级到 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:29drawCount × 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
默认构造空 bufferInfoDrawIndirect 的 read 入口 src/vsg/commands/DrawIndirect.cpp:35,空解引用在 :50write 的空分支回读bufferInfo->buffer 空指针默认构造即 BufferInfo::create()
vertexOffset 符号性include/vsg/commands/DrawIndexed.h:48负顶点偏移命令类与规范/POD 类型不一致统一为 int32_t
stride 为 0include/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:244glslang 目标低于 SPIR-V 1.4mesh / 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:62PipelineLayout 前后不同全部描述符集被标脏、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/ 在同样的扩展协商、条件编译、资源统计约束下回答落地侧的边界。