HGE教程翻译（6）

Tutorial 06 – 创建菜单

 

这个教程显示如何创建通用的GUI控制和菜单。

创建通用控制

首先我们定义控制类，从hgeGUIObject继承：

 

class hgeGUIMenuItem : public hgeGUIObject
     

{
     

public:
     

  hgeGUIMenuItem(int id, hgeFont *fnt, HEFFECT snd,
     

          float x, float y, float delay, char *title);
     

  virtual void  Render();
     

  virtual void  Update(float dt);
     

  virtual void  Enter();
     

  virtual void  Leave();
     

  virtual bool  IsDone();
     

  virtual void  Focus(bool bFocused);
     

  virtual void  MouseOver(bool bOver);
     

  virtual bool  MouseLButton(bool bDown);
     

  virtual bool  KeyClick(int key, int chr);
     

private:
     

  hgeFont       *fnt;
     

  HEFFECT       snd;
     

  float         delay;
     

  char          *title;
     

  hgeColor      scolor, dcolor, scolor2, dcolor2, color;
     

  hgeColor      sshadow, dshadow, shadow;
     

  float         soffset, doffset, offset;
     

  float         timer, timer2;
     

};
     

 

构造函数初始化数据成员id, bStatic, bVisible, bEnabled 和rect：

 

hgeGUIMenuItem::hgeGUIMenuItem(int _id, hgeFont *_fnt,
     

                HEFFECT _snd, float _x, float _y,
     

                float _delay, char *_title)
     

{
     

  id=_id;
     

  fnt=_fnt;
     

  snd=_snd;
     

  delay=_delay;
     

  title=_title;
     

  color.SetHWColor(0xFFFFE060);
     

  shadow.SetHWColor(0x30000000);
     

  offset=0.0f; timer=-1.0f; timer2=-1.0f;
     

  bStatic=false; bVisible=true; bEnabled=true;
     

  float w=fnt->GetStringWidth(title);
     

  rect.Set(_x-w/2, _y, _x+w/2, _y+fnt->GetHeight());
     

}
     

 

Render函数是重点，每个控制都要定义它。

 

void hgeGUIMenuItem::Render()
     

{
     

  fnt->SetColor(shadow.GetHWColor());
     

  fnt->Render(rect.x1+offset+3, rect.y1+3, HGETEXT_LEFT, title);
     

  fnt->SetColor(color.GetHWColor());
     

  fnt->Render(rect.x1-offset, rect.y1-offset, HGETEXT_LEFT, title);
     

}
     

 

所有其他方法都是可选的，你可以不定义。

Update在每次GUI更新并需要渲染时调用。在这例子中我们有两个定时器根据时间调节颜色和位置，

 

void hgeGUIMenuItem::Update(float dt)
     

{
     

  if(timer2 != -1.0f)
     

  {
     

    timer2+=dt;
     

    if(timer2 >= delay+0.1f)
     

    {
     

      color=scolor2+dcolor2;
     

      shadow=sshadow+dshadow;
     

      offset=0.0f;
     

      timer2=-1.0f;
     

    }
     

    else
     

    {
     

      if(timer2 < delay) { color=scolor2; shadow=sshadow; }
     

      else {
     

        color=scolor2+dcolor2*(timer2-delay)*10;
     

        shadow=sshadow+dshadow*(timer2-delay)*10;
     

      }
     

    }
     

  }
     

  else if(timer != -1.0f)
     

  {
     

    timer+=dt;
     

    if(timer >= 0.2f)
     

    {
     

      color=scolor+dcolor;
     

      offset=soffset+doffset;
     

      timer=-1.0f;
     

    }
     

    else
     

    {
     

      color=scolor+dcolor*timer*5;
     

      offset=soffset+doffset*timer*5;
     

    }
     

  }
     

}
     

 

Enter在GUI将要出现在屏幕上时调用。一个控制动画应该在这里进入：

 

void hgeGUIMenuItem::Enter()
     

{
     

  hgeColor tcolor2;
     

  scolor2.SetHWColor(0x00FFE060);
     

  tcolor2.SetHWColor(0xFFFFE060);
     

  dcolor2=tcolor2-scolor2;
     

  sshadow.SetHWColor(0x00000000);
     

  tcolor2.SetHWColor(0x30000000);
     

  dshadow=tcolor2-sshadow;
     

  timer2=0.0f;
     

}
     

 

Leave在GUI要从屏幕消失时调用。

 

void hgeGUIMenuItem::Leave()
     

{
     

  hgeColor tcolor2;
     

  scolor2.SetHWColor(0xFFFFE060);
     

  tcolor2.SetHWColor(0x00FFE060);
     

  dcolor2=tcolor2-scolor2;
     

  sshadow.SetHWColor(0x30000000);
     

  tcolor2.SetHWColor(0x00000000);
     

  dshadow=tcolor2-sshadow;
     

  timer2=0.0f;
     

}
     

 

IsDone用来检测这个控制是否完成Enter/Leave动画。完成返回true。

 

