HGE 系列教材(3) --- 初试 HGE

当 HGE 安装完成之后,就可以使用了,关于 HGE 的安装,可以参考《HGE 系列教材(2) --- 安装 HGE

现在使用 HGE 开发一个极小的程序:

1. 包含 hge.h 文件,并且定义一个 HGE 的指针,通过这个指针,我们可以访问 HGE Core Functions 层的函数。

    #include <hge.h>

    HGE *pHge = 0;

使用完 HGE 指针之后,需要释放这个指针,pHGE->Release();

2. 帧函数(Frame Function)是一个用户定义的函数,每一帧时间,它会被 HGE Engine 调用一次,函数返回 true,则调用停止:

    bool FrameFunc()

    {

       if (hge->Input_GetKeyState(HGEK_ESCAPE))

       {

          return true;

       }

       return false;

    }

3. 建立一个 WinMain 函数,WinMain 函数是标准的 Windows 应用程序入口,这里,我们首先初始化 HGE 指针:

    int WINAPI WinMain( HINSTANCE hInstance,
                       HINSTANCE hPrevInstance,
                       LPSTR lpCmdLine,
                       int nShowCmd)
    {
        pHge = hgeCreate(HGE_VERSION);
        // ...

        pHge->Release();
        return 0;
    }

    通过 HGE 指针,我们才可以访问 HGE Engine 的接口。调用了 hgeCreate 函数之后,不要忘记了使用 Release 函数释放资源。

4. 初始化操作:

有一些初始化操作需要完成,使得程序能够跑起来:

    // 设置帧函数

    pHge->System_SetState(HGE_FRAMEFUNC, FrameFunc);

    // 设置窗口模式
    pHge->System_SetState(HGE_WINDOWED, true);

    // 设置不使用声音
    pHge->System_SetState(HGE_USESOUND, false);

    // 设置标题为 "Minimal HGE"
    pHge->System_SetState(HGE_TITLE, "Minimal HGE");

最后需要调用函数 System_Initiate 来完成初始化操作,这个函数返回值是一个 bool 类型的变量,如果是 true 那么表示初始化成功,如果是 false 表示出错,这时候可以通过 System_GetErrorMessage 函数来获取错误消息:

    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();

5. 整个完整的程序如下:

#include <hge.h>

HGE* pHge = 0;

bool FrameFunc()
{
    if (pHge->Input_GetKeyState(HGEK_ESCAPE))
    {
        return true;
    }
    return false;
}

int WINAPI WinMain( HINSTANCE hInstance,
                   HINSTANCE hPrevInstance,
                   LPSTR lpCmdLine,
                   int nShowCmd)
{
    pHge = hgeCreate(HGE_VERSION);
    pHge->System_SetState(HGE_FRAMEFUNC, FrameFunc);
    pHge->System_SetState(HGE_WINDOWED, true);
    pHge->System_SetState(HGE_USESOUND, false);
    pHge->System_SetState(HGE_TITLE, "HGE小程序");

    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;
}

注意,程序运行之后,一直调用函数 FrameFunc 直到用户按下 ESC,那么跳到 pHge->System_Shutdown() 处执行。 

  • 0
    点赞
  • 2
    收藏
    觉得还不错? 一键收藏
  • 1
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值