Nebula2探秘15-Simple Application Framework

Nebula2探秘15-Simple Application Framework

happykevins文

在经历了前14章的学习之后，本章将介绍一个简单的Nebula2应用程序框架nAppFrame。nAppFrame可以说是nApplication的最简化版本，去掉了状态机和所有不必要的Packages和Servers。nAppFrame的代码简单明了，易于使用，可以是省去每次重新创建Nebula2程序繁杂而枯燥的活动。
以下的示例代码就应用了nAppFrame，并挂载了Render2D和Render3D两个函数，Render3D什么事情都没做，读者有兴趣的话可以扩展该例子代码，例如显示个3D模型或骨骼动画之类的东东，当然这些内容我将在以后章节中介绍，请大家继续关注Nebula2探秘哦：）

开始贴代码，nAppFrame的代码：

/****************************************************************************/
/*Nebula2-TutorialnAppFrame*/
/*ASimpleProgramFramework*/
/*author:happykevins*/
/****************************************************************************/
#pragmaonce

//关闭讨厌的类型检查warning
#pragmawarning(disable:42444267)

#include"kernel/nkernelserver.h"
#include"kernel/nroot.h"
#include"kernel/nautoref.h"
#include"gfx2/ndisplaymode2.h"
#include"gfx2/ncamera2.h"
#include"tools/nmayacamcontrol.h"
#include"tools/nnodelist.h"

classnScriptServer;
classnGfxServer2;
classnInputServer;
classnConServer;
classnResourceServer;
classnSceneServer;
classnVariableServer;
classnAnimationServer;
classnParticleServer;
classnVideoServer;
classnGuiServer;
classnShadowServer2;
classnAudioServer3;
classnPrefServer;
classnLocaleServer;

//
//classnAppFrame
//仿照napplication制作的一个Nebula2应用程序框架，对初始化和运行做了减化
//只开启我认为必要的服务
//
classnAppFrame:publicnRoot
{
public:
typedefvoid(*nFunc)(void);

nAppFrame();
~nAppFrame();

///初始化Nebula2引擎
boolOpenNebula();
///关闭Nebula2引擎
boolCloseNebula();
///进入Nebula2引擎的主循环
voidRunNebula();

///用户可重载的初始化方法（在OpenNebula的最后被调用）
virtualboolClientOpen(){returntrue;}
///用户可重载的关闭方法（在CloseNebula之前被调用）
virtualboolClientClose(){returntrue;}

///在这里添加3D渲染代码
virtualvoidOnRender3D();
///在这里添加2D渲染代码
virtualvoidOnRender2D();
///在这里添加游戏逻辑代码
virtualvoidOnFrame();

///KernelServer
staticnKernelServer*ks;

///OnFrameFunctionHook
nFuncm_fpOnFrame;
///OnRender3DFunctionHook
nFuncm_fpOnRender3D;
///OnRender2DFunctionHook
nFuncm_fpOnRender2D;

///nNode节点列表
nNodeListm_nodes;

protected:

///摄像机控制代码（有默认实现，用户可重载）
virtualvoidOnCameraControll();

///Nebula2启动标志
boolisOpen;

///Servers
nAutoRef<nScriptServer>refScriptServer;
nAutoRef<nGfxServer2>refGfxServer;
nAutoRef<nInputServer>refInputServer;
nAutoRef<nConServer>refConServer;
nAutoRef<nResourceServer>refResourceServer;
nAutoRef<nSceneServer>refSceneServer;
nAutoRef<nVariableServer>refVariableServer;
nAutoRef<nGuiServer>refGuiServer;
nAutoRef<nShadowServer2>refShadowServer;
nAutoRef<nParticleServer>refParticleServer;
nAutoRef<nAnimationServer>refAnimationServer;

//nAutoRef<nVideoServer>refVideoServer;
//nAutoRef<nAudioServer3>refAudioServer;
//nAutoRef<nPrefServer>refPrefServer;
//nAutoRef<nLocaleServer>refLocaleServer;

///CameraControll
nDisplayMode2display;
nCamera2camera;
matrix44view;
nMayaCamControlm_ccam;
};

///nappframe.cpp

#include"nappframe.h"
#include"nutildefs.h"

#include"kernel/nfileserver2.h"
#include"kernel/ntimeserver.h"
#include"kernel/nscriptserver.h"
#include"gfx2/ngfxserver2.h"
#include"input/ninputserver.h"
#include"misc/nconserver.h"
#include"resource/nresourceserver.h"
#include"scene/nsceneserver.h"
#include"variable/nvariableserver.h"
#include"anim2/nanimationserver.h"
#include"particle/nparticleserver.h"
#include"video/nvideoserver.h"
#include"gui/nguiserver.h"
#include"kernel/nremoteserver.h"
#include"audio3/naudioserver3.h"
#include"misc/nprefserver.h"
#include"locale/nlocaleserver.h"
#include"shadow2/nshadowserver2.h"

