模板匹配算法

使用模板图像在搜索图像上运行模板匹配算法。 更多...

枚举
enum	VPITemplateMatchingMethod
	定义计算模板匹配得分的模板匹配方法。 更多...

函数
VPIStatus	vpiCreateTemplateMatching (uint64_t backends, int32_t imageWidth, int32_t imageHeight, VPIPayload *payload)
	为 vpiSubmitTemplateMatching 创建负载 (payload)。 更多...
VPIStatus	vpiTemplateMatchingSetSourceImage (VPIStream stream, uint64_t backend, VPIPayload payload, VPIImage srcImage)
	设置源图像。 更多...
VPIStatus	vpiTemplateMatchingSetTemplateImage (VPIStream stream, uint64_t backend, VPIPayload payload, VPIImage templImage, VPIImage mask)
	设置模板图像。 更多...
VPIStatus	vpiSubmitTemplateMatching (VPIStream stream, uint64_t backend, VPIPayload payload, VPIImage output, VPITemplateMatchingMethod method)
	使用提供的模板运行模板匹配算法。 更多...

详细描述

使用模板图像在搜索图像上运行模板匹配算法。

有关更多详细信息和用法示例，请参阅 模板匹配。

枚举类型文档

VPITemplateMatchingMethod

enum VPITemplateMatchingMethod

#include <vpi/algo/TemplateMatching.h>

定义计算模板匹配得分的模板匹配方法。

枚举器
VPI_TEMPLATE_MATCHING_NCC	归一化互相关。

定义于文件 TemplateMatching.h 的第 195 行。

函数文档

vpiCreateTemplateMatching()

VPIStatus vpiCreateTemplateMatching	(	uint64_t	backends,
		int32_t	imageWidth,
		int32_t	imageHeight,
		VPIPayload *	payload
	)

#include <vpi/algo/TemplateMatching.h>

为 vpiSubmitTemplateMatching 创建负载 (payload)。

注意

为了使此函数成功执行，必须在系统中安装以下库

• libnppc.so.11
• libnppial.so.11
• libnppidei.so.11
• libnppist.so.11

参数

[输入]	backends	有资格执行算法的 VPI 后端。 有效值 VPI_BACKEND_CPU VPI_BACKEND_CUDA 后端必须在当前上下文中启用。
[输入]	imageWidth	源图像宽度。
[输入]	imageHeight	源图像高度。
[输出]	payload	指向接收创建句柄的 payload 变量的指针。

返回值

VPI_ERROR_INVALID_ARGUMENT	payload 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	imageWidth 和 imageHeight 超出有效范围。
VPI_ERROR_INVALID_ARGUMENT	backends 指的是无效的后端。
VPI_ERROR_INVALID_OPERATION	后端未在当前上下文中启用。
VPI_ERROR_INVALID_OPERATION	系统中未安装所需的 NPP 库。
VPI_ERROR_NOT_IMPLEMENTED	给定后端不支持该算法。
VPI_ERROR_INVALID_CONTEXT	当前上下文已销毁。
VPI_ERROR_OUT_OF_MEMORY	无法分配所需资源。
VPI_SUCCESS	操作执行成功。

vpiTemplateMatchingSetSourceImage()

VPIStatus vpiTemplateMatchingSetSourceImage	(	VPIStream	stream,
		uint64_t	backend,
		VPIPayload	payload,
		VPIImage	srcImage
	)

#include <vpi/algo/TemplateMatching.h>

设置源图像。

参数

[输入]	stream	操作将排队进入的流句柄。 不能为空 (NULL)。 流必须启用将执行算法的后端。
[输入]	backend	将执行算法的后端。 有效值 VPI_BACKEND_CPU VPI_BACKEND_CUDA
[输入]	payload	指向接收创建句柄的 payload 变量的指针。
[输入]	srcImage	将在其上搜索模板图像的源图像。 不能为空 (NULL)。 图像必须启用将执行算法的后端。 接受的图像格式为 格式 CPU CUDA VPI_IMAGE_FORMAT_U8 * * VPI_IMAGE_FORMAT_Y8_ER * * VPI_IMAGE_FORMAT_Y8 * *

