bm_image device memory 管理

bm_image 结构需要关联相关 device memory,并且 device memory 中有你所需要的数据时,才能够调用之后的 bmcv API。无论是调用 bm_image_alloc_dev_mem 内部申请,还是调用 bm_image_attach 关联外部内存,均能够使得 bm_image 对象关联 device memory。

判断 bm_image 对象是否已经关联了,可以调用以下 API:

bool bm_image_is_attached(
        bm_image image
);

传入参数说明:

  • bm_image image

输入参数。待判断的 bm_image 对象

返回值说明:

  1. 如果 bm_image 对象未创建,则返回 false;

  2. 该函数返回 bm_image 对象是否关联了一块 device memory,如果已关联,则返回 true,否则返回 false

注意事项:

  1. 一般情况而言,调用 bmcv api 要求输入 bm_image 对象关联 device memory,否则返回失败。而输出 bm_image 对象如果未关联 device memory,则会在在内部调用 bm_image_alloc_dev_mem 函数,内部申请内存。

  2. bm_image 调用 bm_image_alloc_dev_mem 所申请的内存都由内部自动管理,在调用 bm_image_destroy、 bm_image_detach 或者 bm_image_attach 其他 device memory 时自动释放,无需调用者管理。相反,如果 bm_image_attach 一块 device memory 时,表示这块 memory 将由调用者自己管理。无论是 bm_image_destroy、bm_image_detach,或者再调用 bm_image_attach 其他 device memory,均不会释放,需要调用者手动释放。

  3. 目前 device memory 分为三块内存空间:heap0、heap1和heap2,三者的区别在于芯片的硬件 VPP 模块是否有读取权限,其他完全相同,因此如果某一 API 需要指定使用硬件VPP模块来实现,则必须保证该 API 的输入 bm_image 保存在 heap1 或者 heap2 空间上。

heap id

VPP 是否可读

heap0

heap1

heap2