HALCON Reference Manual 10.0.2
Table of Contents / System / Compute Devices ClassesClassesClasses | | | Operators

init_compute_deviceT_init_compute_deviceinit_compute_deviceInitComputeDeviceInitComputeDevice (Operator)

Name

init_compute_deviceT_init_compute_deviceinit_compute_deviceInitComputeDeviceInitComputeDevice — Initialize a compute device.

Signature

init_compute_device( : : DeviceHandle, Operators : )

Herror T_init_compute_device(const Htuple DeviceHandle, const Htuple Operators)

Herror init_compute_device(const HTuple& DeviceHandle, const HTuple& Operators)

void HComputeDevice::InitComputeDevice(const HTuple& Operators) const

void HOperatorSetX.InitComputeDevice(
[in] VARIANT DeviceHandle, [in] VARIANT Operators)

void HComputeDeviceX.InitComputeDevice([in] VARIANT Operators)

static void HOperatorSet.InitComputeDevice(HTuple deviceHandle, HTuple operators)

void HComputeDevice.InitComputeDevice(HTuple operators)

Description

init_compute_deviceinit_compute_deviceinit_compute_deviceInitComputeDeviceInitComputeDevice initializes a compute device and prepares a list of operators given in OperatorsOperatorsOperatorsOperatorsoperators for the execution on this device. Further the device is activated for the current thread. If init_compute_deviceinit_compute_deviceinit_compute_deviceInitComputeDeviceInitComputeDevice is not called or operators other than those in OperatorsOperatorsOperatorsOperatorsoperators are used on the device, the initialization is performed on demand.

Use get_operator_infoget_operator_infoget_operator_infoGetOperatorInfoGetOperatorInfo to test if an operator qualifies for execution on the compute device.

Attention

Be aware that the execution time of init_compute_deviceinit_compute_deviceinit_compute_deviceInitComputeDeviceInitComputeDevice depends on the number of OperatorsOperatorsOperatorsOperatorsoperators and may last up to several seconds.

Parallelization

Parameters

DeviceHandleDeviceHandleDeviceHandleDeviceHandledeviceHandle (input_control)  compute_device → HComputeDevice, HTupleHComputeDevice, HTupleHComputeDeviceX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong)

Compute device handle.

OperatorsOperatorsOperatorsOperatorsoperators (input_control)  string-array → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

List of operators to prepare.

Default value: 'all' "all" "all" "all" "all"

List of values: 'all'"all""all""all""all", 'derivate_gauss'"derivate_gauss""derivate_gauss""derivate_gauss""derivate_gauss", 'sobel_amp'"sobel_amp""sobel_amp""sobel_amp""sobel_amp"

Result

The operator init_compute_deviceinit_compute_deviceinit_compute_deviceInitComputeDeviceInitComputeDevice returns the value 2 (H_MSG_TRUE) if the initialization was successful. Otherwise an exception will be raised.

Possible Predecessors

query_available_compute_devicesquery_available_compute_devicesquery_available_compute_devicesQueryAvailableComputeDevicesQueryAvailableComputeDevices, open_compute_deviceopen_compute_deviceopen_compute_deviceOpenComputeDeviceOpenComputeDevice

Possible Successors

activate_compute_deviceactivate_compute_deviceactivate_compute_deviceActivateComputeDeviceActivateComputeDevice

Module

Foundation

Table of Contents / System / Compute Devices ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH