OSPRay Studio

This is release v0.10.0 of Intel® OSPRay Studio. It is released under the Apache 2.0 license.

Visit OSPRay Studio (http://www.ospray.org/ospray_studio) for more information.

See what's new in this release.

Overview

Intel OSPRay Studio is an open source and interactive visualization and ray tracing application that leverages Intel OSPRay as its core rendering engine. It can be used to load complex scenes requiring high fidelity rendering or very large scenes requiring supercomputing resources.

The main control structure is a scene graph which allows users to create an abstract scene in a directed acyclical graph manner. Scenes can either be imported or created using scene graph nodes and structure support. The scenes can then be rendered either with OSPRay's pathtracer or scivis renderer.

More information can be found in the high-level feature description.

Building OSPRay Studio

tl;dr - For most installations, these 5 steps will build a plain vanilla OSPRay Studio

  1. git clone https://github.com/ospray/ospray_studio.git
  2. mkdir ospray_studio/build
  3. cd ospray_studio/build
  4. cmake ..
  5. cmake --build .

OSPRay Studio has the following required and optional dependencies.

Required dependencies

CMake (v3.15+) and any C++14 compiler
Intel OSPRay (v2.9.0) and its dependencies - OSPRay Studio builds on top of OSPRay. Instructions on building OSPRay are provided here.
- Intel Open VKL (v1.2.0 or newer)
- Intel Embree (v3.13.1 or newer)
- Intel oneAPI Rendering Toolkit common library rkcommon (v1.9.0)
- Intel Threading Building Blocks
OpenGL and GLFW (v3.3.4) - for the windowing environment

Optional Dependencies

Intel Open Image Denoise - (v1.2.3 or newer) for denoising frames. To use with OSPRay Studio, OSPRay must be built with -DBUILD_OIDN=ON in CMake.
OpenImageIO and OpenEXR to support images in a variety of file formats. Set OPENIMAGEIO_ROOT and OPENEXR_ROOT to the respective install directories to use these libraries.
[Python] (3.9.7) (https://python.org) for python bindings

Building on Linux and macOS

Follow OSPRay's build instructions to install it, which will also fulfill most other required dependencies. Set the following environment variables to easily locate OSPRay, Open VKL, Embree, and rkcommon during CMake.
```
export ospray_DIR = ${OSPRAY_INSTALL_LOCATION}
export openvkl_DIR = ${OPENVKL_INSTALL_LOCATION}
export embree_DIR = ${EMBREE_INSTALL_LOCATION}
export rkcommon_DIR = ${RKCOMMON_INSTALL_LOCATION}
```
Alternatively, CMAKE_PREFIX_PATH can be set to find the OSPRay install and other dependencies.

Clone OSPRay Studio

git clone https://github.com/ospray/ospray_studio/

Create build directory and change directory to it (we recommend keeping a separate build directory)
```
cd ospray_studio
mkdir build
cd build
```

Then run the typical CMake routine

cmake -DCMAKE_CXX_COMPILER=clang++ -DCMAKE_C_COMPILER=clang ... # or use ccmake
make -j `nproc` # or cmake --build .

To run OSPRay Studio, make sure LD_LIBRARY_PATH (on Linux) or DYLD_LIBRARY_PATH (on macOS) contains all dependencies. For example,
```
export LD_LIBRARY_PATH=${OSPRAY_INSTALL}/lib64:${OPENVKL_INSTALL}/lib64:...:$LD_LIBRARY_PATH
# then run!
./ospStudio
```

Building on Windows

Use CMake (cmake-gui) to configure and generate a Microsoft Visual Studio solution file for OSPRay Studio.

Specify the source folder and the build directory in CMake
Specify ospray_DIR, openvkl_DIR and rkcommon_DIR CMake variables for the respective install locations
Click 'Configure' and select the appropriate generator (we recommend using at least Visual Studio 15 2017)
Select x64 as an optional parameter for the generator (32-bit builds are not supported)
Click 'Generate' to create ospray_studio.sln. Open this in Visual Studio and compile

You can optionally use the CMake command line:

cmake --build . --config Release --target install