bmcv_image_draw_point

该接口用于在图像上填充一个或者多个point。

处理器型号支持:

该接口仅支持BM1684X。

接口形式:
bm_status_t bmcv_image_draw_point(
        bm_handle_t   handle,
        bm_image      image,
        int           point_num,
        bmcv_point_t *coord,
        int           length,
        unsigned char r,
        unsigned char g,
        unsigned char b)

传入参数说明:

  • bm_handle_t handle

    输入参数。设备环境句柄,通过调用 bm_dev_request 获取。

  • bm_image image

    输入参数。需要在其上填充point的 bm_image 对象。

  • int point_num

    输入参数。需填充point的数量,指 coord 指针中所包含的 bmcv_point_t 对象个数。

  • bmcv_point_t* rect

    输入参数。point位置指针。具体内容参考下面的数据类型说明。

  • int length

    输入参数。point的边长,取值范围为[1, 510]。

  • unsigned char r

    输入参数。矩形填充颜色的r分量。

  • unsigned char g

    输入参数。矩形填充颜色的g分量。

  • unsigned char b

    输入参数。矩形填充颜色的b分量。

返回值说明:

  • BM_SUCCESS: 成功

  • 其他:失败

数据类型说明:

typedef struct {
    int x;
    int y;
} bmcv_point_t;
  • x 描述了 point 在原图中所在的起始横坐标。自左而右从 0 开始,取值范围 [0, width)。

  • y 描述了 point 在原图中所在的起始纵坐标。自上而下从 0 开始,取值范围 [0, height)。

注意事项:

  1. 该接口支持输入 bm_image 的图像格式为

num

input image_format

1

FORMAT_NV12

2

FORMAT_NV21

3

FORMAT_YUV420P

4

RGB_PLANAR

5

RGB_PACKED

6

BGR_PLANAR

7

BGR_PACKED

支持输入 bm_image 数据格式为

num

intput data_type

1

DATA_TYPE_EXT_1N_BYTE

如果不满足输入输出格式要求,则返回失败。

  1. 输入输出所有 bm_image 结构必须提前创建,否则返回失败。

  2. 所有输入point对象区域必须在图像以内。

  3. 当输入是FORMAT_YUV420P、FORMAT_NV12、FORMAT_NV21时,length必须为偶数。