This repository provides a collection of example applications built using the Donut 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. |
| Meshlets | ✅ | ✅ | Renders a triangle using meshlets. | |
| 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. |
Same as the requirements for Donut.
-
Clone the repository with 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 the NVRHI 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 the MIT License.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent