rkrga叠加字符时出现乱码或偏移，如何正确配置编码与坐标？

Question

在RK平台使用RGA进行OSD字符叠加时，常因编码格式与坐标配置不当导致乱码或位置偏移。典型原因有三：一是输入文本未统一转为UTF-8（RGA硬件仅支持UTF-8字节流，GB2312/GBK直接传入会解码错乱）；二是字体位图未按UTF-8码点正确索引，尤其中文需确保font atlas中Unicode码位映射准确；三是RGA Blit坐标以像素为单位，但若源图像stride、pitch未对齐（如非4字节对齐），或YUV/RGB色彩空间混用（如误将RGB字体图叠加到NV12帧），会导致采样偏移与色块错位。此外，RGA不支持自动换行与文本度量，需应用层预计算每字符宽高（依赖字体DPI与字号），并严格校验x/y起始坐标是否在目标buffer有效范围内。建议通过`rga_info_t`显式设置src_format/dst_format、clip_rect及alpha预乘模式，并用`adb shell dumpsys SurfaceFlinger`验证图层合成状态。

Answer 1

```html

一、现象层：OSD叠加乱码与偏移的典型表征

• 中文字符显示为方块、问号或完全不可读符号（如“”）
• 多字文本整体右移/下移数像素，且偏移量随字数线性增长
• 单个汉字局部撕裂（上半部正常、下半部错位），或出现垂直色带（尤其在NV12目标帧中）
• 部分字符渲染后边缘发虚、alpha通道异常透底，或背景色污染文字区域

二、根因层：三大硬性约束与隐式依赖解析

RK RGA是固定功能硬件单元，无软件解码逻辑，其行为严格受以下物理约束支配：

维度	约束条件	违反后果
编码格式	仅接收UTF-8字节流；不识别BOM，不兼容GB2312/GBK/Big5	多字节中文被截断为多个非法码元，触发font atlas索引越界
字体映射	font atlas必须按Unicode码点（非GB2312内码）组织；需支持U+4F60（你）、U+597D（好）等CJK统一汉字区	同形异码字（如“骨”U+9AA8 vs U+F931）映射错误，导致替换成其他字形
内存布局	src_stride/dst_stride必须≥width×bytes_per_pixel且4字节对齐；RGB与YUV格式不可混用	stride=127时RGA按128取行，造成每行首像素右移1字节，累积偏移显著

三、工程层：全链路调试与加固实践

1. 文本预处理：使用iconv或libiconv强制转换：iconv -f GBK -t UTF-8 input.txt > utf8.txt
2. 字体构建：用fontforge导出TrueType字体时勾选“Unicode BMP only”，生成含U+4E00–U+9FFF映射的PNG atlas
3. RGA参数显式化：在rga_info_t中强制指定：
   .src_format = RK_FORMAT_RGBA_8888, .dst_format = RK_FORMAT_YCbCr_420_SP,
.clip_rect = {.x = 0, .y = 0, .w = dst_w, .h = dst_h},
.alpha_rop_flag = 1 // 启用premultiplied alpha
4. 坐标校验：对每个字符执行：if (x + char_width > dst_w || y + char_height > dst_h) continue;

四、验证层：从寄存器到图层栈的交叉印证

采用分层验证法确认问题定位精度：

graph TD
  A[应用层] -->|传入UTF-8字节流| B(RGA驱动)
  B -->|dump rga_reg| C[寄存器快照]
  C --> D{src_format==dst_format?}
  D -->|否| E[立即报错-EINVAL]
  D -->|是| F[硬件Blit执行]
  F --> G[SurfaceFlinger合成]
  G --> H[adb shell dumpsys SurfaceFlinger | grep -A10 'Layer.*OSD']
  H --> I[确认Z-order、transform、visibleRegion]

五、进阶层：跨平台可移植性增强设计

• 封装osd_renderer_t结构体，内含UTF-8转码器句柄、font atlas元数据缓存、stride对齐计算器
• 实现osd_measure_text()：基于FreeType加载字体，查询FT_Face->units_per_EM与实际DPI，计算px/char
• 增加rga_safe_blit()包装函数：自动校验stride对齐、坐标边界、色彩空间兼容性，并返回详细error code
• 在Android.mk中添加LOCAL_CFLAGS += -DRK_RGA_DEBUG，启用RGA驱动级日志（需kernel配置CONFIG_ROCKCHIP_RGA_DEBUG=y）

六、避坑指南：高频反模式清单

1. ❌ 直接memcpy(gbk_str, rga_src_buf, len) —— 必须先转UTF-8
2. ❌ 使用Windows记事本保存的UTF-8文件（含BOM）—— RGA将BOM作为首字符渲染
3. ❌ 假设所有RGB字体图可直叠NV12—— 需预乘alpha并转换为YUV域或使用RGAB_8888+YUV混合模式
4. ❌ 用strlen()计算中文字符数—— UTF-8中一个汉字占3字节，应使用mbstowcs()或utf8proc库

```