The DirectX Shader Compiler project includes a compiler and related tools used to compile High-Level Shader Language (HLSL) programs into DirectX Intermediate Language (DXIL) representation. Applications that make use of DirectX for graphics, games, and computation can use it to generate shader programs.

The project evolves by supporting newShader Models, which reflect capabilities of underlying hardware and drivers, andLanguage Versions, which reflect capabilities of the compiler toolchain.

The starting point of the project is a fork of theLLVM andClang projects, modified to accept HLSL and emit a validated container that can be consumed by GPU drivers.

At the moment, the DirectX HLSL Compiler provides the following components:

• dxc.exe, a command-line tool that can compile HLSL programs for shader model 6 and beyond

• dxcompiler.dll, a DLL providing a componentized compiler, assembler, disassembler, and validator

• various other tools based on the above components

The Microsoft Windows SDK releases include supported versions of the compiler and validator.

The goal of the project is to allow the broader community of shader developers to contribute to the language and representation of shader programs, maintaining the principles of compatibility and supportability for the platform. It's currently in active development across two axes: language evolution (with no impact to DXIL representation), and surfacing hardware capabilities (with impact to DXIL, and thus requiring coordination with GPU implementations).Candidate feature lists for both language and hardware evolution are included on theRoadmap page.

• Build the compiler.
• Run the tests that verify the compiler built correctly.
• Compile shaders and samples with your new compiler.

To make contributions, see theContributing.md file in this project.

You can find documentation for this project in the docs/ directory. These contain the original LLVM documentation files, as well as some new files worth noting:

• HLSLChanges.rst:this is the starting point for how this fork diverges from the original llvm/clang sources
• DXIL.rst:this file contains the specification for the DXIL format
• tools/clang/docs/UsingDxc.rst:this file contains a user guide for dxc.exe

Additional documentation is available on the Wiki:

• Shader Model andLanguage version information
• More information onPorting shaders from FXC to DXC or try theD3DCompiler DXC Bridge.
• Releases.

This project has adopted theMicrosoft Open Source Code of Conduct. For more information see theCode of Conduct FAQ or contactopencode@microsoft.com with any additional questions or comments.