CEGUI初学者指南1——使用CEGUI渲染

使用CEGUI渲染的初学者指南
From CEGUIWiki

无论使用哪个引擎，使用CEGUI渲染GUI必须有三个步骤

1. 创建一个CEGUI::Renderer基对象.
2. 创建CEGUI::System对象.
3. 调用相关方法渲染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中使用不同的场景管理器；以及一些高级话题，例如用户选择资源提供者，等等