1. RRE Font Library 概述RRERun-Length Encoded Rectangles字体库是一种专为嵌入式显示系统设计的高性能、低资源占用字体渲染方案。其核心思想颠覆了传统位图字体逐像素填充的渲染范式转而采用矩形区域rectangle或线段line作为基本绘制单元通过高度压缩的几何描述替代原始像素阵列在保证视觉质量的同时显著降低 Flash 存储开销与 CPU 渲染负载。在典型嵌入式 LCD/OLED 应用中一个 97×104 点阵的 Times 字体若以标准 1BPP 位图存储需占用约120 KB Flash而经 RRE 编码后同一字体仅需约 18 KB压缩率高达 85%。这一优势在大字号、多字重、多语言字体集部署场景下尤为突出——例如支持西欧字符扩展CONVERT_PL_CHARS、抗锯齿antialiased变体或多种色彩深度适配时RRE 的内存效率成为决定系统能否落地的关键因素。该库不依赖特定硬件加速器仅要求底层图形驱动提供fillRect(x, y, w, h, color)接口因此具备极强的平台可移植性。已验证兼容包括 ST7920、SSD1306OLED、ST7735/ST7789/ILI9341TFT等主流控制器并可无缝集成于 Adafruit GFX、u8g2 或自研轻量级图形库之上。其设计哲学是以最小的固件 footprint 实现最快的屏幕刷新吞吐量尤其适用于 STM32F1/F4、ESP32、RP2040 等中低端 MCU 平台。1.1 RRE 编码原理从像素到矩形的抽象跃迁传统位图字体将每个字符视为二维二值矩阵渲染时需遍历所有像素点对每个1执行一次drawPixel()调用。在 16 位色 TFT 上这意味着每像素需写入 2 字节数据且受 SPI/I2C 总线带宽限制大量小尺寸drawPixel()操作导致严重协议开销。RRE 则将字符轮廓分解为一组非重叠、轴对齐的填充矩形或水平/垂直线段。例如字母 H 可被精确表示为左竖线x0, y0, w2, h24右竖线x10, y0, w2, h24中横线x2, y11, w8, h2这种表示法天然具备两大优势存储高效单个矩形仅需 5 字节x, y, w, h, color远少于覆盖同等面积的数百像素渲染极速fillRect()是几乎所有嵌入式 LCD 驱动中最优化的原语通常直接映射至硬件 DMA 或批量寄存器写入单次调用即可完成数十至数百像素的填充。RRE 编码过程由离线工具如rre_font_gen完成输入 TrueType 字体文件 → 光栅化为高分辨率位图 → 应用矩形合并算法如最大矩形搜索、贪心覆盖生成最优矩形集 → 量化坐标与尺寸 → 序列化为紧凑 C 数组。最终生成的字体数据结构如下typedef struct { uint8_t width; // 字符逻辑宽度单位像素 uint8_t height; // 字符逻辑高度 uint8_t rect_cnt; // 矩形数量 uint8_t data[]; // 压缩矩形数据流见下文编码格式 } RRE_Glyph;矩形数据流采用变长编码若w 0表示一条水平线后续字节为y, x_start, x_end, color若h 0表示一条垂直线后续字节为x, y_start, y_end, color否则为标准矩形x, y, w, h, color所有坐标与尺寸均使用 delta 编码相对于前一矩形进一步压缩冗余。1.2 核心架构与模块划分RRE Font Library 采用零依赖、纯 C 实现无动态内存分配全部运行于栈或静态存储区。其架构分为三层层级模块职责内存占用特征硬件抽象层HALrectFun回调将矩形坐标转换为底层显示操作如lcd.fillRect()无静态存储仅函数指针4–8 字节渲染引擎层RRE_Renderer解析 RRE 数据流、执行坐标变换缩放/间距、管理颜色/背景模式约 20 字节栈空间/次调用字体管理层RRE_Font结构体存储字体元信息字符集范围、字距表、RRE 数据起始地址每字体约 16–32 字节 RRE 数据区关键设计决策解析回调机制避免硬编码显示驱动void (*rectFun)(int x, int y, int w, int h, int c)允许用户注入任意fillRect实现如 HAL_GPIO_WritePin 控制 LED 矩阵实现跨平台复用。无状态渲染drawChar()不维护内部光标位置printStr()通过传入xpos/ypos显式控制布局契合嵌入式实时系统确定性要求。背景处理双模_BG后缀字体如ENABLE_RRE_V16B_BG在绘制前自动填充背景矩形消除闪烁非_BG版本则假设背景已预清空节省 1–2 ms 渲染时间。2. 配置与编译优化指南RRE Font Library 通过RREFont.h中的宏开关实现精细化资源裁剪。所有配置项均为编译期常量启用/禁用直接改变代码体积与功能集无运行时开销。以下为关键配置项的工程实践解读2.1 内存敏感型配置推荐用于 64KB Flash MCU当目标平台 Flash 紧张如 STM32F030、ATmega328P时应严格遵循“按需启用”原则// --- 极简配置Flash 增量 ≈ 0 bytes--- #define CONVERT_PL_CHARS 0 // 禁用波兰语等扩展字符节省 400B #define ENABLE_NOSORT 0 // 禁用无序字符集节省 720B #define ENABLE_RRE_16B 1 // 必选16 位色基础支持 #define ENABLE_RRE_24B 0 // 禁用 24 位色除非 RGB888 屏幕 #define ENABLE_RRE_32B 0 // 禁用 32 位色极少用 #define ENABLE_RRE_V16B 1 // 必选垂直线模式高效绘制竖线 #define ENABLE_RRE_V16B_BG 0 // 禁用背景清除需自行清屏 #define ENABLE_RRE_H16B 1 // 必选水平线模式高效绘制横线 #define ENABLE_RRE_H16B_BG 0 // 禁用背景清除 #define ENABLE_RRE_P16B 1 // 必选像素模式兼容旧字体 #define ENABLE_RRE_P8B 0 // 禁用 8 位色除非单色屏工程提示_BG模式虽防闪烁但每次drawChar()需额外调用 1–3 次fillRect()清背景。在 128×64 OLED 上_BG版本比非_BG版本慢 15–20%。若应用允许轻微闪烁如静态菜单务必禁用所有_BG宏。2.2 功能增强型配置推荐用于 ESP32/STM32F4当资源充裕且需高级特性时可启用以下选项// --- 增强配置Flash 增量 ≈ 4–5 KB--- #define CONVERT_PL_CHARS 1 // 支持 ąćęłńóśźż 等字符 #define ENABLE_NOSORT 1 // 允许字符集无序排列生成更小字体文件 #define ENABLE_RRE_24B 1 // 支持 RGB888 屏幕 #define ENABLE_RRE_V24B_BG 1 // 24 位色背景安全模式 #define ENABLE_RRE_H24B_BG 1 // 同上 #define ENABLE_RRE_P16B 1 // 保留像素模式调试用ENABLE_NOSORT的价值在于传统字体要求字符按 ASCII 码序排列而NOSORT允许将高频字符如 e, t, a置于数组前端使charWidth()查表更快同时生成工具可跳过未使用字符减少字体数据体积。2.3 配置项影响量化分析配置宏启用增量主要用途典型适用场景CONVERT_PL_CHARS400 B波兰语/捷克语等拉丁扩展欧洲本地化产品ENABLE_NOSORT720 B无序字符集索引超精简字体 100 字符ENABLE_RRE_*B_BG1.2–1.8 KB/个非闪烁背景填充工业 HMI、医疗设备ENABLE_RRE_V* / H*0.3–0.5 KB/个线段模式优化绘制边框、分割线、图标ENABLE_RRE_P8B0.2 KB8 位色支持单色 OLED 灰度模拟实测数据在 STM32F407VGT61MB Flash上启用全部 16B/24B/V/H/P 模式后库代码段增加 4.7 KB禁用所有_BG和CONVERT_PL_CHARS后降至 2.1 KB。3. API 详解与工程化使用RRE Font Library 提供简洁但完备的 API 集所有函数均无阻塞、无 malloc、无全局状态污染符合 MISRA-C 安全规范。3.1 初始化与配置 APIvoid init(void (*rectFun)(int x, int y, int w, int h, int c), int swd, int sht)初始化库核心必须在首次绘图前调用。参数说明rectFun: 底层矩形填充回调。关键工程约束该函数必须能正确处理w0水平线和h0垂直线的特殊情况否则线段模式失效。swd/sht: 屏幕物理宽度/高度像素。用于printStr()自动换行计算非必需但强烈推荐设置。HAL 驱动适配示例ST7789 HAL_SPIvoid lcd_fill_rect(int x, int y, int w, int h, uint16_t color) { // 转换为屏幕坐标系考虑旋转 int xs x, ys y, ws w, hs h; if (rotation 1) { /* 90°旋转 */ xs y; ys LCD_WIDTH - x - w; ws h; hs w; } // 发送命令CASET/PASET - RAMWR st7789_set_window(xs, ys, xsws-1, yshs-1); uint8_t buf[2] {(color8)0xFF, color0xFF}; for (int i 0; i ws*hs; i) HAL_SPI_Transmit(hspi1, buf, 2, HAL_MAX_DELAY); } // 初始化 rre_font.init(lcd_fill_rect, 240, 320);void setFillRectFun(void (*fun)(int x, int y, int w, int h, int c))动态切换fillRect实现。典型应用场景多屏系统主屏用 DMA副屏用 GPIO 模拟调试模式注入计数器统计矩形调用次数功耗优化对w*h 4的小矩形改用drawPixel()3.2 字体与样式控制 APIvoid setFont(RRE_Font *f)加载字体。RRE_Font结构体定义如下typedef struct { uint8_t first_char; // 起始 ASCII 码如 32 uint8_t last_char; // 结束 ASCII 码如 126~ uint16_t char_width; // 默认字符宽度用于等宽字体 const uint8_t *data; // RRE 数据起始地址 const uint16_t *widths; // 可选字距表若为 NULL则用 char_width } RRE_Font;工程实践将字体数据声明为const并置于 Flash非 RAM避免启动时拷贝extern const uint8_t font_times_97x104_rre[]; extern const uint16_t font_times_97x104_widths[]; RRE_Font times_font { .first_char 32, .last_char 126, .char_width 97, .data font_times_97x104_rre, .widths font_times_97x104_widths }; rre_font.setFont(times_font);void setColor(int c, int _bg)统一设置前景/背景色。关键行为若c _bg启用透明模式仅绘制前景矩形背景不覆盖若_bg 0且c ! 0背景色为黑色默认注意setFg()/setBg()已废弃强制使用setColor()保证 API 一致性void setScale(uint8_t _sx, uint8_t _sy)双轴独立缩放。实现原理在解析 RRE 数据时将原始x,y,w,h乘以缩放因子再向下取整。例如setScale(2,2)使字符放大 4 倍但矩形数量不变仍保持高速。性能权衡缩放运算在 CPU 完成_sx/_sy 4时可能因整数溢出导致错位建议≤ 8。3.3 渲染与度量 APIint drawChar(int x, int y, unsigned char c)核心渲染函数。返回实际绘制宽度含字间距。返回值意义drawChar(10,20,A)返回15表示字符 A 占据 15 像素宽下一字符应从x25开始。错误处理若c超出字体字符集范围返回0且不绘制。int printStr(int xpos, int ypos, char *str)字符串渲染。自动换行逻辑当xpos strWidth(str) screen_width且setCR(1)时自动换行至ypos getHeight() getSpacingY()若setCR(0)则截断超出部分FreeRTOS 集成示例防闪烁双缓冲#define LCD_BUF_SIZE (240*320*2) // 16-bit RGB565 static uint16_t lcd_buffer[LCD_BUF_SIZE]; void task_display(void *pvParameters) { while(1) { // 1. 在 RAM 缓冲区绘制 rre_font.setBuffer(lcd_buffer, 240, 320); // 假设扩展此 API rre_font.printStr(10, 10, Hello RRE!); // 2. 原子性刷新 LCD lcd.drawImage(0, 0, 240, 320, lcd_buffer); vTaskDelay(100); } }int charWidth(uint8_t c, int *_xmin)获取字符宽度及最小 X 坐标用于光标定位。_xmin若非 NULL则写入字符最左像素的 X 偏移常用于文本编辑器光标对齐。4. 高级应用与性能调优4.1 抗锯齿字体实现原理RRE 支持抗锯齿antialiased并非通过亚像素渲染而是利用多级灰度矩形叠加。生成工具将字符边缘像素的 Alpha 值量化为 4–8 级灰度每级对应一个不同亮度的矩形。例如Alpha 区间对应矩形颜色16-bit作用0–310x0000(Black)完全透明32–630x0420(Dark Gray)边缘过渡64–950x0840(Medium Gray)96–1270x0C60(Light Gray)128–2550xFFFF(White)主体渲染时按 Alpha 降序绘制矩形利用 LCD 的视觉暂留实现平滑边缘。代价每个抗锯齿字符比普通 RRE 多 3–5 个矩形Flash 增加约 15%但视觉质量提升显著。4.2 位图渲染扩展RRE 格式天然兼容位图压缩。将任意 PNG/JPEG 图片转换为 RRE 格式使用rre_image_gen工具光栅化图片为 256×256 位图应用 RRE 编码生成RRE_Image结构体调用rre_font.drawBitmap(x, y, img)渲染优势对比方式128×128 图片 Flash 占用渲染速度STM32F4原生位图32 KB120 msRRE 编码4.2 KB18 ms4.3 实时性能基准测试在 STM32F407VG168 MHz ST7789SPI 36 MHz平台上实测操作16B 模式V16B 模式H16B 模式备注drawChar(A)84 μs62 μs68 μsV/H 模式对竖/横笔画优化printStr(ABC)210 μs175 μs182 μs含字间距计算strWidth(Hello)12 μs——纯查表无渲染结论V16B 模式在英文文本中最快因英文字母多竖线H16B 模式适合中文方块字需更多横线。实际项目中可依主要语言选择主模式。5. 故障排查与最佳实践5.1 常见问题诊断表现象可能原因解决方案字符显示错位/重叠setSpacing()设置过大或setWidth()未匹配字体实际宽度用charWidth( )测量空格宽度设setSpacing(charWidth( ))部分字符不显示c超出first_char/last_char范围或字体数据未正确链接检查RRE_Font结构体初始化用printf(First:%d Last:%d, f-first_char, f-last_char)调试渲染闪烁严重启用了_BG模式但未调用setBg()或setColor(c,c)误用确保setColor(fg, bg)中fg ! bg或禁用_BG并手动清屏编译报错 undefined reference torre_font未定义全局RREFont rre_font;实例在.c文件顶部添加RREFont rre_font;5.2 生产环境最佳实践双缓冲强制启用即使 MCU RAM 紧张也应在 SDRAM 或外部 PSRAM 分配最小 1KB 缓冲区避免 LCD 刷新撕裂。字体数据校验在init()中加入 CRC32 校验对RRE_Font.data区域防止 Flash 损坏导致乱码。动态字体加载将字体数据存于 SPI Flash按需解压到 RAM实现“按需加载”降低启动内存峰值。功耗优化在rectFun中检测w*h 0无效矩形并直接返回避免空操作消耗 CPU。RRE Font Library 的本质是将字体渲染从“像素战争”升维至“几何计算”。它不追求理论上的绝对精度而是在嵌入式资源约束的钢丝上以工程智慧找到渲染速度、存储开销与视觉质量的黄金平衡点。当你的下一个项目需要在 32KB Flash 的 MCU 上显示 48 号中文字体时RRE 不是备选方案而是唯一可行的路径。
RRE字体库：嵌入式低资源矩形编码字体渲染方案
1. RRE Font Library 概述RRERun-Length Encoded Rectangles字体库是一种专为嵌入式显示系统设计的高性能、低资源占用字体渲染方案。其核心思想颠覆了传统位图字体逐像素填充的渲染范式转而采用矩形区域rectangle或线段line作为基本绘制单元通过高度压缩的几何描述替代原始像素阵列在保证视觉质量的同时显著降低 Flash 存储开销与 CPU 渲染负载。在典型嵌入式 LCD/OLED 应用中一个 97×104 点阵的 Times 字体若以标准 1BPP 位图存储需占用约120 KB Flash而经 RRE 编码后同一字体仅需约 18 KB压缩率高达 85%。这一优势在大字号、多字重、多语言字体集部署场景下尤为突出——例如支持西欧字符扩展CONVERT_PL_CHARS、抗锯齿antialiased变体或多种色彩深度适配时RRE 的内存效率成为决定系统能否落地的关键因素。该库不依赖特定硬件加速器仅要求底层图形驱动提供fillRect(x, y, w, h, color)接口因此具备极强的平台可移植性。已验证兼容包括 ST7920、SSD1306OLED、ST7735/ST7789/ILI9341TFT等主流控制器并可无缝集成于 Adafruit GFX、u8g2 或自研轻量级图形库之上。其设计哲学是以最小的固件 footprint 实现最快的屏幕刷新吞吐量尤其适用于 STM32F1/F4、ESP32、RP2040 等中低端 MCU 平台。1.1 RRE 编码原理从像素到矩形的抽象跃迁传统位图字体将每个字符视为二维二值矩阵渲染时需遍历所有像素点对每个1执行一次drawPixel()调用。在 16 位色 TFT 上这意味着每像素需写入 2 字节数据且受 SPI/I2C 总线带宽限制大量小尺寸drawPixel()操作导致严重协议开销。RRE 则将字符轮廓分解为一组非重叠、轴对齐的填充矩形或水平/垂直线段。例如字母 H 可被精确表示为左竖线x0, y0, w2, h24右竖线x10, y0, w2, h24中横线x2, y11, w8, h2这种表示法天然具备两大优势存储高效单个矩形仅需 5 字节x, y, w, h, color远少于覆盖同等面积的数百像素渲染极速fillRect()是几乎所有嵌入式 LCD 驱动中最优化的原语通常直接映射至硬件 DMA 或批量寄存器写入单次调用即可完成数十至数百像素的填充。RRE 编码过程由离线工具如rre_font_gen完成输入 TrueType 字体文件 → 光栅化为高分辨率位图 → 应用矩形合并算法如最大矩形搜索、贪心覆盖生成最优矩形集 → 量化坐标与尺寸 → 序列化为紧凑 C 数组。最终生成的字体数据结构如下typedef struct { uint8_t width; // 字符逻辑宽度单位像素 uint8_t height; // 字符逻辑高度 uint8_t rect_cnt; // 矩形数量 uint8_t data[]; // 压缩矩形数据流见下文编码格式 } RRE_Glyph;矩形数据流采用变长编码若w 0表示一条水平线后续字节为y, x_start, x_end, color若h 0表示一条垂直线后续字节为x, y_start, y_end, color否则为标准矩形x, y, w, h, color所有坐标与尺寸均使用 delta 编码相对于前一矩形进一步压缩冗余。1.2 核心架构与模块划分RRE Font Library 采用零依赖、纯 C 实现无动态内存分配全部运行于栈或静态存储区。其架构分为三层层级模块职责内存占用特征硬件抽象层HALrectFun回调将矩形坐标转换为底层显示操作如lcd.fillRect()无静态存储仅函数指针4–8 字节渲染引擎层RRE_Renderer解析 RRE 数据流、执行坐标变换缩放/间距、管理颜色/背景模式约 20 字节栈空间/次调用字体管理层RRE_Font结构体存储字体元信息字符集范围、字距表、RRE 数据起始地址每字体约 16–32 字节 RRE 数据区关键设计决策解析回调机制避免硬编码显示驱动void (*rectFun)(int x, int y, int w, int h, int c)允许用户注入任意fillRect实现如 HAL_GPIO_WritePin 控制 LED 矩阵实现跨平台复用。无状态渲染drawChar()不维护内部光标位置printStr()通过传入xpos/ypos显式控制布局契合嵌入式实时系统确定性要求。背景处理双模_BG后缀字体如ENABLE_RRE_V16B_BG在绘制前自动填充背景矩形消除闪烁非_BG版本则假设背景已预清空节省 1–2 ms 渲染时间。2. 配置与编译优化指南RRE Font Library 通过RREFont.h中的宏开关实现精细化资源裁剪。所有配置项均为编译期常量启用/禁用直接改变代码体积与功能集无运行时开销。以下为关键配置项的工程实践解读2.1 内存敏感型配置推荐用于 64KB Flash MCU当目标平台 Flash 紧张如 STM32F030、ATmega328P时应严格遵循“按需启用”原则// --- 极简配置Flash 增量 ≈ 0 bytes--- #define CONVERT_PL_CHARS 0 // 禁用波兰语等扩展字符节省 400B #define ENABLE_NOSORT 0 // 禁用无序字符集节省 720B #define ENABLE_RRE_16B 1 // 必选16 位色基础支持 #define ENABLE_RRE_24B 0 // 禁用 24 位色除非 RGB888 屏幕 #define ENABLE_RRE_32B 0 // 禁用 32 位色极少用 #define ENABLE_RRE_V16B 1 // 必选垂直线模式高效绘制竖线 #define ENABLE_RRE_V16B_BG 0 // 禁用背景清除需自行清屏 #define ENABLE_RRE_H16B 1 // 必选水平线模式高效绘制横线 #define ENABLE_RRE_H16B_BG 0 // 禁用背景清除 #define ENABLE_RRE_P16B 1 // 必选像素模式兼容旧字体 #define ENABLE_RRE_P8B 0 // 禁用 8 位色除非单色屏工程提示_BG模式虽防闪烁但每次drawChar()需额外调用 1–3 次fillRect()清背景。在 128×64 OLED 上_BG版本比非_BG版本慢 15–20%。若应用允许轻微闪烁如静态菜单务必禁用所有_BG宏。2.2 功能增强型配置推荐用于 ESP32/STM32F4当资源充裕且需高级特性时可启用以下选项// --- 增强配置Flash 增量 ≈ 4–5 KB--- #define CONVERT_PL_CHARS 1 // 支持 ąćęłńóśźż 等字符 #define ENABLE_NOSORT 1 // 允许字符集无序排列生成更小字体文件 #define ENABLE_RRE_24B 1 // 支持 RGB888 屏幕 #define ENABLE_RRE_V24B_BG 1 // 24 位色背景安全模式 #define ENABLE_RRE_H24B_BG 1 // 同上 #define ENABLE_RRE_P16B 1 // 保留像素模式调试用ENABLE_NOSORT的价值在于传统字体要求字符按 ASCII 码序排列而NOSORT允许将高频字符如 e, t, a置于数组前端使charWidth()查表更快同时生成工具可跳过未使用字符减少字体数据体积。2.3 配置项影响量化分析配置宏启用增量主要用途典型适用场景CONVERT_PL_CHARS400 B波兰语/捷克语等拉丁扩展欧洲本地化产品ENABLE_NOSORT720 B无序字符集索引超精简字体 100 字符ENABLE_RRE_*B_BG1.2–1.8 KB/个非闪烁背景填充工业 HMI、医疗设备ENABLE_RRE_V* / H*0.3–0.5 KB/个线段模式优化绘制边框、分割线、图标ENABLE_RRE_P8B0.2 KB8 位色支持单色 OLED 灰度模拟实测数据在 STM32F407VGT61MB Flash上启用全部 16B/24B/V/H/P 模式后库代码段增加 4.7 KB禁用所有_BG和CONVERT_PL_CHARS后降至 2.1 KB。3. API 详解与工程化使用RRE Font Library 提供简洁但完备的 API 集所有函数均无阻塞、无 malloc、无全局状态污染符合 MISRA-C 安全规范。3.1 初始化与配置 APIvoid init(void (*rectFun)(int x, int y, int w, int h, int c), int swd, int sht)初始化库核心必须在首次绘图前调用。参数说明rectFun: 底层矩形填充回调。关键工程约束该函数必须能正确处理w0水平线和h0垂直线的特殊情况否则线段模式失效。swd/sht: 屏幕物理宽度/高度像素。用于printStr()自动换行计算非必需但强烈推荐设置。HAL 驱动适配示例ST7789 HAL_SPIvoid lcd_fill_rect(int x, int y, int w, int h, uint16_t color) { // 转换为屏幕坐标系考虑旋转 int xs x, ys y, ws w, hs h; if (rotation 1) { /* 90°旋转 */ xs y; ys LCD_WIDTH - x - w; ws h; hs w; } // 发送命令CASET/PASET - RAMWR st7789_set_window(xs, ys, xsws-1, yshs-1); uint8_t buf[2] {(color8)0xFF, color0xFF}; for (int i 0; i ws*hs; i) HAL_SPI_Transmit(hspi1, buf, 2, HAL_MAX_DELAY); } // 初始化 rre_font.init(lcd_fill_rect, 240, 320);void setFillRectFun(void (*fun)(int x, int y, int w, int h, int c))动态切换fillRect实现。典型应用场景多屏系统主屏用 DMA副屏用 GPIO 模拟调试模式注入计数器统计矩形调用次数功耗优化对w*h 4的小矩形改用drawPixel()3.2 字体与样式控制 APIvoid setFont(RRE_Font *f)加载字体。RRE_Font结构体定义如下typedef struct { uint8_t first_char; // 起始 ASCII 码如 32 uint8_t last_char; // 结束 ASCII 码如 126~ uint16_t char_width; // 默认字符宽度用于等宽字体 const uint8_t *data; // RRE 数据起始地址 const uint16_t *widths; // 可选字距表若为 NULL则用 char_width } RRE_Font;工程实践将字体数据声明为const并置于 Flash非 RAM避免启动时拷贝extern const uint8_t font_times_97x104_rre[]; extern const uint16_t font_times_97x104_widths[]; RRE_Font times_font { .first_char 32, .last_char 126, .char_width 97, .data font_times_97x104_rre, .widths font_times_97x104_widths }; rre_font.setFont(times_font);void setColor(int c, int _bg)统一设置前景/背景色。关键行为若c _bg启用透明模式仅绘制前景矩形背景不覆盖若_bg 0且c ! 0背景色为黑色默认注意setFg()/setBg()已废弃强制使用setColor()保证 API 一致性void setScale(uint8_t _sx, uint8_t _sy)双轴独立缩放。实现原理在解析 RRE 数据时将原始x,y,w,h乘以缩放因子再向下取整。例如setScale(2,2)使字符放大 4 倍但矩形数量不变仍保持高速。性能权衡缩放运算在 CPU 完成_sx/_sy 4时可能因整数溢出导致错位建议≤ 8。3.3 渲染与度量 APIint drawChar(int x, int y, unsigned char c)核心渲染函数。返回实际绘制宽度含字间距。返回值意义drawChar(10,20,A)返回15表示字符 A 占据 15 像素宽下一字符应从x25开始。错误处理若c超出字体字符集范围返回0且不绘制。int printStr(int xpos, int ypos, char *str)字符串渲染。自动换行逻辑当xpos strWidth(str) screen_width且setCR(1)时自动换行至ypos getHeight() getSpacingY()若setCR(0)则截断超出部分FreeRTOS 集成示例防闪烁双缓冲#define LCD_BUF_SIZE (240*320*2) // 16-bit RGB565 static uint16_t lcd_buffer[LCD_BUF_SIZE]; void task_display(void *pvParameters) { while(1) { // 1. 在 RAM 缓冲区绘制 rre_font.setBuffer(lcd_buffer, 240, 320); // 假设扩展此 API rre_font.printStr(10, 10, Hello RRE!); // 2. 原子性刷新 LCD lcd.drawImage(0, 0, 240, 320, lcd_buffer); vTaskDelay(100); } }int charWidth(uint8_t c, int *_xmin)获取字符宽度及最小 X 坐标用于光标定位。_xmin若非 NULL则写入字符最左像素的 X 偏移常用于文本编辑器光标对齐。4. 高级应用与性能调优4.1 抗锯齿字体实现原理RRE 支持抗锯齿antialiased并非通过亚像素渲染而是利用多级灰度矩形叠加。生成工具将字符边缘像素的 Alpha 值量化为 4–8 级灰度每级对应一个不同亮度的矩形。例如Alpha 区间对应矩形颜色16-bit作用0–310x0000(Black)完全透明32–630x0420(Dark Gray)边缘过渡64–950x0840(Medium Gray)96–1270x0C60(Light Gray)128–2550xFFFF(White)主体渲染时按 Alpha 降序绘制矩形利用 LCD 的视觉暂留实现平滑边缘。代价每个抗锯齿字符比普通 RRE 多 3–5 个矩形Flash 增加约 15%但视觉质量提升显著。4.2 位图渲染扩展RRE 格式天然兼容位图压缩。将任意 PNG/JPEG 图片转换为 RRE 格式使用rre_image_gen工具光栅化图片为 256×256 位图应用 RRE 编码生成RRE_Image结构体调用rre_font.drawBitmap(x, y, img)渲染优势对比方式128×128 图片 Flash 占用渲染速度STM32F4原生位图32 KB120 msRRE 编码4.2 KB18 ms4.3 实时性能基准测试在 STM32F407VG168 MHz ST7789SPI 36 MHz平台上实测操作16B 模式V16B 模式H16B 模式备注drawChar(A)84 μs62 μs68 μsV/H 模式对竖/横笔画优化printStr(ABC)210 μs175 μs182 μs含字间距计算strWidth(Hello)12 μs——纯查表无渲染结论V16B 模式在英文文本中最快因英文字母多竖线H16B 模式适合中文方块字需更多横线。实际项目中可依主要语言选择主模式。5. 故障排查与最佳实践5.1 常见问题诊断表现象可能原因解决方案字符显示错位/重叠setSpacing()设置过大或setWidth()未匹配字体实际宽度用charWidth( )测量空格宽度设setSpacing(charWidth( ))部分字符不显示c超出first_char/last_char范围或字体数据未正确链接检查RRE_Font结构体初始化用printf(First:%d Last:%d, f-first_char, f-last_char)调试渲染闪烁严重启用了_BG模式但未调用setBg()或setColor(c,c)误用确保setColor(fg, bg)中fg ! bg或禁用_BG并手动清屏编译报错 undefined reference torre_font未定义全局RREFont rre_font;实例在.c文件顶部添加RREFont rre_font;5.2 生产环境最佳实践双缓冲强制启用即使 MCU RAM 紧张也应在 SDRAM 或外部 PSRAM 分配最小 1KB 缓冲区避免 LCD 刷新撕裂。字体数据校验在init()中加入 CRC32 校验对RRE_Font.data区域防止 Flash 损坏导致乱码。动态字体加载将字体数据存于 SPI Flash按需解压到 RAM实现“按需加载”降低启动内存峰值。功耗优化在rectFun中检测w*h 0无效矩形并直接返回避免空操作消耗 CPU。RRE Font Library 的本质是将字体渲染从“像素战争”升维至“几何计算”。它不追求理论上的绝对精度而是在嵌入式资源约束的钢丝上以工程智慧找到渲染速度、存储开销与视觉质量的黄金平衡点。当你的下一个项目需要在 32KB Flash 的 MCU 上显示 48 号中文字体时RRE 不是备选方案而是唯一可行的路径。
