Repository files navigation

This is release v1.1.0 of Intel® OSPRay Studio. It is released under theApache 2.0 license.

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

Seewhat'snewin this release.

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

The main control structure is ascene graph which allows users tocreate an abstract scene in adirected acyclical graph manner. Scenescan either be imported or created using scene graph nodes and structuresupport. The scenes can then be rendered either with OSPRay's pathtraceror scivis renderer.

More information can be found in thehigh-level featuredescription.

• CMake (v3.15+) and any C++14 compiler

For convenience, OSPRay Studio provides a CMake Superbuild script which willpull down its dependencies i.e. GLFW, OSPRay, rkcommon and TBB. It builds OSPRayStudio without OpemImageIO and OpenEXR support.stb_image is used for allimage operations by default instead.

To use the superbuild run with:

mkdir buildcd buildcmake ..cmake --build.

For other full set of options, run:

ccmake ..

or

cmake-gui ..

For standard cmake process turn off cmake optionOSPRAY_INSTALL and providefollowing required dependencies with their respective cmake options as will belisted in OS-specific building process below.

• CMake (v3.15+) and any C++14 compiler
• IntelOSPRay (v3.2.0) and itsdependencies - OSPRay Studio builds on top of OSPRay. Instructions onbuilding OSPRay are providedhere.OSPRay and OSPRay Studio have the following common dependencies which Studiocan hence leverage from an OSPRay build.
  • Intel Rendering Toolkit common libraryrkcommon (v1.14.0)
  • IntelThreading Building Blocks
• OpenGL andGLFW (v3.3.10) - for the windowing environment

• IntelOpen Image Denoise - (v2.3.0 ornewer) for denoising frames. To use with OSPRay Studio, OSPRay must be builtwith-DBUILD_OIDN=ON in CMake.
• OpenVDB to support loading VDB formatted volume files.
• OpenImageIO andOpenEXR(either v2.x or v3.x) to support images in a variety of file formats. SetOPENIMAGEIO_ROOTandOPENEXR_ROOT to the respective install directories to use these libraries.(tested with OpenImageIO v2.3.16 and OpenEXR v2.5.8 and v3.3.0)
• [Python] (3.9.7) (https://python.org) for python bindings

• Follow OSPRay's build instructions to install it, which will alsofulfill most other required dependencies. Set the followingenvironment variables to easily locate OSPRay andrkcommon during CMake.

  export ospray_DIR =${OSPRAY_INSTALL_LOCATION}export rkcommon_DIR =${RKCOMMON_INSTALL_LOCATION}export TBB_DIR =${TBB_INSTALL_LOCATION}

  Alternatively,CMAKE_PREFIX_PATHcan 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 recommendkeeping a separate build directory)

  cd ospray_studiomkdir buildcd build

• Then run the typical CMake routine

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

• To run OSPRay Studio, make sureLD_LIBRARY_PATH (on Linux) orDYLD_LIBRARY_PATH (on macOS) contains all dependencies. Forexample,

  export LD_LIBRARY_PATH=${OSPRAY_INSTALL}/lib64:...:$LD_LIBRARY_PATH# then run!./ospStudio

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

• Specify the source folder and the build directory in CMake
• Specifyospray_DIR,rkcommon_DIR CMakevariables for the respective install locations
• Click 'Configure' and select the appropriate generator (we recommendusing at least Visual Studio 15 2017)
• Select x64 as an optional parameter for the generator (32-bit buildsare not supported)
• Click 'Generate' to createospray_studio.sln. Open this in VisualStudio and compile

You can optionally use the CMake command line:

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