DrawMatches
Draws the keypoints and matches for visualization purpose.
Can use available TwinCAT Job Tasks for executing parallel code regions.
Syntax
Definition:
HRESULT DrawMatches(
HRESULT hrPrev,
ITcVnImage* ipSrcImage1,
ITcVnContainer* ipKeyPoints1,
ITcVnImage* ipSrcImage2,
ITcVnContainer* ipKeyPoints2,
ITcVnContainer* ipMatches1To2,
ITcVnImage*& ipDestImage,
TcVnVector4_LREAL& aMatchColor = {-1, -1, -1, -1},
TcVnVector4_LREAL& aSingleColor = {-1, -1, -1, -1},
ITcVnContainer* ipMatchesMask = nullptr,
ETcVnDrawMatchesFlags eFlags = DMF_DEFAULT
)Parameters
|
Name |
Type |
Default |
Description |
|---|---|---|---|
|
hrPrev |
|
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) | |
|
ipSrcImage1 |
|
Source image 1 (elements of type USINT) | |
|
ipKeyPoints1 |
|
Container with the keypoints 1 (ContainerType_Vector_TcVnKeyPoint) | |
|
ipSrcImage2 |
|
Source image 2 (elements of type USINT, must have the same number of channels as ipSrcImage1) | |
|
ipKeyPoints2 |
|
Container with the keypoints 2 (ContainerType_Vector_TcVnKeyPoint) | |
|
ipMatches1To2 |
|
Container with the descriptor matches (ContainerType_Vector_TcVnDMatch) | |
|
ipDestImage |
|
Destination image (An appropriate color image will be created if required.) | |
|
aMatchColor |
{-1, -1, -1, -1} |
Color to draw the matches (for {-1, -1, -1, -1}, a random color is chosen for each point and line) | |
|
aSingleColor |
{-1, -1, -1, -1} |
Color to draw the single keypoints (for {-1, -1, -1, -1}, a random color is chosen for each point) | |
|
ipMatchesMask |
nullptr |
Mask to select the matches to be drawn (ContainerType_Vector_SINT; Set to 0 if all matches should be drawn.) | |
|
eFlags |
DMF_DEFAULT |
A combination of flags to support overdrawing an existing destination image and/or drawing additional (Rich-)Keypoint information (size and orientation) and/or skipping single keypoints |
Return valueRequired License
TC3 Vision Matching