OpenCLTM API Headers
This repository contains C language headers for the OpenCL API.
The authoritative public repository for these headers is located at:
Issues, proposed fixes for issues, and other suggested changes should be created using Github.
While the OpenCL Headers can be built and installed in isolation, it is part of the OpenCL SDK. If looking for streamlined build experience and a complete development package, refer to the SDK build instructions instead of the following guide.
- The OpenCL Headers CMake package support uses CMake for its build system. If CMake is not provided by your build system or OS package manager, please consult the CMake website.
While the headers may just be copied as-is, this repository also contains a CMake script with an install rule to allow for packaging the headers.
cmake -S . -B build -DCMAKE_INSTALL_PREFIX=/chosen/install/prefix cmake --build build --target install
Example CMake invocation
cmake -D CMAKE_PREFIX_PATH=/chosen/install/prefix /path/to/opencl/app
cmake_minimum_required(VERSION 3.0) cmake_policy(VERSION 3.0...3.18.4) project(proj) add_executable(app main.cpp) find_package(OpenCLHeaders REQUIRED) target_link_libraries(app PRIVATE OpenCL::Headers)
The OpenCL API headers in this repository are Unified headers and are designed to work with all released OpenCL versions. This differs from previous OpenCL API headers, where version-specific API headers either existed in separate branches, or in separate folders in a branch.
Compiling for a Specific OpenCL Version
By default, the OpenCL API headers in this repository are for the latest
OpenCL version (currently OpenCL 3.0). To use these API headers to target
a different OpenCL version, an application may
#define the preprocessor
CL_TARGET_OPENCL_VERSION before including the OpenCL API headers.
CL_TARGET_OPENCL_VERSION is a three digit decimal value representing
the OpenCL API version.
For example, to enforce usage of no more than the OpenCL 1.2 APIs, you may include the OpenCL API headers as follows:
#define CL_TARGET_OPENCL_VERSION 120 #include <CL/opencl.h>
README.md This file LICENSE Source license for the OpenCL API headers CL/ Unified OpenCL API headers tree
OpenCL and the OpenCL logo are trademarks of Apple Inc. used by permission by Khronos.