MST OSD 解析.doc

MSTOSD解析
一、OSD基本概念

UI语言：指OSD内容中的文字部分使用的语言类型；

UI模式：指OSD内容适用的环境，例如不同的信号源(TV、DVD、PC)带来的模式化其作用主要区分不同的环境下OSD的不同表现；

UI场景：特定语言模式下及较多信息页面情况下，当前OSD适用的特定页面；

UI事件：用户利用输入设备向UI系统提供的操作命令；

UI动作表：指在特定UI场景中，对于UI输入的命令进行对应处理的索引表；

OSD画布：指整个OSD呈现的区域，通常为一个矩形区域；

OSD位置：通常指在OSD画布中，相较左上角原点的相对位置；

OSD物件：呈现在画布上，表达特定信息，具有特定属性的像素组合。

二、MSTOSD流程图

Mstar的OSD方案，感觉主要是在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下的MenuItems

BYTEMenuItemCount;//该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_SOU