VPI - Vision Programming Interface

0.4.4 Release

Harris Corner Detector

Data Structures

struct  VPIHarrisCornerDetectorParams
 Structure that defines the parameters for vpiSubmitHarrisCornerDetector. More...
 

Functions

VPIStatus vpiCreateHarrisCornerDetector (VPIBackend backend, uint32_t inputWidth, uint32_t inputHeight, VPIPayload *payload)
 Creates a Harris Corner Detector payload. More...
 
VPIStatus vpiSubmitHarrisCornerDetector (VPIStream stream, VPIPayload payload, VPIImage input, VPIArray outFeatures, VPIArray outScores, const VPIHarrisCornerDetectorParams *params)
 Submits Harris Corner Detector operation to the stream associated with the payload. More...
 

Detailed Description


Data Structure Documentation

◆ VPIHarrisCornerDetectorParams

struct VPIHarrisCornerDetectorParams

Structure that defines the parameters for vpiSubmitHarrisCornerDetector.

Definition at line 79 of file HarrisCornerDetector.h.

+ Collaboration diagram for VPIHarrisCornerDetectorParams:
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.

For PVA backend, this must be set to 8.

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

◆ vpiCreateHarrisCornerDetector()

VPIStatus vpiCreateHarrisCornerDetector ( VPIBackend  backend,
uint32_t  inputWidth,
uint32_t  inputHeight,
VPIPayload payload 
)

#include <vpi/algo/HarrisCornerDetector.h>

Creates a Harris Corner Detector payload.

This function allocates all temporary memory needed by the algorithm.

Parameters
[in]backendVPI backend where the algorithm will be executed.
[in]inputWidth,inputHeightDimensions of the input image that will be used with this payload.
[out]payloadPointer to memory where the created payload handle will be written to.
Returns
VPI_SUCCESS if payload was created successfully, some other VPIStatus value in case of error.

◆ vpiSubmitHarrisCornerDetector()

VPIStatus vpiSubmitHarrisCornerDetector ( VPIStream  stream,
VPIPayload  payload,
VPIImage  input,
VPIArray  outFeatures,
VPIArray  outScores,
const VPIHarrisCornerDetectorParams params 
)

#include <vpi/algo/HarrisCornerDetector.h>

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

Parameters
[in]streamThe stream where the operation will be queued in.
[in]payloadPayload to be submitted along the other parameters.
[in]inputInput image from where the Harris corners will be extracted.
[out]outFeaturesArray that will receive the detected corners. It must have type VPI_ARRAY_TYPE_KEYPOINT.
[out]outScoresArray that will receive the corners' scores. It must have type VPI_ARRAY_TYPE_U32.
[in]paramsPointer to a VPIHarrisCornerDetectorParams 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.