This repo hosts the source for the DirectX Shader Compiler which is based on LLVM/Clang.
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 247 commits behind Microsoft:master.
ehsannas [linux-port] Do not use llvm DynamicLibrary in dxcapi.use.h (#1527)
Fixes #1525

This CL changes dxcapi.use.h back to what it was before the Linux-port work. It does, however, add a snippet into it to redirect FreeLibrary to dlcose, LoadLibraryW to dlopen, and GetProcAddress to dlsym for non-Windows platforms.
Latest commit a2085d4 Sep 6, 2018
Permalink
Failed to load latest commit information.
.vs Fix building with VS 2017 integrated cmake (#279) May 9, 2017
autoconf [linux-port] Update CMake files. prepare for Linux. (#1312) May 29, 2018
cmake Update to VS 2017 and CMake 3.11.2 (#1347) Jun 9, 2018
docs [spirv] Add mechanism for fine-grained control of debug info (#1518) Aug 29, 2018
examples Clean up mistakes made when fixing copyright banners. Jan 25, 2017
external [spirv] Update SPIRV-Tools for bugfixes and workarounds (#1510) Aug 23, 2018
include [linux-port] Do not use llvm DynamicLibrary in dxcapi.use.h (#1527) Sep 6, 2018
lib [linux-port] Do not use llvm DynamicLibrary in dxcapi.use.h (#1527) Sep 6, 2018
projects Revert license text in banner comments to original llvm verbage (#33) Jan 25, 2017
resources first commit Dec 28, 2016
test Revert license text in banner comments to original llvm verbage (#33) Jan 25, 2017
tools [spirv] Stop emitting commit count (#1524) Sep 5, 2018
unittests Revert license text in banner comments to original llvm verbage (#33) Jan 25, 2017
utils Include one single copy of Git commit information Aug 27, 2018
.clang-format first commit Dec 28, 2016
.clang-tidy first commit Dec 28, 2016
.gitignore [spirv] Use git submodules for SPIR-V dependency projects (#455) Jul 24, 2017
.gitmodules [spirv] Use git submodules for SPIR-V dependency projects (#455) Jul 24, 2017
.travis.yml [ci] Checkout full history for correct commit count in version (#1488) Aug 3, 2018
CMakeLists.txt [spirv] Do not build tests by default and hook up with ctest (#1394) Jun 29, 2018
CMakeSettings.json Clean up crlf and mixed line ending issues. (#391) Jun 29, 2017
CONTRIBUTING.md first commit Dec 28, 2016
LICENSE.TXT Revert license text in banner comments to original llvm verbage (#33) Jan 25, 2017
LLVMBuild.txt Revert license text in banner comments to original llvm verbage (#33) Jan 25, 2017
README.md [linux-port] Enable Travis Linux and macOS bots. (#1407) Jul 9, 2018
ThirdPartyNotices.txt Add heading text for ThirdPartyNotices.txt Feb 25, 2017
appveyor.yml [appveyor] Clone the whole history (#1365) Jun 21, 2018

README.md

DirectX Shader Compiler

Build status Build Status

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.

For more information, see the Wiki.

Features and Goals

The starting point of the project is a fork of the LLVM and Clang 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.0 or higher

  • 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 a supported version 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).

SPIR-V CodeGen

As an example of community contribution, this project can also target the SPIR-V intermediate representation. Please see the doc for how HLSL features are mapped to SPIR-V, and the wiki page for how to build, use, and contribute to the SPIR-V CodeGen.

Building Sources

Note: Instead of building manually, you can download the artifacts built by Appveyor for the latest master branch at here.

Note: If you intend to build from sources on Linux/macOS, follow these instructions.

Before you build, you will need to have some additional software installed. This is the most straightforward path - see Building Sources on the Wiki for more options, including Visual Studio 2015 and Ninja support.

  • Git.
  • Visual Studio 2017. Select the following workloads: Universal Windows Platform Development and Desktop Development with C++.
  • Python. Version 2.7.x is required, 3.x might work but it's not officially supported. You need not change your PATH variable during installation.

After cloning the project, you can set up a build environment shortcut by double-clicking the utils\hct\hctshortcut.js file. This will create a shortcut on your desktop with a default configuration.

Tests are built using the TAEF framework. Unless you have the Windows Driver Kit installed, you should run the script at utils\hct\hctgettaef.py from your build environment before you start building to download and unzip it as an external dependency. You should only need to do this once.

To build, run this command on the HLSL Console.

hctbuild

You can also clean, build and run tests with this command.

hctcheckin

To see a list of additional commands available, run hcthelp

Running Tests

To run tests, open the HLSL Console and run this command after a successful build.

hcttest

Some tests will run shaders and verify their behavior. These tests also involve a driver that can run these execute these shaders. See the next section on how this should be currently set up.

Running Shaders

To run shaders compiled as DXIL, you will need support from the operating system as well as from the driver for your graphics adapter. Windows 10 Creators Update is the first version to support DXIL shaders. See the Wiki for information on using experimental support or the software adapter.

Hardware Support

Hardware GPU support for DXIL is provided by the following vendors:

NVIDIA

NVIDIA's r396 drivers (r397.64 and later) provide release mode support for DXIL 1.1 and Shader Model 6.1 on Win10 1709 and later, and experimental mode support for DXIL 1.2 and Shader Model 6.2 on Win10 1803 and later. These drivers also support DXR in experimental mode.

Drivers can be downloaded from geforce.com.

AMD

AMD’s driver (Radeon Software Adrenalin Edition 18.4.1 or later) provides release mode support for DXIL 1.1 and Shader Model 6.1. Drivers can be downloaded from AMD's download site.

Intel

Intel's 15.60 drivers (15.60.0.4849 and later) support release mode for DXIL 1.0 and Shader Model 6.0 as well as release mode for DXIL 1.1 and Shader Model 6.1 (View Instancing support only).

Drivers can be downloaded from the following link Intel Graphics Drivers

Direct access to 15.60 driver (latest as of of this update) is provided below:

Installer

Release Notes related to DXIL

Making Changes

To make contributions, see the CONTRIBUTING.md file in this project.

Documentation

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

License

DirectX Shader Compiler is distributed under the terms of the University of Illinois Open Source License.

See LICENSE.txt and ThirdPartyNotices.txt for details.

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.