Harris 角点

检测图像中的 Harris 关键点，通常用于关键点跟踪。 更多...

数据结构
struct	VPIHarrisCornerDetectorParams
	定义 vpiSubmitHarrisCornerDetector 参数的结构体。 更多...

函数
VPIStatus	vpiInitHarrisCornerDetectorParams (VPIHarrisCornerDetectorParams *params)
	使用默认值初始化 VPIHarrisCornerDetectorParams。 更多...
VPIStatus	vpiCreateHarrisCornerDetector (uint64_t backends, int32_t inputWidth, int32_t inputHeight, VPIPayload *payload)
	创建 Harris 角点检测器 有效载荷。 更多...
VPIStatus	vpiSubmitHarrisCornerDetector (VPIStream stream, uint64_t backend, VPIPayload payload, VPIImage input, VPIArray outFeatures, VPIArray outScores, const VPIHarrisCornerDetectorParams *params)
	向流提交 Harris 角点检测器 操作。 更多...

详细描述

检测图像中的 Harris 关键点，通常用于关键点跟踪。

有关更多详细信息和使用示例，请参阅 Harris 角点检测器。

---

数据结构文档

VPIHarrisCornerDetectorParams

struct VPIHarrisCornerDetectorParams

定义 vpiSubmitHarrisCornerDetector 参数的结构体。

定义于文件 HarrisCorners.h 的第 81 行。

VPIHarrisCornerDetectorParams 的协作图

数据字段
int32_t	gradientSize	梯度窗口大小。 必须为 3、5 或 7。
int32_t	blockSize	用于计算 Harris 角点得分的块窗口大小。 必须为 3、5 或 7。
float	strengthThresh	指定用于消除 Harris 角点得分的最小阈值。 阈值取决于输入图像范围。对于图像格式 U8 和 S8，它在 [0-20] 范围内。对于 U16 和 S16 可以更大。 必须 >= 0。
float	sensitivity	指定 Harris-Stephens 方程的灵敏度阈值。
float	minNMSDistance	非极大值抑制半径，设置为 0 则禁用。 在 PVA 后端，此值必须设置为 8。

函数文档

vpiInitHarrisCornerDetectorParams()

VPIStatus vpiInitHarrisCornerDetectorParams

(

VPIHarrisCornerDetectorParams *

params

)

#include <vpi/algo/HarrisCorners.h>

使用默认值初始化 VPIHarrisCornerDetectorParams。

默认值为

• gradientSize: 3
• blockSize: 3
• strengthThresh: 20
• sensitivity: 0.0625
• minNMSDistance: 8

返回值

VPI_ERROR_INVALID_ARGUMENT	params 为 NULL。
VPI_SUCCESS	操作成功执行。

vpiCreateHarrisCornerDetector()

VPIStatus vpiCreateHarrisCornerDetector	(	uint64_t	backends,
		int32_t	inputWidth,
		int32_t	inputHeight,
		VPIPayload *	payload
	)

#include <vpi/algo/HarrisCorners.h>

创建 Harris 角点检测器 有效载荷。

此函数分配算法所需的所有临时内存。

参数

[in]	backends	有资格执行该算法的 VPI 后端。 有效值 VPI_BACKEND_CPU VPI_BACKEND_CUDA VPI_BACKEND_PVA 后端必须在当前上下文中启用。
[in]	inputWidth,inputHeight	将与此有效载荷一起使用的输入图像的尺寸。 在 PVA 上，尺寸限制为最小 160x120，最大 3264x2448。 必须 >= 0（其他后端）。
[out]	payload	指向接收创建句柄的有效载荷变量的指针。

返回值

VPI_ERROR_INVALID_ARGUMENT	payload 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	inputWidth 或 inputHeight 超出有效范围。
VPI_ERROR_INVALID_ARGUMENT	backends 引用无效的后端。
VPI_ERROR_INVALID_OPERATION	后端硬件不可用。
VPI_ERROR_NOT_IMPLEMENTED	给定后端不支持 Harris 角点检测器算法。
VPI_ERROR_INVALID_CONTEXT	当前上下文已销毁。
VPI_ERROR_OUT_OF_MEMORY	无法分配所需资源。
VPI_ERROR_INVALID_OPERATION	后端未在当前上下文中启用。
VPI_SUCCESS	操作成功执行。

vpiSubmitHarrisCornerDetector()

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

#include <vpi/algo/HarrisCorners.h>

向流提交 Harris 角点检测器 操作。

参数

[in]	stream	将在其中排队操作的流。 不得为 NULL。 流必须已启用将执行该算法的后端。
[in]	backend	将执行该算法的后端。 必须是有效载荷创建期间指定的后端，或 0 作为使用此后端的简写。
[in]	payload	要与其他参数一起提交的有效载荷。
[in]	input	从中提取 Harris 角点的输入图像。 不得为 NULL。 图像必须已启用将执行该算法的后端。 接受的图像格式为 VPI_IMAGE_FORMAT_U8 VPI_IMAGE_FORMAT_S8 VPI_IMAGE_FORMAT_U16 VPI_IMAGE_FORMAT_S16（PVA 后端仅支持此格式）
[out]	outFeatures	将接收检测到的角点的数组。数组大小会根据找到的角点数量进行更新。 不得为 NULL。 它必须具有类型 VPI_ARRAY_TYPE_KEYPOINT_F32。 数组必须已启用将执行该算法的后端。
[out]	outScores	将接收角点得分的数组。数组大小与 outFeatures 数组的大小匹配。 不得为 NULL。 它必须具有类型 VPI_ARRAY_TYPE_U32。 数组必须已启用将执行该算法的后端。 必须具有与 outFeatures 相同的容量。
[in]	params	指向 VPIHarrisCornerDetectorParams 的指针，其中包含此算法调用的参数。这些参数在每次调用中都可能不同，并且将在内部复制，无需保留该对象。

返回值

VPI_ERROR_INVALID_ARGUMENT	stream 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	input、outFeatures 或 outScores 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	payload 不是由 vpiCreateHarrisCornerDetector 创建的。
VPI_ERROR_INVALID_ARGUMENT	params 中的强度阈值超出有效范围。
VPI_ERROR_INVALID_ARGUMENT	输出数组必须具有相同的容量。
VPI_ERROR_INVALID_ARGUMENT	不支持的 outFeatures 或 outScores 类型。
VPI_ERROR_INVALID_ARGUMENT	无效的 input 尺寸。
VPI_ERROR_INVALID_PAYLOAD_TYPE	payload 无效。
VPI_ERROR_INVALID_IMAGE_FORMAT	不支持的输入格式。
VPI_ERROR_INVALID_OPERATION	所需的后端未在 stream、outFeatures 或 outScores 中启用。
VPI_SUCCESS	操作成功执行。