RK3588s RGA库使用

RK3588s RGA库使用

一、 RGA库简介

ISP输出的图像在像素、格式是固定的，有时无法满足后端算法的要求，这时需要对图像进行裁剪、缩放或格式转换等二次处理。RGA (Raster Graphic Acceleration Unit)官方提供的独立的2D硬件加速器，可用于加速点/线绘制、执行图像缩放、旋转、格式转换等常见的2D图形操作，且其不占用CPU计算资源，因此可用于图像的二次处理。
RGA模块支持库为librga.so，通过对图像缓冲区结构体struct rga_info进行配置，实现相应的2D图形操作。为了获得更友好的开发体验，在此基础上进一步封装常用的2D图像操作接口RAG_API。RAG_API包含以下特点：
1、接口参考opencv/matlab中常用的2D图形接口定义，以减少二次开发的学习成本。
2、为消除RGA硬件版本差异带来的兼容问题，加入RGA query查询功能。查询内容主要包括版本信息，输入输出大分辨率及图像格式的支持。
3、对于2D图像复合操作，增加improcess接口。通过传入一系列预定义的usage执行复合操作。
4、执行图像操作之前，需要对输入输出图像缓冲区进行处理。调用wrapbuffer_T接口将输入输出图像信息填充到结构体struct rga_buffer_t，结构体中包含分辨率及图像格式等信息。

二、RGA库调用

在调用RGA时，程序需要包含头文件和库文件两部分，具体如下：
1、头文件引用：
调用librga：include/RockchipRga.h
调用im2d api：im2d_api/im2d.hpp
2、库文件：librga.so

具体实现流程如下图：

在实际应用中，RAG_API包含以下函数：

• querystring： 查询获取当前芯片平台RGA硬件版本与功能支持信息，以字符串的形式返回。
• importbuffer_T： 将外部buffer导入RGA驱动内部，实现硬件快速访问非连续物理地址（dma_fd、虚拟地址）。
• releasebuffer_handle： 将外部buffer从RGA驱动内部解除引用与映射。
• wrapbuffer_handle速封装图像缓冲区结构（rga_buffer_t）。
• imcopy： 调用RGA实现快速图像拷贝操作。
• imresize： 调用RGA实现快速图像缩放操作。
• impyramind： 调用RGA实现快速图像金字塔操作。
• imcrop： 调用RGA实现快速图像裁剪操作。
• imrotate： 调用RGA实现快速图像旋转操作。
• imflip： 调用RGA实现快速图像翻转操作。
• imfill： 调用RGA实现快速图像填充操作。
• imtranslate： 调用RGA实现快速图像平移操作。
• imblend： 调用RGA实现双通道快速图像合成操作。
• imcomposite： 调用RGA实现三通道快速图像合成操作。
• imcolorkey： 调用RGA实现快速图像颜色键操作。
• imcvtcolor： 调用RGA实现快速图像格式转换。
• imquantize： 调用RGA实现快速图像运算点前处理（量化）操作。
• imrop： 调用RGA实现快速图像光栅操作。
• improcess： 调用RGA实现快速图像复合处理操作。
• imcheck： 校验参数是否合法，以及当前硬件是否支持该操作。
• imsync： 用于异步模式时，同步任务完成状态。
• imconfig： 向当前线程上下文添加默认配置。

三、颜色空间转换示例

以下是我写的一段示例代码-原始图像数据输出的是YUV格式，用RGA库从YUV转为RGB，用htop命令显示每秒30帧速处理，3588单核cpu只占30%左右。

参考：
1、RGA官方开发指南：Rockchip_Developer_Guide_RGA_CN.pdf
2、官方FAQ：Rockchip_FAQ_RGA_CN.pdf
3、sdk中示例程序： linux_librga