Technique:Compiled GPU shader formats
| On this wiki | Facts · Code · Notes · Topics |
|---|
Which binary shader and GPU program formats turn up inside games and apps, how to recognise each by its first bytes, and which have no portable format at all (driver-specific GLSL program binaries).
Recognition table
- Format:SPIR-V (Vulkan, OpenCL): word 0x07230203, bytes 03 02 23 07.
- Format:DXBC (Direct3D 10/11, and the container of D3D12 shaders): ASCII 'DXBC'.
- Format:DXIL (Shader Model 6): a part named DXIL inside a DXBC container, program header then LLVM bitcode ('BC' C0 DE, or wrapper 0x0B17C0DE).
- Format:D3D9 shader bytecode: first dword 0xFFFE03xx (vertex) / 0xFFFF03xx (pixel), ends with 0x0000FFFF.
- Format:Metal library: 'MTLB'.
- Format:CUDA fatbin and cubin: ELF with EM_CUDA, or a fatbin with 0xBA55ED50; host wrapper magic 0x466243B1.
- Format:AMDGPU code object: ELF with e_machine 224.
- GLSL / OpenGL source: plain text; many games ship it uncompiled or inside engine archives.
Formats with no portable layout
OpenGL program binaries (glGetProgramBinary, glProgramBinary; ARB_get_program_binary) have no portable format: the blob is defined by the driver, depends on GPU and driver version, and engines only cache it, so it is not a shipped asset format. Games that need portability ship source text or SPIR-V. Vulkan pipeline caches (VkPipelineCache data) are likewise vendor blobs behind a small standard header. Unverified: both statements are from the specifications as I remember them, not from a source I read.
Engine wrappers
Engines wrap shaders in their own containers (for example Unreal's shader code libraries and IoStore chunk types, see Fact:Unreal IoStore/enum/chunk types UE5, or Unity's Shader assets). Strip the wrapper first, then identify the payload with the table above.
Approach
- Search the files for the magics above (a sliding scan, also inside decompressed archives).
- Identify the producing compiler: SPIR-V generator id, DXBC 'VERS' part or compiler comment in the CTAB, AMDGPU notes.
- Use the matching open disassembler (SPIRV-Tools, vkd3d-shader, LLVM) rather than reading tokens by hand.
Code & repositories
- https://github.com/KhronosGroup/SPIRV-Headers @
86f980c731e62ae4eaf383d320449d71687936bf· license: MIT (declared by the contributor for the files used; GitHub reports MIT (read from LICENSE; GitHub's detector did not classify it) for the repository)
Official SPIR-V headers, grammar JSON and the registry of generator tool ids (spir-v.xml).
Tested on: source read, not run: read only · checked 2026-10-19; last activity 2026-10-02