cSparrowApp类以及IO事件处理

1、cSparrowApp类的设计

cSparrowApp类是所有SPE应用程序的抽象基类，应用程序继承它之后可以重写它感兴趣的虚函数。cSparrowApp类定义了下面这些虚函数，

virtual void OnInit(){}
virtual void OnExit(){}
virtual bool OnKeyDown(Key key){return false;}
virtual bool OnMouse(MouseState mstate,int x,int y) {return false;}
virtual bool OnMouseMove(MouseState mstate,int x,int y){return false;}
virtual void OnResize(int width,int height){}
virtual void OnFrameMove(float appTime,float elapsedTime){};
virtual void OnFrameRender() = 0;

里面除了惟一的一个纯虚函数OnFrameRender()必须重新实现外，其他都可以有选择地实现。

应用程序端的所有初始化操作可以放到OnInit()中，所有的收尾操作如释放资源等可以放到OnExit()中，它们分别会在窗口创建以及窗口销毁时被调用一次。

应用程序可以通过上面第3、4和5个函数来处理键盘和鼠标事件，当某个键被按下时，OnKeyDown()会被调用，当鼠标被按下或放开时OnMouse()会被调用，当鼠标滚轮滚动或按住某个键移动时，OnMouseMove()会被调用；其中Key，MouseState是引擎定义的枚举类型，应用程序可以通过它们获得具体的事件信息。这三个函数都返回一个布尔类型的变量，用来指示应用程序是否处理了该事件。

应用程序端的逻辑控制以及计算如物理运算可以放到OnFrameMove()函数当中，它有两个参数，appTime表示自应用程序启动至现在经历的时间，elapsedTime表示自上一帧开始经历的时间，都以毫秒为单位，OnFrameMove会在OnFrameRender()调用之前被调用一次。

几何信息的绘制，以及一些渲染效果的实现可以放到OnFrameRender()中。

OnResize()在窗口大小被改变时会被调用，在函数中可以更新投影矩阵或控件的大小位置等。

一个完整的应用程序框架代码看起来像下面这样子：

class cMyApplication : public cSparrowApp
{
public:
	cMyApplication(int argc,char *argv[]) : cSparrowApp(argc,argv)
	{}
	void OnInit()
	{
		// init code here
	}
	void OnExit()
	{
		// uninit code here
	}
	bool OnKeyDown(Key key)
	{
		if (key == KEY_0)
		{
			// key handling code
			return true;
		}
		return false;
	}
	bool OnMouse(MouseState mstate,int x,int y) 
	{
		if (mstate == MOUSE_LEFT_UP)
		{
			// handle left mouse up
			return true;
		}
		return false;
	}
	bool OnMouseMove(MouseState mstate,int x,int y)
	{
		if (mstate == MOUSE_ROLL_FORWARD)
		{
			// handle mouse rolling forward
			return true;
		}
		return false;
	}
	void OnResize(int width,int height)
	{
		// handling window resizing
	}
	void OnFrameMove(float appTime,float elapsedTime)
	{
		// computing&updating code here
	}
	void OnFrameRender()
	{
		// rendering code here
	}
};

int main(int argc, char* argv[])
{
	cMyApplication app(argc,argv);

	cSparrowApp::GetAppRef().CreateRenderWindow("SparrowEngine Demo",0,0,600,600);
	cSparrowApp::GetAppRef().Run();

	return 0;
}

2、查询键盘状态

为了考虑效率，当一个键被一直按着时，键被按下事件不会频繁产生，也就是OnKeyDown()并不会被重复调用；但有的时候需要查询某个键是否处于按下状态，如第一人称摄像机用键盘控制的时候就需要，为此，SPE提供了一个KeyHandler类，里面有一个IsKeyDown()函数可用于查询某个常规键是否处于按下状态，若要查询控制键(如Ctrl,Shift,Alt)的状态可以使用IsCtrlActive(),IsShiftActive()以及IsAltActive()这三个函数；这几个函数原型为：

static bool IsCtrlActive()
static bool IsAltActive()
static bool IsShiftActive()

static bool IsKeyDown(Key key)

它们都是KeyHandler类中的静态函数。