递归高斯滤波器

对输入图像运行通用 2D 高斯滤波器。 更多...

函数
VPIStatus	vpiCreateRecursiveGaussianFilter (uint64_t backends, int32_t maxWidth, int32_t maxHeight, VPIPayload *payload)
	为 vpiSubmitRecursiveGaussianFilter 创建有效负载。 更多...
VPIStatus	vpiSubmitRecursiveGaussianFilter (VPIStream stream, uint64_t backend, VPIPayload payload, VPIImage input, VPIImage output, float sigmaX, float sigmaY, VPIBorderExtension border)
	对图像运行递归高斯滤波器。 更多...

详细描述

对输入图像运行通用 2D 高斯滤波器。

它允许比 基于直接卷积的高斯滤波器 中可用的更大的 sigma 值。 有关更多详细信息和使用示例，请参阅 递归高斯滤波器。

函数文档

vpiCreateRecursiveGaussianFilter()

VPIStatus vpiCreateRecursiveGaussianFilter	(	uint64_t	backends,
		int32_t	maxWidth,
		int32_t	maxHeight,
		VPIPayload *	payload
	)

#include <vpi/algo/RecursiveGaussianFilter.h>

为 vpiSubmitRecursiveGaussianFilter 创建有效负载。

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

参数

[in]	backends	符合执行算法条件的 VPI 后端。 支持的后端 VPI_BACKEND_CPU VPI_BACKEND_CUDA 后端必须在当前上下文中启用。
[in]	maxWidth	为算法提供的输入和输出图像的最大宽度。 它必须 >= 1。
[in]	maxHeight	为算法提供的输入和输出图像的最大高度。 它必须 >= 1。
[out]	payload	指向接收已创建句柄的有效负载变量的指针。 它不能为 NULL。

返回值

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

vpiSubmitRecursiveGaussianFilter()

VPIStatus vpiSubmitRecursiveGaussianFilter	(	VPIStream	stream,
		uint64_t	backend,
		VPIPayload	payload,
		VPIImage	input,
		VPIImage	output,
		float	sigmaX,
		float	sigmaY,
		VPIBorderExtension	border
	)

#include <vpi/algo/RecursiveGaussianFilter.h>

对图像运行递归高斯滤波器。

参数

[in]	stream	操作将排队进入的流。 它不能为 NULL。 流必须启用将执行算法的后端。
[in]	backend	将执行算法的后端。 有效值 VPI_BACKEND_CPU VPI_BACKEND_CUDA
[in]	payload	由 vpiCreateRecursiveGaussianFilter 创建的有效负载。 它不能为 NULL。
[in]	input	要过滤的输入图像。 它不能为 NULL。 图像必须启用将执行算法的后端。 它的尺寸必须小于或等于有效负载中设置的最大尺寸。 接受的图像格式为 VPI_IMAGE_FORMAT_Y8 VPI_IMAGE_FORMAT_Y16 VPI_IMAGE_FORMAT_Y8_ER VPI_IMAGE_FORMAT_Y16_ER VPI_IMAGE_FORMAT_U8 VPI_IMAGE_FORMAT_S8 VPI_IMAGE_FORMAT_U16 VPI_IMAGE_FORMAT_S16 VPI_IMAGE_FORMAT_F32
[out]	output	结果将写入的图像。 不能为 NULL。 图像必须启用将执行算法的后端。 必须具有与输入图像相同的尺寸和格式。
[in]	sigmaX	X 方向高斯滤波器的标准差。 它必须 > 0。
[in]	sigmaY	Y 方向高斯滤波器的标准差。 它必须 > 0。 它必须等于 sigmaX。
[in]	border	如何处理图像边界外的像素。 接受的边界扩展为 VPI_BORDER_ZERO VPI_BORDER_CLAMP VPI_BORDER_REFLECT

返回值

VPI_ERROR_INVALID_ARGUMENT	stream 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	input 或 output 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	payload 不是使用 vpiCreateRecursiveGaussianFilter 生成的。
VPI_ERROR_INVALID_ARGUMENT	input 或 output 图像尺寸超出有效范围。
VPI_ERROR_INVALID_ARGUMENT	input 和 output 图像尺寸和格式必须相同。
VPI_ERROR_INVALID_ARGUMENT	input 和 output 尺寸大于在 payload 中定义的尺寸。
VPI_ERROR_INVALID_ARGUMENT	不支持 border。
VPI_ERROR_INVALID_ARGUMENT	backend 无效或未知。
VPI_ERROR_INVALID_IMAGE_FORMAT	不支持 input 或 output 图像格式。
VPI_ERROR_INVALID_PAYLOAD_TYPE	payload 无效。
VPI_ERROR_NOT_IMPLEMENTED	算法不支持给定的后端。
VPI_ERROR_INVALID_OPERATION	后端硬件不可用。
VPI_ERROR_INVALID_OPERATION	所需的后端未在 stream、input 或 output 中启用。
VPI_SUCCESS	操作执行成功。