Get Started

  • 2022.2
  • 04/11/2022
  • Public Content

Run Intel® OSPRay Studio

This walkthrough demonstrates how to run the Intel® OSPRay Studio application. Intel OSPRay Studio is a showcase application included in the
Intel® oneAPI Rendering Toolkit
(Render Kit). It is an interactive and extendable ray-tracing application.
: Configure your system.
To run the application:
  1. Open a terminal.
  2. If you did not set up oneAPI toolkit environment permanently: Set up environment variables:
    • For root or sudo users:
      . /opt/intel/oneapi/
    • For non-root users:
      . ~/intel/oneapi/
    See Set up Environment Variables for other options.
    If you installed the Render Kit to a custom location, make sure to replace
    (for root or sudo users) or
    (for non-root users) with the custom installation path before running the command.
  3. Go to a writable directory and create a directory to store supporting and result files.
    For example, create the
    cd ~
    mkdir rk_gsg
    cd rk_gsg
  4. Run Intel OSPRay Studio:
    You should see an interactive rendering window:
    Intel oneAPI Rendering Toolkit: Intel OSPRay Studio interactive window on macOS
  5. In the rendering window, go to
    Demo Scene
    and select one of the predefined demo scenes.
    Intel oneAPI Rendering Toolkit: Select Intel OSPRay Studio demo scene on macOS
    Some scenes demonstrate Intel® Open Volume Kernel Library integration capability.
  6. Review the selected scene. For example, the Multilevel Hierarchy demo looks as follows:
    Intel oneAPI Rendering Toolkit: Multilevel Hierarchy Intel OSPRay Studio demo scene on macOS
    You can control the scene view with a mouse as follows:
    • Right-click to move the camera in and out from the look-at point.
    • Left-click to rotate.
    • Scroll the mouse wheel to zoom in and out.
    • Drag and drop to move the camera.
    You can also use the following keyboard controls:
    • UP
      : Move the camera along the Z axis (in and out).
    • ALT+UP
      : Move the camera along the Y axis (up or down).
    • LEFT
      : Move the camera to the left along the X axis.
    • RIGHT
      : Move the camera to the right along the X axis.
    • W
      : Change camera elevation.
    • ALT+S
      : Save a frame as a file to a local directory.
    • A
      : Change camera azimuth.
    • ALT+A
      : Change camera roll.
    • G
      : Show/Hide the user interface.
    • Q
      : Quit the application.
    • P
      : Print a scene graph to the shell.
    • M
      : Print a material registry to the shell.
    • B
      : Print frame bounds.
    • V
      : Print camera parameters to the shell.
    • =
      : Push a location to save camera parameters.
    • -
      : Pop a location to save camera parameters.
    • 0-9
      : Set a camera snapshot.
    • Hold
      , hold
      , hold
      : Keep axis constrained for camera movement.
  7. You can save output image from
    in a preferred image format. The image is saved to the working
    directory as
    Intel oneAPI Rendering Toolkit: Save Intel OSPRay Studio demo scene on macOS
  8. You can review the saved screenshot with your preferred image viewer.

Next Steps

Product and Performance Information


Performance varies by use, configuration and other factors. Learn more at