---
title: GrayErodeBorder
description: "使用蒙版进行图像灰度腐蚀。灰度腐蚀就是求局部源图像与蒙版元素和的最小值的操作，运算符是“”，其定义如下："
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/240RC1/accel/kunpengaccel_hmpp_06_0247.html
sourcePath: /source/zh/kunpengboostkithistory/240RC1/accel/kunpengaccel_hmpp_06_0247.html
indexId: 7dc5e2bfdb3a99663822939774b37c02860c4f8a2299bfabaa1ba0b26e2d6f0b77
---
# GrayErodeBorder

使用蒙版进行图像灰度腐蚀。灰度腐蚀就是求局部源图像与蒙版元素和的最小值的操作，运算符是“”，其定义如下：


该公式表示用蒙版B来对图像A进行灰度腐蚀处理，其中B是一个蒙版。通过蒙版B与图像A进行卷积计算，扫描图像中的每一个像素点，计算B覆盖区域的像素点与B蒙版元素值和的最小值，并用这个最小值替换参考点指定的像素值实现灰度腐蚀。

以下为接口输入输出图示：


此类函数支持的边界方式说明可参照枚举类型的HmppiBorderType说明，但只支持HMPP_BORDER_REPL。

该函数调用流程如下：

1. 调用对应类型Init初始化HmppiMorphGrayPolicy结构体，否则主函数无法调用成功。
2. 调用主函数。
3. 最后调用Release释放HmppiMorphGrayPolicy函数所包含内存，否则将产生内存泄漏。

函数接口声明如下：

- 初始化操作：
  HmppResult HMPPI_MorphGrayInit_8u_C1R(HmppiMorphGrayPolicy_8u **policy, HmppiSize roiSize, const int32_t *mask, HmppiSize maskSize, HmppiPoint anchor)；

  HmppResult HMPPI_MorphGrayInit_32f_C1R(HmppiMorphGrayPolicy_32f **policy, HmppiSize roiSize, const float *mask, HmppiSize maskSize, HmppiPoint anchor);

- 主函数操作：
  HmppResult HMPPI_GrayErodeBorder_8u_C1R(const uint8_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize, HmppiBorderType borderType, HmppiMorphGrayPolicy_8u *policy);

  HmppResult HMPPI_GrayErodeBorder_32f_C1R(const float *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize, HmppiBorderType borderType, HmppiMorphGrayPolicy_32f *policy);

- 释放内存操作：
  HmppResult HMPPI_MorphGrayRelease_8u(HmppiMorphGrayPolicy_8u *policy);

  HmppResult HMPPI_MorphGrayRelease_32f(HmppiMorphGrayPolicy_32f *policy);


#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| mask | 指向蒙版的指针。 | 非空 | 输入 |
| maskSize | 蒙版图像的大小（以像素为单位）。 | maskSize.width∈(0, INT\_MAX]，maskSize.height∈(0, INT\_MAX] | 输入 |
| anchor | 锚点坐标。 | anchor.x∈(0, maskSize.width\-1]，anchor.y∈(0, maskSize.height\-1] | 输入 |
| src | 指向源图像的指针。 | 非空 | 输入 |
| srcStep | 源图像中连续行的起点之间的距离（以字节为单位）。 | 非负整数，且为src数据类型的字节整倍数。 | 输入 |
| dst | 指向目的向量的指针。 | 非空 | 输出 |
| dstStep | 目标图像中连续行的起点之间的距离（以字节为单位）。 | 非负整数，且为dst数据类型的字节整倍数。 | 输入 |
| roiSize | 源和目标图像感兴趣区域的大小（以像素为单位）。 | roiSize.width∈(0, INT\_MAX]，roiSize.height∈(0, INT\_MAX] | 输入 |
| borderType | 边界填充类型。 | 枚举，边界填充类型。 HMPP\_BORDER\_REPL：边框从边缘像素复制而来。 | 输入 |
| policy （init函数中） | 指向内存存储HmppiMorphGrayPolicy的指针的指针。 | 非空 | 输出 |
| policy（主函数中和release函数中） | 指向HmppiMorphGrayPolicy结构体的指针。 | 非空 | 输入 |


#### 返回值

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


#### 错误码

