F_VN_MeasureAngleBetweenEdgesExp

Syntax

Definition:

FUNCTION F_VN_MeasureAngleBetweenEdgesExp : HRESULT
VAR_INPUT
    ipSrcImage             : ITcVnImage;
END_VAR
VAR_IN_OUT
    fAngle                 : REAL;
    aInnerPoint            : TcVnPoint2_REAL;
    aOuterPoint1           : TcVnPoint2_REAL;
    aOuterPoint2           : TcVnPoint2_REAL;
END_VAR
VAR_INPUT
    eEdgeDirection         : ETcVnEdgeDirection;
    fMinStrength           : REAL;
    nSearchLines           : UDINT;
    fSearchLineDist        : REAL;
    nMaxThickness          : UDINT;
    bInvertSearchDirection : BOOL;
    nSubpixelsIterations   : UDINT;
    bAngleInDegrees        : BOOL;
    fApproxPrecision       : REAL;
    eAlgorithm             : ETcVnEdgeDetectionAlgorithm;
    ipEdgePoints1          : Reference To  ITcVnContainer;
    ipEdgePoints2          : Reference To  ITcVnContainer;
    hrPrev                 : HRESULT;
END_VAR

Inputs

Name	Type	Description
ipSrcImage	ITcVnImage	Source image (1 channel)
eEdgeDirection	ETcVnEdgeDirection	Specification of the edge direction from aInnerPoint to aOuterPoint1 and aOuterPoint2 to search for
fMinStrength	REAL	Specification of the minimum strength (intensity difference) of the edge to search for
nSearchLines	UDINT	Width of the search window, i.e. the number of search lines (3, 5, 7, ...), centered around the line specified by aInnerPoint and aOuterPoint1, aOuterPoint2
fSearchLineDist	REAL	Distance between the search lines in pixels (> 0)
nMaxThickness	UDINT	Specification of the maximum thickness of the edge to search for, which means fMinStrength must be reached within nMaxThickness pixels
bInvertSearchDirection	BOOL	If true, the search starts from each aOuterPoint in direction of aInnerPoint
nSubpixelsIterations	UDINT	Specifies the number of subpixels (for INTERPOLATION, 10 - 20 usually is sufficient) or maximum number of iterations for optimizing the parameters (for APPROX_ERF and APPROX_GAUSSIAN, 50 - 100 usually is sufficient)
bAngleInDegrees	BOOL	fAngle is in degrees, if true
fApproxPrecision	REAL	Specifies the approximation precision for APPROX_ERF and APPROX_GAUSSIAN (0.001 usually is sufficient, unused for INTERPOLATION)
eAlgorithm	ETcVnEdgeDetectionAlgorithm	Selection of the edge detection algorithm
ipEdgePoints1	Reference To ITcVnContainer	Returns the detected edge points between aInnerPoint and aOuterPoint1 (ContainerType_Vector_TcVnPoint2_REAL)
ipEdgePoints2	Reference To ITcVnContainer	Returns the detected edge points between aInnerPoint and aOuterPoint2 (ContainerType_Vector_TcVnPoint2_REAL)
hrPrev	HRESULT	HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

In/Outputs

Name	Type	Description
fAngle	REAL	Returns the angle between the detected edges (radians or degrees, depending on bAngleInDegrees)
aInnerPoint	TcVnPoint2_REAL	Position inside the angle to measure, from which to start the edge search process (in the direction of aOuterPoint1 and aOuterPoint2)
aOuterPoint1	TcVnPoint2_REAL	Position where the search process for edge 1 ends
aOuterPoint2	TcVnPoint2_REAL	Position where the search process for edge 2 ends

Return value

HRESULT

Further information

The function F_VN_MeasureAngleBetweenEdgesExp is the expert version of F_VN_MeasureAngleBetweenEdges.

Parameter

Input image

The ipSrcImage input image must be a 1-channel grayscale image.

Angle ^{(Return value)}

The fAngle parameter returns the angle between the localized edges.

Depending on the bAngleInDegrees parameter, the fAngle angle is specified in radians (FALSE) or in degrees (TRUE).

Position information

To localize the edges, the common starting point (aInnerPoint) and the two target points (aOuterPoint1, aOuterPoint2) must first be specified. The position of the starting point must be within the angle to be measured from which the edge search process is started. The search process ends at the respective destination points.

Parameters for edge localization

The remaining parameters are explained in detail in the chapter Edge localization.

Localized points ^{(Expert, return value)}

The ipEdgePoints1 and ipEdgePoints2 containers return the exact points that were localized on the basis of each search line. If not needed, the 0 value can be transferred instead of an interface pointer

Application

The measurement of an angle with expert parameters looks like this, for example:

hr := F_VN_MeasureAngleBetweenEdgesExp(
    ipSrcImage             := ipImageIn,
    fAngle                 := fAngle,
    aInnerPoint            := aInnerPoint,
    aOuterPoint1           := aOuterPoint1,
    aOuterPoint2           := aOuterPoint2,
    eEdgeDirection         := TCVN_ED_LIGHT_TO_DARK,
    fMinStrength           := fMinStrength,
    nSearchLines           := nSearchLines,
    fSearchLineDist        := fSearchLineDist,
    nMaxThickness          := 7,
    bInvertSearchDirection := False,
    nSubpixelsIterations   := 10,
    bAngleInDegrees        := TRUE,
    fApproxPrecision       := 0.001, 
    eAlgorithm             := TCVN_EDA_INTERPOLATION,
    ipEdgePoints1          := ipEdgePoints1,
    ipEdgePoints2          := ipEdgePoints2,
    hrPrev                 := hr);

Samples

Measure Angle Between Edges

Related functions

ClosestPointsBF for calculating the closest points in two point clouds
MeasureAngleBetweenEdges for measuring the angle between two edges
MeasureEdgeDistance for measuring the average distance between two edges
MeasureMinEdgeDistance for measuring the minimum distance between two edges

Required License

TC3 Vision Metrology 2D