HGE 系列教材（6） --- 程序流程与细节

HGE 的一些细节，通过源码可以更加清楚的了解，通过读源码，可以更加高效的使用 HGE Engine。

必要的第一步：

Help Classes 层建立于 Core Functions 层之上，这并不意味着用户只需要关心 Help Classes 而忽略 Core Functions，因此我们需要获得一个 HGE 指针，来使用 Core Functions 的函数：

<1> 获取 HGE 指针：

HGE* pHGE = pgeCreate(HGE_VERSION);

<2> 释放 HGE 指针：

使用之后，需要释放 HGE 指针。

pHGE->Release();

Create 和 Release 过程使用了引用计数，也就是说，一般来看，除了第一次的 Create 调用之外几乎不消耗CPU时间和资源，每调用一次 Create 函数，引用计数器就加一，只有在第一次调用的时候才会真正的分配空间，调用 Release 会使得引用计数器减一，当它为 0 的时候，才真正是释放资源。因此以下代码是可用的：

while(true)

{

    HGE* pHGE = pgeCreate(HGE_VERSION);   // 确保不是第一次调用 pgeCreate 函数，因为如果是第一次调用，会分配内存。

    // ... do something

    pHGE->Release();

}

此外，要成对的调用 pgeCreate 和 Release 函数，每次调用 Release 之后，调用它的指针将被赋值为0，例如：

HGE* pHGE = hgeCreate(HGE_VERSION);

pHGE->Release();

pHGE->Release(); // ERROR: pHGE == 0

另外，pHGE->Release 会调用 pHGE->System_Shutdown();

必要的第二步：

初始化： pHGE->System_Initiate();

初始化语句放在 Windows 入口函数中，这个函数将按顺序完成

1）窗口类的注册

2）创建窗口

3）初始化子系统

4）显示一个 HGE 的 LOGO（这个东西在 HGE 里面被称之为 HGE splash）

一般使用 System_Initiate() 都会是这样的：
    if (pHGE->System_Initiate())
    {
        pHGE->System_Start();
    }
    else
    {
        MessageBox(NULL, pHGE->System_GetErrorMessage(), "Error", MB_OK | MB_ICONERROR | MB_APPLMODAL);
    }

必要的第三步：

调用： pHGE->System_Start();

调用了 System_Start 的目的是开始消息循环，见必要的第二步代码

pHGE->System_Start 和 pHGE->System_Shutdown 是成对出现的，处于某些原因，即使我们知道 pHGE->Release 会调用 System_Shutdown 函数，我们还是应该去显示的调用 System_Shutdown 函数。System_Shutdown 相比 Release 要安全，我们可以这样调用，而不会出错：

pHGE->System_Start();

// ... Something

pHGE->System_Shutdown();

pHGE->System_Shutdown(); // OK

不论如何，Create 和 Release 成对调用，Start 和 Shutdown 成对调用，那么就不会有问题出现。

还有什么是需要的？

System_SetState 函数

常常需要设置窗口大小或者是设置为全屏模式，需要设置是否使用声音等，这一系列操作被称之为设置系统状态，统一通过调用 pHGE->System_SetState 函数来完成，最为关键的是设置帧函数，调用了 pHGE->System_Start 之后，会在绘制每帧图像时调用帧函数。

pHGE->System_SetState(XXX, XXX) 通常可以在如何地方，如何情况下调用，不要认为它们只能在 pHGE->System_Initiate 之前调用

System_SetState 函数的第一个参数表示状态，在内部实现时，它是 FSM 的状态，而第二个参数表示值，通过这个函数，可以绑定状态和相关的值

补充一下，帧函数必须是一个全局函数，而不能是一个类的成员函数，并且帧函数的原型必须是：

bool FunName(void);

惯用法：

我们通常会在程序初始化之前设置状态，即在 System_Initiate 调用之前，例如：

int WINAPI WinMain( HINSTANCE hInstance,
                   HINSTANCE hPrevInstance,
                   LPSTR lpCmdLine,
                   int nShowCmd)
{
    pHGE->System_SetState(HGE_FRAMEFUNC, FrameFunc);
    pHGE->System_SetState(HGE_WINDOWED, true);
    pHGE->System_SetState(HGE_USESOUND, false);
    pHGE->System_SetState(HGE_TITLE, "HGE");
    pHGE->System_SetState(HGE_SHOWSPLASH, false); // 用于去除 LOGO

    if (pHGE->System_Initiate())
    {
        pHGE->System_Start();
    }
    else
    {
        MessageBox(NULL, pHGE->System_GetErrorMessage(), "Error", MB_OK | MB_ICONERROR | MB_APPLMODAL);
    }

    pHGE->System_Shutdown();
    pHGE->Release();

    return 0;
}