Merge
函数功能
图像处理类，Tensor类的图片通道合并接口，用于将多个图片合并为一个多通道的图片。支持异步调用。
当前支持Atlas 推理系列产品和Atlas 200I/500 A2 推理产品。
在Atlas 200I/500 A2 推理产品上，支持预加载（示例请参见“初始化算子预加载文件实例”章节）。
使用时需满足以下条件：
- 接口中的输入输出Tensor必须在Device或DVPP侧且各参数（stream及数据内存）需位于同一Device中。
- 同步场景下，数据内存所在Device需与初始化的Device一致。
- 各输入、输出参数对应Tensor的形状相等（最后一维除外）、类型一致。
函数原型
APP_ERROR Merge(const std::vector <Tensor> &tv, Tensor &dst, AscendStream& stream = AscendStream::DefaultStream());
参数说明
参数名 |
输入/输出 |
说明 |
|---|---|---|
tv |
输入 |
std::vector <Tensor>类，用于存储等待合并的Tensor向量。其中，Tensor支持float16、float32、uint8类型。 维度支持HWC（三维）、NHWC（四维）且“tv”向量长度大于1（至少传入2个Tensor）。 |
dst |
输出 |
Tensor类，合并后的多通道Tensor，支持float16、float32、uint8类型，支持传入空Tensor，如果dst不为空Tensor，需要调用Tensor.Malloc()接口提前分配内存。 “dst”中的“C”（通道数）为3或4，等于“tv”中的“C”数量总和。 |
stream |
输入 |
AscendStream类型，默认值为“AscendStream::DefaultStream()”。当参数值为默认值时，接口为同步操作，其他情况下，接口为异步操作。 |
返回参数说明
数据结构 |
说明 |
|---|---|
APP_ERROR |
程序执行返回的错误码，请参考APP_ERROR说明。 |
父主题： TensorOperations