Mstar液晶电视方案-OSD代码详解

Mstar OSD 详解一、OSD基本概念UI语言：指OSD内容中的文字部分使用的语言类型；UI模式：指OSD内容适用的环境，例如不同的信号源(TV、DVD、PC)带来的模式化其作用主要区分不同的环境下OSD的不同表现；UI场景：特定语言模式下及较多信息页面情况下，当前OSD适用的特定页面；UI事件：用户利用输入设备向UI系统提供的操作命令；UI动作表：指在特定UI场景中，对于UI输入的命令进行对应处理的索引表；OSD画布：指整个OSD呈现的区域，通常为一个矩形区域；OSD位置：通常指在OSD画布中，相较左上角原点的相对位置；OSD物件：呈现在画布上，表达特定信息，具有特定属性的像素组合。 二、MST OSD流程图 Mstar的OSD方案，感觉主要是在msosd.c(底层部分)，menu.c， menutbl.c这里，主要有MenuPageType、MenuItemType、DrawSubMenuGroupType、MenuItemFuncType等几个Stucture，菜单位置、大小及相应操作方法都在结构体里；在Main循环程序中通过不断的调用keyDetectHander()、irDecodeCommand()和OsdHandler()来达到OSD的各种功能与目的。 三、模块说明1、User Command 这部分指的是用户利用Keypad、Ir或Visual Key进行操作，产生中断触发激活KeyEvent；主要功能是在Irfunc.c、keyPad.c里完成的，在keyDetectHandler()、irDecodeCommand()中获得相关按键信息，而后通过MenuProcessKey()、ExecuteKeyEvent()执行相应的操作（包括画OSD以及执行按键功能等）。这里比较重要的是如何将某状态下的按键（如某一按键连续按两次或者一直按下）转化成正确的MenuItemActionType，因为所有的按键最终都会被转到ExecuteKeyEvent()进行处理，而ExecuteKeyEvent()正是根据不同的MenuItemActionType实现不同的功能；实现此功能的关键在于所使用的Menu Structure上，详细内容请参考Menu Table模块。 2、Draw OSD 在Global.h中定义的一些与OSD相关的全局变量（如：g_ucMenuPageIndex、g_ucMenuItemIndex、g_ucOsdTimeCounter等等），在User Command部分中若用户进行了不同的操作则会影响到这些变量，根据变量值的不同，OsdHandler()、DrawOsdMenu()、DrawOsdMenuPage()、DrawOsdSubMenuGroup()也就可以画出不同的OSD界面了；这几个函数大部分是在Menu.c里定义的，实现这些函数的功能则是依靠调用底层部分（msosd.c）的各种功能函数，一般来讲，我们不需要更改底层的内容。 同样，实现各种OSD界面风格的关键也是在于所使用的Menu Structure上，因此，理解MenuDef.h中的各种Menu Structure是学习整个Mstar OSD结构的关键。 3、Menu Table这个非常重要，理解了Menu Structure，整个OSD学习也就容易多了，在MenuDef.h中定义的如下几个结构：A、菜单页面结构体：typedef struct BYTE XSize, YSize; /定义MenuPage窗口大小（Set Window Size） BYTE PrevMenuPage; /前一个MenuPage（场景） MenuItemType* MenuItems; /该MenuPage下的MenuItems BYTE MenuItemCount; /该MenuPage下的MenuItems个数 BYTE ItemSelLength, ItemSubGroupSelLength; /Item及可选长度 fpExecFunc ExecFunction; /执行功能，如Power On/Off等 /MenuFontType *Fonts; /关闭，暂时未用 BYTE Flags; /标志位，是否可见/保持 MenuPageType;在MenuDef.h中的枚举型变量MenuPageIndexType与MenuTbl.c中的tblMenus一起定义了MenuPageType类型的各种MenuPage。如：MENU_MAIN, /值5，为1级菜单（MENU_ROOT为虚拟根菜单，另外还有1、2、3级菜单）MENU_PICTURE, /2级菜单MENU_SOUND,MENU_CHANNEL,MENU_FUNCTION,MENU_PC,MENU_OSD, /值11，为2级菜单等等。该结构与DrawOsdMenu间的沟通桥梁是定义在Menu.h中的如下宏定义：#define CURRENT_MENU tblMenusg_ucMenuPageIndex#define CURRENT_MENU_ITEMS CURRENT_MENU.MenuItems#define CURRENT_MENU_ITEM_COUNT (CURRENT_MENU.MenuItemCount)#define CURRENT_MENU_ITEM CURRENT_MENU_ITEMSg_ucMenuItemIndex#define CURRENT_MENU_ITEM_FUNC CURRENT_MENU_ITEM.KeyFunction B、页面选项结构体：typedef struct BYTE XPos, YPos; /MenuItem区域 BYTE UnSelColorType, SelColorType; /选中与未选中图标颜色模式 BYTE NextMenuPage; /下一个MenuPage（场景） DrawMenuTextType DrawItemMethod; /画Item方法，包括可选颜色、字体等 fpDisplayText DisplayText; /所要显示的字符 MenuItemActionType *KeyEvents; /按键触发事件类别（该MenuItem下各按键动作，导航信息） MenuItemFuncType KeyFunction; /所选Item对应功能 DrawSubMenuGroupType* DrawSubMenuGroup; /画菜单的方法 /MenuFontType *Fonts; BYTE Flags; /该MenuItem是否可选、在不同模式下是否可用（MENU_MAIN） MenuItemType;MenuItemActionType *KeyEvents选项对应不同状态下各个按键的不同响应（导航信息）。例如：当使用IR按下Menu按键时，IR产生一个IRKEY_OSD_MENU值，利用IrDecommand()调用MenuProcessKey(BTN_OSD)，在这里，就必须判断当前状态下的KeyEvent，用于产生对应的MenuItemActionType供ExecuteKeyEvent()使用，若当前状态（即当前g_ucMenuPageIndex与g_ucMenuItemIndex的值）与按下此按键后的状态相同，也就是按下Menu键后再次按下Menu键，这时，所依据的KeyEvent就为CURRENT_MENU_ITEM.KeyEvent指向的结构（定义在MenuTbl.h），为MenuItemActionType code NaviAdjustKeyEventBTN_ENDBTN = MIA_POWER, / BTN_POWER MIA_SOURCE, / BTN_SOURCE MIA_INCVALUE, / BTN_Right MIA_GOTOPREV, / BTN_Osd MIA_PREVITEM, / BTN_Up MIA_NEXTITEM, / BTN_Down MIA_DECVALUE, / BTN_Left MIA_PIPFUNC / BTN_Pip;即对应BTN_Osd为MIA_GOTOPREV，表示在两次按下Menu键后返回第一次按下Menu键前的场景，应该说明的一点是不同状态下所对应的KeyEvent大多会有异同。因此，每个Button可以转换成多种类型的MenuAction,而后调用ExecuteKeyEvent(MenuAction)来执行这个MenuAction。 另外还需要注意的是，对于不同的InputSource，OSD需要显示的MenuPage或MenuItem是会不同的，决定是否显示某一MenuPage的控制权在于MenuPage为1级MENU_MAIN中该结构体下的Flag位（MenuItem的控制权在各自MenuPage下该Flag位），通过IsItemSelectable()获得其值，若为True则画之，否则就蔽之；画出具体某一MenuItem的功能函数是DrawOsdSubMenuGroup()。 C、菜单物件结构体：typedef struct BYTE Flags; /Draw SubMenuItemText method BYTE UnSelColorType, SelColorType; /选中与未选中图标颜色样式 BYTE XPos, YPos; /文本信息显示的位置 BYTE Length; /选中/箭头等长度 fpDisplayText DisplayText; /所要显示的文本信息 fpGetValue GetValue; /获取数值，如OSD位置、透明度等 DrawSubMenuGroupType;这个部分要说明的是DisplayText，因为有多种语言格式，需要从Menu Strings模块中选择正确语言的DisplayText Strings（实际上是个表），在String.c中的GetStringToBuffer()实现此功能，大致过程是：在DrawSubMenuGroupType结构里添加指向定义在MenuStr.c里的各种字符串函数，返回定义在Strings.h里的对应字符串索引，该索引最终指向Strings.c里的某些字符表代码，最后当调用DrawOsdSubMenuGroup()时就显示出各种菜单信息。另外全局变量bCurrFontTableId表示当前使用哪种语言字库，使用OSD菜单下进行语系更改时改变其值，从而实现语言重载，显示出对应语系下的OSD信息。 D、菜单功能结构体：typedef struct fpAdjustValue AdjustFunction; /调整功能函数 fpExecFunc ExecFunction; /执行功能函数 MenuItemFuncType; 在Menu.c中的ExecuteKeyEvent（）函数中判断菜单项的功能，如果有相应功能便执行。4、Menu Strings表结构，主要定义在Strings.c里，依据用户选择不同的语言查找相应的表；当我们需要更改或添加语言时，可以使用 Mstar提供的制作ICON及修改添加语言功能的工具，其中，Mstgen.exe功能是制作ICON，将个性化的菜单图标生成源码，需要注意的是要选好Horizontal与Vertical的值，对于6X89系列的话其值分别为12、32，它产生的源码需添加到Palette.c、Font.c、Font_Download.c等文件里；MenuEditor.exe用来更改添加语言，打开strings.xls文件，修改添加字符串直接在Strings里改，添加字库则在Dynamic里添加定义，至于要添加什么字体及多少字体，则要使用DynFontSort.exe工具，将新增语言的字符COPY到DynFontSort.exe，点击Sort后便可产生需要的字体，选择除已有的字体外的全部字符，添加到自己所定义的语言项里，修改完strings.xls文件后保存，使用MenuEditor.exe的Convert Strings按钮直接修改源码（注意对应6X