使用CEGUI渲染的初学者指南
From CEGUIWiki
无论使用哪个引擎,使用CEGUI渲染GUI必须有三个步骤
- 创建一个CEGUI::Renderer基对象.
- 创建CEGUI::System对象.
- 调用相关方法渲染GUI
很明显在此之前必须装载一些基本的文件,这些将会在下面的装载数据文件和初始化中介绍到。另外你必须获得系统输入,这些将会在插入输入的初学者指南中介绍到
1 创建一个CEGUI::Renderer基对象.
必须include你使用渲染器的头文件。
基本的创建代码:
Direct3D 8.1
CEGUI::DirectX81Renderer* myRenderer =
new CEGUI::DirectX81Renderer(myD3D8Device);
Direct3D 9
CEGUI::DirectX9Renderer* myRenderer =
new CEGUI::DirectX9Renderer(myD3D9Device);
OpenGL
CEGUI::OpenGLRenderer* myRenderer =
new CEGUI::OpenGLRenderer(0);
Ogre3D
CEGUI::OgreCEGUIRenderer* myRenderer =
new CEGUI::OgreCEGUIRenderer(myRenderWindow);
Irrlicht Engine
CEGUI::IrrlichtRenderer* myRenderer =
new CEGUI::IrrlichtRenderer(myIrrlichtDevice, true);
2 创建CEGUI::System对象.
传递一个刚才创建的渲染器指针
new CEGUI::System(myRenderer);
3 调用相关方法渲染GUI
这个是唯一和你的渲染器相关的步骤,因此要根据情况分开调用。你必须在渲染循环的最后调用CEGUI::System::renderGUI。Ogre3D引擎的用户不需要做这个。例子如下
Direct3D 8.1 / 9
// Start the scene
myD3DDevice->BeginScene();
// clear display
myD3DDevice->Clear(0, 0, D3DCLEAR_TARGET, D3DCOLOR_XRGB(0, 0, 0), 1.0f, 0);
// user function to draw 3D scene
draw3DScene();
// draw GUI
CEGUI::System::getSingleton().renderGUI();
// end the scene
myD3DDevice->EndScene();
// finally present the frame.
myD3DDevice->Present(0, 0, 0, 0);
OpenGL
// user function to draw 3D scene
draw3DScene();
// draw GUI (should not be between glBegin/glEnd pair)
CEGUI::System::getSingleton().renderGUI();
Irrlicht
// start the scene
myIrrlichtDriver->beginScene(true, true, irr::video::SColor(150,50,50,50));
// draw main scene
myIrrlichtSceneManager->drawAll();
// draw gui
CEGUI::System::getSingleton().renderGUI();
// end the scene
myIrrlichtDriver->endScene();
4 结论
这是CEGUI最基础的教程。一些话题没有在这里介绍,例如在OGER3D中使用不同的场景管理器;以及一些高级话题,例如用户选择资源提供者,等等