bmcv_image_draw_point
=========================

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


**处理器型号支持：**

该接口仅支持BM1684X。


**接口形式：**
    .. code-block:: c

        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: 成功

* 其他:失败


**数据类型说明：**


    .. code-block:: c

        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         |
+-----+-------------------------------+

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

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

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

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