TransEdgesToWorld

Converts an Edges structure from image coordinates to world coordinates. The function computes the offset and orientation of the edges 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.

TransEdgesToWorld Inputs

Syntax: TransEdgesToWorld(Calib,Edges,Number to Convert)

Parameter Description

Calib

This argument must reference a spreadsheet cell that contains a valid Calib data structure.

Edges

This argument must reference a spreadsheet cell that contains a valid Edges data structure.

Number to Convert

Specifies the number of edges from the original Edges data structure to convert to world coordinates. (0 to 160; default = 3)

TransEdgesToWorld Outputs

 Returns

Edges data structure containing the transformed edges, or #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.

TransEdgesToWorld 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 sort and pair Edges data structures. For more information, see Edges, SortEdges, PairEdges, Edge, Property Sheet or Calibrate.