A C++ based, cross platform ray tracing library
The Visionaray git repository can be cloned using the following commands:
git clone --recursive https://github.com/szellmann/visionaray.gitAn existing working copy can be updated using the following commands:
git pull
git submodule sync
git submodule update --init --recursiveC++14 compliant compiler (tested with g++-7.4.0 on Ubuntu 18.04 x86_64, tested with clang-902.0.39.1 on Mac OS X 10.13 (Apple LLVM version 9.1.0), tested with clang-1316.0.21.2.5 on Mac OS X 12.5.1 arm-64 (M1), tested with Microsoft Visual Studio 2015 VC14 for x64)
CMake version 3.1.3 or newer
NVIDIA CUDA Toolkit (optional)
Libraries need to ship with C/C++ header files (developer packages)
To compile the viewer and the examples, the following additional packages are needed or recommended:
It is strongly recommended to build Visionaray in release mode, as the source code relies heavily on function inlining by the compiler, and executables may be extremely slow without that optimization. It is also recommended to supply an architecture flag that corresponds to the CPU architecture you are targeting.
cd visionaray
mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_FLAGS="-march=native"
make
make installHeaders, libraries and binaries will then be located in the standard install path of your operating system (usually /usr/local).
See the Getting Started Guide and the Troubleshooting section in the Wiki for further information.
The "CMake -> Visual Studio Solution" code path is tested from time to time. Visionaray is primarily developed on Linux and Mac OS, though, so you may encounter the occasional "Commit XY breaks builds on Windows" etc.
On Windows, use CMake to generate a Visual Studio solution file that can be loaded by the IDE, or compiled on the command line using msbuild.exe.
The viewer is optional but built by default. It supports a number of 3D file formats. The viewer is primarily targeted at developers, as a tool for debugging and testing.
Use the CMake variable VSNRAY_ENABLE_VIEWER to exclude the viewer from building. With a standard install, the viewer can be invoked using the following command:
vsnray-viewer <file>Supported file formats are wavefront .obj, .ply, and `.pbrt.
Documentation can be found in the Wiki.
Visionaray is a template library, so that most algorithms are implemented in header files located under include/visionaray.
Visionaray can optionally interoperate with graphics and GPGPU APIs. Interoperability with the respective libraries is compiled into the Visionaray library. When GPU interoperability isn't required, chances are that you don't need to link with Visionaray at all, but can use it as a header only library.
Files in detail/ subfolders are not part of the public API. Code in namespace detail contains private implementation. Template class implementations go into files ending with .inl, which are included at the bottom of the public interface header file.
Visionaray comes with a viewer (see above) and a set of examples. Those can be found in
The viewer and the examples link with the Visionaray-common library that provides functionality such as windowing classes or mouse interaction. The Visionaray-common library is not part of the public API and interfaces may change between releases.
The viewer and the examples use the following third-party libraries (the Visionaray library can be built without these dependencies):
See the file CHANGELOG.md for updates on feature addition and removals, bug fixes and general changes.
If you use Visionaray or some of its code for your scientific project, please cite this paper:
@inproceedings{zellmann:visionaray,
author = {Zellmann, Stefan and Wickeroth, Daniel and Lang, Ulrich},
title = {Visionaray: A Cross-Platform Ray Tracing Template Library},
booktitle = {2017 IEEE 10th Workshop on Software Engineering and Architectures for Realtime Interactive Systems (SEARIS)},
year = {2017},
publisher = {IEEE},
pages = {1-8},
}Visionaray is licensed under the MIT License (MIT)