| 错误码 | 描述 |
| --- | --- |
| HMPP\_STS\_NULL\_PTR\_ERR | 任何指定的指针为空。 |
| HMPP\_STS\_SIZE\_ERR | roiSize或者maskSize的字段为零或负值。 |
| HMPP\_STS\_ANCHOR\_ERR | 锚点anchor字段为负或大于等于maskSize的字段。 |
| HMPP\_STS\_STEP\_ERR | 源或者目标Step中存在零或负值。 |
| HMPP\_STS\_MALLOC\_FAILED | Init函数中进行算法模型所需内存申请失败。 |
| HMPP\_STS\_NOT\_EVEN\_STEP\_ERR | srcStep或者dstStep不为其图像所属数据类型的字节长度的整倍数。 |
| HMPP\_STS\_ROI\_ERR | 源或者目标图像的宽和高比roiSize的字段小。 |
| HMPP\_STS\_BORDER\_ERR | 不支持的边界填充类型。 |
| HMPP\_STS\_NOT\_SUPPORTED\_INPLACE\_MODE\_ERR | src与dst内存地址相同。 |


src不能和dst是同一数组，或内存重叠，否则可能导致结果错误。


#### 示例

```
#define SRC_BUFFER_SIZE_T 96
#define DST_BUFFER_SIZE_T 64
#define MASK_BUFFER_SIZE_T 12
void GrayErodeBorderExample()
{
HmppiSize roiSize = { 4, 4 };
const uint8_t src[SRC_BUFFER_SIZE_T] = {
11, 122, 13, 14, 15, 16, 17, 18, 12, 19, 13, 15,
21, 22, 23, 24, 25, 26, 27, 28, 22, 29, 23, 25,
31, 32, 33, 34, 35, 36, 37, 38, 32, 39, 33, 35,
41, 42, 43, 44, 45, 46, 47, 48, 42, 49, 43, 45,
51, 52, 53, 54, 55, 56, 57, 58, 52, 59, 53, 55,
61, 62, 63, 64, 65, 66, 67, 68, 62, 69, 63, 65,
71, 72, 73, 74, 75, 76, 77, 78, 72, 79, 73, 75,
81, 82, 83, 84, 85, 86, 87, 88, 82, 89, 83, 85
};
uint8_t dst[DST_BUFFER_SIZE_T] = { 0 };
HmppiSize maskSize = { 4, 3 };
HmppiPoint anchor = { 0, 0 };
int32_t mask[MASK_BUFFER_SIZE_T] = {
-7, 0, -2, 3,
5, -1, 1, 0,
0, 2, 0, -6,
};
const int32_t srcWidth = 12;
const int32_t dstWidth = 8;
int32_t srcStep = srcWidth * sizeof(uint8_t);
int32_t dstStep = dstWidth * sizeof(uint8_t);
HmppiBorderType borderType = HMPPI_BORDER_REPL;
HmppiMorphGrayPolicy_8u *policy = NULL;
HmppResult result;
result = HMPPI_MorphGrayInit_8u_C1R(&policy, roiSize, mask, maskSize, anchor);
printf("HMPPI_MorphGrayInit_8u_C1R result = %d\n", result);
if (result != HMPP_STS_NO_ERR) {
return;
}
result = HMPPI_GrayErodeBorder_8u_C1R(src, srcStep, dst, dstStep, roiSize, borderType, policy);
printf("HMPPI_GrayErodeBorder_8u_C1R result = %d\n", result);
(void)HMPPI_MorphGrayRelease_8u(policy);
policy = NULL;
if (result != HMPP_STS_NO_ERR) {
return;
}
printf("result = %d \ndst = ", result);
if (result != HMPP_STS_NO_ERR) {
printf("result error: %d\n", result);
}
for (int32_t i = 0; i < DST_BUFFER_SIZE_T; ++i) {
if (i % dstWidth == 0) {
printf("\n");
}
printf("%3d ", dst[i]);
}
printf("\n");
}
int main(void)
{
GrayErodeBorderExample();
return 0;
}
```

运行结果：

```
HMPPI_MorphGrayInit_8u_C1R result = 0
HMPPI_GrayDilateBorder_8u_C1R result = 0
result = 0
dst =
4  12   6   7   0   0   0   0
14  15  16  17   0   0   0   0
24  25  26  27   0   0   0   0
34  35  36  37   0   0   0   0
0   0   0   0   0   0   0   0
0   0   0   0   0   0   0   0
0   0   0   0   0   0   0   0
0   0   0   0   0   0   0   0
```