F_VN_FindReferenceKeyPointsInImageBRISKExp
Searches a reference image, represented by its BRISK keypoints and corresponding descriptors, in a given source image. (expert function)
Can use available TwinCAT Job Tasks for executing parallel code regions.
Syntax
Definition:
FUNCTION F_VN_FindReferenceKeyPointsInImageBRISKExp : HRESULT
VAR_INPUT
ipSrcImage : ITcVnImage;
ipRefKeyPoints : ITcVnContainer;
ipRefDescriptors : ITcVnImage;
nRefImageWidth : UDINT;
nRefImageHeight : UDINT;
ipEdgePoints : Reference To ITcVnContainer;
fMaxDist : REAL;
fMaxKnnRatio : REAL;
eNormType : ETcVnNormalizationType;
ipSrcImageMask : ITcVnImage;
END_VAR
VAR_IN_OUT
stBriskParams : TcVnParamsBRISK;
END_VAR
VAR_INPUT
eAlgorithm : ETcVnEstimationAlgorithm;
fReprojThreshold : LREAL;
nMaxIterations : UDINT;
fConfidence : LREAL;
hrPrev : HRESULT;
END_VAR
VAR_OUTPUT
aPerspectiveTransform : TcVnMatrix3x3_LREAL;
nNumberOfGoodMatches : UDINT;
nNumberOfInliers : UDINT;
END_VAR
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
ipSrcImage |
Source image | |
|
ipRefKeyPoints |
KeyPoints of the reference image, e.g. computed with F_VN_KeyPointsAndDescriptorsBRISK (ContainerType_Vector_TcVnKeyPoint) | |
|
ipRefDescriptors |
Descriptors of the reference image KeyPoints, e.g. computed with F_VN_KeyPointsAndDescriptorsBRISK | |
|
nRefImageWidth |
UDINT |
Width of the reference image in pixels |
|
nRefImageHeight |
UDINT |
Height of the reference image in pixels |
|
ipEdgePoints |
Reference To ITcVnContainer |
Returns a container with the 4 edge points of the reference image transformed into ipSrcImage coordinates (ContainerType_Vector_TcVnPoint2_REAL) |
|
fMaxDist |
REAL |
Maximum allowed descriptor distance (-1 disables this filter criterion) |
|
fMaxKnnRatio |
REAL |
Maximum allowed distance ratio between first and second best match ([0..1], -1 disables this filter criterion) |
|
eNormType |
Normalization type used for descriptor matching | |
|
ipSrcImageMask |
Mask to specify, where to look for keypoints in ipSrcImage (set to 0 if no mask required) | |
|
eAlgorithm |
Estimation algorithm used for computing the perspective transformation between the two point sets | |
|
fReprojThreshold |
LREAL |
Maximum allowed reprojection error to treat a point pair as an inlier (only used if eAlgorithm is RANSAC, RHO) |
|
nMaxIterations |
UDINT |
Maximum number of RANSAC iterations |
|
fConfidence |
LREAL |
Confidence (0..1) |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
In/Outputs
|
Name |
Type |
Description |
|---|---|---|
|
stBriskParams |
Parameters to configure the keypoint and descriptor computation for ipSrcImage (resulting descriptors must be compatible to ipRefDescriptors!) |
Outputs
|
Name |
Type |
Description |
|---|---|---|
|
aPerspectiveTransform |
Returns the perspective transformation matrix, which transforms the reference points to the source points | |
|
nNumberOfGoodMatches |
UDINT |
Return the number of good matches |
|
nNumberOfInliers |
UDINT |
Return the number of inlier matches |
Required License
TC3 Vision Matching