Reference Manual
Chapter
4
IVC-2D
©
SICK AG • Advanced Industrial Sensors • www.sick.com • All rights reserved
113
Matching
Get Shape
The Get Shape tool is used together with the Shape Locator tool to retrieve information
about a located shape.
The tool refers to a previous Shape Locator step and the zero-based index of a located
shape. It is possible to visualize the position of the specified shape if a destination bank is
specified. Note that only the green edges of the shape are drawn in the destination bank.
The actual live image must be copied separately to the image bank before calling this tool.
Input Parameters
01 = Shape locator step
The Shape Locator step that was used to find shapes.
02 = Shape index
The zero-based index of the shape to retrieve information
about.
03 = Visualization
Determines how the result shall be visualized in the desti-
nation bank.
04 = Destination bank
The image bank where the result shall be visualized. Set to
-1 if no visualization is used.
Returned Values
01 = Status code
The status of the execution of the 'Shape Locator' step.
02 = Ref. point X coor-
dinate
The x coordinate of the point that corresponds to the
reference point in the reference shape.
03 = Ref. point Y coor-
dinate
The y coordinate of the point that corresponds to the
reference point in the reference shape.
04 = Angle (degrees)
The angle of the found shape in the coordinate system
defined in the reference image.
05 = Scale
The scale of the found shape compared to the scale of the
shape defined in the reference image.
06 = Score
A measure of the resemblance of the shape found and the
reference shape. The score has an interval of 0 through
100, but it does not represent the similarity in percent.
SEARCH STATUS
The result Search status can have one of the following values
0 All
OK
8825
The reference point of the shape is located outside the image.
ERROR CODES
8810
The referenced step is not a Shape Locator step.
8812
The index of the shape is not valid, e.g. larger than the number of located
shapes.
8813
No results found from the Shape Locator tool. This can happen if the execution
of the Shape Locator tool failed for some reason.
8833
Timeout in the shape locating algorithm