图像直方图

从输入图像计算图像直方图。 更多...

函数
VPIStatus	vpiCreateHistogramEven (uint64_t backends, VPIImageFormat fmt, float start, float end, int32_t numBins, VPIPayload *payload)
	为图像直方图均匀算法创建有效负载。 更多...
VPIStatus	vpiSubmitHistogram (VPIStream stream, uint64_t backend, VPIPayload payload, VPIImage input, VPIArray output, uint64_t flags)
	计算图像直方图。 更多...

详细描述

从输入图像计算图像直方图。

有关更多详细信息和用法示例，请参阅 图像直方图。

函数文档

vpiCreateHistogramEven()

VPIStatus vpiCreateHistogramEven	(	uint64_t	backends,
		VPIImageFormat	fmt,
		float	start,
		float	end,
		int32_t	numBins,
		VPIPayload *	payload
	)

#include <vpi/algo/Histogram.h>

为图像直方图均匀算法创建有效负载。

它计算图像直方图，假设使用均匀（相等）的 bin。

参数

[输入]	backends	有资格执行该算法的 VPI 后端。 有效值 VPI_BACKEND_CPU VPI_BACKEND_CUDA 后端必须在当前上下文中启用。
[输入]	fmt	输入图像的格式。 接受的图像格式为 VPI_IMAGE_FORMAT_U8 VPI_IMAGE_FORMAT_U16
[输入]	start	指定直方图范围的低端（包含）。 必须 <= end。
[输入]	end	指定直方图范围的高端（不包含）。 必须 >= start。
[输入]	numBins	指定输出数组中的 bin 数量。 最大 bin 数量取决于输入图像格式 VPI_IMAGE_FORMAT_U8 : 256 VPI_IMAGE_FORMAT_U16 : 65536
[输出]	payload	指向接收已创建句柄的 payload 变量的指针。

返回值

VPI_ERROR_INVALID_ARGUMENT	payload 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	给定 fmt 允许的最大 numBins 超出有效范围。
VPI_ERROR_INVALID_ARGUMENT	无效的 start 和 end 值。
VPI_ERROR_INVALID_ARGUMENT	backends 指的是无效的后端。
VPI_ERROR_NOT_IMPLEMENTED	给定后端不支持直方图均匀算法。
VPI_ERROR_INVALID_CONTEXT	当前上下文已被销毁。
VPI_IMAGE_FORMAT_INVALID	不支持 fmt。
VPI_ERROR_OUT_OF_MEMORY	无法分配所需的资源。
VPI_ERROR_INVALID_OPERATION	后端未在当前上下文中启用。
VPI_SUCCESS	操作成功执行。

vpiSubmitHistogram()

VPIStatus vpiSubmitHistogram	(	VPIStream	stream,
		uint64_t	backend,
		VPIPayload	payload,
		VPIImage	input,
		VPIArray	output,
		uint64_t	flags
	)

#include <vpi/algo/Histogram.h>

计算图像直方图。

参数

[输入]	stream	将在其中排队操作的流。 不得为 NULL。 流必须已启用将执行该算法的后端。
[输入]	backend	将执行该算法的后端。 必须是在 payload 创建期间指定的后端，或者为 0 以简写形式使用此后端。
[输入]	payload	由 vpiCreateHistogramEven 创建的 Payload。
[输入]	input	输入图像。 不得为 NULL。 必须具有与 payload 创建期间指定的格式相同的格式。 图像必须已启用将执行该算法的后端。
[输出]	output	结果图像直方图将写入到此处。 不得为 NULL。 数组的容量必须大于或等于 payload 中配置的 bin 数量。 数组必须已启用将执行该算法的后端。
[输入]	flags	控制标志。 有效值是以下一个或多个标志的组合 0: 输出将首先清零。 VPI_ACCUMULATE_OUTPUT : 累加到现有输出值。

返回值

VPI_ERROR_INVALID_ARGUMENT	stream 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	input 或 output 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	payload 不是由 vpiCreateHistogramEven 创建的。
VPI_ERROR_INVALID_ARGUMENT	output 数组的容量超出有效范围。
VPI_ERROR_INVALID_ARRAY_TYPE	不支持 output 数组类型。
VPI_ERROR_INVALID_IMAGE_FORMAT	input 图像格式与 payload 关联的格式不匹配。
VPI_ERROR_INVALID_PAYLOAD_TYPE	payload 无效。
VPI_ERROR_INVALID_OPERATION	所需的后端未在 stream、input 或 output 中启用。
VPI_SUCCESS	操作成功执行。