--- title: ErodeBorder description: "使用蒙版进行图像腐蚀，原理同Erode3x3。" url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/240RC2/accel/kunpengaccel_hmpp_06_0245.html sourcePath: /source/zh/kunpengboostkithistory/240RC2/accel/kunpengaccel_hmpp_06_0245.html indexId: 0dcc8bdd925a6d0e605376c2239f89e84b81a0d3b3f7df2c8330e3fe4fe5d38877 --- # ErodeBorder 使用蒙版进行图像腐蚀，原理同Erode3x3。 其中最小值的有效计算仅针对蒙版图像中的非0元素。 以下为接口输入输出图示： 此类函数支持的边界方式说明可参照枚举类型的HmppiBorderType的说明。 同时支持混合填充方式：如HMPP_BORDERREPL | HMPP_BORDERINMEM_TOP，表示上边界以HMPP_BORDERINMEM方式填充，其余边界以HMPP_BORDERREPL方式填充。 该函数调用流程如下： 1. 调用对应类型Init初始化HmppiMorphPolicy结构体，否则主函数无法调用成功。 2. 调用主函数。 3. 最后调用Release释放HmppiMorphPolicy函数所包含内存，否则将产生内存泄漏。 函数接口声明如下： - 初始化操作： HmppResult HMPPI_MorphInit(HmppiSize roiSize, const uint8_t *mask, HmppiSize maskSize, HmppDataType dataType, int32_t numChannels, HmppiMorphPolicy **policy); HmppResult HMPPI_ErodeInit(HmppiSize roiSize, const uint8_t *mask, HmppiSize maskSize, HmppDataType dataType, int32_t numChannels, HmppiMorphPolicy **policy); HmppResult HMPPI_MorphologyBorderInit_1u_C1R(HmppiSize roiSize, const uint8_t *mask, HmppiSize maskSize, HmppiMorphPolicy **policy); HmppResult HMPPI_MorphologyBorderInit_8u_C1R(HmppiSize roiSize, const uint8_t *mask, HmppiSize maskSize, HmppiMorphPolicy **policy); HmppResult HMPPI_MorphologyBorderInit_16u_C1R(HmppiSize roiSize, const uint8_t *mask, HmppiSize maskSize, HmppiMorphPolicy **policy); HmppResult HMPPI_MorphologyBorderInit_16s_C1R(HmppiSize roiSize, const uint8_t *mask, HmppiSize maskSize, HmppiMorphPolicy **policy); HmppResult HMPPI_MorphologyBorderInit_32f_C1R(HmppiSize roiSize, const uint8_t *mask, HmppiSize maskSize, HmppiMorphPolicy **policy); HmppResult HMPPI_MorphologyBorderInit_8u_C3R(HmppiSize roiSize, const uint8_t *mask, HmppiSize maskSize, HmppiMorphPolicy **policy); HmppResult HMPPI_MorphologyBorderInit_32f_C3R(HmppiSize roiSize, const uint8_t *mask, HmppiSize maskSize, HmppiMorphPolicy **policy); HmppResult HMPPI_MorphologyBorderInit_8u_C4R(HmppiSize roiSize, const uint8_t *mask, HmppiSize maskSize, HmppiMorphPolicy **policy); HmppResult HMPPI_MorphologyBorderInit_32f_C4R(HmppiSize roiSize, const uint8_t *mask, HmppiSize maskSize, HmppiMorphPolicy **policy); - 主函数操作： HmppResult HMPPI_ErodeBorder_1u_C1R(const uint8_t *src, int32_t srcStep, int32_t srcBitOffset, uint8_t *dst, int32_t dstStep, int32_t dstBitOffset, HmppiSize roiSize, HmppiBorderType borderType, uint8_t borderValue, const HmppiMorphPolicy *policy); HmppResult HMPPI_ErodeBorder_8u_C1R(const uint8_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize, HmppiBorderType borderType, uint8_t borderValue, const HmppiMorphPolicy *policy); HmppResult HMPPI_ErodeBorder_16u_C1R(const uint16_t *src, int32_t srcStep, uint16_t *dst, int32_t dstStep, HmppiSize roiSize, HmppiBorderType borderType, uint16_t borderValue, const HmppiMorphPolicy *policy); HmppResult HMPPI_ErodeBorder_16s_C1R(const int16_t *src, int32_t srcStep, int16_t *dst, int32_t dstStep, HmppiSize roiSize, HmppiBorderType borderType, int16_t borderValue, const HmppiMorphPolicy *policy); HmppResult HMPPI_ErodeBorder_32f_C1R(const float *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize, HmppiBorderType borderType, float borderValue, const HmppiMorphPolicy *policy); HmppResult HMPPI_ErodeBorder_8u_C3R(const uint8_t* src, int32_t srcStep, uint8_t* dst, int32_t dstStep, HmppiSize roiSize, HmppiBorderType borderType, const uint8_t borderValue[3], const HmppiMorphPolicy* policy); HmppResult HMPPI_ErodeBorder_32f_C3R(const float *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize, HmppiBorderType borderType, const float borderValue[3], const HmppiMorphPolicy *policy); HmppResult HMPPI_ErodeBorder_8u_C4R(const uint8_t* src, int32_t srcStep, uint8_t* dst, int32_t dstStep, HmppiSize roiSize, HmppiBorderType borderType, const uint8_t borderValue[4], const HmppiMorphPolicy* policy); HmppResult HMPPI_ErodeBorder_32f_C4R(const float *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize, HmppiBorderType borderType, const float borderValue[4], const HmppiMorphPolicy *policy); - 释放内存操作： HmppResult HMPPI_MorphRelease(HmppiMorphPolicy *policy); HmppResult HMPPI_ErodeRelease(HmppiMorphPolicy *policy); HmppResult HMPPI_MorphologyBorderRelease_1u_C1R(HmppiMorphPolicy *policy); HmppResult HMPPI_MorphologyBorderRelease_8u_C1R(HmppiMorphPolicy *policy); HmppResult HMPPI_MorphologyBorderRelease_16u_C1R(HmppiMorphPolicy *policy); HmppResult HMPPI_MorphologyBorderRelease_16s_C1R(HmppiMorphPolicy *policy); HmppResult HMPPI_MorphologyBorderRelease_32f_C1R(HmppiMorphPolicy *policy); HmppResult HMPPI_MorphologyBorderRelease_8u_C3R(HmppiMorphPolicy *policy); HmppResult HMPPI_MorphologyBorderRelease_32f_C3R(HmppiMorphPolicy *policy); HmppResult HMPPI_MorphologyBorderRelease_8u_C4R(HmppiMorphPolicy *policy); HmppResult HMPPI_MorphologyBorderRelease_32f_C4R(HmppiMorphPolicy *policy); #### 参数 | 参数名 | 描述 | 取值范围 | 输入/输出 | | --- | --- | --- | --- | | mask | 指向蒙版的指针。 | 非空 | 输入 | | maskSize | 蒙版图像的大小（以像素为单位）。 | maskSize.width∈(0, INT\_MAX]，maskSize.height∈(0, INT\_MAX] | 输入 | | dataType | 源图像的数据类型（目标图像同源图像）。 | 枚举，数据类型。支持HMPP8U、HMPP16U、HMPP16S和HMPP32F。 | 输入 | | numChannels | 源图像的通道数（目标图像同源图像）。 | 仅支持1、3和4通道 | 输入 | | src | 指向源图像的指针。 | 非空 | 输入 | | srcStep | 源图像中连续行的起点之间的距离（以字节为单位）。 | 非负整数，且为src数据类型的字节整倍数 | 输入 | | srcBitOffset | 从源图像的第一个字节开始的偏移量（以bit为单位）。 | (0, INT\_MAX]，且与roiSize.width的和需大于等于srcStep \* 8 | 输入 | | dst | 指向目的向量的指针。 | 非空 | 输出 | | dstStep | 目标图像中连续行的起点之间的距离（以字节为单位）。 | 非负整数，且为dst数据类型的字节整倍数 | 输入 | | dstBitOffset | 从目标图像的第一个字节开始的偏移量（以bit为单位）。 | (0, INT\_MAX]，且与roiSize.width的和需大于等于dstStep \* 8 | 输入 | | roiSize | 源和目标图像感兴趣区域的大小（以像素为单位）。 | roiSize.width∈(0, INT\_MAX]，roiSize.height∈(0, INT\_MAX] | 输入 | | borderType | 边界填充类型。 | 枚举，边界填充类型。 HMPP\_BORDER\_DEFAULT：边框设置为HMPP\_BORDER\_CONST，其borderValue= MAX\_VALUE。 HMPP\_BORDER\_REPL：边框从边缘像素复制而来。 HMPP\_BORDER\_IN\_MEM：边框是从内存中的源图像像素获得的。 HMPP\_BORDER\_CONST：所有边框像素的值都设置为常数。 HMPP\_BORDER\_MIRROR：边框像素从源图像边界像素镜像而来。 还支持混合边框。 | 输入 | | borderValue | 常量值，分配给常量边框HMPP\_BORDER\_CONST的像素。 | 数据类型范围内的值 | 输入 | | policy （init函数中） | 指向内存存储HmppiMorphPolicy的指针的指针。 | 非空 | 输出 | | policy（主函数中和release函数中） | 指向HmppiMorphPolicy结构体的指针。 | 非空 | 输入 | #### 返回值 - 成功：返回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 | srcStep、dstStep、srcBitOffset或者dstBitOffset中存在零或负值。 或srcBitOffset、dstBitOffset不能满足roiSize字段的关系。 | | HMPP\_STS\_MALLOC\_FAILED | Init函数中进行算法模型所需内存申请失败。 | | HMPP\_STS\_NOT\_EVEN\_STEP\_ERR | srcStep或者dstStep不为其图像所属数据类型的字节长度的整倍数。 | | HMPP\_STS\_ROI\_ERR | 源或者目标图像的宽和高比roiSize的字段小。 | | HMPP\_STS\_BORDER\_ERR | 不支持的边界填充类型的错误。 | - src不能和dst是同一数组，或内存重叠，否则可能导致结果错误。 - 当使用HMPP_BORDER_IN_MEM边界填充模式时，需保证入参的源图像有足够的额外数据以供计算使用，调用主函数时将src偏移最少offset长度，否则甚至可能产生崩溃等情况。offset需满足： 其中T为源图像数据类型。 - 1u_C1R类型接口不支持HMPP_BORDER_MIRROR模式，否则将返回HMPP_STS_BORDER_ERR错误。 #### 示例 ``` #define SRC_BUFFER_SIZE_T 96 #define DST_BUFFER_SIZE_T 64 #define MASK_BUFFER_SIZE_T 12 void ErodeBorderExample() { HmppiSize roiSize = { 4, 4 }; const int16_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 }; int16_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 = HMPP16S; int32_t numChannels = 1; HmppiBorderType borderType = HMPPI_BORDER_REPL; int16_t borderValue = -100; HmppiMorphPolicy *policy = NULL; HmppResult result; result = HMPPI_MorphologyBorderInit_16s_C1R(roiSize, mask, maskSize, &policy); printf("HMPPI_MorphologyBorderInit_16s_C1R result = %d\n", result); if (result != HMPP_STS_NO_ERR) { return; } result = HMPPI_ErodeBorder_16s_C1R(src, srcStep, dst, dstStep, roiSize, borderType, borderValue, policy); printf("HMPPI_ErodeBorder_16s_C1R result = %d\n", result); (void)HMPPI_ErodeRelease(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) { ErodeBorderExample(); return 0; } ``` 运行结果： ``` HMPPI_MorphologyBorderInit_16s_C1R result = 0 HMPPI_ErodeBorder_16s_C1R result = 0 result = 0 dst = 11 11 12 13 0 0 0 0 11 11 12 13 0 0 0 0 21 21 22 23 0 0 0 0 31 31 32 33 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 ```