HGE-1 图元和音效的使用

/*
** Haaf's Game Engine 1.8
** Copyright (C) 2003-2007, Relish Games
** hge.relishgames.com
**
** hge_tut02 - Using input, sound and rendering
*/


// 请从 "precompiled"文件夹下复制"particles.png"和"menu.wav"
// 到程序文件夹下.当然hge.dll和bass.dll也是需要复制的.

#include <hge.h>
#pragma comment(lib,"hge.lib")
HGE *hge=0;

// 四边形是HGE中用于渲染的基本元素(图元)
// 四边形有四个顶点,按顺时针方向分别标记为0,1,2,3
hgeQuad quad;

// 音效句柄
HEFFECT snd;

// 一些和程序运行有关的变量和常量
float x=100.0f, y=100.0f;
float dx=0.0f, dy=0.0f;

const float speed=90;
const float friction=0.98f;

// 这个函数根据图元位置和速度播放音效
void boom() 
{
    int pan=int((x-400)/4);
    float pitch=(dx*dx+dy*dy)*0.0005f+0.2f;
    hge->Effect_PlayEx(snd,100,pan,pitch);
}

bool FrameFunc()
{
    // 获取上一帧到这一帧的时间.
    // 用这个时间来计时有利于在不同的机器条件和视频模式下得到同样的结果
    float dt=hge->Timer_GetDelta();

    // 检查按键
    if (hge->Input_GetKeyState(HGEK_ESCAPE)) return true;
    if (hge->Input_GetKeyState(HGEK_LEFT)) dx-=speed*dt;
    if (hge->Input_GetKeyState(HGEK_RIGHT)) dx+=speed*dt;
    if (hge->Input_GetKeyState(HGEK_UP)) dy-=speed*dt;
    if (hge->Input_GetKeyState(HGEK_DOWN)) dy+=speed*dt;

    // 做一些运动计算和碰撞判断    
    dx*=friction; dy*=friction; x+=dx; y+=dy;
    if(x>784) {x=784-(x-784);dx=-dx;boom();}
    if(x<16) {x=16+16-x;dx=-dx;boom();}
    if(y>584) {y=584-(y-584);dy=-dy;boom();}
    if(y<16) {y=16+16-y;dy=-dy;boom();}

    // 设置图元的屏幕坐标(x,y)
    quad.v[0].x=x-16; quad.v[0].y=y-16;
    quad.v[1].x=x+16; quad.v[1].y=y-16;
    quad.v[2].x=x+16; quad.v[2].y=y+16;
    quad.v[3].x=x-16; quad.v[3].y=y+16;

    // 继续循环
    return false;
}

// 这个函数将会在屏幕需要被重绘的时候被HGE引擎调用
// 在这里写一些渲染屏幕的代码,这是上一个教程中没有的函数
// 因为上一个教程不需要进行渲染工作
bool RenderFunc()
{
    // 开始渲染图元.
    // 这个函数必须在实际渲染之前被调用,
    // 以初始化渲染环境
    hge->Gfx_BeginScene();

    // 用黑色填充屏幕
    // 在渲染之前做这一步的目的在于避免这一次的渲染
    // 和上一次的渲染的颜色产生重叠
    hge->Gfx_Clear(0);

    // 渲染图元.
    // 这一个函数已经足够满足我们现在的需求
    hge->Gfx_RenderQuad(&quad);

    // 结束渲染以及更新屏幕
    // 这个函数和Gfx_BeginScene()函数对称出现
    // 两个函数中间则为实际的渲染代码
    hge->Gfx_EndScene();

    // 渲染函数总是返回false
    return false;
}


int WINAPI WinMain(HINSTANCE, HINSTANCE, LPSTR, int)
{
    // 获得HGE接口
    hge = hgeCreate(HGE_VERSION);

    // 设置log文件, 帧函数, 渲染函数以及窗口标题
    hge->System_SetState(HGE_LOGFILE, "hge_tut02.log");
    hge->System_SetState(HGE_FRAMEFUNC, FrameFunc);
    hge->System_SetState(HGE_RENDERFUNC, RenderFunc);
    hge->System_SetState(HGE_TITLE, "HGE Tutorial 02 - Using input, sound and rendering");

    // 设置视频模式
    hge->System_SetState(HGE_WINDOWED, true);
    hge->System_SetState(HGE_SCREENWIDTH, 800);
    hge->System_SetState(HGE_SCREENHEIGHT, 600);
    hge->System_SetState(HGE_SCREENBPP, 32);

    if(hge->System_Initiate())
    {
        // 加载声音和纹理
        snd=hge->Effect_Load("menu.wav");
        quad.tex=hge->Texture_Load("particles.png");
        if(!snd || !quad.tex)
        {
            // 声音和纹理只要有一个没加载成功,
            // 就显示一个错误消息然后退出程序
            MessageBox(NULL, "Can't load MENU.WAV or PARTICLES.PNG", "Error", MB_OK | MB_ICONERROR | MB_APPLMODAL);
            hge->System_Shutdown();
            hge->Release();
            return 0;
        }

        // 设置图元在渲染中的融合特性
        quad.blend=BLEND_ALPHAADD | BLEND_COLORMUL | BLEND_ZWRITE;

        for(int i=0;i<4;i++)
        {
            // 设置顶点的z坐标
            quad.v[i].z=0.5f;
            // 设置颜色,颜色值使用X8R8G8B8的格式
            quad.v[i].col=0xFFFFA000;
        }

        // 设置图元的纹理坐标(tx,ty),注意和图元的屏幕坐标的区别.
        // 0.0,0.0 表示纹理左上角,
        // 1.0,1.0 表示纹理右下角.
        quad.v[0].tx=96.0/128.0; quad.v[0].ty=64.0/128.0; 
        quad.v[1].tx=128.0/128.0; quad.v[1].ty=64.0/128.0; 
        quad.v[2].tx=128.0/128.0; quad.v[2].ty=96.0/128.0; 
        quad.v[3].tx=96.0/128.0; quad.v[3].ty=96.0/128.0; 

        // 会在这里执行循环,上一教程中已经说明了.
        hge->System_Start();

        // 释放纹理和音效
        hge->Texture_Free(quad.tex);
        hge->Effect_Free(snd);
    }
    else MessageBox(NULL, hge->System_GetErrorMessage(), "Error", MB_OK | MB_ICONERROR | MB_SYSTEMMODAL);

    // 最后的清理以及退出
    hge->System_Shutdown();
    hge->Release();
    return 0;
}