F_VN_FitLineExp
Fit a line into a point set. (expert function)
Syntax
Definition:
FUNCTION F_VN_FitLineExp : HRESULT
VAR_INPUT
ipPointSet : ITcVnContainer;
END_VAR
VAR_IN_OUT
aFitLine : TcVnVector4_LREAL;
END_VAR
VAR_INPUT
eDistanceType : ETcVnDistanceType;
fParam : LREAL;
fEpsRadius : LREAL;
fEpsAngle : LREAL;
hrPrev : HRESULT;
END_VAR
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
ipPointSet |
Source point set (ContainerType_Vector_TcVnPoint2_DINT or ContainerType_Vector_TcVnPoint2_REAL; The elements of this container are the individual points.) | |
|
eDistanceType |
Distance computation method (supported: L1, L2, L12, FAIR, WELSCH, HUBER) | |
|
fParam |
LREAL |
Numerical parameter (c) for some eDistanceType (should be >= 0). If 0, an optimal value is chosen internally. |
|
fEpsRadius |
LREAL |
Accuracy of the radius (distance of the line from the coordinate origin, should be > 0). A smaller value means higher accuracy. |
|
fEpsAngle |
LREAL |
Accuracy of the angle (should be > 0). A smaller value means higher accuracy. |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
In/Outputs
|
Name |
Type |
Description |
|---|---|---|
|
aFitLine |
Resulting line. The first and second element describe the x and y component of a vector collinear to the line. The third and fourth element describe the x and y component of a point on the line. |
Return valueRequired License
TC3 Vision Base
System Requirements
Development environment | Target platform | PLC libraries to include |
|---|---|---|
TwinCAT V3.1.4024.54 or later | PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU | Tc3_Vision |