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

1、Mstar OSD 详解一、OSD基本概念UI语言：指OSD内容中的文字部分使用的语言类型；UI模式：指OSD内容适用的环境，例如不同的信号源(TV、DVD、PC)带来的模式化其作用主要区分不同的环境下OSD的不同表现；UI场景：特定语言模式下及较多信息页面情况下，当前OSD适用的特定页面；UI事件：用户利用输入设备向UI系统提供的操作命令；UI动作表：指在特定UI场景中，对于UI输入的命令进行对应处理的索引表；OSD画布：指整个OSD呈现的区域，通常为一个矩形区域；OSD位置：通常指在OSD画布中，相较左上角原点的相对位置；OSD物件：呈现在画布上，表达特定信息，具有特定属性的像素组合。 二

2、、MST OSD流程图 Mstar的OSD方案，感觉主要是在msosd.c(底层部分)，这里，主要有MenuPageType、MenuItemType、DrawSubMenuGroupType、MenuItemFuncType等几个Stucture，菜单位置、大小及相应操作方法都在结构体里；在Main循环程序中通过不断的调用keyDetectHander()、irDecodeCommand()和OsdHandler()来到达OSD的各种功能与目的。 三、模块说明1、User Command 这部分指的是用户利用Keypad、Ir或Visual Key进行操作，产生中断触发激活KeyEvent；

3、主要功能是在、里完成的，在keyDetectHandler()、irDecodeCommand()中获得相关按键信息，而后通过MenuProcessKey()、ExecuteKeyEvent()执行相应的操作包括画OSD以及执行按键功能等。这里比较重要的是如何将某状态下的按键如某一按键连续按两次或者一直按下转化成正确的MenuItemActionType，因为所有的按键最终都会被转到ExecuteKeyEvent()进行处理，而ExecuteKeyEvent()正是根据不同的MenuItemActionType实现不同的功能；实现此功能的关键在于所使用的Menu Structure上，详细内容

4、请参考Menu Table模块。 2、Draw OSD 在中定义的一些与OSD相关的全局变量如：g_ucMenuPageIndex、g_ucMenuItemIndex、g_ucOsdTimeCounter等等，在User Command部分中假设用户进行了不同的操作则会影响到这些变量，根据变量值的不同，OsdHandler()、DrawOsdMenu()、DrawOsdMenuPage()、DrawOsdSubMenuGroup()也就可以画出不同的OSD界面了；这几个函数大部分是在里定义的，实现这些函数的功能则是依靠调用底层部分的各种功能函数，一般来讲，我们不需要更改底层的内容。 同样，实现

5、各种OSD界面风格的关键也是在于所使用的Menu Structure上，因此，理解中的各种Menu Structure是学习整个Mstar OSD结构的关键。 3、Menu Table这个非常重要，理解了Menu Structure，整个OSD学习也就容易多了，在中定义的如下几个结构：A、菜单页面结构体：typedef struct BYTE XSize, YSize; /定义MenuPage窗口大小Set Window Size BYTE PrevMenuPage; /前一个MenuPage场景 MenuItemType* MenuItems; /该MenuPage下的MenuItems B

6、YTE MenuItemCount; /该MenuPage下的MenuItems个数 BYTE ItemSelLength, ItemSubGroupSelLength; /Item及可选长度 fpExecFunc ExecFunction; /执行功能，如Power On/Off等 /MenuFontType *Fonts; /关闭，暂时未用 BYTE Flags; /标志位，是否可见/保持 MenuPageType;在中的枚举型变量MenuPageIndexType与中的tblMenus一起定义了MenuPageType类型的各种MenuPage。如：MENU_MAIN, /值5，为1级菜

7、单MENU_ROOT为虚拟根菜单，另外还有1、2、3级菜单MENU_PICTURE, /2级菜单MENU_SOUND,MENU_CHANNEL,MENU_FUNCTION,MENU_PC,MENU_OSD, /值11，为2级菜单等等。该结构与DrawOsdMenu间的沟通桥梁是定义在中的如下宏定义：#define CURRENT_MENU tblMenusg_ucMenuPageIndex#define CURRENT_MENU_ITEM_COUNT (CURRENT_MENU.MenuItemCount)#define CURRENT_MENU_ITEM CURRENT_MENU_ITEMS

8、g_ucMenuItemIndex B、页面选项结构体：typedef struct BYTE XPos, YPos; /MenuItem区域 BYTE UnSelColorType, SelColorType; /选中与未选中图标颜色模式 BYTE NextMenuPage; /下一个MenuPage场景 DrawMenuTextType DrawItemMethod; /画Item方法，包括可选颜色、字体等 fpDisplayText DisplayText; /所要显示的字符 MenuItemActionType *KeyEvents; /按键触发事件类别该MenuItem下各按键动作，

9、导航信息 MenuItemFuncType KeyFunction; /所选Item对应功能 DrawSubMenuGroupType* DrawSubMenuGroup; /画菜单的方法 /MenuFontType *Fonts; BYTE Flags; /该MenuItem是否可选、在不同模式下是否可用MENU_MAIN MenuItemType;MenuItemActionType *KeyEvents选项对应不同状态下各个按键的不同响应导航信息。例如：当使用IR按下Menu按键时，IR产生一个IRKEY_OSD_MENU值，利用IrDecommand()调用MenuProcessKey

10、(BTN_OSD)，在这里，就必须判断当前状态下的KeyEvent，用于产生对应的MenuItemActionType供ExecuteKeyEvent()使用，假设当前状态即当前g_ucMenuPageIndex与g_ucMenuItemIndex的值与按下此按键后的状态相同，也就是按下Menu键后再次按下Menu键，这时，所依据的KeyEvent就为指向的结构定义在，为MenuItemActionType code NaviAdjustKeyEventBTN_ENDBTN = MIA_POWER, / BTN_POWER MIA_SOURCE, / BTN_SOURCE MIA_INCVAL

11、UE, / 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。

12、 另外还需要注意的是，对于不同的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

13、UnSelColorType, SelColorType; /选中与未选中图标颜色样式 BYTE XPos, YPos; /文本信息显示的位置 BYTE Length; /选中/箭头等长度 fpDisplayText DisplayText; /所要显示的文本信息 fpGetValue GetValue; /获取数值，如OSD位置、透明度等 DrawSubMenuGroupType;这个部分要说明的是DisplayText，因为有多种语言格式，需要从Menu Strings模块中选择正确语言的DisplayText Strings实际上是个表，在中的GetStringToBuffer()实现此

14、功能，大致过程是：在DrawSubMenuGroupType结构里添加指向定义在MenuStr.c里的各种字符串函数，返回定义在Strings.h里的对应字符串索引，该索引最终指向Strings.c里的某些字符表代码，最后当调用DrawOsdSubMenuGroup()时就显示出各种菜单信息。另外全局变量bCurrFontTableId表示当前使用哪种语言字库，使用OSD菜单下进行语系更改时改变其值，从而实现语言重载，显示出对应语系下的OSD信息。 D、菜单功能结构体：typedef struct fpAdjustValue AdjustFunction; /调整功能函数 fpExecFunc

15、 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按钮直接修改源码注意对应6X89平台format应该选择