膨胀 (Dilate)

使用由膨胀形态学操作组成的 2D 二进制核来过滤图像。 更多...

函数成员
VPIStatus	vpiSubmitDilate (VPIStream stream, uint64_t backend, VPIImage input, VPIImage output, const int8_t *kernelData, int32_t kernelWidth, int32_t kernelHeight, VPIBorderExtension border)
	对图像运行 2D 膨胀操作。 更多...

详细描述

使用由膨胀形态学操作组成的 2D 二进制核来过滤图像。

有关膨胀 (Dilate) 的更多详细信息和使用示例，请参阅 膨胀 (Dilate)。

函数文档

vpiSubmitDilate()

VPIStatus vpiSubmitDilate	(	VPIStream	stream,
		uint64_t	backend (后端),
		VPIImage	input (输入),
		VPIImage	output (输出),
		const int8_t *	kernelData (内核数据),
		int32_t	kernelWidth (内核宽度),
		int32_t	kernelHeight (内核高度),
		VPIBorderExtension	border (边界)
	)

#include <vpi/algo/MorphologicalFilter.h>

对图像运行 2D 膨胀操作。

参数

[in] (输入)	stream	操作将要排队的流句柄。 不能为空 (NULL)。 流必须启用将执行该算法的后端。
[in] (输入)	backend (后端)	将执行该算法的后端。 有效值 VPI_BACKEND_CPU VPI_BACKEND_CUDA VPI_BACKEND_PVA
[in] (输入)	input (输入)	要使用内核膨胀的输入图像。 不能为空 (NULL)。 图像必须启用将执行该算法的后端。 支持的格式 VPI_IMAGE_FORMAT_U8 VPI_IMAGE_FORMAT_S8 VPI_IMAGE_FORMAT_U16 VPI_IMAGE_FORMAT_S16 对于 PVA 后端，图像尺寸必须大于 128x128。
[out] (输出)	output (输出)	结果写入到的输出图像。 不能为空 (NULL)。 其图像格式和尺寸必须与输入相同。 图像必须启用将执行该算法的后端。
[in] (输入)	kernelWidth,kernelHeight (内核宽度，内核高度)	内核尺寸。 必须介于 1x1 和 11x11 之间，并且可以是非正方形。（PVA 仅支持 3x3 和 5x5 正方形尺寸）
[in] (输入)	kernelData (内核数据)	膨胀内核二进制掩码，即结构元素或邻域定义，采用行优先布局。内核元素被复制到内部缓冲区。调用后可以释放传递的缓冲区。对于完整邻域，使用 NULL，所有元素都视为 1。 如果不是 NULL，则它必须指向具有 kernelWidth * kernelHeight 元素的缓冲区。（PVA 仅支持 3x3、5x5 正方形和 3x3 十字形内核）
[in] (输入)	border (边界)	如何处理图像边界外的像素。 接受的边界扩展是 VPI_BORDER_ZERO VPI_BORDER_CLAMP VPI_BORDER_REFLECT（PVA 不支持） VPI_BORDER_MIRROR（PVA 不支持） VPI_BORDER_LIMITED（忽略图像边界外的像素）

返回值

VPI_ERROR_INVALID_ARGUMENT (VPI_ERROR_无效参数)	stream 为 NULL。
VPI_ERROR_INVALID_ARGUMENT (VPI_ERROR_无效参数)	input 或 output 为 NULL。
VPI_ERROR_INVALID_ARGUMENT (VPI_ERROR_无效参数)	kernelWidth 或 kernelHeight 超出有效范围。
VPI_ERROR_INVALID_ARGUMENT (VPI_ERROR_无效参数)	input 和 output 图像必须具有相同的尺寸和格式。
VPI_ERROR_INVALID_ARGUMENT (VPI_ERROR_无效参数)	不支持 border。
VPI_ERROR_INVALID_IMAGE_FORMAT (VPI_ERROR_无效图像格式)	不支持 input 格式。
VPI_ERROR_NOT_IMPLEMENTED (VPI_ERROR_未实现)	给定后端不支持膨胀 (Dilate) 算法。
VPI_ERROR_INVALID_OPERATION (VPI_ERROR_无效操作)	所需的后端未在 stream、input 或 output 中启用。
VPI_SUCCESS (VPI_成功)	操作执行成功。