现在的位置: 首页 > 综合 > 正文

FTK应用程序编程接口(API)手册-1

2013年08月16日 ⁄ 综合 ⁄ 共 1088字 ⁄ 字号 评论关闭

框架函数


框架函数支撑FTK的主体,它负责初始化应用程序,启动主循环和退出主循环。它对任何一个FTK应用程序都是不可缺少的,即使应用程序没有使用任何控件(当然这也没有什么意义),所以我们先介绍这些函数。

1.初始化FTK

原型:Ret
 ftk_init(int argc, char* argv[]);

说明:用于初始化FTK,比如平台相关的初始化,加载配置文件,初始化Display,字体,主题和输入法等。如果应用程序是作为桌面的插件运行的,那是不需要调用这个函数的,因为桌面已经调用了。
参数:这里基本上把main函数的参数直接传递进去即可。argc是参数的个数,argv是具体的参数。目前的支持的参数有:

--disable-statusbar:禁用状态栏,使用这个参数,状态栏则不会创建。

--enable-cursor:启用鼠标指针,使用这个参数,FTK用主题中的图片cursor.png作为鼠标指针。

--theme=
指定主题的名称,缺省为default。

--data-dir=
指定数据文件的目录。

--test-data-dir=指定测试数据文件的目录,包括demos需要的数据。

--rotate=
指定屏幕旋转的度数,可选的值有0, 90和180。

--log-level=
指定log的级别。可选的值有V,D, W, I, E,分别对应FTK_LOG_V,FTK_LOG_D,FTK_LOG_I,FTK_LOG_W和FTK_LOG_E。


请参考:ftk_config_init的代码,这里负责处理这些参数。

返回值:成功返回RET_OK。

2.进入主循环

原型:Ret
 ftk_run(void);

说明:进入FTK主循环,等待事件发生,然后处理这些事件,不断循环直到ftk_quit被调用。如果应用程序是作为桌面的插件运行的,那是不需要调用这个函数的,因为桌面已经调用了。
参数:无
返回值:成功返回RET_OK。

3.退出主循环

原型:void
ftk_quit(void)

说明:退出FTK的主循环,如果需要退出整个应用程序,则调用此函数。如果应用程序是作为桌面插件运行的,调用这个函数就会退出桌面。
参数:无。
返回值:无。

4.退出后清理现场
原型:void
ftk_deinit(void);

说明:FTK退出主循环后,应用程序将退出,此时需要释放FTK占用的全部资源。应用程序一般不需要调用这个函数,因为一般会通过atexit自动调用。
参数:无。
返回值:无。

5.本节使用示例:

int
main(int argc, char* argv[])

{   

ftk_init(argc,
argv);

ftk_run();

return
0;

}

抱歉!评论已关闭.