Get Started

  • 2021.3
  • 07/20/2021
  • Public Content

Run Intel® OSPRay Studio

Intel® OSPRay Studio is a showcase application included in the
Intel® oneAPI Rendering Toolkit
. It is an interactive and extendable ray-tracing application. This walkthrough demonstrates how to run the Intel OSPRay Studio application.
Prerequisites
  • Intel® oneAPI Rendering Toolkit
    (
    Render Kit
    ) with Intel OSPRay Studio. By default, the
    Render Kit
    is installed to
    /opt/intel/oneapi/
    directory. Replace
    <install-dir>
    with the default or your custom installation path.
  • Optional: A
    .ppm
    image viewer (
    for example, ImageMagick* or GIMP*
    )
Run Intel OSPRay Studio
  1. Open a new terminal window.
  2. Go to a writable directory and create a folder to save the sample application results to.
    For example, create the
    rk_gsg
    folder
    :
    cd ~
    mkdir rk_gsg
    cd rk_gsg
  3. Set Intel® oneAPI Toolkits environment variables:
    source <install-dir>/setvars.sh
    where
    <install-dir>
    is the directory where you installed the
    Intel® oneAPI Rendering Toolkit
    . By default, it is
    /opt/intel/oneapi/
    .
    All prerequisite Render Kit dynamic libraries should now be available for the Intel OSPRay Studio.
  4. Run Intel OSPRay Studio:
    ospStudio
    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
    File
    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
      /
      DOWN
      : Move the camera along the Z axis (in and out).
    • ALT+UP
      /
      ALT+DOWN
      : 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
      /
      S
      : Change camera elevation.
    • ALT+S
      : Save a frame as a file to a local directory.
    • A
      /
      D
      : Change camera azimuth.
    • ALT+A
      /
      ALT+D
      : 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
      X
      , hold
      Y
      , hold
      Z
      : Keep axis constrained for camera movement.
  7. You can save output image from
    Menu
    Save...
    Screenshot
    in a preferred image format. The image is saved to the working
    rk_gsg
    directory as
    studio.<NNNN>
    .
    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

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.