37ed613864
This change applies clang-format to all of the sources added in DXC that were not part of the original LLVM/Clang 3.7 release when DXC forked. This provides consistent code formatting across the codebase. Fixes #5591. |
||
|---|---|---|
| .. | ||
| runtime | ||
| CMakeLists.txt | ||
| DxrFallbackCompiler.cpp | ||
| FunctionBuilder.h | ||
| LLVMBuild.txt | ||
| LLVMUtils.cpp | ||
| LLVMUtils.h | ||
| LiveValues.cpp | ||
| LiveValues.h | ||
| Reducibility.cpp | ||
| Reducibility.h | ||
| StateFunctionTransform.cpp | ||
| StateFunctionTransform.h | ||
| readme.md | ||
| runtime.h | ||
readme.md
DXR Fallback Compiler
The DXR Fallback Compiler is a specialized compiler that's a part of the D3D12 Raytracing Fallback Layer. The purpose of the DXR Fallback Compiler is to take input DXR shader libs and link them into a single compute shader that is runnable DX12 hardware (even without DXR driver support).
Building the DXR Fallback Compiler
In order to build the DXR Fallback Compiler in Visual Studio, simply build the dxrfallbackcompiler project in the Clang Libraries folder.
Using with the D3D12 Raytracing Fallback Layer
To use the DXR Fallback Compiler with the DirectX Graphics Samples, build a dxrfallbackcompiler.dll using the Build instructions and place the output dll in Samples/Desktop/D3D12Raytracing/tools/x64.
If you're incorporating the Fallback Layer into your own personal project, you need to ensure that the dll is either alongside your executable or in the working directory.
Overview
Note that the below overview and all proceeding documentation assumes familiarity with the DirectX Raytracing API.
The DXR Fallback Compiler addresses several challenges that native DX12 compute shaders are not normally capable of handling:
- Combining multiple orthogonal shaders into a single large compute shader
- Uses of all new DXR HLSL intrinsics
- Invocation of another shader in the middle of shader code - i.e. TraceRay and CallShader
- Recursive invocations of shader calls
These challenges are handled by abstractly viewing GPU execution of a DXR pipeline as State Machine traversal, where each shader is transformed into one or more state functions. further technical details are described in the header of StateFunctionTransform.h.
Building runtime.h
Download LLVM 3.7: http://releases.llvm.org/3.7.0/LLVM-3.7.0-win64.exe You may need to adjust BINPATH in script.cmd to point to your llvm binaries Run script.cmd and it should output a patched runtime.h