IF_TargetsHandler - AddTargetWithSlots (Method)

Overview

Type:	Method
Available as of:	V1.4.1.0

This chapter provides information on:

Adds a target to the list allowing you to assign a different target type to each slot.

The method AddTargetWithSlots adds a target to the list handled by the function block allowing you to assign a different target type to each slot.

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.
i_auiSlotsTypeList	ARRAY [1..Gc_uiMaxNumberOfSlots] OF UINT	A list that describes the type of each slot.

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 container target created by the targets handler.
q_udiUnivocalId	UDINT	Unique identifier linked to the container target.

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

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.

Enumeration name:	NumberOfSlotsInvalid
Enumeration value:	117
Description:	The configured number of slots is invalid for a called method.

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 number of configured slots is zero.	Ensure that the number of configured slots is greater than zero before calling this method. To configure the number of configured slots, call the ConfigureSlotList method.

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.

Status Message: A new target with a list of slots has been successfully added to the list.

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.

Adding a target to the list was unsuccessful.

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.