1# 更新日志 2 3## 1.9.3 （2023-06-28） 4 5该版本RGA驱动建议更新至1.2.27及以上版本，最低支持1.2.4。 6 7### 优化 8 9- 补充对samples目录下示例代码功能说明。 10- 增加RK_FORMAT_XX格式的描述。 11 12### 修复 13 14- 修复FBC输入对实宽、实高的过度约束。（驱动须更新至1.2.27） 15- 修复示例代码中部分笔误。 16 17 18 19## 1.9.2 （2023-04-13） 20 21该版本RGA驱动建议更新至1.2.25及以上版本，最低支持1.2.4。 22 23### 新增 24 25- 补全对FBC/TILE8×8 限制的检查。 26- 增加FBC/Tile8×8的示例代码。 27- 增加在不支持UV均值下采样的芯片上针对YUV422->YUV420场景下采样方法的示例代码。 28 29### 优化 30 31- 移除对libdrm.so的依赖，避免受libdrm版本影响导致编译失败。 32 33### 修复 34 35- 修复immakeBorder()配置top/bottom/left/right为0时输出画面异常。 36- 修复部分fill/color_palette模式无法返回release_fence fd的问题。 37 38 39 40## 1.9.1 （2023-02-06） 41 42该版本RGA驱动建议更新至1.2.24及以上版本，最低支持1.2.4。 43 44### 新增 45 46- 新增支持芯片RK3562。 47- 增加TILE8x8、FBC示例代码。 48 49### 优化 50 51- 编译阶段无需依赖libdrm.so。 52- 完善TILE8x8、FBC的参数限制。 53 54### 修复 55 56- 修复TILE8x8格式运行异常问题。（驱动须更新至1.2.24） 57- 修复 imcheckHeader() 在编译C程序时的报错。 58- 修复meson无法编译librga。 59 60 61 62## 1.9.0 （2022-12-20） 63 64该版本RGA驱动建议更新至1.2.22及以上版本，最低支持1.2.4。 65 66### 新增 67 68- 新增支持芯片RK3528。 69 70- 适配Android 12 gralloc 0.3 71- 新增头文件校验接口。 72- 新增批处理接口（im2d_task.h）。 73- 新增数组模式接口。 74- 新增padding接口。 75- 支持通过Android属性/环境变量动态的开启/关闭 librga 运行日志。 76- 增加对drm_fourcc格式支持。 77- 增加示例代码单独编译说明。 78- 增加多种常见场景示例代码。 79 - allocator_demo 80 - alpha_demo 81 - async_demo 82 - config_demo 83 - copy_demo 84 - crop_demo 85 - cvtcolor_demo 86 - fill_demo 87 - mosaic_demo 88 - resize_demo 89 - rop_demo 90 - transform_demo 91 - padding_demo 92 93### 优化 94 95- 兼容rga2 driver、multi_rga driver。 96- 优化librga与驱动之间版本校验机制。 97- 优化头文件结构。 98- 头文件添加更多描述信息。 99- 优化cmake编译脚本。 100 101### 修复 102 103- 修复RGA3 dst-over模式对YUV格式处理异常问题。 104 105 106 107## 1.8.1 （2022-06-20） 108 109### 修复 110 111- 更正wrapbuffer_handle宏函数与C++函数定义不同的问题，更正后与宏函数传参相同。。 112- 修复部分编译warning。 113 114 115 116## 1.8.0 （2022-05-25） 117 118该版本RGA驱动须更新至1.2.6。 119 120### 新增 121 122- 新增支持芯片RK3326S、RV1106、RV1103。 123- 增加英文说明文档。 124- 增加马赛克、OSD接口（部分芯片支持）。 125- 支持Rockit-ko在内核的调用。 126- 新增importbuffer接口支持使用buffer_size作为传参（RGA驱动1.2.9及以上版本支持）。 127- 增加默认编译静态库、动态库。 128 129### 优化 130 131- 针对部分接口的异常返回，增加更多的报错信息。 132 133### 修复 134 135- 更正文档中部分描述。 136- 修复部分格式无法importbuffer的问题。 137 138## 1.7.2 （2022-01-20） 139 140该版本RGA驱动须更新至1.2.6。 141 142### 新增 143 144- Android/Linux平台支持异步模式。 145- 支持多硬件约束条件融合校验。 146- 增加librga对驱动版本校验功能。 147- 支持查询RGA负载。 148- 针对外部buffer增加import/release接口。 149 150### 优化 151 152- 优化cmake编译脚本。 153- 异步模式支持查询指定任务完成情况。 154 155### 变更 156 157- C++接口实现与C实现隔离。 158- librga支持12及以前的Android版本。 159 160### 修复 161 162- 修复软件信号导致异常退出的问题。 163 164### 移除 165 166- 弃用genversion.sh 167 168## 1.6.0 (2021-11-23) 169 170### 新增 171 172- 支持RGA3硬件。 173- 增加任务核心指定、优先级配置。 174- 异步模式引入fence机制。 175- utils支持AFBC图像的读写。 176- 3588 RGA支持ROP功能。 177- CMAKE编译支持C接口。 178 179### 变更 180 181- 驱动支持变更为 multi_rga。 182- improcess增加传参：input_fence_fd、output_fence_fd、im_opt_t结构体。 183- imsync增加传参：release_fence_fd。 184- im2d_api 中 color/colorkey/nn/rop 模式将通过 im_opt_t 结构体进行配置。 185- Linux平台暂时不支持Async模式。 186- 头文件的数据类型与驱动重新对齐。（头文件存在修改） 187 188### 修复 189 190- 改正部分错误的格式命名。 191- 更正YUYV420的像素大小。 192- 修改宏函数内临时变量名称，避免非预期错误。 193 194## 1.4.0 （2021-11-10） 195 196### 新增 197 198- 支持Android 12编译。 199 200### 变更 201 202- RockchipRga接口demo目录变更： 203 204 librga/sample/ -> librga/sample/legacy/。 205 206## 1.3.1 （2021-11-05） 207 208### 新增 209 210- 支持ARGB4444/5551/8888、XRGB8888格式。（该功能有对应kernel提交） 211 212### 优化 213 214- 支持SDK通过CMAKE编译librga。 215 216### 修复 217 218- 修复部分已知问题。 219- 修复搭载RGA1的平台调用librga时出现内核报错的问题。 220- 解决BGR565、BGRA4444、BGRA5551格式转换颜色异常的问题。 221- 修复IM2D API中设置globalAlpha后导致混合效果异常的问题。 222- 修复部分crop场景imcheck无法正确校验的问题。 223- 解决rgaImDemo fill模式异常报错的问题。 224 225## 1.3.0 （2021-08-05） 226 227### 新增 228 229- 完善三通道模式src1通道参数校验。 230- 增加usage —— IM_ASYNC 231 232### 变更 233 234- 更正IM_SYNC语意，原语意为 “标识本次RGA操作需要同步” ，与同步模式存在歧义，修改如下： 235 236 传参 sync = 1 为同步模式， usage配置IM_SYNC； 237 238 传参 sync = 0 为异步模式， usage配置IM_ASYNC。 239 240### 修复 241 242- 解决三通道模式Alpha叠加场景中复合旋转显示异常的问题。 243 244## 1.2.6 （2021-08-02） 245 246### 新增 247 248- 支持BGR565、BGRA5551、BGRA4444格式。（该功能有对应kernel提交） 249 250### 优化 251 252- 优化部分内部逻辑。 253 254### 修复 255 256- 更正引用rga.h时可能会出现的编译报错。 257- 更正docs/RGA_API_Instruction.md中部分芯片型号的硬件支持信息。 258- 避免RockchipRga单例被异常销毁后可能引发的错误。 259 260### 移除 261 262- 部分功能中无用的日志打印。 263 264## 1.2.5 （2021-07-08） 265 266### 新增 267 268- docs/RGA_FAQ.md。 269- 三通道模式混合支持配置每条通道的CSC。 270 271### 变更 272 273- RGA硬件版本规则更改。 274- docs/README.md重命名为docs/RGA_API_Instruction.md。 275 276### 优化 277 278- RGA硬件版本信息管理。 279- RGA硬件功能校验。 280- 更加完善明了的报错信息。 281 282### 修复 283 284- IMStrError() 线程安全。 285- 修正RGA API开发指南中关于图像合成的错误描述。 286 287## 1.2.4 （2021-06-01） 288 289### 新增 290 291- 405（src over）/504（dst over）两种预乘Alpha的混合模式。 292- im2d api支持配置src/src1/dst图层自身的色域空间。 293 294## 1.2.3 （2021-05-31） 295 296### 新增 297 298- 支持full csc模式。 299 300### 变更 301 302- 更正debian版本号。 303 304## 1.2.2 （2021-04-26） 305 306### 新增 307 308- im2d api文档中增加版本号管理介绍。 309- src支持直接读取256阶灰度图，并对灰度图进行缩放、裁剪等功能。（该功能有对应kernel提交） 310 311### 修复 312 313- im2d api中CSC模式错误的定义。 314- 使用meson编译无法向下兼容的问题。 315 316### 移除 317 318- 一些无用打印。 319- 对于旋转模式不合理的校验。 320 321 322 323## 1.2.0 (2021-04-26) 324 325### 新增 326 327* im2d api支持ROP。 328* sample目录下增加示例图片。 329* 支持Gralloc4.0。 330* rgaImDemo的循环选项和打印预期选项。 331* color key功能。 332* color fill支持YUV格式。 333* 对RGA1的校验。 334* 多种方式查询librga版本号。 335* CHANGLOG.md。 336 337### 变更 338 339* 部分定义的索引值。 340* 更新im2d api说明文档。 341* 使用Apache-2.0 license。 342* imresize()使用系数进行缩放时使用向下对齐。 343* 取消全局初始化。 344* librga版本号的管理。 345 346### 优化 347 348* 整合不同版本Android平台源码。 349* 兼容Android、Linux平台。 350* C_API的易用性。 351* librga图像格式与Android平台图像格式兼容。 352* imStrError()内存使用上的风险。 353* 兼容两种同步/异步的配置方法。 354* rgaSlt demo中支持配置虚拟地址和fd。 355* rgaSlt demo返回报错值。 356* 获取硬件支持信息的逻辑。 357* imcheck()校验功能的可扩展性。 358* rotate功能与mirror功能可以同时配置。 359* nn_quantize功能与Alpha混合功能可以同时配置。 360 361### 修复 362 363* 修复一些已知错误。 364* 在一些旧版本的Android的编译问题。 365* C_API向下兼容问题。 366* YUV对齐width stride只支持4对齐问题。 367* A+B->C模式color space异常的问题。 368 369### 移除 370 371* 一些无效的定义。 372* 对libhardware的依赖。 373* makefile编译。 374* librga初始化的打印。 375* C_API对RGA模块的初始化。 376 377 378 379## 1.1.1 (2020-11-12) 380 381### 新增 382 383* color palette功能。 384* 支持A+B->C模式进行Alpha混合。 385* src、dst、dst over Alpha混合模式。 386* 输入格式YUYV422，输出格式YUYV422/420支。 387* 输出格式Y400、Y4、Y1。 388* wrapbuffer_handle api。 389* meson支持编译im2d demo。 390 391### 变更 392 393* license变更。 394 395### 优化 396 397* librga版本管理机制。 398* Android NDK编译。 399 400### 修复 401 402* 虚拟地址调用RGA结果输出黑线的问题（cache）。 403 404* 修复一些已知错误。 405 406 407 408## 1.0.3 (2020-09-18) 409 410### 新增 411 412* 在原本librga的代码基础上封装im2d api。 413* 增加meson、cmake的编译支持。 414 415### 变更 416 417* 修改C_API的实现逻辑。 418 419### 优化 420 421* 整合源代码，使Linux和Android共用同一套源码。 422 423 424 425## 1.0.0 （2020-06-03） 426 427### 新增 428 429* 移植librga到Android Q。 430