Back to Adaptive Vision Studio website

You are here: Start » Filter Reference » Configuration » InitGPUProcessing

InitGPUProcessing


Initializes GPU OpenCL processing.

Name Type Description
inPlatformName String* Name or fragment of a name of OpenCL provider platform
inDeviceName String* Name or fragment of a name of OpenCL device
diagDeviceInfo String Provides human readable diagnostic information about OpenCL device selected for processing

Description

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)