![]() |
---|
The famous "Sponza" scene with teapots. 1920x1080 image (4096 spp, 4 bounces), rendered with Tauray in 15 seconds on a dual-GPU setup with RTX 3090 and RTX 2080 Ti. |
Tauray is a real-time rendering framework, with a focus on distributed computing, scalability,
portability and low latency. It uses C++17 and Vulkan, primarily relying on the VK_KHR_ray_tracing
extension, but comes with a fallback rasterization mode that can be used on devices that
do not have that extension.
Tauray development is led by the VGA research group in Tampere University. The project is described in a conference publication (DOI link), which includes performance benchmarks and more information on Tauray. A pre-print is available.
Measurements in the publication are done with the v1.0.0 release. For practical purposes however, we recommend always using the latest available release instead, as there are bug fixes and additional features included.
Tauray is licensed under LGPL version 2.1. You can find the license text in
COPYING.LESSER. External dependencies in the external
folder have their own licenses specified either at the start of each file or as
separate license text files.
- Real-time path tracing (
--renderer=path-tracer
)- Accumulation mode (
--accumulation
) - Denoising (
--denoiser=svgf
or--denoiser=bmfr
)
- Accumulation mode (
- Offline rendering (
--headless=output_file
)- Animations with
--animation
- Output file type with
--filetype=[png,exr]
- Animations with
- DDISH-GI, as used in the DDISH-GI publication (
--renderer=dshgi
)- Remote probe rendering (
--renderer=dshgi-server
and--renderer=dshgi-client
) - Note that scenes for DDISH-GI need to be authored to include the probe grid: use the included Blender glTF export plugin and place an irradiance volume!
- Remote probe rendering (
- Multi-GPU rendering (real-time and offline!)
- All compatible GPUs are used by default (you can limit to one with
--devices=0
)
- All compatible GPUs are used by default (you can limit to one with
- Light field rendering
- Real-time for Looking Glass displays:
--display=looking-glass
- Offline:
--camera-grid=w,h,x,y
and--camera-recentering-distance=distance
- Real-time for Looking Glass displays:
- VR rendering (
--display=openxr
)
And more, see the user manual for details.
Clone the repository recursively with
git clone --recursive https://github.com/vga-group/tauray/
.
Tauray has been tested on the Ubuntu 22.04 operating system. Building on Ubuntu 22.04 can be done as follows:
- Install dependencies:
sudo apt install build-essential cmake libsdl2-dev libglm-dev libczmq-dev libnng-dev libcbor-dev vulkan-tools libvulkan-dev vulkan-validationlayers libxcb-glx0-dev glslang-tools libassimp-dev
cmake -S . -B build
cmake --build build
build/tauray my_scene.glb
Building with Windows is also possible but not recommended. You can use the CMakeLists.txt with Visual Studio. A vcpkg.json is provided in this repository to handle dependencies with Windows builds. Note that multi-GPU rendering is not supported on Windows.
To launch a simple interactive path tracing session with the included test model:
build/tauray test/test.glb --preset=accumulation
See the user manual for more detailed usage documentation.
To measure representative benchmarks with Tauray, please build a release build and disable validation:
- Delete your existing build directory (if applicable)
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build
build/tauray --validation=off -t my_scene.glb
You may also want to set --force-double-sided
for better performance if your
scene does not require single-sided surfaces. Also, remember to set
--max-ray-depth
appropriately for the type of benchmark, the default is quite
high. It sets the number of bounces.
By default, Tauray will use all GPUs with support for the required extensions.
If you wish to use a specific GPU on a multi-GPU system, use --devices=0
(or
any other index; the first thing Tauray prints is the devices it picked.)
In the output with the -t
flag, lines starting with HOST:
are total
frametimes, which you most likely want to measure. The first few frametimes of
a run can be weird as in-flight frames haven't been queued properly and some
initialization still runs, so please exclude those if possible.
--warmup-frames
can also be used for this purpose.
See the user manual for more detailed info on configuring Tauray for you benchmark setup.
If you use Tauray in a research paper, please cite our paper with the format below:
@inproceedings{Ikkala22,
author={Ikkala, Julius and Mäkitalo, Markku and Lauttia, Tuomas and Leria, Erwan and Jääskeläinen, Pekka},
title={Tauray: A Scalable Real-Time Open-Source Path Tracer for Stereo and Light Field Displays},
year={2022},
booktitle={SIGGRAPH Asia 2022 Technical Communications},
series={SA '22 Technical Communications},
location={Daegu, Republic of Korea},
doi={10.1145/3550340.3564225},
address={New York, NY, USA},
publisher={Association for Computing Machinery},
url={https://webpages.tuni.fi/vga/publications/Tauray2022.pdf}
}