DiligentSamples

This module contains tutorials and sample applications intended to demonstrate the usage of Diligent Engine. The module depends on the Core and Tools submodules.

To build and run the applications in the module, please follow the instructions in the master repository.

Table of Contents

• Tutorials
  • 01 - Hello Triangle
  • 02 - Cube
  • 03 - Texturing
  • 03 - Texturing-C
  • 04 - Instancing
  • 05 - Texture Array
  • 06 - Multithreading
  • 07 - Geometry Shader
  • 08 - Tessellation
  • 09 - Quads
  • 10 - Data Streaming
  • 11 - Resource Updates
  • 12 - Render Target
  • 13 - Shadow Map
  • 14 - Compute Shader
  • 15 - Multiple Windows
  • 16 - Bindless Resources
  • 17 - MSAA
  • 18 - Queries
  • 19 - Render Passes
  • 20 - Mesh Shader
  • 21 - Ray Tracing
• Samples
  • Atmospheric Light Scattering
  • GLTF Viewer
  • Shadows
  • Dear ImGui Demo
  • Nuklear Demo
  • Hello AR
• Build and Run Instructions
• License
• Contributing

Tutorials

Tutorial 01 - Hello Triangle

This tutorial shows how to render simple triangle using Diligent Engine API.

Tutorial 02 - Cube

This tutorial demonstrates how to render an actual 3D object, a cube. It shows how to load shaders from files, create and use vertex, index and uniform buffers.

Tutorial 03 - Texturing

This tutorial demonstrates how to apply a texture to a 3D object. It shows how to load a texture from file, create shader resource binding object and how to sample a texture in the shader.

Tutorial 03 - Texturing-C

This tutorial is identical to Tutorial03, but is implemented using C API.

Tutorial 04 - Instancing

This tutorial demonstrates how to use instancing to render multiple copies of one object using unique transformation matrix for every copy.

Tutorial 05 - Texture Array

This tutorial demonstrates how to combine instancing with texture arrays to use unique texture for every instance.

Tutorial 06 - Multithreading

This tutorial shows how to generate command lists in parallel from multiple threads.

Tutorial 07 - Geometry Shader

This tutorial shows how to use geometry shader to render smooth wireframe.

Tutorial 08 - Tessellation

This tutorial shows how to use hardware tessellation to implement simple adaptive terrain rendering algorithm.

Tutorial 09 - Quads

This tutorial shows how to render multiple 2D quads, frequently swithcing textures and blend modes.

Tutorial 10 - Data Streaming

This tutorial shows dynamic buffer mapping strategy using MAP_FLAG_DISCARD and MAP_FLAG_DO_NOT_SYNCHRONIZE flags to efficiently stream varying amounts of data to GPU.

Tutorial 11 - Resource Updates

This tutorial demonstrates different ways to update buffers and textures in Diligent Engine and explains important internal details and performance implications related to each method.

Tutorial 12 - Render Target

This tutorial demonstrates how to render a 3d cube into an offscreen render target and do a simple post-processing effect.

Tutorial 13 - Shadow Map

This tutorial demonstrates how to render basic shadows using a shadow map.

Tutorial 14 - Compute Shader

This tutorial shows how to implement a simple particle simulation system using compute shaders.

Tutorial 15 - Multiple Windows

This tutorial demonstrates how to use Diligent Engine to render to multiple windows.

Tutorial 16 - Bindless Resources

This tutorial shows how to implement bindless resources, a technique that leverages dynamic shader resource indexing feature enabled by the next-gen APIs to significantly improve rendering performance.

Tutorial 17 - MSAA

This tutorial demonstrates how to use multisample anti-aliasing (MSAA) to make geometrical edges look smoother and more temporarily stable.

Tutorial 18 - Queries

This tutorial demonstrates how to use queries to retrieve various information about the GPU operation, such as the number of primitives rendered, command processing duration, etc.

Tutorial 19 - Render passes

This tutorial demonstrates how to use the render passes API to implement simple deferred shading.

Tutorial 20 - Mesh Shader

This tutorial demonstrates how to use amplification and mesh shaders, the new programmable stages, to implement view frustum culling and object LOD calculation on the GPU.

Tutorial 21 - Ray Tracing

This tutorial demonstrates the basics of using ray tracing API in Diligent Engine.

Samples

Atmospheric Light Scattering sample

This sample demonstrates how to integrate Epipolar Light Scattering post-processing effect into an application to render physically-based atmosphere.

GLTF Viewer

This sample demonstrates how to use the Asset Loader and GLTF PBR Renderer to load and render GLTF models.

Shadows

This sample demonstrates how to integrate the Shadowing component into an application to render high-quality shadows.

Dear ImGui Demo

This sample demonstrates the integration of the engine with dear imgui UI library.

Nuklear Demo

This sample demonstrates the integration of the engine with nuklear UI library.

Hello AR

This sample demonstrates how to use Diligent Engine in a basic Android AR application.

Build and Run Instructions

Please refer to Build and Run Instructions section in the master repository's readme.

Command line options:

• -mode {d3d11|d3d12|vk|gl} - select rendering back-end (example: -mode d3d12).
• -width value - set desired window width (example: -width 1024).
• -height value - set desired window height (example: -height 768).
• -capture_path path - path to the folder where screen captures will be saved. Specifying this parameter enables screen capture (example: -capture_path .).
• -capture_name name - screen capture file name. Specifying this parameter enables screen capture (example: -capture_name frame).
• -capture_fps fps - recording fps when capturing frame sequence (example: -capture_fps 10). Default value: 15.
• -capture_frames value - number of frames to capture after the app starts (example: -capture_frames 50).
• -capture_format {jpg|png} - image file format (example: -capture_format jpg). Default value: jpg.
• -capture_quality value - jpeg quality (example: -capture_quality 80). Default value: 95.
• -capture_alpha value - when saving png, whether to write alpha channel (example: -capture_alpha 1). Default value: false.
• -validation value - set validation level (example: -validation 1). Default value: 1 in debug build; 0 in release builds.
• -adapter value - select GPU adapter, if there are more than one installed on the system (example: -adapter 1). Default value: 0.

When image capture is enabled the following hot keys are available:

• F2 starts frame capture recording.
• F3 finishes frame capture recroding.
• F4 saves single screenshot.

To record multiple frames after the app starts, use command line like this:

-mode d3d12 -capture_path . -capture_fps 15 -capture_name frame -width 640 -height 480 -capture_format png -capture_frames 50

License

See Apache 2.0 license.

This project has some third-party dependencies, each of which may have independent licensing:

• nuklear: A single-header ANSI C gui library (MIT or Public domain license).

Contributing

To contribute your code, submit a Pull Request to this repository. Diligent Engine is licensed under the Apache 2.0 license that guarantees that content in the DiligentSamples repository is free of Intellectual Property encumbrances. In submitting any content to this repository, you license that content under the same terms, and you agree that the content is free of any Intellectual Property claims and you have the right to license it under those terms.

Diligent Engine uses clang-format to ensure consistent source code style throught the code base. The format is validated by appveyor and travis for each commit and pull request, and the build will fail if any code formatting issue is found. Please refer to this page for instructions on how to set up clang-format and automatic code formatting.

diligentgraphics.com