且构网

分享程序员开发的那些事...
且构网 - 分享程序员编程开发的那些事

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

更新时间:2022-08-21 15:40:54

转自:http://blog.csdn.net/absurd/article/details/6702047

框架函数

框架函数支撑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;
}

 

【作者】张昺华
【新浪微博】 张昺华--sky
【twitter】 @sky2030_
【facebook】 张昺华 zhangbinghua
本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利.