69 / 109Issued: 11.10.2013 Version: KST VisionTech 2.1 V1
11 Programming
Explanation of
the syntax
Example
11.7.1 Structure of VTRESULT
11.8 Subprogram VTRESULT_CHECK
Description The subprogram VTRESULT_CHECK checks the result of an image process-
ing task. If the result is faulty, a message is displayed. The result of the image
Element Description
RET Correction frame that can be offset against the compo-
nent base
Type: FRAME
Image processing
result
Image processing result from which the correction
frame is extracted
Type: VTRESULT (IN)
(>>> 11.7.1 "Structure of VTRESULT" Page 69)
DECL VTRESULT RESULT
RESULT = GET_VTRESULT("VisionTechConfig")
CORRECTIONFRAME = GET_VTCORRECTIONFRAME(RESULT)
BASE_DATA[3] = BASE_DATA[2]:CORRECTIONFRAME
Name Unit Data type Description
X mm REAL Translational deviation in the X direction
relative to the nominal position.
Y mm REAL Translational deviation in the Y direction
relative to the nominal position.
Z mm REAL Translational deviation in the Z direction
relative to the nominal position.
A degrees REAL Rotational deviation about the Z axis rela-
tive to the nominal position.
B degrees REAL Rotational deviation about the Y axis rela-
tive to the nominal position.
C degrees REAL Rotational deviation about the X axis rela-
tive to the nominal position.
SCORE REAL For a 2D task:
Match between the trained pattern and the
pattern on the current search image.
Note: The value is normally between 0.0
and 1.0. The closer the value is to 1.0, the
better the match.
For a 3D task:
Mean square residual error after calcula-
tion of the object position relative to the
nominal position.
Note: If the position of the object cannot be
calculated, the value -1 is displayed.
SUCCEEDED BOOL
TRUE: The image processing task has
been executed successfully.
FALSE: An error occurred during exe-
cution of the image processing task.
ERRORMESSAGE CHAR[100] Indicates errors that have occurred during
execution of the image processing task.