# 1 前言
这段时间的工作需要研究stb_truetype库，因此本篇文章记录一下该库的基本用法。stb_truetype是一个常见字体加载库, 只有一个头文件, 功能虽没有 FreeType 库强大，但代码量小很多，在Flash非常小的开发板上也可以用，觉得 FreeType 库太大的，可以考虑使用stb_truetype库。
备注：stb库的GitHub仓库：https://github.com/nothings/stb (opens new window)。
# 2 stb_truetype解析ttf字体
使用stb_truetype库解析ttf字体的步骤通常如下：
- 加载并初始化ttf字体文件；
- 设置字体大小（字号）并计算缩放比例；
- 获取垂直方向上的度量并根据缩放比例调整，比如字高、行间距等；
- 获取水平方向上的度量，比如字宽、字间距等；
- 获取字符图片的边框（每个字符转化为图像的边界）；
- 调整每个字体图像的宽高（代码中的x、y），并渲染字体；
至此，解析ttf字体已完成，附加步骤为使用stb_image_write库将渲染出来的图像保存为本地图片，下面直接上代码：
注意：在包含stb_truetype.h头文件的时候需要定义
STB_TRUETYPE_IMPLEMENTATION，否则将会无法使用。
#include <stdio.h>
#include <stdlib.h>
#define STB_IMAGE_WRITE_IMPLEMENTATION
#include "stb_image_write.h" /* http://nothings.org/stb/stb_image_write.h */
#define STB_TRUETYPE_IMPLEMENTATION
#include "stb_truetype.h" /* http://nothings.org/stb/stb_truetype.h */
int main(int argc, const char *argv[])
{
/* 加载字体（.ttf）文件 */
long int size = 0;
unsigned char *fontBuffer = NULL;
FILE *fontFile = fopen("font/default.ttf", "rb");
if (fontFile == NULL)
{
printf("Can not open font file!\n");
return 0;
}
fseek(fontFile, 0, SEEK_END); /* 设置文件指针到文件尾，基于文件尾偏移0字节 */
size = ftell(fontFile); /* 获取文件大小（文件尾 - 文件头 单位：字节） */
fseek(fontFile, 0, SEEK_SET); /* 重新设置文件指针到文件头 */
fontBuffer = calloc(size, sizeof(unsigned char));
fread(fontBuffer, size, 1, fontFile);
fclose(fontFile);
/* 初始化字体 */
stbtt_fontinfo info;
if (!stbtt_InitFont(&info, fontBuffer, 0))
{
printf("stb init font failed\n");
}
/* 创建位图 */
int bitmap_w = 512; /* 位图的宽 */
int bitmap_h = 128; /* 位图的高 */
unsigned char *bitmap = calloc(bitmap_w * bitmap_h, sizeof(unsigned char));
/* "STB"的 unicode 编码 */
char word[20] = {0x53, 0x54, 0x42};
/* 计算字体缩放 */
float pixels = 64.0; /* 字体大小（字号） */
float scale = stbtt_ScaleForPixelHeight(&info, pixels); /* scale = pixels / (ascent - descent) */
/**
* 获取垂直方向上的度量
* ascent：字体从基线到顶部的高度；
* descent：基线到底部的高度，通常为负值；
* lineGap：两个字体之间的间距；
* 行间距为：ascent - descent + lineGap。
*/
int ascent = 0;
int descent = 0;
int lineGap = 0;
stbtt_GetFontVMetrics(&info, &ascent, &descent, &lineGap);
/* 根据缩放调整字高 */
ascent = roundf(ascent * scale);
descent = roundf(descent * scale);
int x = 0; /*位图的x*/
/* 循环加载word中每个字符 */
for (int i = 0; i < strlen(word); ++i)
{
/**
* 获取水平方向上的度量
* advanceWidth：字宽；
* leftSideBearing：左侧位置；
*/
int advanceWidth = 0;
int leftSideBearing = 0;
stbtt_GetCodepointHMetrics(&info, word[i], &advanceWidth, &leftSideBearing);
/* 获取字符的边框（边界） */
int c_x1, c_y1, c_x2, c_y2;
stbtt_GetCodepointBitmapBox(&info, word[i], scale, scale, &c_x1, &c_y1, &c_x2, &c_y2);
/* 计算位图的y (不同字符的高度不同） */
int y = ascent + c_y1;
/* 渲染字符 */
int byteOffset = x + roundf(leftSideBearing * scale) + (y * bitmap_w);
stbtt_MakeCodepointBitmap(&info, bitmap + byteOffset, c_x2 - c_x1, c_y2 - c_y1, bitmap_w, scale, scale, word[i]);
/* 调整x */
x += roundf(advanceWidth * scale);
/* 调整字距 */
int kern;
kern = stbtt_GetCodepointKernAdvance(&info, word[i], word[i + 1]);
x += roundf(kern * scale);
}
/* 将位图数据保存到1通道的png图像中 */
stbi_write_png("STB.png", bitmap_w, bitmap_h, 1, bitmap, bitmap_w);
free(fontBuffer);
free(bitmap);
return 0;
}
运行后可以见STB.png图片，效果如下：
# 3 总结
以上便是stb_truetype库的基本用法，可以看出使用过程比较简单，其中需要调整的参数主要是字体大小（字号），使用过程中需要注意以下两点：
- 上面已经提过，这里再提一遍，在包含stb_truetype.h头文件的时候需要定义STB_TRUETYPE_IMPLEMENTATION，否则将会无法使用。
- 调用stb_truetype库函数传入的字符编码必须是unicode编码。