混合通道

将一个或多个输入图像通道混合到一个或多个输出图像通道。 更多...

宏
#define	VPI_MIX_CHANNELS_MAX_IMAGES   4
	可以作为输入或输出传递给混合通道的最大图像数量。

函数
VPIStatus	vpiSubmitMixChannels (VPIStream stream, uint64_t backend, VPIImage *inputs, int numInputs, VPIImage *outputs, int numOutputs, const int *inMapping, const int *outMapping, int numMapping)
	向流提交一个混合通道操作。更多...

详细描述

将一个或多个输入图像通道混合到一个或多个输出图像通道。

此操作是复制操作，不会增加或减少分辨率，输入和输出大小必须匹配，并且不进行任何颜色转换。 有关更多详细信息和用法示例，请参阅混合通道。

函数文档

vpiSubmitMixChannels()

VPIStatus vpiSubmitMixChannels	(	VPIStream	stream,
		uint64_t	backend,
		VPIImage *	inputs,
		int	numInputs,
		VPIImage *	outputs,
		int	numOutputs,
		const int *	inMapping,
		const int *	outMapping,
		int	numMapping
	)

#include <vpi/algo/MixChannels.h>

向流提交一个混合通道操作。

参数

[输入]	stream	操作将被排队的流。 不能为空。 流必须启用将执行该算法的后端。
[输入]	backend	将执行该算法的后端。 有效值 VPI_BACKEND_CPU VPI_BACKEND_CUDA VPI_BACKEND_PVA
[输入]	inputs	从中提取通道的一个或多个输入图像。 不能为空。 所有输入图像都必须已分配。 每个输入图像平面大小必须与映射的输出图像平面大小匹配。 图像必须启用将执行该算法的后端。 CUDA 和 CPU 后端接受的图像格式为 VPI_IMAGE_FORMAT_U8 VPI_IMAGE_FORMAT_S8 VPI_IMAGE_FORMAT_U16 VPI_IMAGE_FORMAT_U32 VPI_IMAGE_FORMAT_S32 VPI_IMAGE_FORMAT_S16 VPI_IMAGE_FORMAT_2S16 VPI_IMAGE_FORMAT_F32 VPI_IMAGE_FORMAT_F64 VPI_IMAGE_FORMAT_2F32 VPI_IMAGE_FORMAT_Y8 VPI_IMAGE_FORMAT_Y8_ER VPI_IMAGE_FORMAT_Y16 VPI_IMAGE_FORMAT_Y16_ER VPI_IMAGE_FORMAT_NV12 VPI_IMAGE_FORMAT_NV12_ER VPI_IMAGE_FORMAT_NV24 VPI_IMAGE_FORMAT_NV24_ER VPI_IMAGE_FORMAT_RGB8 VPI_IMAGE_FORMAT_BGR8 VPI_IMAGE_FORMAT_RGBA8 VPI_IMAGE_FORMAT_BGRA8 VPI_IMAGE_FORMAT_RGB8p VPI_IMAGE_FORMAT_BGR8p VPI_IMAGE_FORMAT_RGBA8p VPI_IMAGE_FORMAT_BGRA8p 对于 VPI_BACKEND_PVA，支持 2 种用例 将 4 个平面 VPI_IMAGE_FORMAT_U8 图像转换为 1 个交错 VPI_IMAGE_FORMAT_RGBA8 图像。 将 1 个交错 VPI_IMAGE_FORMAT_RGBA8 图像转换为 4 个平面 VPI_IMAGE_FORMAT_U8 图像。 对于 VPI_BACKEND_PVA，最小输入图像平面大小为 128x96 像素。
[输入]	numInputs	输入指针参数数组中的输入数量。 必须介于 1 和 VPI_MIX_CHANNELS_MAX_IMAGES 之间。 对于 VPI_BACKEND_PVA，必须为 1 或 4，具体取决于用例。 用例在 inputs 部分下定义。
[输出]	outputs	要将通道插入到的一个或多个输出图像。 不能为空。 所有输出图像都必须已分配。 每个输出图像平面大小必须与映射的输入图像平面大小匹配。 图像必须启用将执行该算法的后端。 接受的图像格式与 inputs 中的相同。
[输入]	numOutputs	输出指针参数数组中的输出数量。 必须介于 1 和 VPI_MIX_CHANNELS_MAX_IMAGES 之间。 对于 VPI_BACKEND_PVA，必须为 1 或 4，具体取决于用例。 用例在 inputs 部分下定义。
[输入]	inMapping	包含输入图像通道索引的数组。通道在整个图像中被认为是线性的，即每个输入都被视为通道序列，并且所有输入都按其数组顺序连接。输入通道的索引给出了整个输入通道连接序列中的位置。 必须包含现有的输入通道索引。 数组大小必须等于 numMapping。 对于 VPI_BACKEND_PVA，必须为 {0,1,2,3}。
[输入]	outMapping	包含输出图像通道索引的数组。通道在整个图像中被认为是线性的，即每个输出都被视为通道序列，并且所有输出都按其数组顺序连接。输出通道的索引给出了整个输出通道连接序列中的位置。 必须包含现有的输出通道索引。 数组大小必须等于 numMapping。 对于 VPI_BACKEND_PVA，必须为 {0,1,2,3}。
[输入]	numMapping	映射数组指针参数中的映射数量。 必须 >= 1 且 <= VPI_MIX_CHANNELS_MAX_IMAGES * VPI_MAX_PLANE_COUNT。 对于 VPI_BACKEND_PVA，必须为 4。

返回值

VPI_ERROR_INVALID_ARGUMENT	stream 或 inputs 或 outputs 或 mappings 为 NULL。
VPI_ERROR_INVALID_ARGUMENT	numInputs 或 numOutputs 或 numMapping 超出有效范围。
VPI_ERROR_INVALID_IMAGE_FORMAT	不支持的输入或输出格式。
VPI_ERROR_INVALID_OPERATION	所需的后端未在 stream、inputs 或 outputs 中启用。
VPI_SUCCESS	操作执行成功。