GrayDilateBorder

使用蒙版进行图像灰度膨胀。灰度膨胀就是求局部源图像与蒙版元素和的最大值的操作，运算符是“ $\text{[math]}$ ”，其定义如下：

$\text{[math]}$

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

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

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

该函数调用流程如下：

调用对应类型Init初始化HmppiMorphGrayPolicy结构体，否则主函数无法调用成功。
调用主函数。
最后调用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_GrayDilateBorder_8u_C1R(const uint8_t *src, int32_t srcStep, uint8_t *dst, int32_t dstStep, HmppiSize roiSize, HmppiBorderType borderType, HmppiMorphGrayPolicy_8u *policy);

HmppResult HMPPI_GrayDilateBorder_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 GrayDilateBorderExample()
{
    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] = {
        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(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_GrayDilateBorder_8u_C1R(src, srcStep, dst, dstStep, roiSize, borderType, policy);
    printf("HMPPI_GrayDilateBorder_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)
{
    GrayDilateBorderExample();
    return 0;
}

运行结果：

HMPPI_MorphGrayInit_8u_C1R result = 0
HMPPI_GrayDilateBorder_8u_C1R result = 0
result = 0
dst =
122 123  36  36   0   0   0   0
 44  45  46  46   0   0   0   0
 46  47  48  49   0   0   0   0
 47  47  48  49   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

父主题： 图像形态学功能