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.
Prerequisite
:
Configure your system.
To run the application:
- Open a terminal.
- If you did not set up oneAPI toolkit environment permanently: Set up environment variables:
- For root or sudo users:source /opt/intel/oneapi/setvars.sh
- For non-root users:source ~/intel/oneapi/setvars.sh
See Set up Environment Variables for other options.If you installed the Render Kit to a custom location, make sure to replace/opt/intel/oneapi/(for root or sudo users) or~/intel/oneapi/(for non-root users) with the custom installation path before running the command. - Go to a writable directory and create a directory to store supporting and result files.For example, create the:rk_gsgfoldercd ~mkdir rk_gsgcd rk_gsg
- Run Intel OSPRay Studio:ospStudioYou should see an interactive rendering window:
- In the rendering window, go toand select one of the predefined demo scenes.Some scenes demonstrate Intel® Open Volume Kernel Library integration capability.
- Review the selected scene. For example, the Multilevel Hierarchy demo looks as follows: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.
- HoldX, holdY, holdZ: Keep axis constrained for camera movement.
- You can save output image fromin a preferred image format. The image is saved to the workingrk_gsgdirectory asstudio.<NNNN>.
- You can review the saved screenshot with your preferred image viewer.For example, to open the resulting images with the EoG image viewer:eog studio.0000.png
Next Steps
- Run pre-compiled sample applications for other Render Kit components.
- See Next Steps for more resources.