- Notifications
You must be signed in to change notification settings - Fork29
License
NVIDIA-RTX/Donut-Samples
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
This repository provides a collection of example applications built using theDonut framework.
| Application | DX11 | DX12 | VK | Description |
|---|---|---|---|---|
| Feature Demo | ✅ | ✅ | ✅ | A demo application that shows most of the raster-based features and effects available. |
| Basic Triangle | ✅ | ✅ | ✅ | The most basic example that draws a single triangle. |
| Bindless Ray Tracing | ✅ | ✅ | Renders a scene using ray tracing, starting from primary rays, and using bindless resources. Includes skeletal animation. | |
| Bindless Rendering | ✅ | ✅ | Renders a scene using bindless resources for minimal CPU overhead. | |
| Deferred Shading | ✅ | ✅ | ✅ | Draws a textured cube into a G-buffer and applies deferred shading to it. |
| Headless Device | ✅ | ✅ | ✅ | Tests operation of a graphics device without a window by adding some numbers. |
| Meshlets | ✅ | ✅ | Renders a triangle using meshlets. | |
| Ray Traced Particles | ✅ | ✅ | Renders a particle system using ray tracing in an environment with mirrors. | |
| Ray Traced Reflections | ✅ | Rasterizes the G-buffer and renders basic ray traced reflections. Materials are accessed using local root signatures. | ||
| Ray Traced Shadows | ✅ | ✅ | Rasterizes the G-buffer and renders basic ray traced directional shadows. | |
| Ray Traced Triangle | ✅ | ✅ | Renders a triangle using ray tracing. | |
| Shader Specializations | ✅ | Renders a few triangles using different specializations of the same shader. | ||
| Threaded Rendering | ✅ | ✅ | Renders a cube map view of a scene using multiple threads, one per face. | |
| Variable Shading | ✅ | ✅ | Renders a scene with variable shading rate specified by a texture. | |
| Vertex Buffer | ✅ | ✅ | ✅ | Creates a vertex buffer for a cube and draws the cube. |
| Work Graphs | ✅ | Demonstrates the new D3D12 work graphs API via a tiled deferred shading renderer that dynamically chooses shaders for each screen tile. Requires DXC with shader model 6.8 support. |
Same as therequirements for Donut.
Clone the repositorywith all submodules:
git clone --recursive <URL>Create a build folder.
cd donut_examples && mkdir build && cd build- Any name works, but git is configured to ignore folders named 'build*'
- This folder should be placed under directory created by 'git clone' in step #1
Use CMake to configure the build and generate the project files.
- Linux:
cmake .. - Windows: use of CMake GUI is recommended. Make sure to select the x64 platform for the generator.
- Linux:
Build the solution generated by CMake in the build folder.
- Linux:
make -j8(example for an 8-core CPU) - Windows: Open the generated solution with Visual Studio and build it.
- Linux:
Run the examples. They should be built in the
binfolder.
Most examples support multiple graphics APIs (on Windows). They are built with all APIs supported in the same executable,and the API can be switched from the command line. Use these command line arguments:
-dx11for D3D11-dx12for D3D12 (default)-vkfor Vulkan
The Feature Demo supports additional command line arguments:
-debugto enable the graphics API debug layer or runtime, and theNVRHI validation layer.-fullscreento start in full screen mode.-no-vsyncto start without VSync (can be toggled in the GUI).-print-graphto print the scene graph into the output log on startup.-widthand-heightto set the window size.<FileName>to load any supported model or scene from the given file.
Donut Examples are licensed under theMIT License.