【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函数查询

使用说明

1. 在调用imcopy之前，需要先使用wrapbuffer_handle或类似函数将图像缓冲区包装成rga_buffer_t类型。
2. src和dst参数可以具有不同的分辨率和格式，imcopy会自动处理格式转换和缩放。
3. 当sync参数为1时，函数会等待操作完成后返回；为0时启用异步模式。
4. 在异步模式下，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。
• 本示例使用了虚拟地址方式。在实际应用中，可能需要根据具体情况选择适当的缓冲区分配和导入方法。