劍孤寒的小站

這篇教程將介紹如何用Galaxy2D游戲引擎構建一個最基礎的應用程序。

首先設置編譯環境：

1. 新建一個Win32項目，打開Galaxy2D引擎目錄，復制engine到當前項目目錄下。

2. 在項目屬性選項卡中的“附加包含目錄”中加入引擎頭文件目錄"engine/inc"。

3. 在“附加依賴項”中加入"engine/lib/galaxy2d.lib"。

4. 復制動態鏈接庫"engine/lib/galaxy2d.dll"至工作目錄。

接下來在當前工程新建一個main.cpp文件，把下面內容添加進去：

#include "ggebase.h"
using namespace gge;

//幀函數
bool Frame()
{
    //開始渲染
    if (Graph_BeginScene())
    {
        //清屏
        Graph_Clear();

        //畫一個矩形
        Graph_RenderQuad(300.0f, 220.0f, 340.0f, 260.0f);

        //結束渲染
        Graph_EndScene();
    }

    return false;
}

WINAPI WinMain(HINSTANCE, HINSTANCE, LPSTR, int)
{
    //創建游戲引擎
    if (!Engine_Create()) return 0;

    System_SetState(GGE_TITLE, "Galaxy2D Game Engine - Hello World");
    //設置幀函數
    System_SetState(GGE_FRAMEFUNC, Frame);
    //設置幀率
    System_SetState(GGE_FPS, 30);

    //系統初始化
    if (System_Initiate()) 
    {
        //開始運行幀函數
        System_Start();
    }

    //關閉引擎，釋放資源
    Engine_Release();
    return 0;
}

如果編譯成功運行該程序將會在屏幕中間顯示一個白色的方塊，現在我們回顧一下前面的代碼，看看Galaxy2D游戲引擎是如何運作的。

在WinMain()函數中首先調用Engine_Create()函數，這個函數將初始化游戲引擎運行環境以及進行一些基礎檢測。之后調用System_SetState()函數設置了一些引擎運行狀態，這些狀態后面會講到，然后就可以調用System_Initiate()進行引擎初始化。如果引擎初始化成功調用System_Start()函數，至此游戲引擎才真正開始運作。最后，在游戲引擎關閉時必須調用Engine_Release()做一些清理工作。

在引擎初始化之前我們設置了三個狀態，首先是“GGE_TITLE”，這個狀態設置的是程序標題欄文字；然后是“GGE_FRAMEFUNC”，這個狀態設置幀函數，也就是游戲的主循環；最后是“GGE_FPS”，這個狀態告訴引擎主循環將以30fps的幀率運行，減小CPU占用率。需要注意的是“GGE_FRAMEFUNC”和“GGE_FPS”是可以在運行時更改的，而“GGE_TITLE”一旦系統初始化完畢就無法更改了，詳細信息可以查看引擎文檔。

為了在屏幕中間畫一個白色的方塊，在幀函數Frame()里做了如下工作。首先調用Graph_BeginScene()函數告訴引擎要開始畫東西了，如果該函數返回true表示引擎已準備好，接下來調用Graph_Clear()清屏，然后用Graph_RenderQuad()函數畫矩形，最后調用Graph_EndScene()告訴引擎東西全都畫完了。