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:
- Open a command prompt.
- Set up environment variables:call "C:\Program Files (x86)\Intel\oneAPI\setvars.bat"If you installed the Render Kit to a custom location, make sure to replaceC:\Program Files (x86)\Intel\oneAPI\with the custom installation path before running the command.
- Go to a writable directory and create a directory to store supporting files.For example, create the:rk_gsgfoldercd %USERPROFILE%mkdir rk_gsgcd rk_gsg
- Run the sample application:vklExamples.exeThe 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.

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 usesvklComputeSample()in support of a Woodcock-tracking sampling algorithm. Use the dialog boxes to control algorithm parameters. SeeDensityPathTracer.cpp.
- Hit-iterator renderer demonstrates hit-iterator and gradient computation functionality. It usesvklIterateHit()andvklComputeGradient(). This example also demonstrates shadow testing. SeeHitIteratorRenderer.cpp.
- Ray-march iterator demonstrates interval iteration and computation of a volume sample. It usesvklIterateInterval()andvklComputeSample(). SeeRayMarchIteratorRenderer.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 therenderPixel()function.
- ISPCmodes 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
- Run pre-compiled sample applications for other Render Kit components.
- See Next Steps for more resources.