HLSL Decompiler 使用教程

HLSL Decompiler 使用教程

HLSLDecompiler HLSL Decompiler forked from 3Dmigoto 项目地址: https://gitcode.com/gh_mirrors/hl/HLSLDecompiler

1. 项目的目录结构及介绍

HLSLDecompiler/
├── BinaryDecompiler/
│   └── ...（二进制反编译相关文件）
├── D3D_Shaders/
│   └── ...（Direct3D 着色器相关文件）
├── HLSLDecompiler/
│   ├── hlsl_decompiler_wrapper.bat
│   ├── log.h
│   ├── shader.h
│   ├── util.h
│   ├── util_min.h
│   └── version.h
├── .gitignore
├── LICENSE
├── README.md
├── StereovisionHacks/
│   ├── sdf
│   ├── sln
│   └── suo
└── cmd_Decompiler.exe

目录结构说明

• BinaryDecompiler: 包含与二进制反编译相关的文件和工具。
• D3D_Shaders: 包含与 Direct3D 着色器相关的文件。
• HLSLDecompiler: 核心目录，包含主要的反编译工具和源代码。
  • hlsl_decompiler_wrapper.bat: 反编译工具的批处理脚本。
  • log.h, shader.h, util.h, util_min.h, version.h: 项目相关的头文件。
• .gitignore: Git 忽略文件，指定哪些文件和目录不应被 Git 跟踪。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文件。
• StereovisionHacks: 包含与立体视觉相关的文件。
• cmd_Decompiler.exe: 反编译工具的可执行文件。

2. 项目的启动文件介绍

hlsl_decompiler_wrapper.bat

该文件是一个批处理脚本，用于调用反编译工具 cmd_Decompiler.exe。通过该脚本，用户可以方便地进行着色器反编译操作。

使用方法：

1. 将 hlsl_decompiler_wrapper.bat 和 cmd_Decompiler.exe 放在同一目录下。
2. 在命令行中运行 hlsl_decompiler_wrapper.bat 并传入需要反编译的文件路径。

3. 项目的配置文件介绍

README.md

该文件是项目的说明文档，包含项目的基本介绍、使用方法以及集成到 RenderDoc 的步骤。

主要内容包括：

• 项目简介：简要介绍 HLSL Decompiler 的功能和用途。
• 使用方法：
  • 如何将工具集成到 RenderDoc。
  • 如何使用反编译工具进行着色器反编译。
  • 如何编辑反编译后的源代码并查看效果。

集成到 RenderDoc 的步骤：

1. 将 hlsl_decompiler_wrapper.bat 和 cmd_Decompiler.exe 放在同一目录下。
2. 打开 RenderDoc，进入 Tools -> Settings -> Shader Viewer。
3. 添加自定义工具，设置工具类型为 Custom Tool，并指定 hlsl_decompiler_wrapper.bat 的绝对路径。
4. 在 Command Line 中输入 [input_file]。
5. 设置输入/输出格式为 DXBC/HLSL。
6. 在 Pipeline State View 中选择任意着色器阶段，点击 Edit -> Decompile with $[Name]。
7. 修改着色器代码后，点击 Refresh 按钮查看更改效果。

通过以上步骤，用户可以方便地将 HLSL Decompiler 集成到 RenderDoc 中，进行着色器的反编译和分析。

HLSLDecompiler HLSL Decompiler forked from 3Dmigoto 项目地址: https://gitcode.com/gh_mirrors/hl/HLSLDecompiler