Canny 边缘检测器

对输入图像运行 Canny 边缘检测器算法。 更多...

数据结构
struct	VPICannyEdgeDetectorParams
	定义 vpiSubmitCannyEdgeDetector 参数的结构体。 更多...

函数
VPIStatus	vpiCreateCannyEdgeDetector (uint64_t backends, int32_t imageWidth, int32_t imageHeight, VPIPayload *payload)
	为 vpiSubmitCannyEdgeDetector 创建负载 (payload)。 更多...
VPIStatus	vpiInitCannyEdgeDetectorParams (VPICannyEdgeDetectorParams *params)
	使用默认值初始化 vpiInitCannyEdgeDetectorParams。 更多...
VPIStatus	vpiSubmitCannyEdgeDetector (VPIStream stream, uint64_t backend, VPIPayload payload, VPIImage input, VPIImage output, float thresholdStrong, float thresholdWeak, float edgeValue, float nonEdgeValue, const VPICannyEdgeDetectorParams *params)
	对图像运行 Canny 边缘检测器算法。 更多...

详细描述

对输入图像运行 Canny 边缘检测器算法。

有关更多详细信息和使用示例，请参阅 Canny 边缘检测器。

---

数据结构文档

VPICannyEdgeDetectorParams

struct VPICannyEdgeDetectorParams

定义 vpiSubmitCannyEdgeDetector 参数的结构体。

定义于文件 CannyEdges.h 的第 107 行。

VPICannyEdgeDetectorParams 的协作图

数据字段
VPINormType	normType	确定用于计算梯度强度的范数类型。
VPIGradientMethod	gradMethod	指定用于从输入图像生成梯度的方法。
int32_t	gradientSize	梯度窗口大小。 必须为 3、5 或 7。

函数文档

vpiCreateCannyEdgeDetector()

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

#include <vpi/algo/CannyEdges.h>

为 vpiSubmitCannyEdgeDetector 创建负载 (payload)。

参数

[in]	backends	有资格执行该算法的 VPI 后端。 有效值 VPI_BACKEND_CPU VPI_BACKEND_CUDA 后端必须在当前上下文中启用。
[in]	imageWidth, imageHeight	输入图像尺寸。 必须 >= 1x1。
[out]	payload	指向接收创建句柄的负载变量的指针。

返回值

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

vpiInitCannyEdgeDetectorParams()

VPIStatus vpiInitCannyEdgeDetectorParams

(

VPICannyEdgeDetectorParams *

params

)

#include <vpi/algo/CannyEdges.h>

使用默认值初始化 vpiInitCannyEdgeDetectorParams。

默认值

• normType: VPI_NORM_L2
• gradMethod: GEN_GRADIENT_SOBEL
• gradientSize: 3

参数

[out]

params

要填充默认值的结构体。

返回值

失败时返回错误代码，否则返回 VPI_SUCCESS。

vpiSubmitCannyEdgeDetector()

VPIStatus vpiSubmitCannyEdgeDetector	(	VPIStream	stream,
		uint64_t	backend,
		VPIPayload	payload,
		VPIImage	input,
		VPIImage	output,
		float	thresholdStrong,
		float	thresholdWeak,
		float	edgeValue,
		float	nonEdgeValue,
		const VPICannyEdgeDetectorParams *	params
	)

#include <vpi/algo/CannyEdges.h>

对图像运行 Canny 边缘检测器算法。

参数

[in]	stream	操作将排队进入的流句柄。 不得为 NULL。 流必须已启用将执行该算法的后端。
[in]	backend	将执行该算法的后端。 有效值 VPI_BACKEND_CPU VPI_BACKEND_CUDA
[in]	payload	指向接收创建句柄的负载变量的指针。
[in]	input	输入图像。 不得为 NULL。 图像必须已启用将执行该算法的后端。 接受的图像格式为 格式 CPU CUDA VPI_IMAGE_FORMAT_U8 * * VPI_IMAGE_FORMAT_S8 * * VPI_IMAGE_FORMAT_U16 * * VPI_IMAGE_FORMAT_S16 * * VPI_IMAGE_FORMAT_F32 * * VPI_IMAGE_FORMAT_Y8_ER * * VPI_IMAGE_FORMAT_Y8 * * VPI_IMAGE_FORMAT_Y16_ER * * VPI_IMAGE_FORMAT_Y16 * *
[out]	output	结果写入到的输出图像。 不得为 NULL。 它必须具有与输入图像相同的尺寸。 图像必须已启用将执行该算法的后端。 接受的格式与 input 相同
[in]	thresholdStrong	用于迟滞过程的强阈值。
[in]	thresholdWeak	用于迟滞过程的弱阈值。
[in]	edgeValue	用于标记边缘的值。 此值应与 nonEdgeValue 不同。 如果此值超出输出图像的值范围，则将被钳制。
[in]	nonEdgeValue	用于标记非边缘的值。 此值应与 edgeValue 不同。 如果此值超出输出图像的值范围，则将被钳制。
[in]	params	Canny 边缘检测器算法的控制参数。

返回值

VPI_ERROR_INVALID_ARGUMENT	stream 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	input 或 output 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	input 或 output 图像尺寸超出有效范围。
VPI_ERROR_INVALID_ARGUMENT	backend 无效或未知。
VPI_ERROR_INVALID_IMAGE_FORMAT	不支持 input 或 output 图像格式。
VPI_ERROR_INVALID_OPERATION	后端硬件不可用。
VPI_ERROR_INVALID_OPERATION	所需的后端在 stream、input 或 output 中未启用。
VPI_ERROR_NOT_IMPLEMENTED	给定后端不支持 Canny 边缘检测器算法。
VPI_SUCCESS	操作成功执行。