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.

Configure Your System

To use the Intel® oneAPI Rendering Toolkit (Render Kit) samples, you first need to set up your system as follows:

  1. Install Microsoft Visual Studio* with CMake* and Windows* SDK to build the samples.
  2. Install Intel® oneAPI Base Toolkit for dependency libraries and the sample browser.
  3. Install imaging tools.
  4. Optional: Configuration for Intel® GPU.

Install Microsoft Visual Studio* with CMake* and Windows* SDK

Although Intel® oneAPI Toolkits do not require CMake* and Windows* SDK , many oneAPI samples are delivered as CMake projects. To build such samples, you need to install CMake and Windows SDK.

To do this, install the Microsoft Visual Studio* C++ development tools, which include CMake tools in the desktop development with C++ workload. See CMake projects in Visual Studio for installation instructions. Typically, the required components are installed from the optional section of the Visual Studio installer.

Visual C++ Tools for CMake is installed by default as part of the Desktop Development with C++ workload.

For more information about CMake, refer to CMake.org. For more information on the Windows* SDK refer to the Microsoft Dev Center Windows* SDK. oneAPI code walkthroughs are tested on Microsoft Visual Studio 2022.

Install the Intel® oneAPI Base Toolkit (Base Kit)

Install the Base Kit with the Intel® oneAPI DPC++/C++ Compiler selected as well as the automatic components the compiler adds. No other Base Kit components are required to be specified for Render Kit. See Base Kit product page for more information.

NOTE:
The Base Kit contains build-time and runtime library distributions for Intel® oneAPI DPC++/C++ Compiler. These Base Kit libraries are required to use Render Kit libraries when targeting Intel Graphics Devices. Other Base Kit libraries may be used directly with the system compiler for Rendering Libraries when targeting CPU. Libraries may be available from other distributions. If you have questions about alternate distributions for production deployment, please ask on the forum.
NOTE:
The oneAPI sample browser is automatically distributed as part of the Base Kit in the dev-utilities directory. Use the oneAPI sample browser to access sample applications easily for Render Kit getting started walkthrough guidance after setup.
NOTE:
You can also get the samples manually using Git*.

Install Imaging Tools

Render Kit samples and applications often require preprocessed images as input or generate images as output. To display and convert input and output images, you need to get imaging tools for staging NetPBM filetypes (PPM and PFM). The ImageMagick* tool is suggested. See the ImageMagick website for standalone and package manager install instructions.

Configuration for Intel® GPU

  1. Download the Intel® Driver & Support Assistant (Intel® DSA) by following the link and clicking Download now. The Intel DSA tool will help you identify and install the correct driver for your system.
  2. Run the Intel® Driver & Support Assistant Application and follow the on-screen prompts to install the latest version of Intel Graphics - Windows 10 or 11 DCH Drivers.
  3. To troubleshoot any installation issues (or to manually install a driver without the use of the Intel DSA), see these step-by-step instructions on downloading and installing an Intel® Graphics Driver in Windows® 10 & Windows 11.
  4. In the System BIOS, enable Resizable BAR (Base Address Register) for better performance if the setting is available.

Next Steps

Get started with the Intel® oneAPI Rendering Toolkit by building and running sample applications.

Feedback on Issues

Share your feedback on this article in the Intel® oneAPI Rendering Toolkit forum.