VPI - Vision Programming Interface

0.2.0 Release

HarrisCornersDetector

Data Structures

struct  VPIHarrisKeypointDetectorParams
 Structure that defines the parameters for vpiSubmitHarrisKeypointDetector. More...
 

Functions

VPIStatus vpiCreateHarrisKeypointDetector (VPIStream stream, uint32_t inputWidth, uint32_t inputHeight, VPIPayload *payload)
 Creates a Harris Keypoint Detector payload. More...
 
VPIStatus vpiSubmitHarrisKeypointDetector (VPIPayload payload, VPIImage input, VPIArray outFeatures, VPIArray outScores, const VPIHarrisKeypointDetectorParams *params)
 Submits Harris Keypoint Detector operation to the stream associated with the payload. More...
 

Detailed Description

Detect Harris keypoints


Data Structure Documentation

◆ VPIHarrisKeypointDetectorParams

struct VPIHarrisKeypointDetectorParams

Structure that defines the parameters for vpiSubmitHarrisKeypointDetector.

Definition at line 80 of file HarrisKeypointDetector.h.

+ Collaboration diagram for VPIHarrisKeypointDetectorParams:
Data Fields
uint32_t blockSize Block window size used to compute the Harris Corner score.

Must be 3, 5 or 7.

uint32_t gradientSize Gradient window size.

Must be 3, 5 or 7.

float minNMSDistance Non-maximum suppression radius, set to 0 to disable it.
float sensitivity Specifies sensitivity threshold from the Harris-Stephens equation.
float strengthThresh Specifies the minimum threshold with which to eliminate Harris Corner scores.

Function Documentation

◆ vpiCreateHarrisKeypointDetector()

VPIStatus vpiCreateHarrisKeypointDetector ( VPIStream  stream,
uint32_t  inputWidth,
uint32_t  inputHeight,
VPIPayload payload 
)

#include <vpi/algo/HarrisKeypointDetector.h>

Creates a Harris Keypoint Detector payload.

This function allocates all temporary memory needed by the algorithm.

Parameters
stream[in] VPI stream to be used.
inputWidth,inputHeight[in] Dimensions of the input image that will be used with this payload.
payload[out] Pointer to a payload handle that will point to the created payload.
Returns
VPI_SUCCESS if payload was created successfully, some other VPIStatus value in case of error.

◆ vpiSubmitHarrisKeypointDetector()

VPIStatus vpiSubmitHarrisKeypointDetector ( VPIPayload  payload,
VPIImage  input,
VPIArray  outFeatures,
VPIArray  outScores,
const VPIHarrisKeypointDetectorParams params 
)

#include <vpi/algo/HarrisKeypointDetector.h>

Submits Harris Keypoint Detector operation to the stream associated with the payload.

Parameters
payload[in] Payload to be submitted.
input[in] Input image from where the Harris keypoints will be extracted.
outFeatures[out] Array that will receive the detected keypoints. It must have type VPI_ARRAY_TYPE_KEYPOINT.
outScores[out] Array that will receive the keypoints' scores. It must have type VPI_ARRAY_TYPE_U32.
params[in] Pointer to a VPIHarrisKeypointDetectorParams with parameters for this algorithm invocation. These parameters can vary in every call and will be copied internally, no need to keep the object around.
Returns
VPI_SUCCESS if the algorithm submitted was created successfully, some other VPIStatus value in case of error. Even if VPI_SUCCESS is returned, the actual algorithm execution might still fail, due to invalid parameters. The actual error will only be returned by some synchronization call or another algorithm submission.