ClassesClassesClassesClasses | | | | Operators

activate_compute_deviceactivate_compute_deviceActivateComputeDeviceactivate_compute_deviceActivateComputeDeviceActivateComputeDevice (Operator)

Name

activate_compute_deviceactivate_compute_deviceActivateComputeDeviceactivate_compute_deviceActivateComputeDeviceActivateComputeDevice — Activate a compute device.

Signature

activate_compute_device( : : DeviceHandle : )

Herror activate_compute_device(const Hlong DeviceHandle)

Herror T_activate_compute_device(const Htuple DeviceHandle)

Herror activate_compute_device(const HTuple& DeviceHandle)

void HComputeDevice::ActivateComputeDevice() const

void ActivateComputeDevice(const HTuple& DeviceHandle)

void HComputeDevice::ActivateComputeDevice() const

void HOperatorSetX.ActivateComputeDevice([in] VARIANT DeviceHandle)

void HComputeDeviceX.ActivateComputeDevice()

static void HOperatorSet.ActivateComputeDevice(HTuple deviceHandle)

void HComputeDevice.ActivateComputeDevice()

Description

activate_compute_deviceactivate_compute_deviceActivateComputeDeviceactivate_compute_deviceActivateComputeDeviceActivateComputeDevice activates the compute device DeviceHandleDeviceHandleDeviceHandleDeviceHandleDeviceHandledeviceHandle for the current HALCON thread. All subsequent HALCON operators called in this thread are executed on DeviceHandleDeviceHandleDeviceHandleDeviceHandleDeviceHandledeviceHandle if they provide an implementation (see get_operator_infoget_operator_infoGetOperatorInfoget_operator_infoGetOperatorInfoGetOperatorInfo) for this device. Use deactivate_compute_devicedeactivate_compute_deviceDeactivateComputeDevicedeactivate_compute_deviceDeactivateComputeDeviceDeactivateComputeDevice to deactivate DeviceHandleDeviceHandleDeviceHandleDeviceHandleDeviceHandledeviceHandle.

Currently, only one compute device can be active for a HALCON thread. If a different device is active before activate_compute_deviceactivate_compute_deviceActivateComputeDeviceactivate_compute_deviceActivateComputeDeviceActivateComputeDevice is called, this device is deactivated automatically.

Parallelization

Parameters

DeviceHandleDeviceHandleDeviceHandleDeviceHandleDeviceHandledeviceHandle (input_control)  compute_device HComputeDevice, HTupleHTupleHComputeDevice, HTupleHComputeDeviceX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Compute device handle.

Example (HDevelop)

open_compute_device (DeviceIdentifier, DeviceHandle)
read_image (Image, 'rings_and_nuts')
*
* Gaussian convolution on a compute device
activate_compute_device (DeviceHandle)
derivate_gauss (Image, DerivGauss, 5, 'none')
*
* Gaussian convolution on the CPU
deactivate_compute_device (DeviceHandle)
derivate_gauss (Image, DerivGauss, 5, 'none')

Result

activate_compute_deviceactivate_compute_deviceActivateComputeDeviceactivate_compute_deviceActivateComputeDeviceActivateComputeDevice returns the value 2 (H_MSG_TRUE) if DeviceHandleDeviceHandleDeviceHandleDeviceHandleDeviceHandledeviceHandle is valid. Otherwise an exception will be raised.

Possible Predecessors

open_compute_deviceopen_compute_deviceOpenComputeDeviceopen_compute_deviceOpenComputeDeviceOpenComputeDevice

See also

deactivate_compute_devicedeactivate_compute_deviceDeactivateComputeDevicedeactivate_compute_deviceDeactivateComputeDeviceDeactivateComputeDevice, deactivate_all_compute_devicesdeactivate_all_compute_devicesDeactivateAllComputeDevicesdeactivate_all_compute_devicesDeactivateAllComputeDevicesDeactivateAllComputeDevices

Module

Foundation


ClassesClassesClassesClasses | | | | Operators