作者：寰子
來源：http://www.hgechina.com/
前言： 寫道:
無意中發現了hge中文社區，聽朋友介紹，認識了hge，然后開始對它進行研究，並使用hge開始制作游戲。
因為我所得的資料基本上都是來源於各位高手的無私翻譯，所以，我打算也做一些貢獻出來，在這里寫一篇hge的基礎教程，供剛接觸hge的朋友研究學習。
教程中可能會出現一些錯誤，請大家及時指正。由於我也是初學者，包括c++，也只是一個初學者，所以寫出的教程可能質量並不高，也請大家諒解。
另外，學習此教程需要c++的基本知識，不需要非常高深，只需要了解函數調用、結構體、枚舉、常量、變量、類的基本知識、函數指針等基本知識即可。
關於轉載：
本教程可以隨處轉載，我的名字就不用了，不過請著名來源於hgechina中文論壇：http://www.hgechina.com/，我們將對此表示感謝。
我使用的編譯器：
我使用的編譯器是microsoft的visual c++ 2005，但是visual c++ 6.0或者visual c++ 2003等visualstudio的c++編譯器都是可以使用hge的，另外，borlandc++也是可以使用hge的，本教程將使用visual studio 2005為大家做講解，如果有一些編譯器問題上的出入，請大家搜索或者提問解決。
hge基礎教程第一章：初識hge
c++有一個理念，我記得是在我看c++ primer學習時看到的，那就是一次代碼編寫，處處使用，所以，就出現了諸如dll,lib等便於大家使用的代碼庫。其思想基本就是把寫好的代碼打包，然后只要在工程中鏈接lib或dll，就可以使用dll或者lib中寫好的代碼，它們的出現，為資源共享創造了空前的便利。那么，hge也是貫徹這個思想的一個庫，它把directx進行封裝，方便大家使用，由於直接使用directx需要直接接觸其他硬件 上的東西，所以不利於入門，hge的出現，讓高效圖形編程成為了簡單的東西。
關於免費：
hge是一個完全免費的，並且開源的引擎，所以我們可以隨便使用在自己的商業或非商業項目，在此，我們也向hge的編寫者致敬。
激動人心的時刻：第一個hge程序。
創建工程：
我們在visual c++中新建一個win32工程，選擇win32控制台程序/win32 console，為你的項目起一個名字。選擇一個目錄保存你的項目，點擊確定-下一步。
選擇windows應用程序，並選擇“空項目”/“empty project”。點擊確定，工程創建完畢，項目文件和代碼就保存在剛才你選擇的目錄里。
工程的設置：
創建好工程后，我們需要進行一些設置，在左邊的解決方案 管理器中，看到你的項目名稱，點右鍵，選擇【屬性r】
打開屬性窗口后，點擊c/c++，將右邊的附加包含目錄設置到你存放hge引擎頭文件的目錄下，一般情況下，下載了hge引擎解壓后，在hge目錄下的include目錄下。
設置完成后，再雙擊左邊的鏈接器，打開子選項后，點【常規】，右邊的附加庫目錄，選到hge目錄下的lib/vc/目錄
再點擊左邊的
此文來自: 馬開東博客 轉載請注明出處 網址： http://www.makaidong.com
【輸入】，右邊附加依賴項：hge.lib、hgehelp.lib
如此一來，工程就設置好了。
好了，我們首先創建一個任意名字的.cpp文件。敲入以下代碼：
另：解釋，我就不寫了，程序很簡短，注釋也很清楚。大家編譯即可創建出第一個hge程序了。怎么樣，很簡單吧！
代碼： 寫道:
#include "hge.h"//包含hge頭文件
hge *hge=0;//創建一個指向hge類的指針。
bool renderfunc()//繪制函數，程序開始后hge將不停調用它
{
return false;//程序正常時總是返回false，返回true將從system_start往下執行
}
bool framefunc()//邏輯函數，程序開始后hge將不停調用它，一些邏輯判斷或者處理可以寫在這里。
{
return false;//總是返回false
}
int winapi winmain(hinstance, hinstance, lpstr, int)//winmain函數，程序的入口。
{
hge=hgecreate(hge_version);//使用hgecreate函數創建hge接口，參數必須傳遞正確的hge_version,它是在hge.h中定義的
hge->system_setstate(hge_screenwidth, 800);//將屏幕寬度設置為800
hge->system_setstate(hge_screenheight,600);//將屏幕高度設置為600
hge->system_setstate(hge_framefunc, framefunc);//設置邏輯函數為framefunc函數
hge->system_setstate(hge_renderfunc,renderfunc);//設置繪制函數為renderfunc函數
hge->system_setstate(hge_title, "我的第一個hge程序");//設置窗口標題為“我的第一個hge程序”
hge->system_setstate(hge_windowed,true);//設置使用窗口模式
hge->system_setstate(hge_usesound,false);//設置不使用聲音（第一個程序我們先不講解聲音和圖像的知識）
if(hge->system_initiate())//用hge類的system_initiate()方法，檢測初始化是否有錯誤出現。
{
hge->system_start();//如果沒有問題，則使用system_start方法，開始程序。
}
hge->system_shutdown();//程序停止
hge->release();//釋放hge所占用的內存。
}
以上代碼應該比較簡單易懂，那么，我說一點小東西，是大家需要留意一下的。
一：請注意hge headfile和dll的版本匹配,如果兩個東西的版本不匹配的話，程序是會出錯的，舉個例子，比如你用了hge 1.7的頭文件，而使用hge 1.8的dll，那么就會報錯。
二：如果你發現了程序開始會有hge的logo，那么不用擔心，它並
此文來自: 馬開東博客 轉載請注明出處 網址： http://www.makaidong.com
不是需要付費才可以解除的，我們只需要加入這一句：h->system_setstate(hge_showsplash,false);即可解除掉程序開頭hge的logo。
三：關於framefunc和renderfunc的返回值，renderfunc需要一直返回false，這貌似是hge的一個規則，必須這么寫，但是framefunc就不一樣了，如果返回了true，程序就會從hge->system_start();函數下面繼續運行，運行到了shutdown，程序就結束了。所以，有時候返回true是結束程序的好方法，而不是隨地亂扔system_shutdown和system_release函數。
hge基礎教程第二章：可以看到的東西--圖像顯示
圖像顯示，是所有程序，包括windows操作系統在內必不可少的部分，代碼編寫者（程序員）將美工繪制好的圖像顯示到程序中，讓使用者更加直觀的看到程序的意圖。廢話就不多說了，這里我們來講一下在hge中，怎么顯示圖像，我相信跟我一樣，大多數朋友在剛剛接觸一個圖像引擎的時候最關心的就是這個部分。ok,我們看下去。
htexture：
這是hge中定義的一個數據類型，用來保存我們加載的圖像，texture的意思是“紋理”，說白了就是圖片，當然，當你的程序越來越復雜的時候，你會很樂意接受這種很規范的命名。我們現在只需要知道，這是一個數據類型，至於怎么把圖像加載、釋放、顯示，我們下面一一道來
屏幕上的精靈--hgesprite類：
精靈，看起來很有意思的名字，但是很簡單，它就是呈現圖像的一個工具，每一個精靈都有一些屬性，包括它的圖像，關於這個，可以在置頂貼中找到hgesprite類的全面資料。並且附加了代碼。
靈魂部分：代碼
說了那么多，不如一段代碼來的實在，同樣，我將保留以上簡潔明了的代碼風格，讓大家很方便的讀懂它，並且會有詳盡的注釋：
另外，請用具體的參數替代代碼中紅字部分
代碼： 寫道:
#include "hge.h"
#include "hgesprite.h"
hge *hge=0;//創建hge指針
hgesprite *spr;//創建精靈類指針
htexture tex;//定義一個texture(紋理)對象
bool renderfunc()//繪制函數，程序開始后hge將不停調用它
{
hge->gfx_beginscene();//開始渲染
hge->gfx_clear(0xff000000);//以某顏色清屏，oxff000000為透明度為0的黑色
spr->render(顯示位置x,顯示位置y);//在指定位置顯示精靈
hge->gfx_endscene();//結束渲染
return false;//總是返回false
}
bool framefunc()//邏輯函數，程序開始后hge將不停調用它，一些邏輯判斷或者處理可以寫在這里。
{
return false;//程序正常時總是返回false，返回true將從system_start往下執行
}
int winapi winmain(hinstance, hinstance, lpstr, int)//winmain函數，程序的入口。
{
hge=hgecreate(hge_version);//使用hgecreate函數創建hge接口，參數必須傳遞正確的hge_version,它是在hge.h中定義的
hge->system_setstate(hge_screenwidth, 800);//將屏幕寬度設置為800
hge->system_setstate(hge_screenheight,600);//將屏幕高度設置為600
hge->system_setstate(hge_framefunc, framefunc);//設置邏輯函數為framefunc函數
hge->system_setstate(hge_renderfunc,renderfunc);//設置繪制函數為renderfunc函數
hge->system_setstate(hge_title, "顯示圖像");//設置窗口標題為“顯示圖像”
hge->system_setstate(hge_windowed,true);//設置使用窗口模式
hge->system_setstate(hge_usesound,false);//設置不使用聲音（第二個程序我們先不講解聲音的知識）
if(hge->system_initiate())//用hge類的system_initiate()方法，檢測初始化是否有錯誤出現。
{
tex=hge->texture_load("圖片路徑和后綴，這里是相對目錄，vc++2005是debug目錄");//根據路徑載入圖片
if(tex)//檢測是否圖片成功載入
spr=new hgesprite(tex,圖片的顯示起始位置x,起始位置y,圖片寬,圖片高);//初始化精靈spr，並且指定tex為它的紋理
hge->system_start();//如果沒有問題，則使用system_start方法，開始程序。
}
hge->texture_free(tex);//釋放紋理
delete spr;//釋放精靈
hge->system_shutdown();//程序停止
hge->release();//釋放hge所占用的內存。
}
編譯運行代碼后，是不是看到你指定的圖片被顯示在了屏幕上呢？很簡單吧，游戲制作的第一步，就這樣輕松的被我們邁了出去。
寰子的話：凌晨1：30了，累死我了，我才發現寫教程不是最累的，最累的是排版……
hge基礎教程第三章：可以聽到的--聲音播放
heffect：
這是hge中的一個數據類型，就像htexture一樣，但是它是用來保存載入的聲音的，而htexture是用來載入保存的紋理（圖像）的。我們根據以上的一章，知道了載入紋理是需要用texture_load函數的，那么，針對heffect數據類型，也有一個函數用來專門載入聲音。
effect_load函數
這是一個有返回值的函數，返回的值便是一個heffect數據，於是，我們可以寫：snd=effect_load("source/music.mp3");
effect_free函數
這是一個沒有返回值的函數，看函數的名字，free，也就是釋放了，那么這個函數不難理解，就是釋放已經載入的聲音數據，作用基本同於delete。
effect_play函數
這個函數的返回值是一個陌生數據類型，這個數據類型叫做hchannel，什么意思呢？就是音軌的意思，我們知道，如果有5個同時播放而互不影
此文來自: 馬開東博客 轉載請注明出處 網址： http://www.makaidong.com
響的音樂，那么，它們處在5個不同的音軌上。那么，這里也會返回一個音軌，方便我們來對這個音軌上播放的文件進行操作，諸如：“暫停，播放，繼續，停止”等。
實例代碼：
以上簡單列舉了一下聲音播放要接觸到的幾個基本函數，當然，我們首先讓程序出聲就可以了，隨后再去考慮變調、變速、或者多軌混合等等這些東西。
代碼： 寫道:
#include "hge.h"
hge *hge=0;//創建hge指針
heffect snd;//定義一個effect(音效)對象
bool renderfunc()//繪制函數，程序開始后hge將不停調用它
{
return false;//總是返回false
}
bool framefunc()//邏輯函數，程序開始后hge將不停調用它，一些邏輯判斷或者處理可以寫在這里。
{
if(hge->input_getkeystate(hgek_a))//檢測是否按下了a鍵
hge->effect_play(snd);//如果按下了a鍵，則播放音樂snd
return false;//程序正常時總是返回false，返回true將從system_start往下執行
}
int winapi winmain(hinstance, hinstance, lpstr, int)//winmain函數，程序的入口。
{
hge=hgecreate(hge_version);//使用hgecreate函數創建hge接口，參數必須傳遞正確的hge_version,它是在hge.h中定義的
hge->system_setstate(hge_screenwidth, 800);//將屏幕寬度設置為800
hge->system_setstate(hge_screenheight,600);//將屏幕高度設置為600
hge->system_setstate(hge_framefunc, framefunc);//設置邏輯函數為framefunc函數
hge->system_setstate(hge_renderfunc,renderfunc);//設置繪制函數為renderfunc函數
hge->system_setstate(hge_title, "播放聲音");//設置窗口標題為“播放聲音”
hge->system_setstate(hge_windowed,true);//設置使用窗口模式
hge->system_setstate(hge_usesound,true);//設置使用聲音
if(hge->system_initiate())//用hge類的system_initiate()方法，檢測初始化是否有錯誤出現。
{
snd=hge->effect_load("聲音路徑和后綴，這里是相對目錄，vc++2005是debug目錄");//根據路徑載入聲音
if(snd)//檢測聲音是否已經載入成功
hge->system_start();//如果沒有問題，則使用system_start方法，開始程序。
}
hge->effect_free(snd);//釋放聲音資源
hge->system_shutdown();//程序停止
hge->release();//釋放hge所占用的內存。
}
這基本就是最簡單的聲音播放了，根據以上學過的知識，我再寫出幾個需要注意的東西，第三章就結束了：
1：使用hgesprite類，htexture，heffect數據類型時，都不要忘記在不需要的時候或者程序結束的時候進行釋放。
2：一定要在使用資源以前檢測資源是否被載入，否則在使用資源操作函數時程序會出錯退出。（如以上代碼中的if(tex)....）
hge基礎教程第四章：顯示順序的仲裁者--z-buffer
z-buffer：
z-buffer又被稱為深度緩沖，不要覺得深奧，我一一道破它的秘密。2d空間中，我們習慣了x,y兩軸的坐標，聰明的朋友可能一眼就知道z是用來做什么的，沒錯，既然非要給2d空間安上一個z坐標軸，那么它的作用，就是決定2d空間上的對象的前后順序，前面的擋住后面的。有人說了：那直接改變繪制順序不就好了，回答是：這樣的程序是在編譯時決定，而z，是在運行時決定，這就意味着程序的靈活性將又有一個質的飛躍，你覺得哪個好呢？
開啟2d空間中的第三根坐標軸：
不難發現，hgesprite也好，hgefont也好，都有一個方法：setz(float z);那么，可能有的朋友也試過，為啥不管用呢？可能你忽略了一步：打開z-buffer功能。如何打開呢？很簡單，在開始的時候，使用加上以下一句：
hge->system_setstate(hge_zbuffer,true);
這樣，z-buffer的功能就被啟用了。
z-buffer的范圍：
z-buffer雖然是一個float，但是，它的有效范圍只在0.0-1.0之間，至於為什么，我就不知道了，需要去問directx了，呵呵。在0.0-1.0這個范圍內，z值越小的對象，將被越靠前繪制，舉個例子：
兩個精靈，spritea，spriteb，他們的z值分別是0.1，0.2
這樣的話，不管你render的順序是什么，他們的覆蓋順序都是spritea覆蓋spriteb。
為什么要使用z-buffer：
本來我已經困了，打算明天再寫，不過想了想，這節也沒太多東西，一順兒寫完吧！
好，回歸正題。除了剛才說到的“編譯時決策”和“運行時決策”的問題，使用z-buffer又有一個好處，那就是它可以優化速度。拿剛才spritea和spriteb的例子來說，
如果按我們的老思路，如果要a覆蓋b，那么繪制的順序是：renderb,rendera，由遠及近，遠處的先畫，近處的后畫，近處的覆蓋遠處的，就成了一個覆蓋順序正確的圖像。那么，既然有了z-buffer，我么就要顛覆一下這套理論了，我們要先rendera，再renderb，為什么呢？因為當你rendera再renderb的時候，directx會自己判斷，有些地方已經有a的存在了，所以b就不需要在那些地方繪制東西了，直接跳過，小圖不說，如果是兩張滿屏的大圖呢？試想一下要節約多少fps？這樣的方法被稱為逆向畫家算法，但是，逆向畫家算法也不是隨便用的，必須要有z-buffer的支持，而且，最重要的是，z-buffer的順序要設置正確，比如，a覆蓋b，那么a的z值要比b小，也就是更靠前一些，然后顛倒正常的繪制順序，就達到了我們優化的目的。
說到這里，一定有人問了，能優化到什么程度呢？我說一下我的試驗吧，一張800*600的滿屏圖，前面5000個50*100的動畫小人不停走動，而且是每次都clear屏幕全部重繪的實時刷新，我是geforce go 7200的顯卡，fps達到了30+fps。拿hge帶的例子比較，我在我的機器上試了，它的小人比我的小，到2000個的時候，就是30fps，再往上就卡得要死了，當然，也是沒有經過任何優化，這么以來，大家比一比，結果就出來了。
以上的東西我已經盡力寫的很明白了，如果還有看不懂的就回帖提問吧！另外，畢竟我也是新手，老手勿笑！
hge基礎教程第五章：你需要知道的更多一些
hgesprite的常用方法之--sethotspot：
sprite，翻譯過來是精靈，它是為我們來呈現texture的一個類，開始在圖像顯示的時候我也在代碼里用到了這個類，這是我們在顯示圖像的時候經常用的東西，可能很多方法大家都不太了解，我現在說幾個常用實用的。首先，我們知道，圖像在屏幕上呈現的位置通常由一個坐標控制，這個坐標相對於屏幕左和上邊緣，那么，相對於圖像呢？可能有的人習慣認為圖像的坐標相對於圖像就是圖像左上角的位置了，但是又有的人習慣把圖像的中心作為這個決定位置的點，別怕，hgesprite都會滿足我們的要求，無論多么苛刻，那就是sethotspot方法，使用這個方法，你可以為你的精靈設置一個熱點，這個熱點，不僅僅決定了顯示坐標相對於圖像的位置，同時也決定了旋轉時的中心，可謂是非常實用了。
hgesprite的常用方法之--setcolor：
看名字就知道，是設置渲染色的，如果你設置一個紅色的渲染色，那么，圖像呈現出來就是帶着紅色渲染效果的，非常簡單，設置的方法很簡單，是一個dword 值，你可以理解為long，是這樣的格式:0xff00ff00，那么除去0x，前兩位ff是透明度，這里是16進制，后面的6位分別是r，g，b，ff就相當於我們平時的255了。但是這樣看起來可就太不方便了，那我們動用一下系統函數：argb()，傳遞給這個函數a,r,g,b，這4個參數，它就會反回一個相應的16進制數，那么，我們就可以這樣些：setcolor(argb(alpha,r,g,b));這樣看起來，是不是簡單多了呢？好了，先說這么兩個，說說其他。
如果我重新載入了texture呢？
我們前面可以看到，hgesprite是和htexture配套出現使用的，htexture是數據，而hgesprite負責呈現它們，那么如果重新載入了圖像呢？有的朋友會習慣性的學習new和delete使用時的方式，也就是要換，先調用hge->texture_free(tex)來釋放texture，然后再delete 精靈，其實是不用的，開始我也是這么寫的，但是經過站長vicky_lh指點，我們這樣寫就可以：第一，在更換texture的時候你只需要tex=hge->texture_load(path)即可，不需要free，其次，精靈更不需要delete，只有在對象被卸載，或者程序結束的時候，才需要這么做。
程序可能出錯，但是我想把錯誤寫到我的文件里去
如果我們設置了logfile，那么hge會把所有的錯誤記錄都會寫到這個log里，如果我們有了自己的需要，那么如何截獲hge發出的錯誤消息呢？使用這個方法：hge->system_geterrormessage()，它會返回一個char *，一個c風格字符串，里面就是程序到現在為止最后一條發生的錯誤信息。很方便吧？
我知道怎么播放音樂了，可是我該如何獲取音樂的長度、暫停、繼續等操作呢？
很簡單啦，可能你也注意到了，有channel_getlength、channel_isplaying等方法，可是怎么用呢？有朋友就問過我這個問題，我說一下如何解決，比如我們載入了一個heffect數據，並且播放了它，那么，在使用hge->effect_play()方法的時候，它會反悔一個hchannel數據，這個數據就是音軌數據，它返回了你這個音樂播放的音軌，我們要操縱這段音樂，就要靠音軌來操作，看代碼片段（這是不能直接編譯執行的，只是代碼片段）：
引用:
heffect snd;//聲音數據
hchannel channel;
snd=hge->effect_load("音樂路徑");