RayTracing - GitLite

KO | EN

gitlite — search

#javascript #react #golang #deep-learning #docker #awesome #cli #kubernetes #vue #pytorch #security #ios #mcp #open-source

RayTracing

(★ 342)

Realtime GPU path tracer based on D3D12 and Vulkan

File Explorer

Download Latest Version (.zip)

- - blue_noise_sampler.h
- - stb_image.h
- - tiny_obj_loader.h
- CLI11
- glm
- GpuApi
- - CGSkies_0036_free.hdr
  - studio_small_03_4k.hdr
  - Topanga_Forest_B_3k.hdr
- checker3.jpg
- CornellBox.mtl
- CornellBox.obj
- CornellBox_Dragon.mtl
- CornellBox_Dragon.obj
- download_bistro.bat
- ShaderBalls.mtl
- ShaderBalls.obj
- FindGLFW3.cmake
- 1.jpg
- 10.JPG
- 11.JPG
- 12.JPG
- 13.JPG
- 14.JPG
- 15.JPG
- 16.JPG
- 17.PNG
- 18.PNG
- 19.PNG
- 2.jpg
- 20.PNG
- 21.PNG
- 22.PNG
- 23.PNG
- 24.PNG
- 3.jpg
- 4.jpg
- 5.jpg
- 6.jpg
- 7.jpg
- 8.JPG
- 9.JPG
- Bistro.png
- blinn-ggx.jpg
- cornell_box_2.jpg
- dof_1.jpg
- importance-sampling-2.jpg
- old1.jpg
- refactor.jpg
- SanMiguel.png
- Sponza.png
- - acceleration_structure.hpp
  - bvh.cpp
  - bvh.hpp
  - hardware_rt_acceleration_structure.cpp
  - hardware_rt_acceleration_structure.hpp
- - hdr_loader.cpp
  - image_loader.cpp
  - image_loader.hpp
  - obj_loader.cpp
  - obj_loader.hpp
- - texture_manager.cpp
  - texture_manager.hpp
- - denoiser.cpp
  - denoiser.hpp
  - path_tracer.cpp
  - path_tracer.hpp
  - post_process.cpp
  - post_process.hpp
  - render.cpp
  - render.hpp
  - simple_accumulator.cpp
  - simple_accumulator.hpp
- - scene.cpp
  - scene.hpp
- - accumulate_direct_samples.cs
  - accumulate_radiance.cs
  - aov.cs
  - bxdf.hlsli
  - clear_counter.cs
  - common.hlsli
  - copy_history.cs
  - denoiser.cs
  - frame_data.hlsli
  - hit_surface.cs
  - light.hlsli
  - material.hlsli
  - miss.cs
  - raygeneration.cs
  - shared_structures.h
  - tonemap.cs
  - trace_bvh.cs
  - trace_common.hlsli
  - trace_rayquery.cs
  - trace_shadow_bvh.cs
  - trace_shadow_rayquery.cs
- - aabb.hpp
  - camera_controller.cpp
  - camera_controller.hpp
  - window.cpp
  - window.hpp
- CMakeLists.txt
- main.cpp
.clang-format
.gitignore
.gitmodules
CMakeLists.txt
LICENSE
README.md
run_bistro.bat

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Realtime GPU Path Tracing Engine

Join my telegram channel, where I post everything related to graphics!
https://t.me/cg_lib

[**Watch demo on YouTube**](https://youtu.be/UIjra1T7ilI)
[![Bistro scene](https://raw.githubusercontent.com/AlexanderVeselov/RayTracing/master/screenshots/Bistro.png)](https://youtu.be/UIjra1T7ilI)
![](https://raw.githubusercontent.com/AlexanderVeselov/RayTracing/master/screenshots/SanMiguel.png)

## Features

- Realtime GPU wavefront path tracing using compute shaders
- Vulkan and D3D12 backends through `GpuApi`
- Hardware ray tracing through Ray Query when supported by the selected backend
- CPU-built BVH fallback with GPU traversal when Ray Query is unavailable
- Lambert diffuse and GGX reflection BRDFs
- Point, directional and environment light sampling
- Temporal reprojection filter
- Depth, normals, albedo and motion vector AOV generation
- Runtime compute pipeline hot reload

## Ray Tracing Paths

The application selects the acceleration-structure path automatically:

- If `Device::SupportsRayQuery()` is true, `HardwareRtAccelerationStructure`
  builds BLAS objects per mesh and a TLAS over scene instances. Tracing uses
  `trace_rayquery.cs` and `trace_shadow_rayquery.cs`.
- Otherwise `Bvh` builds a CPU BVH from scene meshes/instances, uploads the
  nodes and triangles, and tracing uses `trace_bvh.cs` and
  `trace_shadow_bvh.cs`.

Both paths keep the same high-level scene model: `SceneInstance` stores the
mesh index and transform, while ray-hit data stores `instance_id` and
`primitive_id`.

## Building

Requirements:

- CMake
- A C++17 compiler
- GLFW
- Vulkan SDK for the Vulkan backend
- Windows SDK with D3D12 for the D3D12 backend

Clone with submodules:

```bat
git clone --recursive https://github.com/AlexanderVeselov/RayTracing.git
cd RayTracing
```

Generate and build:

```bat
cmake -S . -B build
cmake --build build --config Release --target RayTracingApp
```

The Visual Studio project sets the debugger working directory to the repository
root. `dxcompiler.dll` and `dxil.dll` are copied next to `RayTracingApp` after
build.

## Running

Run `RayTracingApp` from the repository root:

```bat
build\src\Release\RayTracingApp.exe --backend vulkan --scene assets/ShaderBalls.obj
```

Command-line options:

- `--help` prints command-line help
- `-w <width>` sets window width, default `1280`
- `-h <height>` sets window height, default `720`
- `--scene <path>` sets OBJ scene path, default `assets/ShaderBalls.obj`
- `--scale <scale>` sets imported scene scale, default `1.0`
- `--flip_yz <0|1>` flips Y and Z axes during import, default `0`
- `--backend <vulkan|d3d12>` selects render backend, default `vulkan`

Press `R` while the app is running to reload registered compute pipelines. The
reload keeps the previous pipeline if shader compilation or reflected layout
compatibility checks fail.

`run_bistro.bat` downloads Amazon Lumberyard Bistro content into `assets`,
builds the project and runs the Bistro scene.