bmcv_image_copy_to

该接口实现将一幅图像拷贝到目的图像的对应内存区域。

处理器型号支持：

该接口支持BM1684/BM1684X。

接口形式：

bm_status_t bmcv_image_copy_to(
        bm_handle_t handle,
        bmcv_copy_to_atrr_t copy_to_attr,
        bm_image            input,
        bm_image            output
);

参数说明：

bm_handle_t handle

输入参数。bm_handle 句柄。
bmcv_copy_to_atrr_t copy_to_attr

输入参数。api 所对应的属性配置。
bm_image input

输入参数。输入 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 output

输出参数。输出 bm_image，bm_image 需要外部调用 bmcv_image_create 创建。image 内存可以通过 bm_image_alloc_dev_mem 来开辟新的内存，或者使用 bmcv_image_attach 来 attach 已有的内存。如果不主动分配将在 api 内部进行自行分配。

返回值说明：

BM_SUCCESS: 成功
其他:失败

数据类型说明：

typedef struct bmcv_copy_to_atrr_s {
    int           start_x;
    int           start_y;
    unsigned char padding_r;
    unsigned char padding_g;
    unsigned char padding_b;
    int if_padding;
} bmcv_copy_to_atrr_t;

padding_b 表示当 input 的图像要小于输出图像的情况下，多出来的图像 b 通道上被填充的值。
padding_r 表示当 input 的图像要小于输出图像的情况下，多出来的图像 r 通道上被填充的值。
padding_g 表示当 input 的图像要小于输出图像的情况下，多出来的图像 g 通道上被填充的值。
start_x 描述了 copy_to 拷贝到输出图像所在的起始横坐标。
start_y 描述了 copy_to 拷贝到输出图像所在的起始纵坐标。
if_padding 表示当 input 的图像要小于输出图像的情况下，是否需要对多余的图像区域填充特定颜色，0表示不需要，1表示需要。当该值填0时，padding_r，padding_g，padding_b 的设置将无效

格式支持：

bm1684支持以下 image_format 和 data_type 的组合：

num	image_format	data_type
1	FORMAT_BGR_PACKED	DATA_TYPE_EXT_FLOAT32
2	FORMAT_BGR_PLANAR	DATA_TYPE_EXT_FLOAT32
3	FORMAT_BGR_PACKED	DATA_TYPE_EXT_1N_BYTE
4	FORMAT_BGR_PLANAR	DATA_TYPE_EXT_1N_BYTE
5	FORMAT_BGR_PLANAR	DATA_TYPE_EXT_4N_BYTE
7	FORMAT_RGB_PACKED	DATA_TYPE_EXT_FLOAT32
8	FORMAT_RGB_PLANAR	DATA_TYPE_EXT_FLOAT32
9	FORMAT_RGB_PACKED	DATA_TYPE_EXT_1N_BYTE
10	FORMAT_RGB_PLANAR	DATA_TYPE_EXT_1N_BYTE
11	FORMAT_RGB_PLANAR	DATA_TYPE_EXT_4N_BYTE
12	FORMAT_GRAY	DATA_TYPE_EXT_1N_BYTE

bm1684x支持以下数据输入、输出类型：

num	input data type	output data type
1	DATA_TYPE_EXT_1N_BYTE	DATA_TYPE_EXT_FLOAT32
2		DATA_TYPE_EXT_1N_BYTE
3		DATA_TYPE_EXT_1N_BYTE_SIGNED
4		DATA_TYPE_EXT_FP16
5		DATA_TYPE_EXT_BF16
6	DATA_TYPE_EXT_FLOAT32	DATA_TYPE_EXT_FLOAT32

输入和输出支持的色彩格式为：

num	image_format
1	FORMAT_YUV420P
2	FORMAT_YUV444P
3	FORMAT_NV12
4	FORMAT_NV21
5	FORMAT_RGB_PLANAR
6	FORMAT_BGR_PLANAR
7	FORMAT_RGB_PACKED
8	FORMAT_BGR_PACKED
9	FORMAT_RGBP_SEPARATE
10	FORMAT_BGRP_SEPARATE
11	FORMAT_GRAY

注意事项：

1、在调用 bmcv_image_copy_to()之前必须确保输入的 image 内存已经申请。

2、bm1684中的input output 的 data_type，image_format 必须相同。

3、为了避免内存越界，输入图像width + start_x 必须小于等于输出图像width stride。

代码示例：

int channel   = 3;
int in_w      = 400;
int in_h      = 400;
int out_w     = 800;
int out_h     = 800;
int    dev_id = 0;
bm_handle_t handle;
bm_status_t dev_ret = bm_dev_request(&handle, dev_id);
std::shared_ptr<unsigned char> src_ptr(
        new unsigned char[channel * in_w * in_h],
        std::default_delete<unsigned char[]>());
std::shared_ptr<unsigned char> res_ptr(
        new unsigned char[channel * out_w * out_h],
        std::default_delete<unsigned char[]>());
unsigned char * src_data = src_ptr.get();
unsigned char * res_data = res_ptr.get();
for (int i = 0; i < channel * in_w * in_h; i++) {
    src_data[i] = rand() % 255;
}
// calculate res
bmcv_copy_to_atrr_t copy_to_attr;
copy_to_attr.start_x   = 0;
copy_to_attr.start_y   = 0;
copy_to_attr.padding_r = 0;
copy_to_attr.padding_g = 0;
copy_to_attr.padding_b = 0;
bm_image input, output;
bm_image_create(handle,
        in_h,
        in_w,
        FORMAT_RGB_PLANAR,
        DATA_TYPE_EXT_1N_BYTE,
        &input);
bm_image_alloc_dev_mem(input);
bm_image_copy_host_to_device(input, (void **)&src_data);
bm_image_create(handle,
        out_h,
        out_w,
        FORMAT_RGB_PLANAR,
        DATA_TYPE_EXT_1N_BYTE,
        &output);
bm_image_alloc_dev_mem(output);
if (BM_SUCCESS != bmcv_image_copy_to(handle, copy_to_attr, input, output)) {
    std::cout << "bmcv_copy_to error !!!" << std::endl;
    bm_image_destroy(input);
    bm_image_destroy(output);
    bm_dev_free(handle);

    exit(-1);
}
bm_image_copy_device_to_host(output, (void **)&res_data);
bm_image_destroy(input);
bm_image_destroy(output);
bm_dev_free(handle)