• 中文
  • 3.0.31

    • Dilate

    扩张（膨胀）算法使用提供的 2D 布尔核对输入图像执行二维滤波操作，布尔的核大小定义了滤波操作的像素邻域。 作为一种形态学操作算子，相当于最大化操作，会增加或扩大图片中的前景区域（在本例中为下图中的白色），识别并填充图片中的孔洞。

    算子效果

    输入图像参数输出图像
    image-image

    原理

    dst(x,y)=max⁡0⩽i<kwidth0⩽j<kheightsrc(x−⌊kwidth2⌋+i,y−⌊kheight2⌋+j)\begin{aligned}dst(x,y)=\max_{\begin{aligned} 0 \leqslant i<kwidth \\ 0 \leqslant j < kheight\end{aligned}} src(x-\lfloor\frac{kwidth}{2}\rfloor+i,y-\lfloor\frac{kheight}{2}\rfloor+j)\end{aligned}

    形态学操作是一组图像处理操作，它根据图像的形状来处理数字图像。扩张过滤器相当于最大操作，会扩展图像中的明亮结构。 另一个形态滤波器是Erode，相当于最小化操作。可以在扩张滤波器之后使用腐蚀滤波器来构成图像的形态闭合。

    API接口

    int32_t hbVPDilate(hbUCPTaskHandle_t *taskHandle,
                   hbVPImage *dstImg,
                   hbVPImage const *srcImg,
                   hbVPFilterKernel const *dilateKernel,
                   hbVPDilateParam const *dilateParam);

    详细接口信息请查看 hbVPDilate 。

    使用方法

    // Include the header
#include "hobot/hb_ucp.h"
#include "hobot/vp/hb_vp.h"
#include "hobot/vp/hb_vp_dilate.h"

// init Image, allocate memory for image data
hbUCPSysMem src_mem;
hbUCPMallocCached(&src_mem, src_stride * src_height, 0);
hbVPImage src_img{HB_VP_IMAGE_FORMAT_Y,
                  HB_VP_IMAGE_TYPE_U8C1,
                  src_width,
                  src_height,
                  src_stride,
                  src_mem.virAddr,
                  src_mem.phyAddr,
                  nullptr,
                  0,
                  0};

hbUCPSysMem dst_mem;
hbUCPMallocCached(&dst_mem, dst_stride * dst_height, 0);
hbVPImage dst_img{HB_VP_IMAGE_FORMAT_Y,
                  HB_VP_IMAGE_TYPE_U8C1,
                  dst_width,
                  dst_height,
                  dst_stride,
                  dst_mem.virAddr,
                  dst_mem.phyAddr,
                  nullptr,
                  0,
                  0};

// init kernel
hbVPFilterKernel kernel;
kernel.dataType = HB_VP_IMAGE_TYPE_U8C1;
kernel.width = 3;
kernel.height = 3;
hbUCPSysMem kernel_mem;
hbUCPMallocCached(&kernel_mem, kernel.width * kernel.height, 0);
kernel.dataPhyAddr = kernel_mem.phyAddr;
kernel.dataVirAddr = kernel_mem.virAddr;

// init param
hbVPDilateParam dilate_param;
dilate_param.pointLocX = -1;
dilate_param.pointLocY = -1;
dilate_param.iterations = 1;
dilate_param.borderType = HB_VP_BORDER_CONSTANT;
dilate_param.borderValue = 0;

// init task handle and schedule param
hbUCPTaskHandle_t task_handle{nullptr};
hbUCPSchedParam sched_param;
HB_UCP_INITIALIZE_SCHED_PARAM(&sched_param);
sched_param.backend = HB_UCP_DSP_CORE_0;

// create task
hbVPDilate(&task_handle, &dst_img, &src_img, &kernel, &dilate_param);

// submit task
hbUCPSubmitTask(task_handle, &sched_param);

// wait for task done 
hbUCPWaitTaskDone(task_handle, 0);

// release task handle
hbUCPReleaseTask(task_handle);

// release memory
hbUCPFree(&src_mem);
hbUCPFree(&dst_mem);
hbUCPFree(&kernel_mem);