2025-09-30 11:56:06 +08:00
|
|
|
|
## font\_t
|
|
|
|
|
|
### 概述
|
|
|
|
|
|
代表一种字体。
|
|
|
|
|
|
----------------------------------
|
|
|
|
|
|
### 函数
|
|
|
|
|
|
<p id="font_t_methods">
|
|
|
|
|
|
|
|
|
|
|
|
| 函数名称 | 说明 |
|
|
|
|
|
|
| -------- | ------------ |
|
|
|
|
|
|
| <a href="#font_t_font_destroy">font\_destroy</a> | 销毁font对象。 |
|
|
|
|
|
|
| <a href="#font_t_font_get_glyph">font\_get\_glyph</a> | 获取指定字符和大小的字模。 |
|
|
|
|
|
|
| <a href="#font_t_font_get_vmetrics">font\_get\_vmetrics</a> | 获取字体的高度信息。 |
|
|
|
|
|
|
| <a href="#font_t_font_match">font\_match</a> | 检查当前字体是否与指定名称和大小相匹配。 |
|
|
|
|
|
|
| <a href="#font_t_font_shrink_cache">font\_shrink\_cache</a> | 清除最近没使用的字模。 |
|
|
|
|
|
|
#### font\_destroy 函数
|
|
|
|
|
|
-----------------------
|
|
|
|
|
|
|
|
|
|
|
|
* 函数功能：
|
|
|
|
|
|
|
|
|
|
|
|
> <p id="font_t_font_destroy">销毁font对象。
|
|
|
|
|
|
|
|
|
|
|
|
* 函数原型：
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
ret_t font_destroy (font_t* font);
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
* 参数说明：
|
|
|
|
|
|
|
|
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
|
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
|
|
|
|
|
|
| font | font\_t* | font对象。 |
|
|
|
|
|
|
#### font\_get\_glyph 函数
|
|
|
|
|
|
-----------------------
|
|
|
|
|
|
|
|
|
|
|
|
* 函数功能：
|
|
|
|
|
|
|
|
|
|
|
|
> <p id="font_t_font_get_glyph">获取指定字符和大小的字模。
|
|
|
|
|
|
|
|
|
|
|
|
* 函数原型：
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
ret_t font_get_glyph (font_t* font, wchar_t chr, font_size_t font_size, glyph_t* glyph);
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
* 参数说明：
|
|
|
|
|
|
|
|
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
|
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
|
|
|
|
|
|
| font | font\_t* | font对象。 |
|
|
|
|
|
|
| chr | wchar\_t | 字符。 |
|
|
|
|
|
|
| font\_size | font\_size\_t | 字体大小。 |
|
|
|
|
|
|
| glyph | glyph\_t* | 返回字模数据。 |
|
|
|
|
|
|
#### font\_get\_vmetrics 函数
|
|
|
|
|
|
-----------------------
|
|
|
|
|
|
|
|
|
|
|
|
* 函数功能：
|
|
|
|
|
|
|
|
|
|
|
|
> <p id="font_t_font_get_vmetrics">获取字体的高度信息。
|
|
|
|
|
|
|
|
|
|
|
|
* 函数原型：
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
font_vmetrics_t font_get_vmetrics (font_t* font, font_size_t font_size);
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
* 参数说明：
|
|
|
|
|
|
|
|
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
|
| 返回值 | font\_vmetrics\_t | 返回字体的高度信息。 |
|
|
|
|
|
|
| font | font\_t* | font对象。 |
|
|
|
|
|
|
| font\_size | font\_size\_t | 字体大小。 |
|
|
|
|
|
|
#### font\_match 函数
|
|
|
|
|
|
-----------------------
|
|
|
|
|
|
|
|
|
|
|
|
* 函数功能：
|
|
|
|
|
|
|
|
|
|
|
|
> <p id="font_t_font_match">检查当前字体是否与指定名称和大小相匹配。
|
|
|
|
|
|
|
|
|
|
|
|
* 函数原型：
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
bool_t font_match (font_t* font, const char* font_name, font_size_t font_size);
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
* 参数说明：
|
|
|
|
|
|
|
|
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
|
| 返回值 | bool\_t | 返回TRUE表示成功，FALSE表示失败。 |
|
|
|
|
|
|
| font | font\_t* | font对象。 |
|
|
|
|
|
|
| font\_name | const char* | 字体名称。 |
|
|
|
|
|
|
| font\_size | font\_size\_t | 字体大小。 |
|
|
|
|
|
|
#### font\_shrink\_cache 函数
|
|
|
|
|
|
-----------------------
|
|
|
|
|
|
|
|
|
|
|
|
* 函数功能：
|
|
|
|
|
|
|
|
|
|
|
|
> <p id="font_t_font_shrink_cache">清除最近没使用的字模。
|
|
|
|
|
|
|
|
|
|
|
|
* 函数原型：
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
ret_t font_shrink_cache (font_t* font, uint32_t cache_size);
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
* 参数说明：
|
|
|
|
|
|
|
|
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
|
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
|
|
|
|
|
|
| font | font\_t* | font对象。 |
|
|
|
|
|
|
| cache\_size | uint32\_t | 保留缓存字模的个数。 |
|
