| commit | cfc8ba0c18fc634b9484d3b34fac3bfa0f9076d9 | [log] [tgz] |
|---|---|---|
| author | Greg Roth <grroth@microsoft.com> | Wed Jul 17 21:13:26 2024 |
| committer | GitHub <noreply@github.com> | Wed Jul 17 21:13:26 2024 |
| tree | f40e0ed373b159a0563d92f3ddd5225df355c2af | |
| parent | 2f29f1705266fb40c5ea932be5e025eb772fe8fc [diff] |
Add tests for literal overloads of fmod, length, and normalize (#6437) (#6799) Certain HL ops with no double overload will generate double overloads for literal types. These are lowered to double DXIL overloads, some of which are not legal for these ops. We currently rely on illegal intermediate DXIL op overloads for constant evaluation. If constant evaluation fails, we end up with illegal DXIL overloads in final DXIL, which is caught by the validator. The prior revert restored the ability to run these scenarios (with asserts disabled). This change adds tests for #6419 so automated testing will test across configurations and prevent regressions of this scenario in this branch. (cherry picked from commit 9c2b82878e3c52367d4be2d3bf7ee8bd49763483) Co-authored-by: Tex Riddell <texr@microsoft.com>
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.
Visit the DirectX Landing Page for more resources for DirectX developers.
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
dxilconv.dll, a DLL providing a converter from DXBC (older shader bytecode format)
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).
Development kits containing only the dxc.exe driver app, the dxcompiler.dll, and the dxil.dll signing binary are available here, or in the releases tab.
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 DXC requires:
Building on windows additionally requires:
A new experimental simplified build and test workflow is documented here.
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.
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. If your system doesn't have the requisite association for .js files, this may not work. If so, open a cmd window and invoke: wscript.exe utils\hct\hctshortcut.js.
Tests are built using the TAEF framework which is included in the Windows Driver Kit.
To build, run this command on the HLSL Console.
hctbuild
You can also run tests with this command.
hcttest
To see a list of additional commands available, run hcthelp
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 execute these shaders. See the next section on how this should be currently set up.
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 GPU support for DXIL is provided by the following vendors:
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’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'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:
To make contributions, see the CONTRIBUTING.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 two new files worth nothing:
DirectX Shader Compiler is distributed under the terms of the University of Illinois Open Source License.
See LICENSE.txt and ThirdPartyNotices.txt for details.
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.