[Axiom3D]第一个Axiom3D程序
Axiom3D程序的基本渲染流程
1 #region Namespace Declarations
2
3 using System; 4 using System.Linq; 5 using Axiom.Core; 6 using Axiom.Framework.Configuration; 7 using Axiom.Graphics; 8 using Vector3 = Axiom.Math.Vector3; 9
10 #endregion Namespace Declarations
11
12 namespace Axiom.Framework 13 { 14 public abstract class Game : IDisposable, IWindowEventListener 15 { 16 protected Root Engine; 17 protected IConfigurationManager ConfigurationManager; 18 protected ResourceGroupManager Content; 19 protected SceneManager SceneManager; 20 protected Camera Camera; 21 protected Viewport Viewport; 22 protected RenderWindow Window; 23 protected Axiom.Graphics.RenderSystem RenderSystem; 24 protected SharpInputSystem.InputManager InputManager; 25 protected SharpInputSystem.Mouse mouse; 26 protected SharpInputSystem.Keyboard keyboard; 27
28 public virtual void Run() 29 { 30 PreInitialize(); 31 LoadConfiguration(); 32 Initialize(); 33 CreateRenderSystem(); 34 CreateRenderWindow(); 35 LoadContent(); 36 CreateSceneManager(); 37 CreateCamera(); 38 CreateViewports(); 39 CreateInput(); 40 CreateScene(); 41 this.Engine.StartRendering(); 42 } 43
44 private void PreInitialize() 45 { 46 this.ConfigurationManager = new DefaultConfigurationManager(); 47
48 // instantiate the Root singleton
49 this.Engine = new Root( this.ConfigurationManager.LogFilename ); 50
51 // add event handlers for frame events
52 this.Engine.FrameStarted += Engine_FrameRenderingQueued; 53 } 54
55 public virtual void LoadConfiguration() 56 { 57 this.ConfigurationManager.RestoreConfiguration( this.Engine ); 58 } 59
60
61 private void Engine_FrameRenderingQueued( object source, FrameEventArgs e ) 62 { 63 Update( e.TimeSinceLastFrame ); 64 } 65
66 public virtual void Initialize() 67 { 68 } 69
70 public virtual void CreateRenderSystem() 71 { 72 if ( this.Engine.RenderSystem == null ) 73 { 74 this.RenderSystem = this.Engine.RenderSystem = this.Engine.RenderSystems.First().Value; 75 } 76 else
77 { 78 this.RenderSystem = this.Engine.RenderSystem; 79 } 80 } 81
82 public virtual void CreateRenderWindow() 83 { 84 this.Window = Root.Instance.Initialize( true, "Axiom Framework Window" ); 85
86 WindowEventMonitor.Instance.RegisterListener( this.Window, this ); 87 } 88
89 public virtual void LoadContent() 90 { 91 ResourceGroupManager.Instance.InitializeAllResourceGroups(); 92 } 93
94 public virtual void CreateSceneManager() 95 { 96 // Get the SceneManager, a generic one by default
97 this.SceneManager = this.Engine.CreateSceneManager( "DefaultSceneManager", "GameSMInstance" ); 98 this.SceneManager.ClearScene(); 99 } 100
101 public virtual void CreateCamera() 102 { 103 // create a camera and initialize its position
104 this.Camera = this.SceneManager.CreateCamera( "MainCamera" ); 105 this.Camera.Position = new Vector3( 0, 0, 500 ); 106 this.Camera.LookAt( new Vector3( 0, 0, -300 ) ); 107
108 // set the near clipping plane to be very close
109 this.Camera.Near = 5; 110
111 this.Camera.AutoAspectRatio = true; 112 } 113
114 public virtual void CreateViewports() 115 { 116 // create a new viewport and set it's background color
117 this.Viewport = this.Window.AddViewport( this.Camera, 0, 0, 1.0f, 1.0f, 100 ); 118 this.Viewport.BackgroundColor = ColorEx.SteelBlue; 119 } 120
121 public virtual void CreateInput() 122 { 123 var pl = new SharpInputSystem.ParameterList(); 124 pl.Add( new SharpInputSystem.Parameter( "WINDOW", this.Window[ "WINDOW" ] ) ); 125
126 if ( this.RenderSystem.Name.Contains( "DirectX" ) ) 127 { 128 //Default mode is foreground exclusive..but, we want to show mouse - so nonexclusive
129 pl.Add( new SharpInputSystem.Parameter( "w32_mouse", "CLF_BACKGROUND" ) ); 130 pl.Add( new SharpInputSystem.Parameter( "w32_mouse", "CLF_NONEXCLUSIVE" ) ); 131 } 132
133 //This never returns null.. it will raise an exception on errors
134 this.InputManager = SharpInputSystem.InputManager.CreateInputSystem( pl ); 135 //mouse = InputManager.CreateInputObject<SharpInputSystem.Mouse>( true, "" ); 136 //keyboard = InputManager.CreateInputObject<SharpInputSystem.Keyboard>( true, "" );
137 } 138
139 public abstract void CreateScene(); 140
141 public virtual void Update( float timeSinceLastFrame ) 142 { 143 } 144
145 #region IDisposable Implementation
146
147 #region IsDisposed Property
148
149 /// <summary>
150 /// Determines if this instance has been disposed of already. 151 /// </summary>
152 public bool IsDisposed { get; set; } 153
154 #endregion IsDisposed Property
155
156 /// <summary>
157 /// Class level dispose method 158 /// </summary>
159 /// <remarks>
160 /// When implementing this method in an inherited class the following template should be used; 161 /// protected override void dispose( bool disposeManagedResources ) 162 /// { 163 /// if ( !IsDisposed ) 164 /// { 165 /// if ( disposeManagedResources ) 166 /// { 167 /// // Dispose managed resources. 168 /// } 169 ///
170 /// // If there are unmanaged resources to release, 171 /// // they need to be released here. 172 /// } 173 ///
174 /// // If it is available, make the call to the 175 /// // base class's Dispose(Boolean) method 176 /// base.dispose( disposeManagedResources ); 177 /// } 178 /// </remarks>
179 /// <param name="disposeManagedResources">True if Unmanaged resources should be released.</param>
180 protected virtual void dispose( bool disposeManagedResources ) 181 { 182 if ( !IsDisposed ) 183 { 184 if ( disposeManagedResources ) 185 { 186 if ( this.Engine != null ) 187 { 188 // remove event handlers
189 this.Engine.FrameStarted -= Engine_FrameRenderingQueued; 190 } 191 if ( this.SceneManager != null ) 192 { 193 this.SceneManager.RemoveAllCameras(); 194 } 195 this.Camera = null; 196 if ( Root.Instance != null ) 197 { 198 Root.Instance.RenderSystem.DetachRenderTarget( this.Window ); 199 } 200 if ( this.Window != null ) 201 { 202 WindowEventMonitor.Instance.UnregisterWindow( this.Window ); 203 this.Window.Dispose(); 204 } 205 if ( this.Engine != null ) 206 { 207 this.Engine.Dispose(); 208 } 209 } 210
211 // There are no unmanaged resources to release, but 212 // if we add them, they need to be released here.
213 } 214 IsDisposed = true; 215 } 216
217 /// <summary>
218 /// Call to when class is no longer needed 219 /// </summary>
220 public void Dispose() 221 { 222 dispose( true ); 223 GC.SuppressFinalize( this ); 224 } 225
226 ~Game() 227 { 228 dispose( false ); 229 } 230
231 #endregion IDisposable Implementation
232
233 #region IWindowEventListener Implementation
234
235 /// <summary>
236 /// Window has moved position 237 /// </summary>
238 /// <param name="rw">The RenderWindow which created this event</param>
239 public void WindowMoved( RenderWindow rw ) 240 { 241 } 242
243 /// <summary>
244 /// Window has resized 245 /// </summary>
246 /// <param name="rw">The RenderWindow which created this event</param>
247 public void WindowResized( RenderWindow rw ) 248 { 249 } 250
251 /// <summary>
252 /// Window has closed 253 /// </summary>
254 /// <param name="rw">The RenderWindow which created this event</param>
255 public void WindowClosed( RenderWindow rw ) 256 { 257 // Only do this for the Main Window
258 if ( rw == this.Window ) 259 { 260 Root.Instance.QueueEndRendering(); 261 } 262 } 263
264 /// <summary>
265 /// Window lost/regained the focus 266 /// </summary>
267 /// <param name="rw">The RenderWindow which created this event</param>
268 public void WindowFocusChange( RenderWindow rw ) 269 { 270 } 271
272 #endregion
273 } 274 }
查看Run()方法。
public virtual void Run()
{
PreInitialize();
LoadConfiguration();//加载配置
Initialize();
CreateRenderSystem();//创建渲染系统
CreateRenderWindow();//创建渲染窗体
LoadContent();
CreateSceneManager();//创建场景管理器
CreateCamera();//设置相机
CreateViewports();//设置视口
CreateInput();
CreateScene();//构建场景
this.Engine.StartRendering();//开始渲染
}
基本流程：实例化Root，加载配置文件，创建渲染系统，创建渲染窗体，创建场景管理器，设置相机，设置视口，构建场景，开始渲染流程。
新建C#项目，命名为AppAxiom，添加引用Axiom.Engine。
新建类MyGame，继承自Game，编写代码如下：
1 public class myGame : Game 2 { 3 public override void CreateScene() 4 { 5 6 SceneManager.SetSkyDome(true, "Examples/CloudySky", 5, 8); 7 SceneManager.AmbientLight = new ColorEx(0.3f, 0.3f, 0.3f); 8 SceneManager.CreateLight("ParticleSampleLight").Position = new Vector3(20, 80, 50); 9 10 Entity ogreHead = SceneManager.CreateEntity("OgreHead", "ogrehead.mesh"); 11 // Load muiltiple heads for box select and demonstrating single select with stacked objects 12 // create a scene node for each entity and attach the entity 13 SceneNode ogreHead1Node; 14 ogreHead1Node = SceneManager.RootSceneNode.CreateChildSceneNode("OgreHeadNode", Vector3.Zero, Quaternion.Identity); 15 ogreHead1Node.AttachObject(ogreHead); 16 17 SceneNode ogreHead2Node; 18 Entity ogreHead2 = SceneManager.CreateEntity("OgreHead2", "ogrehead.mesh"); 19 ogreHead2Node = SceneManager.RootSceneNode.CreateChildSceneNode("OgreHead2Node", new Vector3(-100, 0, 0), 20 Quaternion.Identity); 21 ogreHead2Node.AttachObject(ogreHead2); 22 23 SceneNode ogreHead3Node; 24 Entity ogreHead3 = SceneManager.CreateEntity("OgreHead3", "ogrehead.mesh"); 25 ogreHead3Node = SceneManager.RootSceneNode.CreateChildSceneNode("OgreHead3Node", new Vector3(+100, 0, 0), 26 Quaternion.Identity); 27 ogreHead3Node.AttachObject(ogreHead3); 28 29 } 30 public override void CreateCamera() 31 { 32 // create a camera and initialize its position 33 this.Camera = this.SceneManager.CreateCamera("MainCamera"); 34 this.Camera.Position = new Vector3(0, 0, 500); 35 this.Camera.LookAt(new Vector3(0, 0, 0)); 36 37 // set the near clipping plane to be very close 38 this.Camera.Near = 5; 39 this.Camera.AutoAspectRatio = true; 40 } 41 }
添加项目配置文件App.Config，内容如下：
1 <?xml version="1.0"?> 2 3 <configuration> 4 <configSections> 5 <section name="axiom" type="Axiom.Framework.Configuration.AxiomConfigurationSection, Axiom.Framework" /> 6 </configSections> 7 <startup useLegacyV2RuntimeActivationPolicy="true"> 8 <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0,Profile=Client" /> 9 </startup> 10 <axiom xmlns="http://www.axiom3d.net/schemas/configuration/v1.0"> 11 <resourceLocations> 12 <!-- Resource Group : Essential --> 13 <resourceLocation type="ZipFile" group="Essential" path="../../media/archives/SdkTrays.zip" recurse="false" /> 14 <resourceLocation type="Folder" group="Essential" path="../../media/thumbnails" recurse="false" /> 15 <resourceLocation type="Folder" group="Essential" path="../../media/icons" recurse="false" /> 16 17 <!-- Resource Group : Popular --> 18 <resourceLocation type="ZipFile" group="Popular" path="../../media/archives/cubemap.zip" recurse="false" /> 19 <resourceLocation type="ZipFile" group="Popular" path="../../media/archives/cubemapsjs.zip" recurse="false" /> 20 <!-- resourceLocation type="ZipFile" group="Popular" path="../../media/archives/dragon.zip" recurse="false" /--> 21 <!-- resourceLocation type="ZipFile" group="Popular" path="../../media/archives/fresneldemo.zip" recurse="false" /--> 22 <!-- resourceLocation type="ZipFile" group="Popular" path="../../media/archives/ogretestmap.zip" recurse="false" /--> 23 <resourceLocation type="ZipFile" group="Popular" path="../../media/archives/skybox.zip" recurse="false" /> 24 <resourceLocation type="ZipFile" group="Popular" path="../../media/archives/sinbad.zip" recurse="false" /> 25 <resourceLocation type="Folder" group="Popular" path="../../media/fonts" recurse="false" /> 26 <resourceLocation type="Folder" group="Popular" path="../../media/programs" recurse="false" /> 27 <resourceLocation type="Folder" group="Popular" path="../../media/materials" recurse="false" /> 28 <resourceLocation type="Folder" group="Popular" path="../../media/particles" recurse="false" /> 29 <resourceLocation type="Folder" group="Popular" path="../../media/textures" recurse="false" /> 30 <resourceLocation type="Folder" group="Popular" path="../../media/meshes" recurse="false" /> 31 <!-- resourceLocation type="Folder" group="Popular" path="../../media/deferredshadingmedia" recurse="false" / --> 32 <!-- resourceLocation type="Folder" group="Popular" path="../../media/pczappmedia" recurse="false" / --> 33 </resourceLocations> 34 <renderSystems> 35 <renderSystem name="Xna"> 36 <options> 37 <option name="Video Mode" value="1280 x 720 @ 32-bit color" /> 38 <option name="Full Screen" value="Yes" /> 39 <option name="VSync" value="No" /> 40 <option name="Anti aliasing" value="None" /> 41 <option name="Floating-point mode" value="Fastest" /> 42 <option name="Allow NVPerfHUD" value="No" /> 43 <option name="Save Generated Shaders" value="No" /> 44 <option name="Use Content Pipeline" value="No" /> 45 </options> 46 </renderSystem> 47 <renderSystem name="DirectX9"> 48 <options> 49 <option name="Video Mode" value="800 x 600 @ 32-bit colour" /> 50 <option name="Full Screen" value="No" /> 51 <option name="VSync" value="No" /> 52 <option name="Anti aliasing" value="None" /> 53 <option name="Floating-point mode" value="Fastest" /> 54 <option name="Allow NVPerfHUD" value="No" /> 55 </options> 56 </renderSystem> 57 <renderSystem name="OpenGL"> 58 <options> 59 <option name="Video Mode" value="1280 x 720" /> 60 <option name="Color Depth" value="32" /> 61 <option name="Display Frequency" value="N/A" /> 62 <option name="Full Screen" value="Yes" /> 63 <option name="FSAA" value="0" /> 64 <option name="VSync" value="No" /> 65 <option name="RTT Preferred Mode" value="FBO" /> 66 </options> 67 </renderSystem> 68 </renderSystems> 69 </axiom> 70 </configuration>
在Main方法下添加代码：
1 static void Main() 2 { 3 myGame my = new myGame(); 4 my.Run(); 5 }
将材质文件Material放在debug同一级目录下，将dll放在Debug目录下，运行效果如下。
奇怪的是同样的D3D、Vs配置在XP系统中无法运行！
![[Axiom3D]第一个Axiom3D程序](http://img.e-com-net.com/image/product/ca1fd4490d9c47c7a1b0a2184a4feb37.jpg)