卷积

使用 2D 卷积核对图像进行卷积。 更多...

函数
VPIStatus	vpiSubmitConvolution (VPIStream stream, uint64_t backend, VPIImage input, VPIImage output, const float *kernelData, int32_t kernelWidth, int32_t kernelHeight, VPIBorderExtension border)
	对图像执行通用 2D 卷积。 更多...
VPIStatus	vpiSubmitSeparableConvolution (VPIStream stream, uint64_t backend, VPIImage input, VPIImage output, const float *kernelXData, int32_t kernelXSize, const float *kernelYData, int32_t kernelYSize, VPIBorderExtension border)
	对图像执行通用 2D 卷积操作，针对可分离卷积核进行了优化。 更多...

详细描述

使用 2D 卷积核对图像进行卷积。

有关卷积的更多详细信息和用法示例，请参阅 卷积。有关可分离卷积的更多详细信息和用法示例，请参阅 可分离卷积。

vpiSubmitConvolution 用于通用 2D 卷积核，无论是否可分离。 对于可分离卷积核，通常使用 vpiSubmitSeparableConvolution 更有效。

函数文档

vpiSubmitConvolution()

VPIStatus vpiSubmitConvolution	(	VPIStream	stream,
		uint64_t	backend,
		VPIImage	input,
		VPIImage	output,
		const float *	kernelData,
		int32_t	kernelWidth,
		int32_t	kernelHeight,
		VPIBorderExtension	border
	)

#include <vpi/algo/Convolution.h>

对图像执行通用 2D 卷积。

参数

[输入]	stream	操作将排队进入的流句柄。 不能为空。 流必须已启用将执行该算法的后端。
[输入]	backend	将执行该算法的后端。 有效值 VPI_BACKEND_CPU VPI_BACKEND_CUDA VPI_BACKEND_PVA
[输入]	input	要与卷积核进行卷积的输入图像。 不能为空。 在 PVA 后端，图像尺寸必须在 65x33 到 3264x2448 之间。 图像必须已启用将执行该算法的后端。 接受的图像格式为 格式 CPU CUDA PVA VPI_IMAGE_FORMAT_U8 * * * VPI_IMAGE_FORMAT_S8 * * * VPI_IMAGE_FORMAT_U16 * * * VPI_IMAGE_FORMAT_S16 * * * VPI_IMAGE_FORMAT_Y8 * * * VPI_IMAGE_FORMAT_Y8_ER * * * VPI_IMAGE_FORMAT_Y16 * * * VPI_IMAGE_FORMAT_Y16_ER * * * VPI_IMAGE_FORMAT_F32 * *
[输出]	output	结果写入的输出图像。 不能为空。 必须与输入图像具有相同的尺寸。 图像必须已启用将执行该算法的后端。 对于 PVA，它必须与输入图像具有相同的格式。 对于其他后端，格式可以是 与输入格式相同。 VPI_IMAGE_FORMAT_F32（无论输入格式如何）。
[输入]	kernelWidth,kernelHeight	卷积核尺寸。 必须在 1x1 到 11x11 之间，并且可以是非正方形。
[输入]	kernelData	卷积核系数，以行优先布局。 卷积核元素被复制到内部缓冲区。 传递的缓冲区可以在调用后被释放。 不能为空。 它必须指向一个包含 kernelWidth * kernelHeight 元素的缓冲区，否则将导致未定义的行为 在 PVA 后端，卷积核权重被限制为 |weight|<=1。
[输入]	border	如何处理图像边界外的像素。 接受的边界扩展为 VPI_BORDER_ZERO VPI_BORDER_CLAMP

返回值

VPI_ERROR_INVALID_ARGUMENT	stream 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	input 或 output 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	kernelWidth 或 kernelHeight 超出有效范围。
VPI_ERROR_INVALID_ARGUMENT	kernelData 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	kernelData 中的某些权重超出有效范围。
VPI_ERROR_INVALID_ARGUMENT	input 或 output 尺寸超出有效范围。
VPI_ERROR_INVALID_ARGUMENT	input 和 output 图像必须具有相同的尺寸。
VPI_ERROR_INVALID_ARGUMENT	不支持 border。
VPI_ERROR_INVALID_ARGUMENT	backend 无效或未知。
VPI_ERROR_INVALID_IMAGE_FORMAT	不支持 input 或 output 格式。
VPI_ERROR_INVALID_IMAGE_FORMAT	input 和 output 格式不兼容。
VPI_ERROR_NOT_IMPLEMENTED	给定后端不支持卷积算法。
VPI_ERROR_INVALID_OPERATION	后端硬件不可用。
VPI_ERROR_INVALID_OPERATION	所需的后端未在 stream、input 或 output 中启用。
VPI_SUCCESS	操作成功执行。

