暴力匹配器

在描述符上运行暴力匹配器算法。 更多...

函数
VPIStatus	vpiSubmitBruteForceMatcher (VPIStream stream, uint64_t backend, VPIArray queryDescriptor, VPIArray referenceDescriptor, VPINormType normType, int32_t maxMatchesPerQuery, VPIArray matches, uint32_t algoFlag)
	在描述符上运行暴力匹配器算法。 更多...

详细描述

在描述符上运行暴力匹配器算法。

暴力匹配器使用用户提供的查询描述符和参考描述符，并通过确定最接近的参考描述符来计算每个查询描述符的匹配项。距离计算指标可以由用户选择，以及每个查询描述符要返回的匹配项数量。

函数文档

vpiSubmitBruteForceMatcher()

VPIStatus vpiSubmitBruteForceMatcher	(	VPIStream	stream,
		uint64_t	backend,
		VPIArray	queryDescriptor,
		VPIArray	referenceDescriptor,
		VPINormType	normType,
		int32_t	maxMatchesPerQuery,
		VPIArray	matches,
		uint32_t	algoFlag
	)

#include <vpi/algo/BruteForceMatcher.h>

在描述符上运行暴力匹配器算法。

参数

[in]	stream	操作将被排入队列的流句柄。
[in]	backend	将执行算法的后端。 有效值 VPI_BACKEND_CPU VPI_BACKEND_CUDA
[in]	queryDescriptor	查询描述符数组。 必须是 VPI_ARRAY_TYPE_BRIEF_DESCRIPTOR 类型 不能为空。
[in]	referenceDescriptor	用作匹配参考的输入描述符数组。 必须是 VPI_ARRAY_TYPE_BRIEF_DESCRIPTOR 类型 不能为空。
[in]	normType	确定范数计算的类型。 必须是 VPI_NORM_HAMMING。
[in]	maxMatchesPerQuery	每个查询要添加到输出数组中的最接近匹配项的最大数量。 必须 >= 1 且 <= VPI_MAX_MATCHES_PER_DESCRIPTOR。 如果 VPI_ENABLE_CROSS_CHECK 作为标志传递，则 maxMatchesPerQuery 必须为 1。
[out]	matches	输出数组。 必须是 VPI_ARRAY_TYPE_MATCHES 类型 不能为空。
[in]	algoFlag	匹配计算标志。 接受的标志是 VPI_ENABLE_CROSS_CHECK 以启用交叉检查。

返回值

VPI_ERROR_INVALID_ARGUMENT	stream 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	queryDescriptor、referenceDescriptor 或 matches 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	matches 容量 >= queryDescriptor 容量。
VPI_ERROR_INVALID_ARGUMENT	不支持 algoFlag。
VPI_ERROR_INVALID_ARGUMENT	backend 无效或未知。
VPI_ERROR_INVALID_ARGUMENT	不支持 queryDescriptor 和 referenceDescriptor 格式。
VPI_ERROR_INVALID_ARGUMENT	不支持 normType。
VPI_ERROR_INVALID_ARGUMENT	不支持 matches 格式。
VPI_ERROR_INVALID_ARGUMENT	maxMatchesPerQuery 超出有效范围。
VPI_ERROR_NOT_IMPLEMENTED	给定后端不支持暴力匹配器算法。
VPI_ERROR_INVALID_OPERATION	后端硬件不可用。
VPI_ERROR_INVALID_OPERATION	所需的后端未在 stream、queryDescriptor、referenceDescriptor 或 matches 中启用。
VPI_SUCCESS	操作执行成功。