MSTAR-相关UI修改规范和使用.docVIP

ZUI – Highly maintainable UI framework! Engin Lee 2007/7/27 Developers: Joseph Chang, CheKuei Hsu, Engin Lee 概要 為了降低OSD GUI的開發及維護成本，我們提出ZUI這個開發流程，ZUI包含UI建立的架構程式碼，以及UI設計的工具程式， 目標 讓UI和logic能夠更明確的切開 將修改UI時side effect降至最低 制定程式撰寫流程及規範，並提供教學文件 UI designer或客戶能直接在UI工具程式上預覽及編輯 提供一套彈性化、可擴充的UI架構，使用者可自行設計新的control或UI look and feel 目前無法達成的目標: 希望能進一步切開GUI層和Controls，但因為8051的一些限制(如遞迴呼叫和XDATA記憶體)，使這個目標無法達成，造成許多GUI export functions直接呼叫/判斷Control Data 本架構最原始版本是在MIPS上開發，後來嘗試移植到8051，發現有許多設計上的限制，所以大幅度改寫，因為8051限制條件較多，所以如果未來移植回MIPS會相對比較容易，但目前無此計劃。 前提 / 假設事項 由於HK51不允許函式遞迴呼叫，所以程式撰寫時有以下原則: 所有的controls都是靜態產生的，也就就在compile time就決定好的，無法動態產生controls，以此架構有兩種方法實行: (A)將可能產生的control以隱藏的方式準備好，需要使用時再顯示出來；(B)若為條列式的資料可使用ListBox等等的control新增刪除資料筆數 所有的controls最基本的欄位有{X，Y，Width，Height，Normal Style，Focus Style，Disabled Style，Normal Alpha，Focus Alpha，Disabled Alpha，Parent，Initial State，Window Proc ID，Private Data，Navigations (Up, Down, Left, Right)，Current Visible，Current Disable}，其中只有Current Visible, Current Disable和位置寬高是可以動態修改的，其它的在設計時期就已經決定。 GUI公開的函式，如MApp_ZUI_API_ShowWindow()等等，不可以使用MApp_ZUI_API_SendMessage()或call進window proc，只能透過MApp_ZUI_API_PostMessage() 基本上，所有的操作都在單一個GWIN上處理，可以簡化管理多個GWIN帶來的不便，但有可能會需要配置兩塊(on-screen and off-screen)很大的framebuffer，需要有足夠的記憶體及頻寬。 撰寫 / 使用原則 分成API，CTL和ACT三大區域，API掌握UI framework的基本操作，包含message的傳送和狀態的處理；而CTL管理各種不同的controls，有各種UI style和behavior，兩者儘可能是保持與系統運作和流程無關，例如不應該在API區撰寫某些按鍵的特別處理，或某些HWND的特別顯示 (只有HWND_MAINFRAME是特例處理)，這些應該放在ACT區域。 函式以MApp_ZUI_為prefix，static變數和函式在最前面加上”_”字元，global變數在最前面加上”g_” MApp_ZUI_Main.h為整體GUI的進入點，提供對外的操作介面，非GUI的程式碼應該只需要include這個檔案，透過個介面來改變GUI及狀態，這些介面函式不屬於API，CTL或ACT。 每一個.c檔案使用類似#define CTL_ANI_DBG(x) //x來控制輸出debug message，submit到perforce時必須將debug message關閉，需要輸出時在自己local端打開。 儘可能減少Window Message的使用量，因為XDATA記憶體有限，所以無法提供很大的message queue，所以要儘量減少使用，例如MSG_NOTIFY_SHOW和MSG_NOTIFY_HIDE就是為了避免Show/Hide window時post出過多的message，所以使用MApp_Menu_ACT_PostMessageFilter()來判斷是否需要post這些message。 在HK51上為了節省使用XDATA記憶體，所以message數量、可移動的control、timer數量都有限制，請參考MApp_ZUI_API_window.c前的#defi