ResizePaste
函数功能
图像缩放贴图接口，支持异步执行，使用该接口申请的Tensor内存无需用户管理，由内部管理释放。支持隐式内存分配。如果预贴图的大小不一致，需要先进行缩放。
当前仅支持Atlas 推理系列产品。
- 输入输出Tensor类支持的图像格式参考如下。
- 只支持Atlas 推理系列产品，图像格式只支持YVU_400、RGB_888，其中输入分辨率不超过（4096 * 4096）。
- “background”的真实分辨率范围：16 * 6 ~ 4096 * 4096。
- 参数“PasteRects”的最大分辨率：4096 * 4096，最小分辨率：10 * 6。
- “dst”若设置“keepMargin”为“true”，输出宽自动与16对齐。若“dst”宽度为16对齐且内存为DVPP侧，则复用输入“background”内存。
- 缩放后图片的宽高不能超出真实图片的[1/32 ,16]倍数区间。
- 输入贴图数量“inputPics”和贴图区域“PasteRects”需一一对应，且最大值为“256”。
- “inputPics”区域在结果图片中的宽为16对齐。
- “keepMargin”控制的为输出结果“dst”是否保留Tensor中无效的边界区域，如果“dst”复用“background”，“background”也会根据“keepMargin”值判断是否保留无效边界区域。默认值为“false”。
- 输入图像格式为“YUV_400”时，最小分辨率为18 * 6。
函数原型
APP_ERROR ResizePaste(const MxBase::Tensor &background, std::vector<MxBase::Tensor> &inputPics, std::vector<MxBase::Rect> &pasteRects, MxBase::Tensor &dst, bool keepMargin = false, MxBase::AscendStream &stream = MxBase::AscendStream::DefaultStream());
参数说明
参数名 |
输入/输出 |
说明 |
|---|---|---|
background |
输入 |
Tensor类，输入张量，被贴图的目标张量，支持uint8类型输入，维度支持HW（2维）、HWC（3维）张量，张量宽度支持[16,4096]，高度支持[6,4096]，灰度支持[18,4096]，数据内存必须在Device侧或DVPP侧。 |
inputPics |
输入 |
std::vector<Tensor>类，输入张量，贴在目标张量上的使用张量组，支持uint8类型输入，维度支持HW（2维）、HWC（3维）张量，张量宽度支持[10,4096]，高度支持[6,4096]，灰度支持[18,4096]，数据内存必须在Device侧或DVPP侧。 |
PasteRects |
输入 |
std::vector<Rect>类，被贴图坐标框，坐标框宽会向上16对齐，对齐后坐标框宽高不能超过背景图片“background”范围。 |
dst |
输出 |
Tensor类，输出张量，贴图结果张量，当“keepMargin”为“true”时结果自动16对齐。支持uint8类型输入，维度支持HW（2维）、HWC（3维）张量，张量宽度支持[10,4096]，高度支持[6,4096]，灰度支持[18,4096]，数据内存必须在Device侧或DVPP侧。若“dst”宽度为16对齐且内存为DVPP侧，则复用输入“background”内存。 |
keepMargin |
输入 |
bool类，是否保留输出“dst”中无效边界区域。 |
stream |
输入 |
AscendStream类型，默认值为“AscendStream::DefaultStream()”。当参数值为默认值时，接口为同步操作，其他情况下，接口为异步操作。 |
返回参数说明
数据结构 |
说明 |
|---|---|
APP_ERROR |
程序执行返回的错误码，请参考APP_ERROR说明。 |