nNebulaUsePackage(nnebula);
nNebulaUsePackage(ntoollib);
nNebulaUsePackage(ndirect3d9);
nNebulaUsePackage(ndinput8);
nNebulaUsePackage(ngui);

nNebulaScriptModule(nAppFrame,nappframe,"nroot");

voidnNebulaScriptInitCmds(nappframe)(nClass*)
{
///addanycmdyouwant.
}

nKernelServer*nAppFrame::ks=NULL;

nAppFrame::nAppFrame():
isOpen(false),
refScriptServer("/sys/servers/script"),
refGfxServer("/sys/servers/gfx"),
refInputServer("/sys/servers/input"),
refConServer("/sys/servers/console"),
refResourceServer("/sys/servers/resource"),
refSceneServer("/sys/servers/scene"),
refVariableServer("/sys/servers/variable"),
refGuiServer("/sys/servers/gui"),
refShadowServer("/sys/servers/shadow"),
refParticleServer("/sys/servers/particle"),
refAnimationServer("/sys/servers/anim")

//refVideoServer("/sys/servers/video"),
//refAudioServer("/sys/servers/audio"),
//refPrefServer("/sys/servers/nwin32prefserver"),
//refLocaleServer("/sys/servers/locale"),
{
n_assert(!nAppFrame::ks);

nAppFrame::ks=n_new(nKernelServer);

m_fpOnFrame=NULL;
m_fpOnRender3D=NULL;
m_fpOnRender2D=NULL;
}

nAppFrame::~nAppFrame()
{
n_assert(nAppFrame::ks);

n_delete(nAppFrame::ks);
nAppFrame::ks=NULL;
}

///OpenNebulaApp
boolnAppFrame::OpenNebula()
{
///AddModules
ks->AddPackage(nnebula);
ks->AddPackage(ntoollib);
ks->AddPackage(ndirect3d9);
ks->AddPackage(ndinput8);
ks->AddPackage(ngui);

///CreateServers
ks->New("ntclserver","/sys/servers/script");
ks->New("nresourceserver","/sys/servers/resource");
ks->New("nvariableserver","/sys/servers/variable");
ks->New("ndi8server","/sys/servers/input");
ks->New("nguiserver","/sys/servers/gui");
ks->New("nconserver","/sys/servers/console");
ks->New("nd3d9server","/sys/servers/gfx");
ks->New("nsceneserver","/sys/servers/scene");
ks->New("nshadowserver2","/sys/servers/shadow");
ks->New("nparticleserver","/sys/servers/particle");
ks->New("nanimationserver","/sys/servers/anim");

//ks->New("ndshowserver","/sys/servers/video");
//ks->New("nprefserver","/sys/servers/nwin32prefserver");
//ks->New("nlocaleserver","/sys/servers/locale");
//ks->New("ndsoundserver3","/sys/servers/audio");

///SetDisplay
display.SetXPos(150);
display.SetYPos(100);
display.SetWidth(640);
display.SetHeight(480);
refGfxServer->SetDisplayMode(display);
refGfxServer->SetCamera(camera);

///////////////////////////////////////////////////////////////////////////
nStringret;

///获得FileServer设置系统路径
nFileServer2*file=(nFileServer2*)ks->Lookup("sys/servers/file2");
///设置系统路径
file->SetAssign("home","bin:../../");
file->SetAssign("renderpath","home:datafiles/shaders");
file->SetAssign("scripts","home:datafiles/scripts");

file->SetAssign("particles","home:datafiles/particles");
file->SetAssign("gfxlib","home:datafiles/gfxlib");
file->SetAssign("textures","home:datafiles/textures");
file->SetAssign("meshes","home:datafiles/meshes");
file->SetAssign("anims","home:datafiles/anims");

///启动RemoteServer
ks->GetRemoteServer()->Open("8379");

///启动sceneserver(启动d3d9server)
refSceneServer->SetRenderPathFilename("renderpath:dx7_renderpath.xml");
if(!refSceneServer->Open())
{
returnfalse;
}

///启动GUIServer
ret.Clear();
refScriptServer->RunScript("scripts:ngui.tcl",ret);
refGuiServer->Open();

///MapInput
refInputServer->Open();
ret.Clear();
refScriptServer->RunScript("scripts:ninput.tcl",ret);

///Opennodelist
this->m_nodes.SetStageScript("gfxlib:stdlight.n2");
this->m_nodes.Open();

///InitClientRes
this->ClientOpen();

///maketheopenmark
this->isOpen=true;

returntrue;
}

