This filter selects desired OpenCL processing device and initializes internal OpenCL processing context. This filter is required to be executed at beginning of a program in order to move processing of OpenCL capable filters to OpenCL device. After executing this filter OpenCL processing is initialized and enabled for consecutive filters. Refer to filters documentation to find which filters can benefit from OpenCL processing. Do not initialize OpenCL processing if you are not using OpenCL capable filters to not waste system resources.

Performance of OpenCL capable filters may vary depending on processed data and target system hardware properties. Resulting performance is hard to predict and always have to be measured on target system. In some situations filters can be executed on OpenCL device without significant speedup or even slower than on CPU and in such cases specific filter instances can be excluded from processing on OpenCL device. In order to specify how OpenCL capable filters will be executed (using CPU or OpenCL device) use EnableGPUProcessing.

Processing is performed using single OpenCL device from system. By default (when inputs are left on auto) the first graphics card found in system that supports required OpenCL properties is selected as processing device. inPlatformName input can be used to limit device search only to specified OpenCL provider platform. inPlatformName is case insensitive and must be set to a name or a fragment of a name of required platform (like "intel" for "Intel(R) OpenCL" platform or "nvidia" for "NVIDIA CUDA" platform). inDeviceName input can be used to manually pick a processing device from local system. Similarly inPlatformName is case insensitive and must be set to a full name or a fragment of a name of required OpenCL device.

diagDeviceInfo diagnostic output (available in diagnostic execution mode) can be used to verify which device is used for processing and what are its capabilities. Output is formed as a human readable text that can be viewed by dragging this output to a preview panel.

For OpenCL capable device to be available for processing a proper device driver or a runtime environment must be installed on a target system. For graphics cards a dedicated device driver, provided by its vendor, must be installed. Be sure to use the newest drivers and always keep device drivers up to date. For some devices a separate dedicated OpenCL runtime library may be needed on target system. Refer to device vendor documentation for more information. Aurora Vision Studio filters requires OpenCL device supporting OpenCL C language with compiler in version 1.1 or greater.

When there is no OpenCL capable device available in system, specified platform name or device name cannot be found or selected device does not supports required properties an IOError is raised by this filter.

This filter initializes OpenCL processing context on a level of current Task Macrofilter. When task macrofilter is left the OpenCL processing context is closed. Be sure to not initialize and close OpenCL processing without the need. Do not nest InitGPUProcessing in Task Macrofilters when it is not required.

Be aware that first execution of this filter as well as first execution of OpenCL processing filters (when OpenCL processing is enabled) requires an extra initialization of OpenCL state and can be significantly longer that execution in next iterations.

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

This filter is available on Advanced Complexity Level.

• EnableGPUProcessing – Resumes or suspends GPU OpenCL processing in filters.