bool hgeGUIMenuItem::IsDone()
     

{
     

  if(timer2==-1.0f) return true;
     

  else return false;
     

}
     

 

Focus当控制获得或失去键盘输入焦点时调用。

 

void hgeGUIMenuItem::Focus(bool bFocused)
     

{
     

  hgeColor tcolor;
     

  if(bFocused)
     

  {
     

    hge->Effect_Play(snd);
     

    scolor.SetHWColor(0xFFFFE060);
     

    tcolor.SetHWColor(0xFFFFFFFF);
     

    soffset=0;
     

    doffset=4;
     

  }
     

  else
     

  {
     

    scolor.SetHWColor(0xFFFFFFFF);
     

    tcolor.SetHWColor(0xFFFFE060);
     

    soffset=4;
     

    doffset=-4;
     

  }
     

  dcolor=tcolor-scolor;
     

  timer=0.0f;
     

}
     

 

MouseOver用来通知鼠标指针进入或离开它的区域。这里我们只设置输入焦点到控制当鼠标经过它时。

 

void hgeGUIMenuItem::MouseOver(bool bOver)
     

{
     

  if(bOver) gui->SetFocus(id);
     

}
     

 

MouseLButton当左键状态改变时调用。如果控制改变它的状态并希望通知调用者，应该返回true：

 

bool hgeGUIMenuItem::MouseLButton(bool bDown)
     

{
     

  if(!bDown)
     

  {
     

    offset=4;
     

    return true;
     

  }
     

  else 
     

  {
     

    hge->Effect_Play(snd);
     

    offset=0;
     

    return false;
     

  }
     

}
     

 

KeyClick用来通知控制一个键被点击。如果控制改变它的状态并希望通知调用者，应返回true：

 

bool hgeGUIMenuItem::KeyClick(int key, int chr)
     

{
     

  if(key==HGEK_ENTER || key==HGEK_SPACE)
     

  {
     

    MouseLButton(true);
     

    return MouseLButton(false);
     

  }
     

  return false;
     

}
     

 

现在我们有通用的控制行为定义了。

使用GUI：

这里是简单部分。首先我们需要资源变量：

 

HEFFECT    snd;
     

HTEXTURE   tex;
     

hgeGUI     *gui;
     

hgeFont    *fnt;
     

hgeSprite  *spr;
     

 

WinMain中，在初始化过程中载入资源：

 

  snd=hge->Effect_Load("menu.wav");
     

  tex=hge->Texture_Load("cursor.png");
     

  fnt=new hgeFont("font1.fnt");
     

  spr=new hgeSprite(tex,0,0,32,32);
     

 

现在创建GUI并添加菜单部件。GUI控制在内部处理，你不需要关心。

 

  gui=new hgeGUI();
     

  gui->AddCtrl(new hgeGUIMenuItem(
     

               1,fnt,snd,400,200,0.0f,"Play"));
     

  gui->AddCtrl(new hgeGUIMenuItem(
     

               2,fnt,snd,400,240,0.1f,"Options"));
     

  gui->AddCtrl(new hgeGUIMenuItem(
     

               3,fnt,snd,400,280,0.2f,"Instructions"));
     

  gui->AddCtrl(new hgeGUIMenuItem(
     

               4,fnt,snd,400,320,0.3f,"Credits"));
     

  gui->AddCtrl(new hgeGUIMenuItem(
     

               5,fnt,snd,400,360,0.4f,"Exit"));
     

 

现在我们设置GUI模式，鼠标图象和默认键盘焦点，然后开始进入动画：

 

  gui->SetNavMode(HGEGUI_UPDOWN | HGEGUI_CYCLED);
     

  gui->SetCursor(spr);
     

  gui->SetFocus(1);
     

  gui->Enter();
     

 

现在看看我们如何更新菜单和接收通知。在FrameFunc中我们调用hgeGUI::Update来更新状态，它返回控制的鉴定值。如果所有的控制都完成离开动画，它返回-1。如果没有事情发生返回0。

 

  int id;
     

  static int lastid=0;
     

  float dt=hge->Timer_GetDelta();
     

  id=gui->Update(dt);
     

  if(id == -1)
     

  {
     

    switch(lastid)
     

    {
     

      case 1:
     

      case 2:
     

      case 3:
     

      case 4:
     

        gui->SetFocus(1);
     

        gui->Enter();
     

        break;
     

      case 5: return true;
     

    }
     

  }
     

  else if(id) { lastid=id; gui->Leave(); }
     

 

在RenderFunc中调用hgeGUI::Render来渲染菜单：

 

  hge->Gfx_BeginScene();
     

  gui->Render();
     

  hge->Gfx_EndScene();
     

 

菜单出现并运行。现在来到WinMain。程序结束时删除GUI并释放资源。

 

  delete gui;
     

  delete fnt;
     

  delete spr;
     

  hge->Texture_Free(tex);
     

  hge->Effect_Free(snd);