CogTransform2DPerspectiveAndRadial.Singular Method

CogTransform2DPerspectiveAndRadial Singular Method

Cognex VisionPro

Returns True if the specified point is within the given Tolerance (i.e., radius) of a singular point in the transform.

Namespace: Cognex.VisionPro
Assembly: Cognex.VisionPro.Core (in Cognex.VisionPro.Core.dll) Version: 65.1.0.0

Syntax

public bool Singular(
	double x,
	double y,
	double tolerance
)

public bool Singular(
	double x,
	double y,
	double tolerance
)

Public Function Singular ( 
	x As Double,
	y As Double,
	tolerance As Double
) As Boolean

Public Function Singular ( 
	x As Double,
	y As Double,
	tolerance As Double
) As Boolean

public:
bool Singular(
	double x, 
	double y, 
	double tolerance
)

public:
bool Singular(
	double x, 
	double y, 
	double tolerance
)

Parameters

x: Type: System Double
The X-coordinate of the point to evaluate.

y: Type: System Double
The Y-coordinate of the point to evaluate.

tolerance: Type: System Double
The tolerance value. If the point specified by x and y is within the tolerance distance of a singular point, this function returns True.

Return Value

Type: Boolean

True if the specified point is within tolerance of a singular point.

Remarks

Returns True if the specified point is within the given tolerance of a singular point in the transform.

In the case of a transformation that includes a nonzero value for PerspectiveDX or PerspectiveDY, a line of singular points exists. This line can be determined by reflecting the "vanishing point" over the line of identity (the line formed by all points that are unchanged by the transformation), as shown in the following figure:

Note that when this transformation is inverted (points are mapped from the red space to the blue space), the "vanishing point" is singular.