---
title: CopyWrapBorder
description: "该类接口在两个图像之间复制像素值，并添加边界框像素。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/2300/accel/kunpengaccel_hmpp_06_0185.html
sourcePath: /source/zh/kunpengboostkithistory/2300/accel/kunpengaccel_hmpp_06_0185.html
indexId: ab9ff675ee12882a25c3455866752269bcd53c78b85dd9de6d9815871747a6ad75
---
# CopyWrapBorder

该类接口在两个图像之间复制像素值，并添加边界框像素。

函数接口声明如下：

- 非原址操作：
  HmppResult HMPPI_CopyWrapBorder_32s_C1R(const int32_t *src, int32_t srcStep, HmppiSize srcRoiSize, int32_t *dst, int32_t dstStep,HmppiSize dstRoiSize, int32_t topBorderHeight, int32_t leftBorderWidth);

  HmppResult HMPPI_CopyWrapBorder_32f_C1R(const float *src, int32_t srcStep, HmppiSize srcRoiSize, float *dst, int32_t dstStep,HmppiSize dstRoiSize, int32_t topBorderHeight, int32_t leftBorderWidth);

- 原址操作：
  HmppResult HMPPI_CopyWrapBorder_32s_C1IR(const int32_t *src, int32_t srcDstStep, HmppiSize srcRoiSize, HmppiSize dstRoiSize,int32_t topBorderHeight, int32_t leftborderwidth);

  HmppResult HMPPI_CopyWrapBorder_32f_C1IR(const float *src, int32_t srcDstStep, HmppiSize srcRoiSize, HmppiSize dstRoiSize,int32_t topBorderHeight, int32_t leftborderwidth);


#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| src | 指向源图像感兴趣区域的指针。 | 非空 | 输入 |
| srcStep | 源图像中连续行的起点之间的距离（以字节为单位）。 | 非负整数 | 输入 |
| dst | 指向目的图像感兴趣区域的指针。 | 非空 | 输出 |
| dstStep | 目标图像中连续行的起点之间的距离（以字节为单位）。 | 非负整数 | 输入 |
| srcDst | 指向源和目标图像感兴趣区域的指针（用于原址操作）。 | 非空 | 输入、输出 |
| srcDstStep | 原址操作的源图像和目标图像中连续行的起点之间的距离（以字节为单位）。 | 非负整数 | 输入 |
| srcRoiSize | 源感兴趣区域的大小（以像素为单位）。 | srcRoiSize.width∈(0, INT\_MAX]，srcRoiSize.height∈(0, INT\_MAX] | 输入 |
| dstRoiSize | 目标感兴趣区域的大小（以像素为单位）。 | dstRoiSize.width∈(0, INT\_MAX]，dstRoiSize.height∈(0, INT\_MAX] | 输入、输出 |
| topBorderHeight | 顶部边框的高度（以像素为单位）。 | 非负整数 | 输入 |
| leftBorderWidth | 左边框的宽度（以像素为单位）。 | 非负整数 | 输入 |


#### 返回值

- 成功：返回HMPP_STS_NO_ERR。
- 失败：返回错误码。


#### 错误码

| 错误码 | 描述 |
| --- | --- |
| HMPP\_STS\_NULL\_PTR\_ERR | src、dst这两个入参中存在空指针。 |
| HMPP\_STS\_SIZE\_ERR | srcRoiSize或dstRoiSize为零或负值。 |
| HMPP\_STS\_STEP\_ERR | srcStep、dstStep中存在零或负值。 |
| HMPP\_STS\_NOT\_EVEN\_STEP\_ERR | srcStep、dstStep不能被src、dst所属数据类型的字节长度整除的错误条件。 |
| HMPP\_STS\_ROI\_ERR | srcRoiSize.width > 步长或dstRoiSize.width > 步长。 |


#### 示例

```
#define SRC_BUFFER_SIZE_T 12
#define DST_BUFFER_SIZE_T 132
int CopyWrapBorderExample()
{
HmppiSize roiSrc = {3,4};
int32_t src[SRC_BUFFER_SIZE_T] = { 1, 2, 3,
2, 3, 4,
3, 4, 5,
4, 5, 6 };
int32_t dst[DST_BUFFER_SIZE_T] = {0};
int32_t srcStep = 3 * sizeof(int32_t);
int32_t dstStep = 11 * sizeof(int32_t);
HmppiSize roiDst = {11,12};
int32_t topBorderHeight = 4;
int32_t leftBorderWidth = 4;
HmppResult result = HMPPI_CopyWrapBorder_32s_C1R(src, srcStep, roiSrc, dst, dstStep, roiDst, topBorderHeight, leftBorderWidth);
printf("result = %d \ndst = \n", result);
if (result != HMPP_STS_NO_ERR) {
printf("result error: %d\n", result);
}
int32_t dstWidth = dstStep / sizeof(uint8_t);
for (int32_t i = 0; i < 12; i++){
for (int32_t j = 0; j < 11; j++){
printf("%3d",dst[i*11+j]);
}
printf("\n");
}
return 0;
}
```

运行结果：

```
result = 0
dst =
3   1   2   3   1   2   3   1   2   3   1
4   2   3   4   2   3   4   2   3   4   2
5   3   4   5   3   4   5   3   4   5   3
6   4   5   6   4   5   6   4   5   6   4
3   1   2   3   1   2   3   1   2   3   1
4   2   3   4   2   3   4   2   3   4   2
5   3   4   5   3   4   5   3   4   5   3
6   4   5   6   4   5   6   4   5   6   4
3   1   2   3   1   2   3   1   2   3   1
4   2   3   4   2   3   4   2   3   4   2
5   3   4   5   3   4   5   3   4   5   3
6   4   5   6   4   5   6   4   5   6   4
```