3 HGE 核心 层介绍

HGE 核心层介绍

HGE Core Functions 层中的函数需要通过 HGE 指针来访问，通过调用 hgeCreate 函数来初始化 HGE 指针，HGE Core Functions 层中的函数，大致分层一下几类：

1 接口函数(Interface functions)

hgeCreate 从HGE接口返回一个指针.

Release 释放获得的HGE接口.

2 系统函数(System functions)

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 将浮点型值写入初始化文件.

Ini_GetFloat 从初始化文件中读取一个浮点行值.

Ini_SetString 将一个字符串写入初始化文件.

Ini_GetString 从初始化文件中读取一个字符串值.

5 随机数生成函数(Random number generation functions)

Random_Seed 确立随机发生数的种子.

Random_Int 获得一个整型随机数.

Random_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 根据指定的参数开始播放声音效果.

8 音乐函数(Music functions)

Music_Load 从磁盘或内存加载音乐.

Music_Free 删除已经加载的音乐和相关联的资源.

Music_Play 开始播放音乐.

9 压缩音频流函数(Compressed audio stream functions)

Stream_Load 从磁盘或内存加载数据流.

Stream_Free 删除已经加载的数据流和相关联的资源. Stream_Play 开始播放数据流.

10 音轨函数(Audio channel functions)

Channel_SetPanning 改变音轨面板.

Channel_SetVolume 改变音轨音量.

Channel_SetPitch 改变音轨的音高.

Channel_Pause 暂停音轨.

Channel_Resume 重新开始一个暂停的音轨.

Channel_Stop 停止一个音轨.

Channel_StopAll 停止全部活动的音轨.

Channel_IsPlaying 测试音轨是否正在播放.

Channel_SetPos 对正在播放的音轨进行快进或快退. Channel_GetPos 取回正在播放的音轨的位置.

Channel_GetLength 取回正在播放的音轨的总长度.

11 输入函数(Input functions)

Input_GetMousePos 返回当前鼠标光标的坐标.

Input_SetMousePos 设置当前鼠标光标的坐标.

Input_GetMouseWheel 在调用框架函数之前返回鼠标滚轮是否移动. Input_IsMouseOver 测试鼠标光标是否没有在HGE窗口内部. Input_GetKeyName 从代码中返回一个键名或鼠标按钮名.

Input_GetKeyState 测试按键或鼠标按钮是否按下.

Input_GetKey 返回调用框架函数之后最后按下的键.

Input_GetChar 返回调用框架函数之后最后按下的键的字符. Input_GetEvent 从队列中获得下一个输入事件.

12 图形函数(Graphics functions)

Gfx_BeginScene 开始渲染图形.