IF_TargetsHandler - AddTarget (Method)

Overview

Type:	Method
Available as of:	V1.4.1.0

This chapter provides information on:

Task

Adds a target to the list handled by the function block.

Description

The method AddTarget adds a target to the list handled by the function block.

Interface

Input	Data type	Description
i_stPose	ST_CartesianPose	The Cartesian pose of the target when it was first detected in the system (for example, the pose returned by a vision system).
i_lrEncoderPosition	LREAL	The position of the encoder linked to the targets handler when the target was first detected by the system.
i_uiType	UINT	An integer value used to identify a specific product type.

Output	Data type	Description
q_etDiag	GD.ET_Diag	General library-independent statement on the diagnostic. A value unequal to GD.ET_Diag.Ok corresponds to a diagnostic message.
q_etDiagExt	ET_DiagExt	POU-specific output on the diagnostic. q_etDiag = ET_Diag.Ok -> Status message q_etDiag <> ET_Diag.Ok -> Diagnostic message
q_sMsg	STRING[80]	Event-triggered message that gives more detailed information on the diagnostic state.
q_udiListIndex	UDINT	Index of the target created inside the targets handler.
q_udiUnivocalId	UDINT	Unique identifier linked to the target.

Diagnostic Messages

q_etDiag	q_etDiagExt	Enumeration value	Description
Ok	Ok	0	Ok
ExecutionAborted	MaxNumberOfTargetsExceeded	108	The list already contains the maximum number of targets.
ExecutionAborted	NotConfigured	101	The function block is not configured yet.
ExecutionAborted	UpdateTargetsActive	109	An update of the target handler targets is running and some method cannot be called.
ExecutionAborted	UnexpectedFeedback	4	Internal error detected.
InputParameterInvalid	OrientationConventionInvalid	38	Invalid orientation convention.

MaxNumberOfTargetsExceeded

Enumeration name:	MaxNumberOfTargetsExceeded
Enumeration value:	108
Description:	The list already contains the maximum number of targets.

Issue	Cause	Solution
The target has not been added to the targets handler.	The maximum number (Gc_udiMaxNumberOfTargets) of targets has been reached. It is not possible to add new targets.	Remove the targets from the list once they have been processed by the system.

NotConfigured

Enumeration name:	NotConfigured
Enumeration value:	101
Description:	The function block is not configured yet.

Issue	Cause	Solution
The target has not been added to the targets handler.	The Configuration method has not been called yet.	Ensure that the Configuration method has been successfully called before calling this method.

Status Message: The target has been successfully added to the targets handler.

OrientationConventionInvalid

Enumeration name:	OrientationConventionInvalid
Enumeration value:	38
Description:	Invalid orientation convention.

Issue	Cause	Solution
The target has not been added to the targets handler.	The input value of i_stPose.etOrientationConvention is invalid.	Provide one of the permissible values of ROB.ET_OrientationConvention. Refer to Robotic Library - ET_OrientationConvention.

Issue

Cause

Solution

The target has not been added to the targets handler.

The input value of i_stPose.etOrientationConvention is invalid.

Provide one of the permissible values of ROB.ET_OrientationConvention.

UnexpectedFeedback

Adding a target to the list was unsuccessful.

UpdateTargetsActive

Enumeration name:	UpdateTargetsActive
Enumeration value:	109
Description:	An update of the target handler targets is running and some method cannot be called.

Issue	Cause	Solution
The target has not been added to the targets handler.	It is not possible to add a new target to the targets handler while the UpdateTargets method is running.	Ensure that the UpdateTargets method is not running before calling this method.