框架函式支撐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應用程式程式設計介面 API 手冊 2
全域性物件訪問函式 ftk中有一些單例項的物件,這些物件是以全域性變數的形式存在的,為了有效的控制對這些物件的訪問,我們提供了相應的存 取函式。這些物件都是在ftk初始化時建立的,所以開發人員無需要再呼叫相應的 存 函式,但有時需要 取 出這些物件,以後 獲得相應的資訊。故這裡只介紹 取 的函式 1...
FTK應用程式程式設計介面 API 手冊 2
全域性物件訪問函式 ftk中有一些單例項的物件,這些物件是以全域性變數的形式存在的,為了有效的控制對這些物件的訪問,我們提供了相應的存 取函式。這些物件都是在ftk初始化時建立的,所以開發人員無需要再呼叫相應的 存 函式,但有時需要 取 出這些物件,以後 獲得相應的資訊。故這裡只介紹 取 的函式 1...
API應用程式程式設計介面
一 api 定義 應用程式程式設計介面,使用廣泛,用於軟體間交換資料,擁有結構化的請求和反饋。用途 獲取資料 演算法 底層裝置 rest repredentational state transfer 用url定位資源,用http描述操作 rest是一種網路應用設計的風格,基於無狀態的c s協議,比...