This repo contains simple OpenCL samples that demonstrate how to build OpenCL applications using only the Khronos-provided headers and libs. All samples have been tested on Windows and Linux.
Most of the samples are written in C and C++ using the OpenCL C++ bindings. A few of the samples have been ported to Python using PyOpenCL.
README.md This file
LICENSE License information
CMakeLists.txt Top-level CMakefile
external/ External Projects (headers and libs)
include/ Include Files (OpenCL C++ bindings)
layers/ Sample Layers
samples/ Sample Applications
tutorials/ Tutorials
The samples require the following external dependencies:
OpenCL Headers:
git clone https://github.com/KhronosGroup/OpenCL-Headers external/OpenCL-Headers
OpenCL ICD Loader:
git clone https://github.com/KhronosGroup/opencl-icd-loader external/opencl-icd-loader
Many samples that use extensions additionally require the OpenCL Extension Loader:
git clone https://github.com/bashbaug/opencl-extension-loader external/opencl-extension-loader
After satisfying the external dependencies create build files using CMake. For example:
mkdir build && cd build
cmake ..
Then, build with the generated build files.
To run the samples, you will need to obtain and install an ICD loader and an
OpenCL implementation (ICD) that supports the cl_khr_icd extension.
The ICD loader is likely provided by your operating system or an OpenCL implementation. If desired, you may use the ICD loader that is built along with these OpenCL samples. The OpenCL implementation will likely be provided by your OpenCL device vendor. There are several open source OpenCL implementations as well.
For brevity, most samples do not include error checking. This means that a
sample may crash or incorrectly report success if an OpenCL error occurs. By
defining the CMake variable SAMPLES_ENABLE_EXCEPTIONS many samples can instead
throw an exception if an OpenCL error occurs.
Tools like the OpenCL Intercept Layer can also be useful to detect when an OpenCL error occurs and to identify the cause of the error.
These samples are licensed under the MIT License.
Notes:
- The OpenCL C++ bindings are built from the Khronos OpenCL-CLHPP Repo, and is licensed under the Khronos(tm) License.
- The samples use popl for its options parsing, which is licensed under the MIT License.
- The samples use stb for image reading and writing, which is dual-licensed under a public domain license and the MIT license.
OpenCL and the OpenCL logo are trademarks of Apple Inc. used by permission by Khronos.
* Other names and brands may be claimed as the property of others.