Function dynamic_ocl::load_opencl

pub fn load_opencl() -> Result<OpenCLVersion, &'static Error>

Attempt to load the system OpenCL library, if not already loaded.

This function will search for the OpenCL library using the absolute path or library name specified by the OPENCL_LIBRARY environment variable if set, and from the system library path using a platform-specific version of the name OpenCL if not set.

Once the library has been found and opened, symbols will be loaded from it and bound to the appropriate function pointers in the raw module. This call will attempt to determine the OpenCL version supported by the library based on which symbols are present or missing, which will be returned. Any functions for which symbols could not be found will be replaced by a shim that simply panics.

Calling any raw function before OpenCL has been loaded with this function will implicitly call this function to load OpenCL, panicking on failure.

The result of this call (including implicit calls from raw function shims) will be stored in static memory, and future calls will simply return the stored result rather than attempting to load the library again. Since raw function pointers are replaced by this call, there is no overhead for OpenCL library calls once the functions have been bound.