TransPatternsToWorld

Applies a coordinate transform to a Patterns structure. The function computes the offset and orientation of the patterns response points with respect to the specified real-world coordinate system.

Note: The output of any vision tool that reports in real-world coordinates cannot be used as a fixture or region input to another vision tool.
Parameter Description

Calib

A reference to a spreadsheet cell containing a valid Calib data structure.

Patterns

A reference to a spreadsheet cell containing a valid Patterns data structure.

Number to Convert

Specifies the number of patterns from the original Patterns data structure to convert to real-world coordinates. (0 to 1024; default = 1)

Returns

Patterns structure translated to real-world coordinates, or returns #ERR if any of the input parameters are invalid.

Results

When the function is initially inserted into a cell, a result table is created in the spreadsheet using the following Patterns Vision Data Access functions:

Label Function Description
Index   Indexed Position

X

GetX(Patterns, Index)

The X-coordinate of the pattern position.

Y

GetY(Patterns, Index)

The Y-coordinate of the pattern position.

Angle

GetAngle(Patterns, Index)

The orientation of the pattern position.

Scale

GetScale(Patterns, Index)

The size of the pattern found compared to the trained model, as a percentage of the model size.

Score

GetScore(Patterns, Index)

The pattern response score.