Edges Vision Data Access Functions

Functions that get values from an Edges structure.

Note: Each of the following functions references a Edge data structure as the first parameter.

Function

Description

GetAngle(Edges, [Index])

Returns the Angle of the indexed edge.

GetContrast(Edges)

Returns the average contrast between the foreground and background (in grey levels, 0 to 255) found. Contrast is positive for black-to-white transitions, and negative for white-to-black transitions. The Edge structure must be created by a FindCircleMinMax function.

GetEdgeDistance(Edges, [Index])

Returns the distance between two edges (edge pair). The Edge structure must be created by a Caliper function.

GetMax(Edges)

Returns the radius of the maximum deviation from the best edge. The Edge structure must be created by a FindCircleMinMax function.

GetMin(Edges)

Returns the radius of the minimum deviation from the best edge. The Edge structure must be created by a FindCircleMinMax function.

GetNFound(Edges)

Returns the number of edges found.

GetPosition(Edges, [Index])

Returns the region X position in pixels of the edge or the edge pair center.

GetRadius(Edges, [Index])

Returns the radius of a specified circle or arc.

GetScore(Edges, [Index1], [Index2])

Returns the Score value (0-100) from the indexed edge. Score is positive for black-to-white transitions and negative for white-to-black transitions (except for FindSegment and FindCircleMinMax, where Score is always positive).

GetSDev(Edges)

Returns the standard deviation value. The Edge structure must be created by a FindCircleMinMax function.

Note: This calculation is a biased standard deviation, where the denominator is N-1 (an unbiased standard deviation has a denominator of N).

GetX(Edges, [Index1], [Index2])

Returns a x-coordinate. Index1 selects the edge number, and Index2 specifies an end point (0 = top-most point; 1 = bottom-most point).

GetY(Edges, [Index1], [Index2])

Returns a y-coordinate. Index1 selects the edge number, and Index2 specifies an end point (0 = left-most point; 1 = right-most point).