# 如何修改 stb_truetype 获取字模时申请的缓冲区大小
stb_truetype 是一个用来解析 ttf 字体文件的开源库,功能强大,体积小巧。
在 AWTK 中,使用 AGGE 渲染模式时,默认采用 stb_truetype 解析 ttf 字体文件(实际上由宏 WITH_STB_FONT 决定)。
stb_truetype 在获取字模时,会 malloc 一块缓冲区保存字模位图中每行像素的变化信息,生成字模后,该缓冲区被释放,由于频繁申请释放内存容易产生内存碎片,因此,AWTK 默认设置该缓冲区大小约为 11 KB。
若由于内存不足 stb_truetype 获取字模失败,则会打印以下提示信息:
STBTT get glyph failed : Cannot allocate memory!
此时,用户可通过定义宏 STBTT_MAX_SCANLINE_EDGES 来设置缓冲区大小,该宏表示字模位图中每行像素的变化信息的最大数量,比如一个宽为 1000 像素的字模,如果它的某一行每个像素点都在变化,那么最大值则为 1000,此时可设置该宏为 1000,代码如下:
#define STBTT_MAX_SCANLINE_EDGES 1000 //缓冲区大小约为 1000 * 28 字节(约 27KB)
当设置宏 STBTT_MAX_SCANLINE_EDGES 为 0 时,stb_truetype 的缓冲区将动态扩张,但容易产生内存碎片,代码如下:
#define STBTT_MAX_SCANLINE_EDGES 0 //缓冲区将动态扩张