Axiom3D程序的基本渲染流程
![[Axiom3D]第一个Axiom3D程序_d3](https://s2.51cto.com/images/blog/202108/09/ab985a3231c6e27735e1f32d13afd886.gif?x-oss-process=image/watermark,size_16,text_QDUxQ1RP5Y2a5a6i,color_FFFFFF,t_30,g_se,x_10,y_10,shadow_20,type_ZmFuZ3poZW5naGVpdGk=)
![[Axiom3D]第一个Axiom3D程序_ide_02](https://s2.51cto.com/images/blog/202108/09/b07973a23f849b5e22a608a062a9dfbe.gif?x-oss-process=image/watermark,size_16,text_QDUxQ1RP5Y2a5a6i,color_FFFFFF,t_30,g_se,x_10,y_10,shadow_20,type_ZmFuZ3poZW5naGVpdGk=)
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 }
View Code
查看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 }
View Code
添加项目配置文件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>
View Code
在Main方法下添加代码：
1 static void Main()
2 {
3 myGame my = new myGame();
4 my.Run();
5 }
将材质文件Material放在debug同一级目录下，将dll放在Debug目录下，运行效果如下。
奇怪的是同样的D3D、Vs配置在XP系统中无法运行！
![[Axiom3D]第一个Axiom3D程序_ide_07](https://s2.51cto.com/images/blog/202108/09/48621119538c2fe0aebfb1c299d34747.png?x-oss-process=image/watermark,size_16,text_QDUxQ1RP5Y2a5a6i,color_FFFFFF,t_30,g_se,x_10,y_10,shadow_20,type_ZmFuZ3poZW5naGVpdGk=/resize,m_fixed,w_1184)
本文章为转载内容，我们尊重原作者对文章享有的著作权。如有内容错误或侵权问题，欢迎原作者联系我们进行内容更正或删除文章。
