MeasureAngleBetweenEdges

Syntax

Definition:

HRESULT MeasureAngleBetweenEdges(
    HRESULT                     hrPrev,
    ITcVnImage*                 ipSrcImage,
    float&                      fAngle,
    TcVnPoint2_REAL&            aInnerPoint,
    TcVnPoint2_REAL&            aOuterPoint1,
    TcVnPoint2_REAL&            aOuterPoint2,
    ETcVnEdgeDirection          eEdgeDirection,
    float                       fMinStrength,
    ULONG                       nSearchLines,
    float                       fSearchLineDist = 1,
    ULONG                       nMaxThickness = 10,
    bool                        bInvertSearchDirection = false,
    ULONG                       nSubpixelsIterations = 10,
    bool                        bAngleInDegrees = false,
    float                       fApproxPrecision = 0.001f,
    ETcVnEdgeDetectionAlgorithm eAlgorithm = EDA_INTERPOLATION,
    ITcVnContainer**            pipEdgePoints1 = nullptr,
    ITcVnContainer**            pipEdgePoints2 = nullptr
)

Parameters

Name	Type	Default	Description
hrPrev	HRESULT		HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)
ipSrcImage	ITcVnImage*		Source image (1 channel)
fAngle	float&		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
eEdgeDirection	ETcVnEdgeDirection		Specification of the edge direction from aInnerPoint to aOuterPoint1 and aOuterPoint2 to search for
fMinStrength	float		Specification of the minimum strength (intensity difference) of the edge to search for
nSearchLines	ULONG		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	float	1	Distance between the search lines in pixels (> 0)
nMaxThickness	ULONG	10	Specification of the maximum thickness of the edge to search for, which means fMinStrength must be reached within nMaxThickness pixels
bInvertSearchDirection	bool	false	If true, the search starts from each aOuterPoint in direction of aInnerPoint
nSubpixelsIterations	ULONG	10	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	false	fAngle is in degrees, if true
fApproxPrecision	float	0.001f	Specifies the approximation precision for APPROX_ERF and APPROX_GAUSSIAN (0.001 usually is sufficient, unused for INTERPOLATION)
eAlgorithm	ETcVnEdgeDetectionAlgorithm	EDA_INTERPOLATION	Selection of the edge detection algorithm
pipEdgePoints1	ITcVnContainer**	nullptr	Returns the detected edge points between aInnerPoint and aOuterPoint1 (ContainerType_Vector_TcVnPoint2_REAL)
pipEdgePoints2	ITcVnContainer**	nullptr	Returns the detected edge points between aInnerPoint and aOuterPoint2 (ContainerType_Vector_TcVnPoint2_REAL)

Return value

HRESULT

Required License

TC3 Vision Metrology 2D

System Requirements

Development environment	Target platform	PLC libraries to include
TwinCAT V3.1. 4024.44 or later	PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU	Tc3_Vision