Vulkan 着色器修改指南

环境准备

  1. 安装 Vulkan SDK
    确保 spirv-cross 和 glslc 工具已加入系统 PATH 环境变量

操作步骤

  1. 启用着色器导出
    在 config.toml 中设置： 

    1. dumpShaders = true

  2. 反编译 SPIR-V 着色器
    执行命令将二进制着色器转为可读 GLSL： 

    1. spirv-cross -V fs_0x000000.spv --output fs_0x000000.glsl

  3. 编辑着色器代码
    用文本编辑器修改生成的 .glsl 文件

  4. 重新编译为 SPIR-V
    根据着色器类型选择编译参数（示例为片段着色器）： 

    1. glslc --target-env=vulkan1.3 --target-spv=spv1.6 \
    2.       -fshader-stage=frag fs_0x000000.glsl \
    3.       -o fs_0x000000.spv

  5. 部署修改后的着色器
    将生成的 .spv 文件放入： 

    1. shader/patch/

    保持文件名与原始文件一致

  6. 启用着色器补丁
    在 config.toml 中启用： 

    1. patchShaders = true

注意事项

• 顶点着色器需使用 -fshader-stage=vert 参数 • SPIR-V 1.6 对应 Vulkan 1.3 规范 • 修改复杂着色器时建议保留原始文件备份 • 确保 GLSL 代码符合 Vulkan 规范（如显式声明版本）