Get Started with the Intel® oneAPI Rendering Toolkit for Windows*

ID 766442
Date 7/13/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Run Intel® Open Volume Kernel Library (Intel® Open VKL) Sample

This tutorial describes how to run a pre-compiled interactive sample application built on Intel® Open Volume Kernel Library (Intel® Open VKL).

The vklExamples sample application renders the Intel Open VKL API results to screen through a graphical interface.

Prerequisite: Configure your system.

To run the application:

  1. Open a command prompt.
  2. Set up environment variables:
    call "C:\Program Files (x86)\Intel\oneAPI\setvars.bat"
    NOTE:
    If you installed the Render Kit to a custom location, make sure to replace C:\Program Files (x86)\Intel\oneAPI\ with the custom installation path before running the command.
  3. Go to a writable directory and create a directory to store supporting files. For example, create the rk_gsg folder :
    cd %USERPROFILE%
    
    mkdir rk_gsg
    cd rk_gsg
  4. Run the sample application:
    vklExamples.exe

    The sample results will open in a new GUI window.

The following controls are available:

  • Left-click (Mouse1) and drag to rotate camera.
  • Right-click (Mouse2) and drag to zoom camera.
  • Middle-click (Mouse3) and drag to pan camera.
  • Select different transfer functions, Intel Open VKL API values, and rendering controls to visualize the volume.

NOTE:
User interface elements may overlap. Drag and drop the blue control bar to see all controls.

Tips and Observations

  • Different renderer modes are available from the rendering drop-down. These modes correspond to contemporary volume sampling and rendering applications.
  • Density Path Tracer renderer demonstrates path tracing within a volume. It uses vklComputeSample() in support of a Woodcock-tracking sampling algorithm. Use the dialog boxes to control algorithm parameters. See DensityPathTracer.cpp.
  • Hit-iterator renderer demonstrates hit-iterator and gradient computation functionality. It uses vklIterateHit() and vklComputeGradient(). This example also demonstrates shadow testing. See HitIteratorRenderer.cpp.
  • Ray-march iterator demonstrates interval iteration and computation of a volume sample. It uses vklIterateInterval() and vklComputeSample(). See RayMarchIteratorRenderer.cpp.
  • When exploring the samples, note that the code is aliased and modular to support the interactive rendering window. To better understand the code, start with the renderPixel() function.
  • ISPC modes correspond with code implementations built on the Intel® Implicit SPMD Program Compiler. These implementations take advantage of SIMD capabilities of modern processors and provide more opportunity for performance.

Next Steps