---
title: MorphReconstructDilate
description: "通过膨胀重建图像。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/240RC2/accel/kunpengaccel_hmpp_06_0253.html
sourcePath: /source/zh/kunpengboostkithistory/240RC2/accel/kunpengaccel_hmpp_06_0253.html
indexId: 6c6e427dc7eeb0c44d344d0d6a91b11032e841dc90b480e9befe241f0527a5f377
---
# MorphReconstructDilate

通过膨胀重建图像。

该函数调用流程如下：

1. 调用对应类型Init初始化主函数执行所需内存buffer，否则主函数无法调用成功。
2. 调用主函数。
3. 最后调用Release释放buffer内存。

函数接口声明如下：

- 初始化操作：
  HmppResult HMPPI_MorphReconstructInit_32f(HmppiSize roiSize, HmppDataType dataType, int32_t numChannels, float **buffer);

  HmppResult HMPPI_MorphReconstructInit_8u(HmppiSize roiSize, HmppDataType dataType, int32_t numChannels, uint8_t **buffer);

- 主函数操作：
  HmppResult HMPPI_MorphReconstructDilate_8u_C1IR(const uint8_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize, uint8_t *buffer, HmppiNorm Norm);

  HmppResult HMPPI_MorphReconstructDilate_16u_C1IR(const uint16_t *src, int32_t srcStep, uint16_t *dst, int32_t dstStep, HmppiSize roiSize, uint8_t *buffer, HmppiNorm Norm);

  HmppResult HMPPI_MorphReconstructDilate_64f_C1IR(const double *src, int32_t srcStep, double *dst, int32_t dstStep, HmppiSize roiSize, uint8_t *buffer, HmppiNorm Norm);

  HmppResult HMPPI_MorphReconstructDilate_32f_C1IR(const float *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize, float *buffer, HmppiNorm Norm);

- 释放内存操作：
  HmppResult HMPPI_MorphReconstructRelease_8u(uint8_t *buffer);

  HmppResult HMPPI_MorphReconstructRelease_32f(float *buffer);


#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| dataType | 源图像的数据类型（目标图像同源图像）。 | 枚举，数据类型。支持HMPP8U、HMPP16U、HMPP32F和HMPP64F。 | 输入 |
| numChannels | 源图像的通道数（目标图像同源图像）。 | 仅支持1、3和4通道。 | 输入 |
| src | 指向源图像的指针。 | 非空 | 输入 |
| srcStep | 源图像中连续行的起点之间的距离（以字节为单位）。 | 非负整数，且为src数据类型的字节整倍数。 | 输入 |
| dst | 指向目的向量的指针。 | 非空 | 输出 |
| dstStep | 目标图像中连续行的起点之间的距离（以字节为单位）。 | 非负整数，且为dst数据类型的字节整倍数。 | 输入 |
| roiSize | 源和目标图像感兴趣区域的大小（以像素为单位）。 | roiSize.width∈(0, INT\_MAX]，roiSize.height∈(0, INT\_MAX] | 输入 |
| Norm | 蒙版标准类型。 | HMPP\_NORMINF：无穷范数，8连通，3x3矩形掩码。 HMPP\_NORML1：L1标准，4连通，3x3交叉蒙版。 | 输入 |
| buffer （init函数中） | 指向辅助内存buffer的指针的指针。 | 非空 | 输出 |
| buffer（主函数中和release函数中） | 指向辅助内存buffer的指针。 | 非空 | 输入 |


#### 返回值

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


#### 错误码

| 错误码 | 描述 |
| --- | --- |
| HMPP\_STS\_NULL\_PTR\_ERR | 任何指定的指针为空。 |
| HMPP\_STS\_SIZE\_ERR | roiSize或者maskSize的字段为零或负值。 |
| HMPP\_STS\_NOT\_SUPPORTED\_MODE\_ERR | 初始化不支持的数据类型。 |
| HMPP\_STS\_NUMCHANNELS\_ERR | 初始化不支持的通道数。 |
| 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\_NORM\_ERR | 蒙版的类型不支持。 |


8u、16u、64f类型主函数使用8u类型初始化接口，32f类型主函数使用32f类型初始化接口，否则调用主函数可能会产生崩溃等情况。


#### 示例

```
#define SRC_BUFFER_SIZE_T 96
#define DST_BUFFER_SIZE_T 64
#define MASK_BUFFER_SIZE_T 12
void MorphReconstructDilateExample()
{
HmppiSize roiSize = { 4, 4 };
const uint16_t src[SRC_BUFFER_SIZE_T] = {
11, 12, 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
};
uint16_t dst[DST_BUFFER_SIZE_T] = { 0 };
HmppiSize maskSize = { 4, 3 };
uint8_t mask[MASK_BUFFER_SIZE_T] = {
1, 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(int16_t);
int32_t dstStep = dstWidth * sizeof(int16_t);
HmppDataType dataType = HMPP16U;
int32_t numChannels = 1;
uint8_t *buffer = NULL;
HmppiNorm Norm = HMPP_NORMINF;
HmppResult result;
result = HMPPI_MorphReconstructInit_8u(roiSize, dataType, numChannels, &buffer);
printf("HMPPI_MorphReconstructInit_8u result = %d\n", result);
if (result != HMPP_STS_NO_ERR) {
return;
}
result = HMPPI_MorphReconstructDilate_16u_C1IR(src, srcStep, dst, dstStep, roiSize, buffer, Norm);
printf("HMPPI_MorphReconstructDilate_16u_C1IR result = %d\n", result);
(void)HMPPI_MorphReconstructRelease_8u(buffer);
buffer = 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)
{
MorphReconstructDilateExample();
return 0;
}
```

运行结果：

```
HMPPI_MorphReconstructInit_8u result = 0
HMPPI_MorphReconstructDilate_16u_C1IR result = 0
result = 0
dst =
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   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
```