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

MstarOSD详解一、OSD基础概念UI语言：指OSD内容中文字部分使用语言类型；UI模式：指OSD内容适用环境，比如不一样信号源(TV、DVD、PC)带来模式化其作用关键区分不一样环境下OSD不一样表现；UI场景：特定语言模式下及较多信息页面情况下，目前OSD适用特定页面；UI事件：用户利用输入设备向UI系统提供操作命令；UI动作表：指在特定UI场景中，对于UI输入命令进行对应处理索引表；OSD画布：指整个OSD展现区域，通常为一个矩形区域；OSD位置：通常指在OSD画布中，相较左上角原点相对位置；OSD物件：展现在画布上，表示特定信息，含有特定属性像素组合。二、MSTOSD步骤图MstarOSD方案，感觉关键是在msosd.c(底层部分)，menu.c，menutbl.c这里，关键有MenuPageType、MenuItemType、DrawSubMenuGroupType、MenuItemFuncType等多个Stucture，菜单位置、大小及对应操作方法全部在结构体里；在Main循环程序中经过不停调用keyDetectHander()、irDecodeCommand()和OsdHandler()来达成OSD多种功效和目标。三、模块说明1、UserCommand这部分指是用户利用Keypad、Ir或VisualKey进行操作，产生中止触发激活KeyEvent；关键功效是在Irfunc.c、keyPad.c里完成，在keyDetectHandler()、irDecodeCommand()中取得相关按键信息，以后经过MenuProcessKey()、ExecuteKeyEvent()实施对应操作（包含画OSD和实施按键功效等）。这里比较关键是怎样将某状态下按键（如某一按键连续按两次或一直按下）转化成正确MenuItemActionType，因为全部按键最终全部会被转到ExecuteKeyEvent()进行处理，而ExecuteKeyEvent()正是依据不一样MenuItemActionType实现不一样功效；实现此功效关键在于所使用MenuStructure上，具体内容请参考MenuTable模块。2、DrawOSD在Global.h中定义部分和OSD相关全局变量（如：g_ucMenuPageIndex、g_ucMenuItemIndex、g_ucOsdTimeCounter等等），在UserCommand部分中若用户进行了不一样操作则会影响到这些变量，依据变量值不一样，OsdHandler()、DrawOsdMenu()、DrawOsdMenuPage()、DrawOsdSubMenuGroup()也就能够画出不一样OSD界面了；这多个函数大部分是在Menu.c里定义，实现这些函数功效则是依靠调用底层部分（msosd.c）多种功效函数，通常来讲，我们不需要更改底层内容。一样，实现多种OSD界面风格关键也是在于所使用MenuStructure上，所以，了解MenuDef.h中多种MenuStructure是学习整个MstarOSD结构关键。3、MenuTable这个很关键，了解了MenuStructure，整个OSD学习也就轻易多了，在MenuDef.h中定义以下多个结构：A、菜单页面结构体：typedefstruct{BYTEXSize,YSize;//定义MenuPage窗口大小（SetWindowSize）BYTEPrevMenuPage;//前一个MenuPage（场景）MenuItemType*MenuItems;//该MenuPage下MenuItemsBYTEMenuItemCount;//该MenuPage下MenuItems个数BYTEItemSelLength,ItemSubGroupSelLength;//Item及可选长度fpExecFuncExecFunction;//实施功效，如PowerOn/Off等//MenuFontType*Fonts;//关闭，临时未用BYTEFlags;//标志位，是否可见/保持}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中以下宏定义：#defineCURRENT_MENUtblMenus[g_ucMenuPageIndex]#defineCURRENT_MENU_ITEMSCURRENT_MENU.MenuItems#defineCURRENT_MENU_ITEM_COUNT(CURRENT_MENU.MenuItemCount)#defineCURRENT_MENU_ITEMCURRENT_MENU_ITEMS[g_ucMenuItemIndex]#defineCURRENT_MENU_ITEM_FUNCCURRENT_MENU_ITEM.KeyFunctionB、页面选项结构体：typedefstruct{BYTEXPos,YPos;//MenuItem区域BYTEUnSelColorType,SelColorType;//选中和未选中图标颜色模式BYTENextMenuPage;//下一个MenuPage（场景）DrawMenuTextTypeDrawItemMethod;//画Item方法，包含可选颜色、字体等fpDisplayTextDisplayText;//所要显示字符MenuItemActionType*KeyEvents;//按键触发事件类别（该MenuItem下各按键动作，导航信息）MenuItemFuncTypeKeyFunction;//所选Item对应功效DrawSubMenuGroupType*DrawSubMenuGroup;//画菜单方法//MenuFontType*Fonts;BYTEFlags;//该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），为MenuItemActionTypecodeNaviAdjustKeyEvent[BTN_ENDBTN]={MIA_POWER,//BTN_POWERMIA_SOURCE,//BTN_SOURCEMIA_INCVALUE,//BTN_RightMIA_GOTOPREV,//BTN_OsdMIA_PREVITEM,//BTN_UpMIA_NEXTITEM,//BTN_DownMIA_DECVALUE,//BTN_LeftMIA_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、菜单物件结构体：typedefstruct{BYTEFlags;//DrawSubMenuItemTextmethodBYTEUnSelColorType,SelColorType;//选中和未选中图标颜色样式BYTEXPos,YPos;//文本信息显示位置BYTELength;//选中/箭头等长度fpDisplayTextDisplayText;//所要显示文本信息fpGetValueGetValue;//获取数值，如OSD位置、透明度等}DrawSubMenuGroupType;这个部分要说明是DisplayText，因为有多个语言格式，需要从MenuStrings模块中选择正确语言DisplayTextStrings（实际上是个表），在String.c中GetStringToBuffer()实现此功效，大致过程是：在DrawSubMenuGroupType结构里添加指向定义在MenuStr.c里多种字符串函数，返回定义在Strings.h里对应字符串索引，该索引最终指向Strings.c里一些字符表代码，最终当调用DrawOsdSubMenuGroup()时就显示出多种菜单信息。另外全局变量bCurrFontTableId表示目前使用哪种语言字库，使用OSD菜单下进行语系更改时改变其值，从而实现语言重载，显示出对应语系下OSD信息。D、菜单功效结构体：typedefstruct{fpAdjustValueAdjustFunction;//调整功效函数fpExecFuncExecFunction;//实施功效函数}MenuItemFuncType;在Menu.c中ExecuteKeyEvent（）函数中判定菜单项功效，假如有对应功效便实施。4、MenuStrings表结构，关键定义在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文件后保留，使用Menu