awtk/docs/manual/font_manager_t.md

font_manager_t

概述

字体管理器。 (如果使用nanovg，字体由nanovg内部管理)

函数

函数名称	说明
font_manager	获取缺省的字体管理器。
font_manager_add	向缓存中加入字体。
font_manager_create	创建字体管理器。
font_manager_deinit	析构字体管理器。
font_manager_destroy	析构并释放字体管理器。
font_manager_find	从缓存中查找字体。
font_manager_init	初始化字体管理器。
font_manager_set	设置缺省的字体管理器。
font_manager_set_assets_manager	设置资源管理器对象
g2d_blend_image	把图片指定的区域渲染到framebuffer指定的区域，src的大小和dst的大小不一致则进行缩放。
g2d_copy_image	把图片指定的区域拷贝到framebuffer中。
g2d_copy_image	把图片指定的区域进行旋转并拷贝到framebuffer相应的区域，本函数主要用于辅助实现横屏和竖屏的切换，一般支持90度旋转即可。
g2d_fill_rect	用颜色填充指定的区域。

属性

名属性称	类型	说明

事件

事件名称	类型	说明

font_manager 函数

---

• 函数功能：

获取缺省的字体管理器。

• 函数原型：

font_manager_t* font_manager ();

• 参数说明：

参数	类型	说明
返回值	font_manager_t*	返回字体管理器对象。

font_manager_add 函数

---

• 函数功能：

向缓存中加入字体。

• 函数原型：

ret_t font_manager_add (font_manager_t* fm, char* name, font_t* font);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
fm	font_manager_t*	字体管理器对象。
name	char*	字体名。
font	font_t*	字体。

font_manager_create 函数

---

• 函数功能：

创建字体管理器。

• 函数原型：

font_manager_t* font_manager_create (font_loader_t* loader);

• 参数说明：

参数	类型	说明
返回值	font_manager_t*	返回字体管理器对象。
loader	font_loader_t*	字体加载器。

font_manager_deinit 函数

---

• 函数功能：

析构字体管理器。

• 函数原型：

ret_t font_manager_deinit (font_manager_t* fm);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
fm	font_manager_t*	字体管理器对象。

font_manager_destroy 函数

---

• 函数功能：

析构并释放字体管理器。

• 函数原型：

ret_t font_manager_destroy (font_manager_t* fm);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
fm	font_manager_t*	字体管理器对象。

font_manager_find 函数

---

• 函数功能：

从缓存中查找字体。

• 函数原型：

font_t* font_manager_find (font_manager_t* fm, char* name, uint16_t size);

• 参数说明：

参数	类型	说明
返回值	font_t*	返回字体对象。
fm	font_manager_t*	字体管理器对象。
name	char*	字体名，为NULL时使用TK_DEFAULT_FONT。
size	uint16_t	字体的大小。

font_manager_init 函数

---

• 函数功能：

初始化字体管理器。

• 函数原型：

font_manager_t* font_manager_init (font_manager_t* fm, font_loader_t* loader);

• 参数说明：

参数	类型	说明
返回值	font_manager_t*	返回字体管理器对象。
fm	font_manager_t*	字体管理器对象。
loader	font_loader_t*	字体加载器。

font_manager_set 函数

---

• 函数功能：

设置缺省的字体管理器。

• 函数原型：

ret_t font_manager_set (font_manager_t* fm);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
fm	font_manager_t*	字体管理器对象。

font_manager_set_assets_manager 函数

---

• 函数功能：

设置资源管理器对象

• 函数原型：

ret_t font_manager_set_assets_manager (font_manager_t* imm, assets_manager_t* assets_manager);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
imm	font_manager_t*	图片管理器对象。
assets_manager	assets_manager_t*	资源管理器。

g2d_blend_image 函数

---

• 函数功能：

把图片指定的区域渲染到framebuffer指定的区域，src的大小和dst的大小不一致则进行缩放。

1.硬件不支持缩放，则返回NOT_IMPL。 2.硬件不支持全局alpha，global_alpha!=0xff时返回NOT_IMPL。

• 函数原型：

ret_t g2d_blend_image (bitmap_t* fb, bitmap_t* img, rect_t* dst, rect_t* src, uint8_t global_alpha);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败，返回失败则上层用软件实现。
fb	bitmap_t*	framebuffer对象。
img	bitmap_t*	图片对象。
dst	rect_t*	目的区域。
src	rect_t*	源区域。
global_alpha	uint8_t	全局alpha。

g2d_copy_image 函数

---

• 函数功能：

把图片指定的区域拷贝到framebuffer中。

• 函数原型：

ret_t g2d_copy_image (bitmap_t* fb, bitmap_t* img, rect_t* src, xy_t dx, xy_t dy);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败，返回失败则上层用软件实现。
fb	bitmap_t*	framebuffer对象。
img	bitmap_t*	图片对象。
src	rect_t*	要拷贝的区域。
dx	xy_t	目标位置的x坐标。
dy	xy_t	目标位置的y坐标。

g2d_copy_image 函数

---

• 函数功能：

把图片指定的区域进行旋转并拷贝到framebuffer相应的区域，本函数主要用于辅助实现横屏和竖屏的切换，一般支持90度旋转即可。

• 函数原型：

ret_t g2d_copy_image (bitmap_t* fb, bitmap_t* img, rect_t* src, lcd_orientation_t o);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败，返回失败则上层用软件实现。
fb	bitmap_t*	framebuffer对象。
img	bitmap_t*	图片对象。
src	rect_t*	要旋转并拷贝的区域。
o	lcd_orientation_t	旋转角度(一般支持90度即可)。

g2d_fill_rect 函数

---

• 函数功能：

用颜色填充指定的区域。

• 函数原型：

ret_t g2d_fill_rect (bitmap_t* fb, rect_t* dst, color_t c);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败，返回失败则上层用软件实现。
fb	bitmap_t*	framebuffer对象。
dst	rect_t*	要填充的目标区域。
c	color_t	颜色。