| 函数名称 | 说明 | | -------- | ------------ | | system\_info | 获取system_info对象。 | | system\_info\_create | 创建system_info对象。 | | system\_info\_deinit | 释放system_info对象。 | | system\_info\_fix\_font\_name | 修正字体名称，如果为NULL，返回缺省字体。 | | system\_info\_init | 初始化system_info对象。 | | system\_info\_set\_app\_root | 设置app root。 | | system\_info\_set\_default\_font | 设置缺省字体。 | | system\_info\_set\_device\_pixel\_ratio | 设置LCD密度。 | | system\_info\_set\_font\_scale | 设置字体缩放比例。 | | system\_info\_set\_lcd\_h | 设置LCD高度。 | | system\_info\_set\_lcd\_orientation | 设置LCD的旋转角度。 | | system\_info\_set\_lcd\_type | 设置LCD类型。 | | system\_info\_set\_lcd\_w | 设置LCD宽度。 | ### 属性
| 属性名称 | 类型 | 说明 | | -------- | ----- | ------------ | | app\_name | const char* | 应用程序的名称。 | | app\_root | const char* | 应用程序的根目录，用于定位资源文件。 | | app\_type | app\_type\_t | 应用程序的类型。 | | country | const char* | locale中的国家。 | | default\_font | const char* | 缺省字体。 | | device\_orientation | const char* | 显示屏的方向名称，可选值："portrait"表示竖屏，"landscape"表示横屏。 | | device\_pixel\_ratio | float\_t | 显示屏的密度。 | | font\_scale | float\_t | 字体缩放比例，用于实现字体整体放大。 | | language | const char* | locale中的语言。 | | lcd\_h | uint32\_t | 显示屏的高度。 | | lcd\_orientation | lcd\_orientation\_t | 显示屏的旋转角度。 | | lcd\_type | lcd\_type\_t | 显示屏的类型。 | | lcd\_w | uint32\_t | 显示屏的宽度。 | #### system\_info 函数 ----------------------- * 函数功能： >
获取system_info对象。 * 函数原型： ``` system_info_t* system_info (); ``` * 参数说明： | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | system\_info\_t* | 返回system\_info对象。 | #### system\_info\_create 函数 ----------------------- * 函数功能： >
创建system_info对象。 * 函数原型： ``` system_info_t* system_info_create (app_type_t app_type, const char* app_name, const char* app_root); ``` * 参数说明： | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | system\_info\_t* | 返回创建的对象指针。 | | app\_type | app\_type\_t | 应用程序的类型。 | | app\_name | const char* | 应用程序的名称。 | | app\_root | const char* | 应用程序的根目录，用于定位资源文件。 | #### system\_info\_deinit 函数 ----------------------- * 函数功能： >
释放system_info对象。 * 函数原型： ``` ret_t system_info_deinit (); ``` * 参数说明： | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 | #### system\_info\_fix\_font\_name 函数 ----------------------- * 函数功能： >
修正字体名称，如果为NULL，返回缺省字体。 * 函数原型： ``` const char* system_info_fix_font_name (const char* name); ``` * 参数说明： | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | const char* | 返回有效的字体名称。 | | name | const char* | 字体名称。 | #### system\_info\_init 函数 ----------------------- * 函数功能： >
初始化system_info对象。 * 函数原型： ``` ret_t system_info_init (app_type_t app_type, const char* app_name, const char* app_root); ``` * 参数说明： | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 | | app\_type | app\_type\_t | 应用程序的类型。 | | app\_name | const char* | 应用程序的名称。 | | app\_root | const char* | 应用程序的根目录，用于定位资源文件。 | #### system\_info\_set\_app\_root 函数 ----------------------- * 函数功能： >
设置app root。 * 函数原型： ``` ret_t system_info_set_app_root (system_info_t* info info, const char* app_root); ``` * 参数说明： | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 | | info | system\_info\_t* info | system\_info对象。 | | app\_root | const char* | app root。 | #### system\_info\_set\_default\_font 函数 ----------------------- * 函数功能： >
设置缺省字体。 * 函数原型： ``` ret_t system_info_set_default_font (system_info_t* info info, const char* default_font); ``` * 参数说明： | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 | | info | system\_info\_t* info | system\_info对象。 | | default\_font | const char* | 缺省字体。 | #### system\_info\_set\_device\_pixel\_ratio 函数 ----------------------- * 函数功能： >
设置LCD密度。 * 函数原型： ``` ret_t system_info_set_device_pixel_ratio (system_info_t* info info, float_t device_pixel_ratio); ``` * 参数说明： | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 | | info | system\_info\_t* info | system\_info对象。 | | device\_pixel\_ratio | float\_t | 设置LCD密度。 | #### system\_info\_set\_font\_scale 函数 ----------------------- * 函数功能： >
设置字体缩放比例。 * 函数原型： ``` ret_t system_info_set_font_scale (system_info_t* info info, float_t font_scale); ``` * 参数说明： | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 | | info | system\_info\_t* info | system\_info对象。 | | font\_scale | float\_t | 字体缩放比例。 | #### system\_info\_set\_lcd\_h 函数 ----------------------- * 函数功能： >
设置LCD高度。 * 函数原型： ``` ret_t system_info_set_lcd_h (system_info_t* info info, uint32_t lcd_h); ``` * 参数说明： | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 | | info | system\_info\_t* info | system\_info对象。 | | lcd\_h | uint32\_t | 设置LCD高度。 | #### system\_info\_set\_lcd\_orientation 函数 ----------------------- * 函数功能： >
设置LCD的旋转角度。 * 函数原型： ``` ret_t system_info_set_lcd_orientation (system_info_t* info info, lcd_orientation_t lcd_orientation); ``` * 参数说明： | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 | | info | system\_info\_t* info | system\_info对象。 | | lcd\_orientation | lcd\_orientation\_t | 设置LCD的旋转角度。 | #### system\_info\_set\_lcd\_type 函数 ----------------------- * 函数功能： >
设置LCD类型。 * 函数原型： ``` ret_t system_info_set_lcd_type (system_info_t* info info, lcd_type_t lcd_type); ``` * 参数说明： | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 | | info | system\_info\_t* info | system\_info对象。 | | lcd\_type | lcd\_type\_t | 设置LCD类型。 | #### system\_info\_set\_lcd\_w 函数 ----------------------- * 函数功能： >
设置LCD宽度。 * 函数原型： ``` ret_t system_info_set_lcd_w (system_info_t* info info, uint32_t lcd_w); ``` * 参数说明： | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 | | info | system\_info\_t* info | system\_info对象。 | | lcd\_w | uint32\_t | 设置LCD宽度。 | #### app\_name 属性 ----------------------- >
应用程序的名称。 * 类型：const char* | 特性 | 是否支持 | | -------- | ----- | | 可直接读取 | 是 | | 可直接修改 | 否 | #### app\_root 属性 ----------------------- >
应用程序的根目录，用于定位资源文件。 * 类型：const char* | 特性 | 是否支持 | | -------- | ----- | | 可直接读取 | 是 | | 可直接修改 | 否 | #### app\_type 属性 ----------------------- >
应用程序的类型。 * 类型：app\_type\_t | 特性 | 是否支持 | | -------- | ----- | | 可直接读取 | 是 | | 可直接修改 | 否 | #### country 属性 ----------------------- >
locale中的国家。 > 只能通过object\_get\_prop函数访问。 * 类型：const char* | 特性 | 是否支持 | | -------- | ----- | | 可直接读取 | 是 | | 可直接修改 | 否 | #### default\_font 属性 ----------------------- >
缺省字体。 * 类型：const char* | 特性 | 是否支持 | | -------- | ----- | | 可直接读取 | 是 | | 可直接修改 | 否 | #### device\_orientation 属性 ----------------------- >
显示屏的方向名称，可选值："portrait"表示竖屏，"landscape"表示横屏。 > 只能通过object\_get\_prop函数访问。 * 类型：const char* | 特性 | 是否支持 | | -------- | ----- | | 可直接读取 | 是 | | 可直接修改 | 否 | #### device\_pixel\_ratio 属性 ----------------------- >
显示屏的密度。 * 类型：float\_t | 特性 | 是否支持 | | -------- | ----- | | 可直接读取 | 是 | | 可直接修改 | 否 | #### font\_scale 属性 ----------------------- >
字体缩放比例，用于实现字体整体放大。 * 类型：float\_t | 特性 | 是否支持 | | -------- | ----- | | 可直接读取 | 是 | | 可直接修改 | 否 | #### language 属性 ----------------------- >
locale中的语言。 > 只能通过object\_get\_prop函数访问。 * 类型：const char* | 特性 | 是否支持 | | -------- | ----- | | 可直接读取 | 是 | | 可直接修改 | 否 | #### lcd\_h 属性 ----------------------- >
显示屏的高度。 * 类型：uint32\_t | 特性 | 是否支持 | | -------- | ----- | | 可直接读取 | 是 | | 可直接修改 | 否 | #### lcd\_orientation 属性 ----------------------- >
显示屏的旋转角度。 * 类型：lcd\_orientation\_t | 特性 | 是否支持 | | -------- | ----- | | 可直接读取 | 是 | | 可直接修改 | 否 | #### lcd\_type 属性 ----------------------- >
显示屏的类型。 * 类型：lcd\_type\_t | 特性 | 是否支持 | | -------- | ----- | | 可直接读取 | 是 | | 可直接修改 | 否 | #### lcd\_w 属性 ----------------------- >
显示屏的宽度。 * 类型：uint32\_t | 特性 | 是否支持 | | -------- | ----- | | 可直接读取 | 是 | | 可直接修改 | 否 |