bmcv_image_morph
可以实现对图像的基本形态学运算,包括膨胀(Dilation)和腐蚀(Erosion)。
用户可以分为以下两步使用该功能:
获取 Kernel 的 Device Memory
可以在初始化时使用以下接口获取存储 Kernel 的 Device Memory,当然用户也可以自定义 Kernel 直接忽略该步骤。
函数通过传入所需 Kernel 的大小和形状,返回对应的 Device Memory 给后面的形态学运算接口使用,用户应用程序的最后需要用户手动释放该空间。
处理器型号支持:
该接口仅支持BM1684。
接口形式:
typedef enum { BM_MORPH_RECT, BM_MORPH_CROSS, BM_MORPH_ELLIPSE } bmcv_morph_shape_t; bm_device_mem_t bmcv_get_structuring_element( bm_handle_t handle, bmcv_morph_shape_t shape, int kw, int kh );
参数说明:
bm_handle_t handle
输入参数。 bm_handle 句柄。
bmcv_morph_shape_t shape
输入参数。表示 Kernel 的形状,目前支持矩形、十字、椭圆。
int kw
输入参数。Kernel 的宽度。
int kh
输入参数。Kernel 的高度。
返回值说明:
返回 Kernel 对应的 Device Memory 空间。
形态学运算
目前支持腐蚀和膨胀操作,用户也可以通过这两个基本操作的组合实现以下功能:
开运算(Opening)
闭运算(Closing)
形态梯度(Morphological Gradient)
顶帽(Top Hat)
黑帽(Black Hat)
接口形式:
bm_status_t bmcv_image_erode( bm_handle_t handle, bm_image src, bm_image dst, int kw, int kh, bm_device_mem_t kmem ); bm_status_t bmcv_image_dilate( bm_handle_t handle, bm_image src, bm_image dst, int kw, int kh, bm_device_mem_t kmem );
参数说明:
bm_handle_t handle
输入参数。 bm_handle 句柄。
bm_image src
输入参数。需处理图像的 bm_image,bm_image 需要外部调用 bmcv_image_create 创建。image 内存可以使用 bm_image_alloc_dev_mem 或者 bm_image_copy_host_to_device 来开辟新的内存,或者使用 bmcv_image_attach 来 attach 已有的内存。
bm_image dst
输出参数。处理后图像的 bm_image,bm_image 需要外部调用 bmcv_image_create 创建。image 内存可以使用 bm_image_alloc_dev_mem 或者 bm_image_copy_host_to_device 来开辟新的内存,或者使用 bmcv_image_attach 来 attach 已有的内存,如用户不申请内部会自动申请。
int kw
输入参数。Kernel 的宽度。
int kh
输入参数。Kernel 的高度。
bm_device_mem_t kmem
输入参数。存储 Kernel 的 Device Memory 空间,可以通过接口bmcv_get_structuring_element获取,用户也可以自定义,其中值为1表示选中该像素,值为0表示忽略该像素。
返回值说明:
BM_SUCCESS: 成功
其他:失败
格式支持:
该接口目前支持以下 image_format:
num |
image_format |
---|---|
1 |
FORMAT_GRAY |
2 |
FORMAT_RGB_PLANAR |
3 |
FORMAT_BGR_PLANAR |
4 |
FORMAT_RGB_PACKED |
5 |
FORMAT_BGR_PACKED |
目前支持以下 data_type:
num |
data_type |
---|---|
1 |
DATA_TYPE_EXT_1N_BYTE |
代码示例:
int channel = 1; int width = 1920; int height = 1080; int kw = 3; int kh = 3; int dev_id = 0; bmcv_morph_shape_t shape = BM_MORPH_RECT; bm_handle_t handle; bm_status_t dev_ret = bm_dev_request(&handle, dev_id); bm_device_mem_t kmem = bmcv_get_structuring_element( handle, shape, kw, kh); std::shared_ptr<unsigned char> data_ptr( new unsigned char[channel * width * height], std::default_delete<unsigned char[]>()); for (int i = 0; i < channel * width * height; i++) { data_ptr.get()[i] = rand() % 255; } // calculate res bm_image src, dst; bm_image_create(handle, height, width, FORMAT_GRAY, DATA_TYPE_EXT_1N_BYTE, &src); bm_image_create(handle, height, width, FORMAT_GRAY, DATA_TYPE_EXT_1N_BYTE, &dst); bm_image_alloc_dev_mem(src); bm_image_alloc_dev_mem(dst); bm_image_copy_host_to_device(src, (void **)&(data_ptr.get())); if (BM_SUCCESS != bmcv_image_erode(handle, src, dst, kw, kh, kmem)) { std::cout << "bmcv erode error !!!" << std::endl; bm_image_destroy(src); bm_image_destroy(dst); bm_free_device(handle, kmem); bm_dev_free(handle); return; } bm_image_copy_device_to_host(dst, (void **)&(data_ptr.get())); bm_image_destroy(src); bm_image_destroy(dst); bm_free_device(handle, kmem); bm_dev_free(handle);