图像处理类，Tensor类的图像通道拆分接口，用于将多通道图片拆分为单通道图片。支持异步调用。

当前支持Atlas 推理系列产品和Atlas 200I/500 A2 推理产品。

在Atlas 200I/500 A2 推理产品上，支持预加载（示例请参见“初始化算子预加载文件实例”章节）。

使用时需满足以下条件：

APP_ERROR Split(const Tensor &src, std::vector<Tensor> &tv, AscendStream &stream = AscendStream::DefaultStream());

参数名	输入/输出	说明
src	输入	Tensor类，支持float16、float32、uint8类型输入。维度支持HWC（三维）、NHWC（四维），其中“C”（通道数）为3或4。
tv	输入/输出	std::vector<Tensor>类，用于存储拆分后的单通道Tensor，Tensor类的元素支持float16、float32、uint8类型，支持传入空vector，如果vector不为空，vector中的tensor需要调用Tensor.Malloc()接口提前分配内存。 “tv”的长度与“src”一致且“C”均为“1”。
stream	输入	AscendStream类型，默认值为“AscendStream::DefaultStream()”。当参数值为默认值时，接口为同步操作，其他情况下，接口为异步操作。

参数名

输入/输出

说明

src

输入

Tensor类，支持float16、float32、uint8类型输入。

维度支持HWC（三维）、NHWC（四维），其中“C”（通道数）为3或4。

输入/输出

std::vector<Tensor>类，用于存储拆分后的单通道Tensor，Tensor类的元素支持float16、float32、uint8类型，支持传入空vector，如果vector不为空，vector中的tensor需要调用Tensor.Malloc()接口提前分配内存。

“tv”的长度与“src”一致且“C”均为“1”。

stream

输入

AscendStream类型，默认值为“AscendStream::DefaultStream()”。当参数值为默认值时，接口为同步操作，其他情况下，接口为异步操作。

数据结构	说明
APP_ERROR	程序执行返回的错误码，请参考APP_ERROR说明。