【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_8888

int 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。
• 本示例使用了虚拟地址方式。在实际应用中，可能需要根据具体情况选择适当的缓冲区分配和导入方法。