A Rust adapter for the Khronos OpenCL API.
A functional, safe Rust interface to the Khronos OpenCL 3.0 C API based upon the cl-sys OpenCL FFI bindings.
OpenCL 3.0
is a unified specification that adds little new functionality to previous OpenCL versions.
It specifies that all OpenCL 1.2 features are mandatory, while all
OpenCL 2.x and 3.0 features are now optional.
This crate applies the adapter pattern
to convert OpenCL C API functions into Rust functions that return a
Result containing the desired result of
the C function or the OpenCL error code.
The only exception is svm_free, which just provides a safe wrapper for the
clSVMFree C API function.
Most of the modules are named after their equivalent "API" sections in
cl.h.
They contain Rust adapter functions for the OpenCL API C functions defined
in those sections with their associated types and constants.
For more information see the Rust documentation.
There are two parts of OpenCL to install: an OpenCL hardware driver and an OpenCL Installable Client Driver (ICD).
OpenCL hardware drivers are normally bundled together with the graphics drivers for the hardware, while there are several options for installing an OpenCL ICD.
AMD support OpenCL 2.2 through their Radeon Open Compute (ROCm) development platform. Unfortunately, it only supports a limited number of Linux distributions, see AMD ROCm Platform.
AMD used to provide the de facto standard OpenCL ICD in AMD APP SDK 3.0 which provided OpenCL 2.0 support on both Linux and Windows. Unfortunately, it is no longer available from AMD, although it can be found elsewhere on the internet, see OpenCL AMD APP SDK 3.0 for windows and linux.
Note: on Windows 10 systems with both an AMD Radeon GPU and an Intel GPU, OpenCL is often limited to the AMD GPU only, see How to Enable Intel OpenCL Support on Windows when AMD Radeon Graphics Driver is Installed for a description of the issue and how to fix it.
The Intel OpenCL ICD currently provides good OpenCL support (version 2.1) for both Linux and Windows, see Intel SDK for OpenCL applications. Intel also provides a useful guide to OpenCL development, see Get Started with Intel SDK for OpenCL.
Nvidia also provides an OpenCL ICD. However, Nvidia OpenCL support has lagged behind AMD and Intel in the past, so it is recommended to install the Nvidia graphics drivers with an AMD or Intel OpenCL ICD, depending on your CPU manufacturer and operating system.
Other OpenCL ICDs are available. For example, cl-sys searches for the OCLSDK_Light on Windows if it can't find any of the AMD, Intel or Nvidia OpenCL ICDs.
Finally, it's possible to build your own OpenCL ICD for Linux or Windows from the Khronos official OpenCL ICD Loader source code.
See the Rust crate documentation: cl3.
Licensed under the Apache License, Version 2.0, as per Khronos Group OpenCL.
You may obtain a copy of the License at: http://www.apache.org/licenses/LICENSE-2.0
OpenCL and the OpenCL logo are trademarks of Apple Inc. used under license by Khronos.