初探 HGE Core Functions 层4

HGE Core Functions 层中的函数需要通过 HGE 指针来访问，就如《HGE 系列教材（3） --- 初试 HGE》所谈到的一样，通过调用 hgeCreate 函数来初始化 HGE 指针，HGE Core Functions 层中的函数，大致分层一下几类：

1. 接口函数（Interface functions）：

hgeCreate --- 初始化 HGE 指针，这是一个全局函数，除了这个函数，HGE Core Funtions 中所有的函数都需要通过 HGE 指针调用。

Release --- 释放 HGE 接口，调用了 hgeCreate 就应该调用 Release 释放。

2. 系统函数（System functions）：

这类函数都是以 System_ 开头，后面加上表示函数意义的单词（不出现下划线），之后介绍的函数也将使用这种命名方式，即类型前缀 + 有意义的单词：

System_Initiate 初始化相关软件和硬件
System_Shutdown 恢复声音模式并且释放资源
System_Start 开始运行用户定义的帧函数
System_SetState 设置系统内部状态
System_GetState 返回内部状态的值
System_GetErrorMessage 返回最后出错的 HGE 错误描述符
System_Log 在日志文件中书写格式化消息
System_Launch 运行一个 URL 或者外部的可执行文件或数据文件
System_Snapshot 截屏并保存到一个文件

3. 资源函数（Resource functions）：

Resource_Load 从硬盘上读取资源到内存中
Resource_Free 从内存中删除读取的资源
Resource_AttachPack 附加一个资源包
Resource_RemovePack 移除一个资源包
Resource_RemoveAllPacks 移除之前关联的所有资源包
Resource_MakePath 建立一个绝对文件路径
Resource_EnumFiles 通过通配符来枚举文件
Resource_EnumFolders 通过通配符来枚举文件夹

4. 初始化文件函数（initialization file functions）

Ini_SetInt 在初始化文件中写入一个整数值
Ini_GetInt 从初始化文件中读取一个整数值
Ini_SetFloat 在初始化文件中写入一个浮点值（float）
Ini_GetFloat 从初始化文件中读取一个浮点值（float）
Ini_SetString 在初始化文件中写入一个字符串
Ini_GetString 从初始化文件中读取一个字符串

5. 随机数参数函数（Random number generation functions）

Random_Seed 设置随机数产生器的种子
Random_Int 产生 int 类型的随机数
Random_Float 产生 float 类型的随机数

6. 计时函数（Timer functions）

Timer_GetTime 返回从调用 System_Initiate 函数到现在所用的时间（单位为秒）
Timer_GetDelta 返回上一次调用帧函数到现在所用的时间（单位为秒）
Timer_GetFPS 返回当前 FPS 的值

7. 声效函数（Sound effect functions）

Effect_Load 载入从硬盘载入声音到内存
Effect_Free 从内存中删除载入的音效和相关的资源
Effect_Play 开始播放音效
Effect_PlayEx 开始播放音效，这个函数含有更多的参数