【Rockchip系列】官方函数：imcopy
imcopy
函数原型
IM_STATUS imcopy(const rga_buffer_t src,rga_buffer_t dst,int sync = 1,int *release_fence_fd = NULL);
功能说明
imcopy函数用于执行单次快速图像拷贝操作，将图像从源缓冲区拷贝到目标缓冲区。
参数说明
| 参数 | 描述 |
|---|---|
| src | [必填] 源图像缓冲区，rga_buffer_t类型 |
| dst | [必填] 目标图像缓冲区，rga_buffer_t类型 |
| sync | [可选] 同步模式标志，默认为1（同步模式） |
| release_fence_fd | [可选] 用于异步模式的释放栅栏文件描述符 |
返回值
返回IM_STATUS类型的状态码：
- IM_STATUS_SUCCESS：操作成功
- 负值：表示操作失败，错误码的具体含义可以通过imStrError函数查询
使用说明
- 在调用imcopy之前，需要先使用wrapbuffer_handle或类似函数将图像缓冲区包装成rga_buffer_t类型。
- src和dst参数可以具有不同的分辨率和格式，imcopy会自动处理格式转换和缩放。
- 当sync参数为1时，函数会等待操作完成后返回；为0时启用异步模式。
- 在异步模式下，release_fence_fd可用作imsync函数的参数来等待操作完成。
示例代码
#include <iostream>
#include <cstring>
#include "im2d.h"
#include "RgaUtils.h"#define WIDTH 1280
#define HEIGHT 720
#define FORMAT RK_FORMAT_RGBA_8888int main() {int ret;rga_buffer_t src, dst;char *src_buf, *dst_buf;int buf_size = WIDTH * HEIGHT * get_bpp_from_format(FORMAT);// 分配内存src_buf = (char *)malloc(buf_size);dst_buf = (char *)malloc(buf_size);if (!src_buf || !dst_buf) {std::cerr << "Failed to allocate memory" << std::endl;return -1;}// 初始化源缓冲区（例如，设置为红色）memset(src_buf, 0, buf_size);for (int i = 0; i < buf_size; i += 4) {src_buf[i] = 255; // Red channel}// 清空目标缓冲区memset(dst_buf, 0, buf_size);// 包装缓冲区src = wrapbuffer_virtualaddr(src_buf, WIDTH, HEIGHT, FORMAT);dst = wrapbuffer_virtualaddr(dst_buf, WIDTH, HEIGHT, FORMAT);// 执行拷贝ret = imcopy(src, dst);if (ret == IM_STATUS_SUCCESS) {std::cout << "Image copy succeeded" << std::endl;// 验证拷贝结果if (memcmp(src_buf, dst_buf, buf_size) == 0) {std::cout << "Verification passed: src and dst buffers are identical" << std::endl;} else {std::cout << "Verification failed: src and dst buffers differ" << std::endl;}} else {std::cerr << "Image copy failed: " << imStrError((IM_STATUS)ret) << std::endl;}// 释放内存free(src_buf);free(dst_buf);return 0;
}
注意事项
- 确保src和dst缓冲区已正确初始化并包含有效数据。
- 如果src和dst的格式或分辨率不同，imcopy会自动进行必要的转换。
- 在多线程环境中使用时，需要注意同步问题，特别是在使用异步模式时。
- 使用异步模式时，需要正确处理release_fence_fd以避免资源泄漏。
- imcopy函数适用于简单的图像拷贝任务，对于需要更复杂处理的场景，可能需要使用其他IM2D API。
- 本示例使用了虚拟地址方式。在实际应用中，可能需要根据具体情况选择适当的缓冲区分配和导入方法。