set_compute_device_paramT_set_compute_device_paramSetComputeDeviceParamSetComputeDeviceParamset_compute_device_param (算子)

名称

set_compute_device_paramT_set_compute_device_paramSetComputeDeviceParamSetComputeDeviceParamset_compute_device_param — 设置计算设备的参数。

签名

描述

set_compute_device_paramset_compute_device_paramSetComputeDeviceParamSetComputeDeviceParamSetComputeDeviceParamset_compute_device_param sets parameters of the compute device DeviceHandleDeviceHandleDeviceHandleDeviceHandledeviceHandledevice_handle for the current HALCON thread.

The following parameters can be set:

'alloc_pinned'"alloc_pinned""alloc_pinned""alloc_pinned""alloc_pinned""alloc_pinned"

If 'true'"true""true""true""true""true", the output image matrices of all operators (executed on the compute device or not) called in the current HALCON thread are created in page locked (so called 'pinned') memory. This accelerates the transfer between host and device memory. However, too excessive usage of page locked memory may have a negative impact on overall system performance. You should activate page locked memory allocation if the output image of of the next operator call is to be transferred to the device. Page locked memory allocation should be deactivated for all operator calls whose output images are not required on the compute device (see example).

值列表： 'true'"true""true""true""true""true", 'false'"false""false""false""false""false".

默认值： 'true'"true""true""true""true""true".

'asynchronous_execution'"asynchronous_execution""asynchronous_execution""asynchronous_execution""asynchronous_execution""asynchronous_execution"

If 'true'"true""true""true""true""true", operators executed on the compute device do not wait for the device computations to finish but return after initiating the computations. All device computations are synchronized as soon as the output of a compute device operation is used on the CPU (e.g., by disp_imagedisp_imageDispImageDispImageDispImagedisp_image).

值列表： 'true'"true""true""true""true""true", 'false'"false""false""false""false""false".

默认值： 'true'"true""true""true""true""true".

'buffer_cache_capacity'"buffer_cache_capacity""buffer_cache_capacity""buffer_cache_capacity""buffer_cache_capacity""buffer_cache_capacity"

Maximum size (in bytes) of the compute device buffer cache.

默认值： 1/3 of the available device memory

'image_cache_capacity'"image_cache_capacity""image_cache_capacity""image_cache_capacity""image_cache_capacity""image_cache_capacity"

Maximum size (in bytes) of the compute device image cache.

默认值： 1/3 of the available device memory

'pinned_mem_cache_capacity'"pinned_mem_cache_capacity""pinned_mem_cache_capacity""pinned_mem_cache_capacity""pinned_mem_cache_capacity""pinned_mem_cache_capacity"

Maximum size (in bytes) of the page locked (pinned) memory cache.

默认值： 32000000 (32MByte)

执行信息

• 多线程类型：可重入（与非独占算子并行运行）。
• 多线程作用域：局部（仅可在创建窗口、模型或工具实例的同一线程中调用）。
• 未采用并行化处理。

参数

示例（HDevelop）

activate_compute_device (DeviceHandle)
read_image (Image, 'fuse')
set_compute_device_param (DeviceHandle, 'alloc_pinned', 'true')
* filter on compute device, output image is page locked
derivate_gauss (Image, DerivGauss, 3, 'gradient')
* filter result on the CPU, output image should not be page locked
set_compute_device_param (DeviceHandle, 'alloc_pinned', 'false')
median_image (DerivGauss, ImageMedian, 'circle', 1, 'mirrored')

结果

算子 set_compute_device_paramset_compute_device_paramSetComputeDeviceParamSetComputeDeviceParamSetComputeDeviceParamset_compute_device_param 在参数正确时返回值 2 ( H_MSG_TRUE )。否则将抛出异常。

可能的前趋

activate_compute_deviceactivate_compute_deviceActivateComputeDeviceActivateComputeDeviceActivateComputeDeviceactivate_compute_device

另见

get_compute_device_paramget_compute_device_paramGetComputeDeviceParamGetComputeDeviceParamGetComputeDeviceParamget_compute_device_param

模块

基础