当前位置：首页 > news >正文

【Rockchip系列】官方函数：importbuffer_virtualaddr

news 来源：原创 2024/9/29 15:59:05

importbuffer_virtualaddr

对于需要RGA处理的外部内存，可以使用importbuffer_virtualaddr接口将缓冲区对应的虚拟地址信息导入到RGA驱动内部，并获取缓冲区相应的地址信息，方便后续稳定、快速地调用RGA完成工作。

函数原型

RGA提供了三个版本的 importbuffer_virtualaddr 函数：

IM_API rga_buffer_handle_t importbuffer_virtualaddr(void *va, int size);
IM_API rga_buffer_handle_t importbuffer_virtualaddr(void *va, int width, int height, int format);
IM_API rga_buffer_handle_t importbuffer_virtualaddr(void *va, im_handle_param_t *param);

参数说明

参数	描述
va	[必填] 指向缓冲区的虚拟地址指针
size	[必填] 缓冲区的大小（以字节为单位）
width	[必填] 图像宽度（以像素为单位）
height	[必填] 图像高度（以像素为单位）
format	[必填] 图像格式（例如 RK_FORMAT_RGBA_8888）
param	[必填] 指向 im_handle_param_t 结构体的指针，包含更多图像参数

返回值

返回 rga_buffer_handle_t 类型的句柄，用于描述导入的内存。如果导入失败，返回 0。

使用说明

第一个版本适用于只知道内存虚拟地址和大小的情况。
第二个版本适用于处理具有已知宽度、高度和格式的图像数据。
第三个版本提供最大的灵活性，允许通过 im_handle_param_t 结构体指定更多参数。

示例代码

#include <iostream>
#include "im2d.h"
#include "RgaUtils.h"int main() {int width = 1280;int height = 720;int format = RK_FORMAT_RGBA_8888;size_t size = width * height * get_bpp_from_format(format);// 分配内存void* buf = malloc(size);if (buf == nullptr) {std::cerr << "Failed to allocate buffer!" << std::endl;return -1;}// 使用第一个版本rga_buffer_handle_t handle1 = importbuffer_virtualaddr(buf, size);// 使用第二个版本rga_buffer_handle_t handle2 = importbuffer_virtualaddr(buf, width, height, format);// 使用第三个版本im_handle_param_t param;memset(&param, 0, sizeof(im_handle_param_t));param.width = width;param.height = height;param.format = format;rga_buffer_handle_t handle3 = importbuffer_virtualaddr(buf, &param);// 使用完毕后释放资源releasebuffer_handle(handle1);releasebuffer_handle(handle2);releasebuffer_handle(handle3);free(buf);return 0;
}