返回值

VPI_ERROR_INVALID_ARGUMENT	payload 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	srcImage 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	srcImage 分辨率与 vpiCreateTemplateMatching 中指定的分辨率不匹配。
VPI_ERROR_INVALID_OPERATION	后端未在当前上下文中启用。
VPI_ERROR_INVALID_OPERATION	srcImage 中未启用所需的后端。
VPI_ERROR_INVALID_CONTEXT	当前上下文已销毁。
VPI_ERROR_OUT_OF_MEMORY	无法分配所需资源。
VPI_SUCCESS	操作执行成功。

vpiTemplateMatchingSetTemplateImage()

VPIStatus vpiTemplateMatchingSetTemplateImage	(	VPIStream	stream,
		uint64_t	backend,
		VPIPayload	payload,
		VPIImage	templImage,
		VPIImage	mask
	)

#include <vpi/algo/TemplateMatching.h>

设置模板图像。

参数

[输入]	stream	操作将排队进入的流句柄。 不能为空 (NULL)。 流必须启用将执行算法的后端。
[输入]	backend	将执行算法的后端。 有效值 VPI_BACKEND_CPU VPI_BACKEND_CUDA
[输入]	payload	指向接收创建句柄的 payload 变量的指针。
[输入]	templImage	模板图像。 不能为空 (NULL)。 图像必须启用将执行算法的后端。 接受的图像格式为 格式 CPU CUDA VPI_IMAGE_FORMAT_U8 * * VPI_IMAGE_FORMAT_Y8_ER * * VPI_IMAGE_FORMAT_Y8 * *
[输入]	mask	计算模板匹配得分时使用的掩码。 如果不需要，可以为 NULL。 必须与模板图像具有相同的尺寸 接受的图像格式为 格式 CPU CUDA VPI_IMAGE_FORMAT_U8 * *

返回值

VPI_ERROR_INVALID_ARGUMENT	payload 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	templImage 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	templImage 分辨率大于源图像。
VPI_ERROR_INVALID_OPERATION	后端未在当前上下文中启用。
VPI_ERROR_INVALID_OPERATION	templImage 中未启用所需的后端。
VPI_ERROR_INVALID_CONTEXT	当前上下文已销毁。
VPI_ERROR_OUT_OF_MEMORY	无法分配所需资源。
VPI_SUCCESS	操作执行成功。

vpiSubmitTemplateMatching()

VPIStatus vpiSubmitTemplateMatching	(	VPIStream	stream,
		uint64_t	backend,
		VPIPayload	payload,
		VPIImage	output,
		VPITemplateMatchingMethod	method
	)

#include <vpi/algo/TemplateMatching.h>

使用提供的模板运行模板匹配算法。

参数

[输入]	stream	操作将排队进入的流句柄。 不能为空 (NULL)。 流必须启用将执行算法的后端。
[输入]	backend	将执行算法的后端。 有效值 VPI_BACKEND_CPU VPI_BACKEND_CUDA
[输入]	payload	指向接收创建句柄的 payload 变量的指针。
[输出]	output	模板匹配得分将写入到的输出图像。 不能为空 (NULL)。 假设源图像的分辨率为 WxH，模板图像的分辨率为 wxh，则输出图像应具有 (W - w + 1) * (H - h + 1) 的分辨率 图像格式必须为 VPI_IMAGE_FORMAT_F32。 图像必须启用将执行算法的后端。
[输入]	method	指定计算模板匹配得分时使用的方法 (模板匹配方法)。

返回值

VPI_ERROR_INVALID_ARGUMENT	stream 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	output 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	backend 无效或未知。
VPI_ERROR_INVALID_IMAGE_FORMAT	不支持 output 图像格式。
VPI_ERROR_INVALID_OPERATION	后端硬件不可用。
VPI_ERROR_INVALID_OPERATION	stream 和 output 中未启用所需的后端。
VPI_ERROR_NOT_IMPLEMENTED	给定后端不支持该算法。
VPI_SUCCESS	操作执行成功。