TransPatternsToWorld

Converts a Patterns structure from image coordinates to world coordinates. 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.

TransPatternsToWorld Inputs

Syntax: TransPatternsToWorld(Calib,Patterns,Number to Convert)

Parameter	Description
Calib	This argument must reference a spreadsheet cell that contains a valid Calib data structure.
Patterns	This argument must reference a spreadsheet cell that contains a valid Patterns data structure.
Number to Convert	Specifies the number of patterns from the original Patterns data structure to convert to world coordinates. (0 to 100; default = 1)

TransPatternsToWorld Outputs

Returns

Patterns data structure containing the transformed patterns, or #ERR if any of the input parameters are invalid.

Note: If TransPatternsToWorld function is referenced by a TransPatternsToFixture function, the TransPatternsToFixture function will still report results in pixel coordinates, even though the TransPatternsToWorld outputs real-world coordinates. For more information, see TransPatternsToFixture.

Results

When the function is initially inserted into a cell, a result table is created in the spreadsheet.

TransPatternsToWorld Vision Data Access Functions

The Vision Data Access functions automatically inserted into the spreadsheet will be similar to those automatically inserted by the functions used to find and sort Patterns data structures. For more information, see Patterns, FindPatterns, SortPatterns, Fixture, Pattern Match, or Property Sheet.