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

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步骤图

MstarOSD方案，感觉关键是在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 tblMenus[g_ucMenuPageIndex]

#define CURRENT_MENU_ITEMS CURRENT_MENU.MenuItems

#define CURRENT_MENU_ITEM_COUNT (CURRENT_MENU.MenuItemCount)

#define CURRENT_MENU_ITEM CURRENT_MENU_ITEMS[g_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 NaviAdjustKeyEvent[BTN_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.exeConvert Strings按钮直接修改源码（注意对应6X89平台format应该选择24X32），修改到源码文件是Strings.h、Strings.c及Strfont.c文件。

四、分析小结

经过以上分析，能够粗略看出MST 方案采取结构化、模块化OSD设计，其OSD信息包含：区域、图标、文字、进度条、数字、可选图标、导航信息等基础元素。另外，分析OSD菜单结构是定位和处理问题一个直观方法，判定问题发生在OSD菜单中某一选项对应功效，寻求出该菜单选项所调用接口功效函数，分析、修改功效函数，最终找出问题所在。

资料起源：我爱电子网