CogCaliperScorerContrast.GetXYParameters Method

CogCaliperScorerContrast GetXYParameters Method

Cognex VisionPro

Get the parameters used to map an edge candidate's contrast to a score. Contrast is the absolute difference in average pixel values across the edge, and has a range of 0 through 255. Score is a unitless value in the range of 0.0 (no edge found) through 1.0 (edge found).

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

Syntax

C++

Copy to Clipboard Print

public void GetXYParameters(
	out double x0,
	out double x1,
	out double xc,
	out double y0,
	out double y1
)

public void GetXYParameters(
	out double x0,
	out double x1,
	out double xc,
	out double y0,
	out double y1
)

Public Sub GetXYParameters ( 
	<OutAttribute> ByRef x0 As Double,
	<OutAttribute> ByRef x1 As Double,
	<OutAttribute> ByRef xc As Double,
	<OutAttribute> ByRef y0 As Double,
	<OutAttribute> ByRef y1 As Double
)

Public Sub GetXYParameters ( 
	<OutAttribute> ByRef x0 As Double,
	<OutAttribute> ByRef x1 As Double,
	<OutAttribute> ByRef xc As Double,
	<OutAttribute> ByRef y0 As Double,
	<OutAttribute> ByRef y1 As Double
)

public:
void GetXYParameters(
	[OutAttribute] double% x0, 
	[OutAttribute] double% x1, 
	[OutAttribute] double% xc, 
	[OutAttribute] double% y0, 
	[OutAttribute] double% y1
)

public:
void GetXYParameters(
	[OutAttribute] double% x0, 
	[OutAttribute] double% x1, 
	[OutAttribute] double% xc, 
	[OutAttribute] double% y0, 
	[OutAttribute] double% y1
)

Parameters

x0: Type: System Double
A contrast value in the range of 0 through 255 that helps describe how an edge candidate's contrast is mapped to a score. Contrast values between x0 and x1 are mapped to a score that is between y0 and y1, while contrast values on the other side of x0 are mapped to a score of y0.

x1: Type: System Double
A contrast value in the range of 0 through 255 that helps describe how an edge candidate's contrast is mapped to a score. The value of x1 must fall between the values of xc and x0. Contrast values between x0 and x1 are mapped to a score that is between y0 and y1, while contrast values between xc and x1 are mapped to a score of y1.

xc: Type: System Double
A contrast value in the range of 0 through 255 that helps describe how an edge candidate's contrast is mapped to a score. Contrast values between xc and x1 are mapped to a score of y1, while contrast values on the other side of xc are mapped to a score of zero.

y0: Type: System Double
The maximum score that will be produced by this scoring function. This unitless value is in the range of 0.0 through 1.0, and must be greater than the y1 value.

y1: Type: System Double
The minimum non-zero score that will be produced by this scoring function. This unitless value is in the range of 0.0 through 1.0, and must be less than the y0 value.

Remarks

Function that gets the individual values that define this scoring function as shown in the following figure:

If x1 is less than x0 raw scores above x0 are mapped to y0, raw scores between xc and x1 are mapped to y1. Raw scores below xc are mapped to a score of 0.

If x0 is less than x1 raw scores below x0 are mapped to y0, raw scores between x1 and xc are mapped to y1. Raw scores above xc are mapped to a score of 0.