GameUI

From Valve Developer Community
< Zh
Jump to: navigation, search
English (en)Deutsch (de)中文 (zh)Translate (Translate)
不要与 game_ui(en) 实体混淆

GameUI 是提供 VGUI(en) 'frontend': broadly speaking, 主菜单还有加载界面的代码。

GameUI panels are children of their own dedicated panel ("GameUI Panel"). 客户端的 RootPanel(en) 只用于游戏里的HUD元素。

Source 2009

Source 2009(en) GameUI. Closed source.

In the original branches of Source (from Episode One(en) to The Orange Box(en)), GameUI is a closed engine library manipulable to a limited extent by editing .res(en) script files. These define properties like width, height, element location, and so on. You can add new non-interactive elements, and with a bit of effort hide existing ones.

It is possible to create new VGUI panels(en) that behave in exactly the same way as GameUI ones. Starting with Source 2013(en) (which uses elements from Team Fortress 2(en)), such panels can override(en) the default main menu with four new functions included in IGameUI(en).

Left 4 Dead

Left 4 Dead branch(en) GameUI. Alien Swarm's SDK provides the code.

The Alien Swarm SDK(en) contains the complete source for the newer L4D-style GameUI, which has been moved into the client library. It has been redesigned for consoles' lack of a pointing device: everything is integrated into the same navigable menu system, and you can't be in more than area at once. It's also far, far easier to program.

Tip.png提示:VGUI panels very similar to Source 2009 ones can still be created with this incarnation of the code.

创建一个新的窗口

  1. 新建一个类, 继承自 CBaseModFrame(en)
  2. game\resource\ui\basemodui\创建一个accompanying "<class name>.res" 脚本。
  3. WINDOW_TYPE 添加一个新的enum(【术语】枚举)
  4. Edit the enormous switch in CBaseModPanel::OpenWindow() to include your new enum and class.

The ugly enum/switch indirection is presumably designed to allow a single "window type" value to open slightly different window objects depending on the UI's state. Too bad Valve haven't found any excuse to do that yet!

Opening windows

Use CBaseModFrame* CBaseModPanel::OpenWindow():

#include "gameui\swarm\basemodpanel.h"

using namespace BaseModUI;

void openwindow()
{
	CBaseModFrame* mainMenu = CBaseModPanel::GetSingleton().GetWindow( WT_MAINMENU );
	CBaseModPanel::GetSingleton().OpenWindow( WT_GAMESETTINGS, mainMenu );
}

The arguments are:

WINDOW_TYPE &wt
An enum value that defines which precise window to open.
CBaseModFrame(en)* caller
The window which requested this one to open. Among other things, this becomes the target of 'back' buttons on the new window.
bool(en) hidePrevious
Hides caller if true.
KeyValues(en)* pParameters
Passed on to the new window.

OnOpen() is called on the opened window.

Startup

初始化顺序为:

  1. CGameUI::Initialize()
  2. CBaseModPanel::RunFrame()
  3. CBaseModPanel::OnGameUIActivated()
  4. CBaseModPanel::OpenFrontScreen()
  5. CBaseModPanel::OpenWindow()

CBaseModPanel is a singleton; CBaseModFrame 是所有窗口的基类。