///CloseNebulaApp
boolnAppFrame::CloseNebula()
{
///maketheclosemark
this->isOpen=false;

///releaseclientres
this->ClientClose();

///closenodelist
this->m_nodes.Close();

///closeservers
if(this->refGuiServer.isvalid())
{
this->refGuiServer->Close();
}
if(this->refSceneServer.isvalid())
{
this->refSceneServer->Close();
}
//if(this->refAudioServer.isvalid())
//{
//this->refAudioServer->Close();
//}
//if(this->refVideoServer.isvalid())
//{
//this->refVideoServer->Close();
//}
//if(this->refLocaleServer.isvalid())
//{
//if(this->refLocaleServer->IsOpen())
//this->refLocaleServer->Close();
//}

//closetheremoteport
ks->GetRemoteServer()->Close();

this->refShadowServer->Release();
this->refGuiServer->Release();
this->refParticleServer->Release();
this->refVariableServer->Release();
this->refSceneServer->Release();
this->refConServer->Release();
this->refInputServer->Release();
this->refGfxServer->Release();
this->refResourceServer->Release();
this->refScriptServer->Release();
this->refAnimationServer->Release();

//this->refVideoServer->Release();
//this->refLocaleServer->Release();
//this->refPrefServer->Release();
//this->refAudioServer->Release();

returntrue;
}

///Mainloop
voidnAppFrame::RunNebula()
{
n_assert(this->isOpen);

boolrun=true;

///TriggerGfxServer(WindowsMessages)&&PingScriptQuitRequest
while(run=refGfxServer->Trigger()&&this->refScriptServer->Trigger())
{
///TriggerTimeServer
nTimeServer::Instance()->Trigger();
doubletime=nTimeServer::Instance()->GetTime();

///TriggerInputServer
this->refInputServer->Trigger(time);

///TriggerLogic
this->OnFrame();

///BeginScene(BeginFrame)
if(refSceneServer->BeginScene(view))
{
//TriggerParticleServer
refParticleServer->Trigger();

//Render3D
this->OnRender3D();

//RenderScene
refSceneServer->RenderScene();

//EndScene
refSceneServer->EndScene();

//Render2D
this->OnRender2D();

//PresentScene(EndFrame)
refSceneServer->PresentScene();
}

///FlushEvents
this->refInputServer->FlushEvents();
}
}

///OnRender3d
voidnAppFrame::OnRender3D()
{
for(size_ti=0;i<m_nodes.GetCount();++i)
{
this->refSceneServer->Attach(m_nodes.GetRenderContextAt(i));
}

if(m_fpOnRender3D)
{
m_fpOnRender3D();
}
}

///OnRender2d
voidnAppFrame::OnRender2D()
{
if(m_fpOnRender2D)
{
m_fpOnRender2D();
}
}

///logictrigger
voidnAppFrame::OnFrame()
{
///updatecamera
this->OnCameraControll();

///updatenodelist
staticunsignedintnFrameID=0;
this->m_nodes.Trigger(nTimeServer::Instance()->GetTime(),nFrameID++);

if(m_fpOnFrame)
{
m_fpOnFrame();
}
}

///cameracontroll
voidnAppFrame::OnCameraControll()
{
//DefaultCameraController
if(!this->refGuiServer->IsMouseOverGui())
{
//RenderDebug
if(refInputServer->GetButton("debug"))
{
if(refSceneServer->GetRenderDebug())
{
refSceneServer->SetRenderDebug(false);
}
else
{
refSceneServer->SetRenderDebug(true);
}
}

//giveinputstocamControl
this->m_ccam.SetResetButton(refInputServer->GetButton("reset"));
this->m_ccam.SetLookButton(refInputServer->GetButton("look"));
this->m_ccam.SetPanButton(refInputServer->GetButton("pan"));
this->m_ccam.SetZoomButton(refInputServer->GetButton("zoom"));
this->m_ccam.SetSliderLeft(refInputServer->GetSlider("left"));
this->m_ccam.SetSliderRight(refInputServer->GetSlider("right"));
this->m_ccam.SetSliderUp(refInputServer->GetSlider("up"));
this->m_ccam.SetSliderDown(refInputServer->GetSlider("down"));

//updateviewandgettheactualviewMatrix
this->m_ccam.Update();
this->view.set(this->m_ccam.GetViewMatrix());
}
}

以下是使用实例代码：

/****************************************************************************/
/*Nebula2-Tutorial15*/
/*SimpleApplicationFramework*/
/*author:happykevins*/
/****************************************************************************/

#include"kernel/nkernelserver.h"
#include"gfx2/ngfxserver2.h"
#include"../NebulaUtils/nappframe.h"
#include"../NebulaUtils/nutildefs.h"

voidRender3D()
{
//Write3DRenderCodeHere.
}

voidRender2D()
{
//drawcubes
vector3CenterPoint(0,0.5f,0);
floatfSize=0.5f;
vector3v[8];
v[0].set(CenterPoint.x-fSize,CenterPoint.y-fSize,CenterPoint.z-fSize);
v[1].set(CenterPoint.x+fSize,CenterPoint.y-fSize,CenterPoint.z-fSize);
v[2].set(CenterPoint.x+fSize,CenterPoint.y+fSize,CenterPoint.z-fSize);
v[3].set(CenterPoint.x-fSize,CenterPoint.y+fSize,CenterPoint.z-fSize);
v[4].set(CenterPoint.x-fSize,CenterPoint.y-