MorphBlackhatBorder
使用蒙版进行图像黑帽操作，其默认蒙版元素全为非0有效。其定义如下：
该公式表示用蒙版B来对图像A进行黑帽处理。形态学中的黑帽操作表示闭操作（通过蒙版B对图像A执行闭操作）与源图像A的差。
此类函数支持的边界方式说明可参照枚举类型中HmppiBorderType的说明。
同时支持混合填充方式：如HMPP_BORDERREPL | HMPP_BORDERINMEM_TOP，表示上边界以HMPP_BORDERINMEM方式填充，其余边界以HMPP_BORDERREPL方式填充。
该函数调用流程如下：
- 调用对应类型Init初始化HmppiMorphAdvPolicy结构体，否则主函数无法调用成功。
- 调用主函数。
- 最后调用Release释放HmppiMorphAdvPolicy函数所包含内存，否则将产生内存泄漏。
函数接口声明如下：
- 初始化操作：
HmppResult HMPPI_MorphAdvInit_1u_C1R(HmppiSize roiSize, const uint8_t *mask, HmppiSize maskSize, HmppiMorphAdvPolicy **policy);
HmppResult HMPPI_MorphAdvInit_8u_C1R(HmppiSize roiSize, const uint8_t *mask, HmppiSize maskSize, HmppiMorphAdvPolicy **policy);
HmppResult HMPPI_MorphAdvInit_16u_C1R(HmppiSize roiSize, const uint8_t *mask, HmppiSize maskSize, HmppiMorphAdvPolicy **policy);
HmppResult HMPPI_MorphAdvInit_16s_C1R(HmppiSize roiSize, const uint8_t *mask, HmppiSize maskSize, HmppiMorphAdvPolicy **policy);
HmppResult HMPPI_MorphAdvInit_32f_C1R(HmppiSize roiSize, const uint8_t *mask, HmppiSize maskSize, HmppiMorphAdvPolicy **policy);
HmppResult HMPPI_MorphAdvInit_8u_C3R(HmppiSize roiSize, const uint8_t *mask, HmppiSize maskSize, HmppiMorphAdvPolicy **policy);
HmppResult HMPPI_MorphAdvInit_32f_C3R(HmppiSize roiSize, const uint8_t *mask, HmppiSize maskSize, HmppiMorphAdvPolicy **policy);
HmppResult HMPPI_MorphAdvInit_8u_C4R(HmppiSize roiSize, const uint8_t *mask, HmppiSize maskSize, HmppiMorphAdvPolicy **policy);
HmppResult HMPPI_MorphAdvInit_32f_C4R(HmppiSize roiSize, const uint8_t *mask, HmppiSize maskSize, HmppiMorphAdvPolicy **policy);
- 主函数操作：
HmppResult HMPPI_MorphBlackhatBorder_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 HmppiMorphAdvPolicy *policy);
HmppResult HMPPI_MorphBlackhatBorder_8u_C1R(const uint8_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize, HmppiBorderType borderType, uint8_t borderValue, const HmppiMorphAdvPolicy *policy);
HmppResult HMPPI_MorphBlackhatBorder_16u_C1R(const uint16_t *src, int32_t srcStep, uint16_t *dst, int32_t dstStep, HmppiSize roiSize, HmppiBorderType borderType, uint16_t borderValue, const HmppiMorphAdvPolicy *policy);
HmppResult HMPPI_MorphBlackhatBorder_16s_C1R(const int16_t *src, int32_t srcStep, int16_t *dst, int32_t dstStep, HmppiSize roiSize, HmppiBorderType borderType, int16_t borderValue, const HmppiMorphAdvPolicy *policy);
HmppResult HMPPI_MorphBlackhatBorder_32f_C1R(const float *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize, HmppiBorderType borderType, float borderValue, const HmppiMorphAdvPolicy *policy);
HmppResult HMPPI_MorphBlackhatBorder_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 HmppiMorphAdvPolicy *policy);
HmppResult HMPPI_MorphBlackhatBorder_32f_C3R(const float *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize, HmppiBorderType borderType, const float borderValue[3], const HmppiMorphAdvPolicy *policy);
HmppResult HMPPI_MorphBlackhatBorder_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 HmppiMorphAdvPolicy *policy);
HmppResult HMPPI_MorphBlackhatBorder_32f_C4R(const float *src, int32_t srcStep, float *dst, int32_t dstStep, HmppiSize roiSize, HmppiBorderType borderType, const float borderValue[4], const HmppiMorphAdvPolicy *policy);
- 释放内存操作：
HmppResult HMPPI_MorphAdvRelease_1u_C1R(HmppiMorphAdvPolicy *policy);
HmppResult HMPPI_MorphAdvRelease_8u_C1R(HmppiMorphAdvPolicy *policy);
HmppResult HMPPI_MorphAdvRelease_16u_C1R(HmppiMorphAdvPolicy *policy);
HmppResult HMPPI_MorphAdvRelease_16s_C1R(HmppiMorphAdvPolicy *policy);
HmppResult HMPPI_MorphAdvRelease_32f_C1R(HmppiMorphAdvPolicy *policy);
HmppResult HMPPI_MorphAdvRelease_8u_C3R(HmppiMorphAdvPolicy *policy);
HmppResult HMPPI_MorphAdvRelease_32f_C3R(HmppiMorphAdvPolicy *policy);
HmppResult HMPPI_MorphAdvRelease_8u_C4R(HmppiMorphAdvPolicy *policy);
HmppResult HMPPI_MorphAdvRelease_32f_C4R(HmppiMorphAdvPolicy *policy);
参数
参数名 |
描述 |
取值范围 |
输入/输出 |
|---|---|---|---|
mask |
指向蒙版的指针。 |
非空 |
输入 |
maskSize |
蒙版图像的大小（以像素为单位）。 |
maskSize.width∈(0, INT_MAX]，maskSize.height∈(0, INT_MAX] |
输入 |
src |
指向源图像的指针。 |
非空 |
输入 |
srcStep |
源图像中连续行的起点之间的距离（以字节为单位）。 |
非负整数，且为src数据类型的字节整倍数 |
输入 |
dst |
指向目的向量的指针。 |
非空 |
输出 |
dstStep |
目标图像中连续行的起点之间的距离（以字节为单位）。 |
非负整数，且为dst数据类型的字节整倍数 |
输入 |
roiSize |
源和目标图像感兴趣区域的大小（以像素为单位）。 |
roiSize.width∈(0, INT_MAX]，roiSize.height∈(0, INT_MAX] |
输入 |
borderType |
边界填充类型。 |
枚举，边界填充类型。 HMPP_BORDER_DEFAULT：边框设置为HMPP_BORDER_CONST，填充值依据基础操作选用填充的固定值。 HMPP_BORDER_REPL：边框从边缘像素复制而来。 HMPP_BORDER_IN_MEM：边框是从内存中的源图像像素获得的。 HMPP_BORDER_CONST：所有边框像素的值都设置为常数。 HMPP_BORDER_MIRROR：边框像素从源图像边界像素镜像而来。 还支持混合边框。 |
输入 |
borderValue |
常量值，分配给常量边框HMPP_BORDER_CONST的像素。 |
数据类型范围内的值 |
输入 |
policy （init函数中） |
指向内存存储HmppiMorphAdvPolicy的指针的指针。 |
非空 |
输出 |
policy（主函数中和release函数中） |
指向HmppiMorphAdvPolicy结构体的指针。 |
非空 |
输入 |
返回值
- 成功：返回HMPP_STS_NO_ERR。
- 失败：返回错误码。
错误码
错误码 |
描述 |
|---|---|
HMPP_STS_NULL_PTR_ERR |
任何指定的指针为空。 |
HMPP_STS_SIZE_ERR |
roiSize或者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 |
不支持的边界填充类型。 |
- 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 MorphBlackhatBorderExample()
{
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;
HmppiMorphAdvPolicy *policy = NULL;
HmppResult result;
result = HMPPI_MorphAdvInit_16s_C1R(roiSize, mask, maskSize, &policy);
printf("HMPPI_MorphAdvInit_16s_C1R result = %d\n", result);
if (result != HMPP_STS_NO_ERR) {
return;
}
result = HMPPI_MorphBlackhatBorder_16s_C1R(src, srcStep, dst, dstStep, roiSize, borderType, borderValue, policy);
printf("HMPPI_MorphBlackhatBorder_16s_C1R result = %d\n", result);
(void)HMPPI_MorphAdvRelease_16s_C1R(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)
{
MorphBlackhatBorderExample();
return 0;
}
运行结果：
HMPPI_MorphAdvInit_16s_C1R result = 0 HMPPI_MorphBlackhatBorder_16s_C1R result = 0 result = 0 dst = 12 11 10 10 0 0 0 0 2 1 0 0 0 0 0 0 2 1 0 0 0 0 0 0 2 1 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