RKMEDIA--RGA的使用

本节主要介绍一下rkmedia rga模块的使用。

RGA (Raster Graphic Acceleration Unit)是一个独立的2D硬件加速器，可用于加速点/线绘制，执行图像缩放、旋转、bitBlt、alpha混合等常见的2D图形操作。

rkmedia的rga部分主要是封装的rk平台的硬件rga接口提供的api来实现的。rkmedia中RGA通道仅支持格式转换、缩放、裁剪、旋转功能，图片叠加则需要单独调用librga.so库
 

在 rv1126/rv1109 中支持的格式转换：
input: ARGB888/888/565/4444/5551, YUV420/YUV422， YUYV
output: ARGB888/888/565/4444/5551, YUV420/YUV422(8/10bit) ,YUYV， Y4,YUV400

在rv1126/rv1109上只有一个硬件rga，所以多路的rga实际上都是分时复用的。如果同时进行太多路的rga操作会导致帧率不够。

rga代码初始化：

以下的代码进行了分辨率的缩放、旋转、格式转换

  RGA_ATTR_S stRgaAttr;
  memset(&stRgaAttr, 0, sizeof(stRgaAttr));
  stRgaAttr.bEnBufPool = RK_TRUE;
  stRgaAttr.u16BufPoolCnt = 3;
  stRgaAttr.u16Rotaion = 90;
  stRgaAttr.stImgIn.u32X = 0;
  stRgaAttr.stImgIn.u32Y = 0;
  stRgaAttr.stImgIn.imgType = IMAGE_TYPE_NV12;
  stRgaAttr.stImgIn.u32Width = video_width;
  stRgaAttr.stImgIn.u32Height = video_height;
  stRgaAttr.stImgIn.u32HorStride = video_width;
  stRgaAttr.stImgIn.u32VirStride = video_height;
  stRgaAttr.stImgOut.u32X = 0;
  stRgaAttr.stImgOut.u32Y = 0;
  stRgaAttr.stImgOut.imgType = IMAGE_TYPE_RGB888;
  stRgaAttr.stImgOut.u32Width = disp_width;
  stRgaAttr.stImgOut.u32Height = disp_height;
  stRgaAttr.stImgOut.u32HorStride = disp_width;
  stRgaAttr.stImgOut.u32VirStride = disp_height;
  ret = RK_MPI_RGA_CreateChn(0, &stRgaAttr);
  if (ret) {
    printf("Create rga[0] falied! ret=%d\n", ret);
    return -1;
  }
裁剪缩放如下：

  RGA_ATTR_S stRgaAttr;
  memset(&stRgaAttr, 0, sizeof(stRgaAttr));
  stRgaAttr.bEnBufPool = RK_TRUE;
  stRgaAttr.u16BufPoolCnt = 3;
  stRgaAttr.u16Rotaion = 0;
  stRgaAttr.stImgIn.u32X = 0;                        //裁剪原始区域的起始位置
  stRgaAttr.stImgIn.u32Y = 0;
  stRgaAttr.stImgIn.imgType = IMAGE_TYPE_NV12;
  stRgaAttr.stImgIn.u32Width = 1280;                //要裁剪的宽高1280*720
  stRgaAttr.stImgIn.u32Height = 720;
  stRgaAttr.stImgIn.u32HorStride = 1920;            //输入进来原始分辨率1920*1080
  stRgaAttr.stImgIn.u32VirStride = 1080;
  stRgaAttr.stImgOut.u32X = 0;
  stRgaAttr.stImgOut.u32Y = 0;
  stRgaAttr.stImgOut.imgType = IMAGE_TYPE_RGB888;
  stRgaAttr.stImgOut.u32Width = 640;                //裁剪完缩放的分辨率640*480
  stRgaAttr.stImgOut.u32Height = 480;
  stRgaAttr.stImgOut.u32HorStride = 640;
  stRgaAttr.stImgOut.u32VirStride = 480;
  ret = RK_MPI_RGA_CreateChn(0, &stRgaAttr);
  if (ret) {
    printf("Create rga[0] falied! ret=%d\n", ret);
    return -1;
  }
上图的功能：把1920*1080的图像以左上角为起点裁剪出1280*720的图像，然后缩放成640*480图像。

比较复杂的就是这个部分的配置，对照着上图即可快速配置裁剪参数。

rga的rgn初始化：

static void set_argb8888_buffer(RK_U32 *buf, RK_U32 size, RK_U32 color) {
  for (RK_U32 i = 0; buf && (i < size); i++)
    *(buf + i) = color;
}
 
int osd_w = 720;
int osd_h = 1280;
BITMAP_S BitMap;
BitMap.enPixelFormat = PIXEL_FORMAT_ARGB_8888;
BitMap.u32Width = osd_w;
BitMap.u32Height = osd_h;
BitMap.pData = malloc(BitMap.u32Width * 4 * BitMap.u32Height);
int ColorBlockSize = BitMap.u32Height * BitMap.u32Width;
 
set_argb8888_buffer((RK_U32 *)BitMap.pData, ColorBlockSize,
                      TEST_ARGB32_RED);
 
OSD_REGION_INFO_S RngInfo;
RngInfo.enRegionId = REGION_ID_0;
RngInfo.u32PosX = 0;
RngInfo.u32PosY = 0;
RngInfo.u32Width = osd_w;
RngInfo.u32Height = osd_h;
RngInfo.u8Enable = 1;
RngInfo.u8Inverse = 0;
RK_MPI_RGA_RGN_SetBitMap(0, &RngInfo, &BitMap);
rga的rgn和venc的使用方式基本一样，同时也是支持8个region。宽高、坐标需要16字节对齐。

在叠加argb图片的时候，直接read文件把数据读到pData中，调用RK_MPI_RGA_RGN_SetBitMap即可。

注意：bmp图片和argb是不一样的，所以在用bmp的时候记得去掉bmp的头数据。

在使用rga的osd的时候，动态切换osd要注意data的释放以及申请（提前释放会导致闪屏）

rga不止画斜线功能，如要画斜线需要软件层实现。

rga查看使用率：cat /sys/kernel/debug/rkrga/load或者/proc/rkrga/load

rkmedia中vmix模块视频合成，实际也是用rga对多路视频进行拼接的。所以在大量使用rga时 要注意。

常见问题：

1、[RKMEDIA] [SYS] [Error]:FilterFlow:rkrga:buffer pool get null buffer!

出现这个打印主要是因为后端获取rga的数据慢了，导致rga没有空的buffer使用，所以可以适当调整rga 初始化时的u16BufPoolCnt  参数。或者及时将rga的数据取走。

暂时写这么多，如有问题可以在评论发出来。