FTK應用程式程式設計介面 API 手冊 1

2021-08-26 03:31:36 字數 1303 閱讀 7669

框架函式支撐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協議,比...