VPI - 视觉编程接口

3.2 版本

颜色名称特征提取器

提取输入图像的颜色名称特征。 更多...

函数

VPIStatus vpiCreateExtractColorNameFeatures (uint64_t backends, VPIImageFormat outFormat, VPIPayload *payload)
 为颜色名称算法创建有效载荷。 更多...
 
VPIStatus vpiSubmitExtractColorNameFeatures (VPIStream stream, uint64_t backend, VPIPayload payload, VPIImage input, VPIImage *output, int32_t numOutputs)
 将颜色名称算法提交到流。 更多...
 

详细描述

提取输入图像的颜色名称特征。

函数文档

◆ vpiCreateExtractColorNameFeatures()

VPIStatus vpiCreateExtractColorNameFeatures ( uint64_t  backends,
VPIImageFormat  outFormat,
VPIPayload payload 
)

#include <vpi/experimental/ColorNames.h>

为颜色名称算法创建有效载荷。

参数
[in]backends有资格执行该算法的VPI后端。
[in]outFormat输出图像的格式。 16位类型将返回更精确的值,但会牺牲一些性能。 8位类型精度稍低,但通常会带来更快的执行时间。*
[out]payload指向将接收创建的有效载荷的句柄的指针。
返回值
VPI_IMAGE_FORMAT_INVALID不支持 outType
VPI_ERROR_INVALID_ARGUMENTpayload 为 NULL。
VPI_ERROR_INVALID_ARGUMENTbackends 指的是无效的后端。
VPI_ERROR_NOT_IMPLEMENTED给定的后端不支持 ColorNames。
VPI_ERROR_INVALID_CONTEXT当前上下文已销毁。
VPI_ERROR_OUT_OF_MEMORY无法分配所需的资源。
VPI_SUCCESS操作成功执行。

◆ vpiSubmitExtractColorNameFeatures()

VPIStatus vpiSubmitExtractColorNameFeatures ( VPIStream  stream,
uint64_t  backend,
VPIPayload  payload,
VPIImage  input,
VPIImage output,
int32_t  numOutputs 
)

#include <vpi/experimental/ColorNames.h>

将颜色名称算法提交到流。

参数
[in]stream操作将排队进入的流。
  • 不能为空。
  • 流必须启用将执行该算法的后端。
[in]backend将执行该算法的后端。 必须是在有效载荷创建期间指定的后端,或者使用 0 作为使用此后端的简写。
[in]payload要与其他参数一起提交的有效载荷。
[in]input输入图像。
[out]output指向 VPIImage 数组的指针,特征将写入其中。 返回的特征具有 numOutputs 维度,每个维度将按顺序写入每个图像。
  • 不能为空。
  • 图像必须具有与有效载荷创建期间指定的格式相同的格式。
  • 所有图像必须具有相同的格式。
  • CPU 和 CUDA:所有图像必须具有与输入图像相同的尺寸。
  • PVA:所有图像的尺寸必须为输入图像的宽度/4 和高度/4。
  • 所有图像必须启用将执行该算法的后端。
[in]numOutputs输出数组中图像的数量。 它指定每个特征具有的维度数。
  • 它必须等于 10。
返回值
VPI_ERROR_INVALID_ARGUMENTstream 为 NULL。
VPI_ERROR_INVALID_ARGUMENTinputoutput 为 NULL。
VPI_ERROR_INVALID_ARGUMENTnumOutputs 超出有效范围。
VPI_ERROR_INVALID_ARGUMENTpayload 不是使用 vpiCreateExtractColorNameFeatures 生成的。
VPI_ERROR_INVALID_ARGUMENT输出图像的数量超出有效范围。
VPI_ERROR_INVALID_ARGUMENT所有输出图像必须具有相同的格式。
VPI_ERROR_INVALID_ARGUMENT所有输出图像必须具有与输入图像相同的尺寸。
VPI_ERROR_INVALID_PAYLOAD_TYPEpayload 无效。
VPI_ERROR_INVALID_OPERATION所需的后端未在 streaminputoutput 中启用。
VPI_SUCCESS操作成功执行。