vpiSubmitSeparableConvolution()

VPIStatus vpiSubmitSeparableConvolution	(	VPIStream	stream,
		uint64_t	backend,
		VPIImage	input,
		VPIImage	output,
		const float *	kernelXData,
		int32_t	kernelXSize,
		const float *	kernelYData,
		int32_t	kernelYSize,
		VPIBorderExtension	border
	)

#include <vpi/algo/Convolution.h>

对图像执行通用 2D 卷积操作，针对可分离卷积核进行了优化。

参数

[输入]	stream	操作将排队进入的流句柄。 不能为空。 流必须已启用将执行该算法的后端。
[输入]	backend	将执行该算法的后端。 有效值 VPI_BACKEND_CPU VPI_BACKEND_CUDA VPI_BACKEND_PVA
[输入]	input	要与卷积核进行卷积的输入图像。 不能为空。 图像必须已启用将执行该算法的后端。 在 PVA 上，图像尺寸必须在 32x32 到 3264x2448 之间。 接受的图像格式为 格式 CPU CUDA PVA VPI_IMAGE_FORMAT_U8 * * VPI_IMAGE_FORMAT_S8 * * VPI_IMAGE_FORMAT_U16 * * VPI_IMAGE_FORMAT_S16 * * * VPI_IMAGE_FORMAT_Y8 * 1 VPI_IMAGE_FORMAT_Y8_ER * 1 VPI_IMAGE_FORMAT_Y16 * 1 VPI_IMAGE_FORMAT_Y16_ER * 1 VPI_IMAGE_FORMAT_F32 * * VPI_IMAGE_FORMAT_RGB8p 2 VPI_IMAGE_FORMAT_RGBA8p 2 VPI_IMAGE_FORMAT_BGR8p 2 VPI_IMAGE_FORMAT_BGRA8p 2 （1）仅适用于卷积核尺寸 <= 3x3 （2）仅适用于卷积核尺寸 >= 3x3
[输出]	output	结果写入的输出图像。 不能为空。 必须与输入图像具有相同的尺寸和格式。 图像必须已启用将执行该算法的后端。
[输入]	kernelXSize,kernelYSize	X 和 Y 方向上的卷积核尺寸。 必须在 1x1 到 11x11 之间。
[输入]	kernelXData,kernelYData	卷积核系数，分别在 X 和 Y 方向上。 卷积核元素被复制到内部缓冲区。 传递的缓冲区可以在调用后被释放。 kernelXData 和 kernelYData 必须分别指向包含 kernelXSize 和 kernelYSize 元素的缓冲区。 它们不能为空。 在 PVA 后端，卷积核权重被限制为 |weight|<1。
[输入]	border	如何处理图像边界外的像素。 接受的边界扩展为 VPI_BORDER_ZERO VPI_BORDER_CLAMP

返回值

VPI_ERROR_INVALID_ARGUMENT	stream 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	input 或 output 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	kernelXData 或 kernelYData 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	kernelXSize 或 kernelYSize 超出有效范围。
VPI_ERROR_INVALID_ARGUMENT	kernelData 中的某些权重超出有效范围。
VPI_ERROR_INVALID_ARGUMENT	input 或 output 图像尺寸超出有效范围。
VPI_ERROR_INVALID_ARGUMENT	不支持 border。
VPI_ERROR_INVALID_ARGUMENT	input 和 output 图像尺寸和格式不匹配。
VPI_ERROR_INVALID_ARGUMENT	backend 无效或未知。
VPI_ERROR_INVALID_IMAGE_FORMAT	不支持 input 和 output 格式
VPI_ERROR_NOT_IMPLEMENTED	给定后端不支持可分离卷积算法。
VPI_ERROR_INVALID_OPERATION	后端硬件不可用。
VPI_ERROR_INVALID_OPERATION	所需的后端未在 stream、input 或 output 中启用。
VPI_SUCCESS	操作成功执行。