教程不难，所以我翻译的很粗略：
Basic Qaf Application
It is assumed that you have some experience with the HGE library, and this tutorial will skip some of the more basic stuff.
这里假设你有使用HGE库的一些经验，这个教程会忽略一些基本的HGE技巧。
The first thing to do is to bring the Qaf namespace into the global scope：
第一件要做的事情是把Qaf名字空间放到全局作用域里：
using namespace qaf;
In the frame function, we'll just invoke Qaf's game loop:
然后在帧函数里，我们需要调用Qaf 的游戏循环：
HGE * hge = NULL;
// The frame function:
bool frameFunction () {
// Perform Qaf's game loop:
Environment::update( hge->Timer_GetDelta() );
if ( hge->Input_GetKeyState( HGEK_ESCAPE ) )
return true;
return false;
}
The "prologue function" is a callback used to notify your program that Qaf is about to begin its rendering operations. Here, we're just going to clear the screen and print some text with the debug console:
“序言函数”是一个回调函数，它在Qaf将要开始渲染的时候被调用。这里，我们只是简单地清除屏幕并利用调试控制台打印一些字符信息：
void prologueFunc () {
// Clear the screen:
hge->Gfx_Clear( 0 );
// Output text:
Environment::cout << "Hello, world!/n";
Environment::cout << hge->Timer_GetFPS() << " FPS/n";
}
In the main function, you must first set up HGE...
在主函数里，你需要首先设置HGE：
// Application entry point:
int WINAPI WinMain ( HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow ) {
hge = hgeCreate( HGE_VERSION );
hge->System_SetState( HGE_FRAMEFUNC, frameFunction );
hge->System_SetState( HGE_FPS, HGEFPS_UNLIMITED );
hge->System_SetState( HGE_SCREENWIDTH, 640 );
hge->System_SetState( HGE_SCREENHEIGHT, 480 );
hge->System_SetState( HGE_WINDOWED, true );
if ( !hge->System_Initiate() )
MessageBox( NULL, hge->System_GetErrorMessage(), "Error", MB_OK | MB_ICONERROR | MB_SYSTEMMODAL );
...And then initialize Qaf:
然后初始化Qaf：
Environment::initialize( false, true );
Here, we're telling Qaf not to create a backbuffer (the first parameter) and that we need to use the debug facilities (the second parameter). Don't worry too much about these; they will be explained in more detail in other tutorials.
这里，第一个参数告诉Qaf不要创建一个后台缓存，第二个参数使我们可以使用Qaf的调试工具。这里不需要太担心这些参数，稍侯我们会再讲到。
Then we tell Qaf which function it should use as the prologue callback:
然后我们告诉 Qaf 哪个函数被作为“序言函数”：
// Set the prologue function:
Environment::setPrologueCallback( prologueFunc );
When that's done, just start the game loop:
完成那一切之后，就可以开始游戏循环了：
if ( !hge->System_Start() ) {
MessageBox( NULL, hge->System_GetErrorMessage(), "Error", MB_OK | MB_ICONERROR | MB_SYSTEMMODAL );
}
After the game loop is finished, you simply shut down Qaf and HGE:
游戏循环结束后，你只需要简单地关闭Qaf和HGE:
Environment::shutdown();
hge->System_Shutdown();
hge->Release();
return 0;
}
Tutorial 2 - Creating and Loading a Room File
只需要用Qaf的RoomEditor编辑好Room文件，然后程序里一次载入，Qaf会自动地显示这个房间。
This is actually the easiest part. After initializing Qaf, you just need to tell it which room to load:
初始化Qaf后，你只需要告诉Qaf你要载入哪个房间即可：
// Set up the environment:
Environment::initialize( false, true );
// Load the room:
Environment::loadRoom( "tut02.qr" );
Tutorial 3 - Game Objects, Sprites and Scrolling
Every game object needs to have qaf::GameObj as its base class, so the missile class declaration should look like this:
游戏里所有的物体都需要从qaf::GameObj继承。--这样方便Qaf来控制所有物体，即把大部分逻辑问题交给游戏框架做，而不是客户程序员。
Finally, it's time to program the behavior of our missiles. The qaf::GameObj class doesn't do anything on its own, but it defines a set of methods you can override to implement objects' actions. In this tutorial, we will use two of them: update() and render().
我们需要为游戏里的物体加入具体的行为。Qaf::GameObj这个类本身没有加入任何有用的行为，但是它定义了一些你可以重载的接口。在这个教程里，我们将使用其中两个这样的接口：Update和Render。
显然，update是用来更新物体逻辑的，而render是用来渲染该物体的。
we're calling Environment::removeGameObj() with its second parameter set to true. This instructs the Environment to automatically delete the object at the end of the frame function.
当我们给Environment::removeGameObj()的第二个参数为TRUE时，Qaf会在帧结尾自动删除不需要的物体。
Tutorial 4 - Spawn Points and Factories
我们可以直接使用RoomEditor往房间文件里加入各种物体。当房间文件里有了物体数据后，我们需要在程序里来创建它们。
The Game Object Factory
qaf::GameObjFactory is an abstract class with just one method:
qaf::GameObjFactory是一个只有一个方法的抽象类：
qaf::GameObj* qaf::GameObjFactory::createObject ( std::string & objID,
int objX,
int objY,
qaf::AttributeTable & attributes );
Its parameters include everything you defined in the Room Editor: ID, position, and attributes. There's nothing Qaf can do with these values, so it's up to us to decode them and create a GameObj.
它的参数包含了你在RoomEditor里定义的所有参数：ID，位置，以及其他属性。Qaf并不能用那些值做什么，因此我们需要处理它们并创建游戏物体。
// Game object factory implementation:
class GameObjFactoryImpl : public GameObjFactory {
public:
GameObj * createObject ( std::string & objID, int objX, int objY, AttributeTable & attributes ) {
// Which object ID?
if ( objID == "ShipObj" ) {
// Create ship at (objX, objY) coordinates, facing up: