HGE 系列教材(6) --- 程序流程与细节

简介: HGE 的一些细节,通过源码可以更加清楚的了解,通过读源码,可以更加高效的使用 HGE Engine。 必要的第一步: Help Classes 层建立于 Core Functions 层之上,这并不意味着用户只需要关心 Help Classes 而忽略 Core Functions,因此我们需要获得一个 HGE 指针,来使用 Core Functions 的函数: <1&gt

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

相关文章
|
域名解析 弹性计算 运维
【运维】阿里云宝塔面板域名DNS解析(如何配置用域名访问网站)
【运维】阿里云宝塔面板域名DNS解析(如何配置用域名访问网站)
6365 0
【运维】阿里云宝塔面板域名DNS解析(如何配置用域名访问网站)
|
自然语言处理 Ubuntu 安全
14个你必须要知道的ubuntu快捷键
14个你必须要知道的ubuntu快捷键
14个你必须要知道的ubuntu快捷键
|
8月前
|
人工智能 Unix Java
[oeasy]python059变量命名有什么规则_惯用法_蛇形命名法_name_convention_snake
本文探讨了Python中变量命名的几种常见方式,包括汉语拼音变量名、蛇形命名法(snake_case)和驼峰命名法(CamelCase)。回顾上次内容,我们主要讨论了使用下划线替代空格以提高代码可读性。实际编程中,当变量名由多个单词组成时,合理的命名惯例变得尤为重要。
332 9
|
应用服务中间件 nginx
typecho——typecho如何开启伪静态
typecho——typecho如何开启伪静态
140 0
|
移动开发 JSON 前端开发
跨域资源共享(CORS):详解跨域请求的限制与解决方法
跨域资源共享(CORS):详解跨域请求的限制与解决方法
|
12月前
|
Unix Linux 开发工具
centos的官网下载和vm16虚拟机安装centos8【保姆级教程图解】
本文详细介绍了如何在官网下载CentOS 8以及在VMware Workstation Pro 16虚拟机上安装CentOS 8的步骤,包括可能出现的问题和解决方案,如vcpu-0错误的处理方法。
centos的官网下载和vm16虚拟机安装centos8【保姆级教程图解】
|
安全 网络安全 网络虚拟化
|
人工智能 Java 开发者
Python与Java:两大编程语言的联系与区别
Python与Java:两大编程语言的联系与区别
298 2
|
缓存 负载均衡 Linux
获取真实 IP 地址(一):判断是否使用 CDN(附链接)
获取真实 IP 地址(一):判断是否使用 CDN(附链接)
|
存储 供应链 大数据
大数据时代的机遇与挑战
大数据时代的机遇与挑战