HGE学习随笔之一

 网页上提供了三个版本的HGE源码,既然是学习,那就从低版本开始吧.

下载解压后,很容易找到核心源码 hge16/src/core

根据文件名就很容易理解HGE的结构了

demo.cpp 明显是演示用的

graphics.cpp 图形显示.

ini.cpp 初始化

input.cpp  输入

random.cpp 随机数的生成

resource.cpp  资源

sound.cpp 声音

system.cpp 系统

timer.cpp 计时

一眼看上去就觉得结构很清晰.

这么多的.cpp,怎么才见到一个hge_impl.h呢?

原来这个头文件里这样写着 class HGE_Impl : public HGE,类里都是函数的声明.定义就都在上面的cpp里了.

上面的这个HGE类就是一个接口类,声明在hge16/include/hge.h中,里面写了所有的接口函数.

在core下还有两个文件夹,BASS和Zlib,前者是音效相关的,后者是个用来压缩和解压的库.

在 hge16/tutorials下提供了8个例子,在hge16/tutorials/precompiled下还提供了例子的可运行程序.

下面就是第一个例子:

 

/*
** Haaf's Game Engine 1.6
** Copyright (C) 2003-2006, Relish Games
** hge.relishgames.com
**
** hge_tut01 - Minimal HGE application
*/


#include "../../include/hge.h"

HGE *hge = 0;

// This function will be called by HGE once per frame.
// Put your game loop code here. In this example we
// just check whether ESC key has been pressed.
bool FrameFunc()
{
    // By returning "true" we tell HGE
    // to stop running the application.
    if (hge->Input_GetKeyState(HGEK_ESCAPE)) return true;

    // Continue execution
    return false;
}

int WINAPI WinMain(HINSTANCE, HINSTANCE, LPSTR, int)
{
    // Here we use global pointer to HGE interface.
    // Instead you may use hgeCreate() every
    // time you need access to HGE. Just be sure to
    // have a corresponding hge->Release()
    // for each call to hgeCreate()
    hge = hgeCreate(HGE_VERSION);

    // Set our frame function
    hge->System_SetState(HGE_FRAMEFUNC, FrameFunc);

    // Set the window title
    hge->System_SetState(HGE_TITLE, "HGE Tutorial 01 - Minimal HGE application");
    
    // Run in windowed mode
    // Default window size is 800x600
    hge->System_SetState(HGE_WINDOWED, true);

    // Don't use BASS for sound
    hge->System_SetState(HGE_USESOUND, false);

    // Tries to initiate HGE with the states set.
    // If something goes wrong, "false" is returned
    // and more specific description of what have
    // happened can be read with System_GetErrorMessage().
    if(hge->System_Initiate())
    {
        // Starts running FrameFunc().
        // Note that the execution "stops" here
        // until "true" is returned from FrameFunc().
        hge->System_Start();
    }
    else
    {    
        // If HGE initialization failed show error message
        MessageBox(NULL, hge->System_GetErrorMessage(), "Error", MB_OK | MB_ICONERROR | MB_APPLMODAL);
    }

    // Now ESC has been pressed or the user
    // has closed the window by other means.

    // Restore video mode and free
    // all allocated resources
    hge->System_Shutdown();

    // Release the HGE interface.
    // If there are no more references,
    // the HGE object will be deleted.
    hge->Release();

    return 0;
}

 

从运行的结果看,这就是一个显示一个简单的logo,然后按Esc或者程序右上角的X就可以退出.

首先就是创建一个接口对象

hge = hgeCreate(HGE_VERSION);

下面就是开始设置参数,然后初始化,接着就可以start了.当程序收到退出命令以后释放所有的资源.

最后就是hge->Release()