📦Text 文本显示

作者: 泡泡

代码文件：src/text.c

DeactivateAllTextPrinters

void DeactivateAllTextPrinters(void);

💬将所有文本显示进程的active设置为FALSE，终止所有的文本显示，通常用于在窗口创建后的初始化

u16 AddTextPrinterParameterized(u8 windowId, u8 fontId, const u8 *str, u8 x, u8 y, u8 speed, void (*callback)(struct TextPrinterTemplate *, u16));

💬设置参数并调用文本显示函数，将指定的文本显示到对应ID的窗口，相较于其他的AddTextPrinterParameterized系列函数，该函数省略了文本颜色和文本间隔的设置，使用了字体默认的颜色和间隔

提示

该函数会执行AddTextPrinter并返回一个bool16的TRUE值，似乎并没有什么用

bool16 AddTextPrinter(struct TextPrinterTemplate *printerTemplate, u8 speed, void (*callback)(struct TextPrinterTemplate *, u16));

💬基础的文本显示函数，根据传入的模板添加文本显示任务，直接调用的情况比较少(比如战斗内文本显示)，该函数会被AddTextPrinterParameterized系列调用

参数	类型	介绍
printerTemplate	struct TextPrinterTemplate *	文本显示参数模板地址
speed	u8	文本打印的速度，(`-1`或`0xFF`时直接显示 )
callback	void*	回调函数，在文本打印的进程中会随时执行该函数

提示

当文本显示速度为-1或0xFF时，文本图像会直接被渲染，并且active设置为FALSE

该函数结束时会返回一个bool16的TRUE值，似乎并没有什么用

void RunTextPrinters(void);

💬执行所有active为TRUE的文本显示任务，并调用其回调函数，该函数通常放置在VblankCallBack实时监控并显示文本

当设置gDisableTextPrinters为TRUE时所有文本显示停止

提示

回调函数仅在文字显示的等待时执行

s32 GetStringWidth(u8 fontId, const u8 *str, s16 letterSpacing);

💬根据指定字体获取一串文本的图像宽度，可用于计算左右对齐的x起始坐标

✔️返回值：

u8 GetFontAttribute(u8 fontId, u8 attributeId);

💬获取字体的指定属性的默认值

参数	类型	介绍
fontId	u8	字体
attributeId	u8	指定的属性

✔️attributeId参考：

✔️返回值：