[Axiom3D]第一个Axiom3D程序

Axiom3D程序的基本渲染流程

 #region Namespace Declarations

 using System;
 using System.Linq;
 using Axiom.Core;
 using Axiom.Framework.Configuration;
 using Axiom.Graphics;
 using Vector3 = Axiom.Math.Vector3;

 #endregion Namespace Declarations

 namespace Axiom.Framework
 {
     public abstract class Game : IDisposable, IWindowEventListener
     {
         protected Root Engine;
         protected IConfigurationManager ConfigurationManager;
         protected ResourceGroupManager Content;
         protected SceneManager SceneManager;
         protected Camera Camera;
         protected Viewport Viewport;
         protected RenderWindow Window;
         protected Axiom.Graphics.RenderSystem RenderSystem;
         protected SharpInputSystem.InputManager InputManager;
         protected SharpInputSystem.Mouse mouse;
         protected SharpInputSystem.Keyboard keyboard;

         public virtual void Run()
         {
             PreInitialize();
             LoadConfiguration();
             Initialize();
             CreateRenderSystem();
             CreateRenderWindow();
             LoadContent();
             CreateSceneManager();
             CreateCamera();
             CreateViewports();
             CreateInput();
             CreateScene();
             this.Engine.StartRendering();
         }

         private void PreInitialize()
         {
             this.ConfigurationManager = new DefaultConfigurationManager();

             // instantiate the Root singleton
             this.Engine = new Root( this.ConfigurationManager.LogFilename );

             // add event handlers for frame events
             this.Engine.FrameStarted += Engine_FrameRenderingQueued;
         }

         public virtual void LoadConfiguration()
         {
             this.ConfigurationManager.RestoreConfiguration( this.Engine );
         }

         private void Engine_FrameRenderingQueued( object source, FrameEventArgs e )
         {
             Update( e.TimeSinceLastFrame );
         }

         public virtual void Initialize()
         {
         }

         public virtual void CreateRenderSystem()
         {
             if ( this.Engine.RenderSystem == null )
             {
                 this.RenderSystem = this.Engine.RenderSystem = this.Engine.RenderSystems.First().Value;
             }
             else
             {
                 this.RenderSystem = this.Engine.RenderSystem;
             }
         }

         public virtual void CreateRenderWindow()
         {
             this.Window = Root.Instance.Initialize( true, "Axiom Framework Window" );

             WindowEventMonitor.Instance.RegisterListener( this.Window, this );
         }

         public virtual void LoadContent()
         {
             ResourceGroupManager.Instance.InitializeAllResourceGroups();
         }

         public virtual void CreateSceneManager()
         {
             // Get the SceneManager, a generic one by default
             this.SceneManager = this.Engine.CreateSceneManager( "DefaultSceneManager", "GameSMInstance" );
             this.SceneManager.ClearScene();
         }

         public virtual void CreateCamera()
         {
             // create a camera and initialize its position
             this.Camera = this.SceneManager.CreateCamera( "MainCamera" );
             this.Camera.Position = new Vector3( , ,  );
             this.Camera.LookAt( new Vector3( , , - ) );

             // set the near clipping plane to be very close
             this.Camera.Near = ;

             this.Camera.AutoAspectRatio = true;
         }

         public virtual void CreateViewports()
         {
             // create a new viewport and set it's background color
             this.Viewport = this.Window.AddViewport( this.Camera, , , 1.0f, 1.0f,  );
             this.Viewport.BackgroundColor = ColorEx.SteelBlue;
         }

         public virtual void CreateInput()
         {
             var pl = new SharpInputSystem.ParameterList();
             pl.Add( new SharpInputSystem.Parameter( "WINDOW", this.Window[ "WINDOW" ] ) );

             if ( this.RenderSystem.Name.Contains( "DirectX" ) )
             {
                 //Default mode is foreground exclusive..but, we want to show mouse - so nonexclusive
                 pl.Add( new SharpInputSystem.Parameter( "w32_mouse", "CLF_BACKGROUND" ) );
                 pl.Add( new SharpInputSystem.Parameter( "w32_mouse", "CLF_NONEXCLUSIVE" ) );
             }

             //This never returns null.. it will raise an exception on errors
             this.InputManager = SharpInputSystem.InputManager.CreateInputSystem( pl );
             //mouse = InputManager.CreateInputObject<SharpInputSystem.Mouse>( true, "" );
             //keyboard = InputManager.CreateInputObject<SharpInputSystem.Keyboard>( true, "" );
         }

         public abstract void CreateScene();

         public virtual void Update( float timeSinceLastFrame )
         {
         }

         #region IDisposable Implementation

         #region IsDisposed Property

         /// <summary>
         /// Determines if this instance has been disposed of already.
         /// </summary>
         public bool IsDisposed { get; set; }

         #endregion IsDisposed Property

         /// <summary>
         /// Class level dispose method
         /// </summary>
         /// <remarks>
         /// When implementing this method in an inherited class the following template should be used;
         /// protected override void dispose( bool disposeManagedResources )
         /// {
         ///     if ( !IsDisposed )
         ///     {
         ///         if ( disposeManagedResources )
         ///         {
         ///             // Dispose managed resources.
         ///         }
         ///
         ///         // If there are unmanaged resources to release,
         ///         // they need to be released here.
         ///     }
         ///
         ///     // If it is available, make the call to the
         ///     // base class's Dispose(Boolean) method
         ///     base.dispose( disposeManagedResources );
         /// }
         /// </remarks>
         /// <param name="disposeManagedResources">True if Unmanaged resources should be released.</param>
         protected virtual void dispose( bool disposeManagedResources )
         {
             if ( !IsDisposed )
             {
                 if ( disposeManagedResources )
                 {
                     if ( this.Engine != null )
                     {
                         // remove event handlers
                         this.Engine.FrameStarted -= Engine_FrameRenderingQueued;
                     }
                     if ( this.SceneManager != null )
                     {
                         this.SceneManager.RemoveAllCameras();
                     }
                     this.Camera = null;
                     if ( Root.Instance != null )
                     {
                         Root.Instance.RenderSystem.DetachRenderTarget( this.Window );
                     }
                     if ( this.Window != null )
                     {
                         WindowEventMonitor.Instance.UnregisterWindow( this.Window );
                         this.Window.Dispose();
                     }
                     if ( this.Engine != null )
                     {
                         this.Engine.Dispose();
                     }
                 }

                 // There are no unmanaged resources to release, but
                 // if we add them, they need to be released here.
             }
             IsDisposed = true;
         }

         /// <summary>
         /// Call to when class is no longer needed
         /// </summary>
         public void Dispose()
         {
             dispose( true );
             GC.SuppressFinalize( this );
         }

         ~Game()
         {
             dispose( false );
         }

         #endregion IDisposable Implementation

         #region IWindowEventListener Implementation

         /// <summary>
         /// Window has moved position
         /// </summary>
         /// <param name="rw">The RenderWindow which created this event</param>
         public void WindowMoved( RenderWindow rw )
         {
         }

         /// <summary>
         /// Window has resized
         /// </summary>
         /// <param name="rw">The RenderWindow which created this event</param>
         public void WindowResized( RenderWindow rw )
         {
         }

         /// <summary>
         /// Window has closed
         /// </summary>
         /// <param name="rw">The RenderWindow which created this event</param>
         public void WindowClosed( RenderWindow rw )
         {
             // Only do this for the Main Window
             if ( rw == this.Window )
             {
                 Root.Instance.QueueEndRendering();
             }
         }

         /// <summary>
         /// Window lost/regained the focus
         /// </summary>
         /// <param name="rw">The RenderWindow which created this event</param>
         public void WindowFocusChange( RenderWindow rw )
         {
         }

         #endregion
     }
 }

查看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，编写代码如下：

  public class myGame : Game
         {
             public override void CreateScene()
             {

                 SceneManager.SetSkyDome(true, "Examples/CloudySky", , );
                 SceneManager.AmbientLight = new ColorEx(0.3f, 0.3f, 0.3f);
                 SceneManager.CreateLight("ParticleSampleLight").Position = new Vector3(, , );

                 Entity ogreHead = SceneManager.CreateEntity("OgreHead", "ogrehead.mesh");
                 // Load muiltiple heads for box select and demonstrating single select with stacked objects
                 // create a scene node for each entity and attach the entity
                 SceneNode ogreHead1Node;
                 ogreHead1Node = SceneManager.RootSceneNode.CreateChildSceneNode("OgreHeadNode", Vector3.Zero, Quaternion.Identity);
                 ogreHead1Node.AttachObject(ogreHead);

                 SceneNode ogreHead2Node;
                 Entity ogreHead2 = SceneManager.CreateEntity("OgreHead2", "ogrehead.mesh");
                 ogreHead2Node = SceneManager.RootSceneNode.CreateChildSceneNode("OgreHead2Node", new Vector3(-, , ),
                                                                                  Quaternion.Identity);
                 ogreHead2Node.AttachObject(ogreHead2);

                 SceneNode ogreHead3Node;
                 Entity ogreHead3 = SceneManager.CreateEntity("OgreHead3", "ogrehead.mesh");
                 ogreHead3Node = SceneManager.RootSceneNode.CreateChildSceneNode("OgreHead3Node", new Vector3(+, , ),
                                                                                  Quaternion.Identity);
                 ogreHead3Node.AttachObject(ogreHead3);

             }
             public override void CreateCamera()
             {
                 // create a camera and initialize its position
                 this.Camera = this.SceneManager.CreateCamera("MainCamera");
                 this.Camera.Position = new Vector3(, , );
                 this.Camera.LookAt(new Vector3(, , ));

                 // set the near clipping plane to be very close
                 this.Camera.Near = ;
                 this.Camera.AutoAspectRatio = true;
             }
         }

添加项目配置文件App.Config，内容如下：

 <?xml version="1.0"?>

 <configuration>
   <configSections>
     <section name="axiom" type="Axiom.Framework.Configuration.AxiomConfigurationSection, Axiom.Framework" />
   </configSections>
   <startup useLegacyV2RuntimeActivationPolicy="true">
     <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0,Profile=Client" />
   </startup>
   <axiom xmlns="http://www.axiom3d.net/schemas/configuration/v1.0">
     <resourceLocations>
       <!-- Resource Group : Essential -->
       <resourceLocation type="ZipFile" group="Essential" path="../../media/archives/SdkTrays.zip" recurse="false" />
       <resourceLocation type="Folder" group="Essential" path="../../media/thumbnails" recurse="false" />
       <resourceLocation type="Folder" group="Essential" path="../../media/icons" recurse="false" />

       <!-- Resource Group : Popular -->
       <resourceLocation type="ZipFile" group="Popular" path="../../media/archives/cubemap.zip" recurse="false" />
       <resourceLocation type="ZipFile" group="Popular" path="../../media/archives/cubemapsjs.zip" recurse="false" />
       <!-- resourceLocation type="ZipFile" group="Popular" path="../../media/archives/dragon.zip" recurse="false" /-->
       <!-- resourceLocation type="ZipFile" group="Popular" path="../../media/archives/fresneldemo.zip" recurse="false" /-->
       <!-- resourceLocation type="ZipFile" group="Popular" path="../../media/archives/ogretestmap.zip" recurse="false" /-->
       <resourceLocation type="ZipFile" group="Popular" path="../../media/archives/skybox.zip" recurse="false" />
       <resourceLocation type="ZipFile" group="Popular" path="../../media/archives/sinbad.zip" recurse="false" />
       <resourceLocation type="Folder" group="Popular" path="../../media/fonts" recurse="false" />
       <resourceLocation type="Folder" group="Popular" path="../../media/programs" recurse="false" />
       <resourceLocation type="Folder" group="Popular" path="../../media/materials" recurse="false" />
       <resourceLocation type="Folder" group="Popular" path="../../media/particles" recurse="false" />
       <resourceLocation type="Folder" group="Popular" path="../../media/textures" recurse="false" />
       <resourceLocation type="Folder" group="Popular" path="../../media/meshes" recurse="false" />
       <!-- resourceLocation type="Folder" group="Popular" path="../../media/deferredshadingmedia" recurse="false" / -->
       <!-- resourceLocation type="Folder" group="Popular" path="../../media/pczappmedia" recurse="false" / -->
     </resourceLocations>
     <renderSystems>
       <renderSystem name="Xna">
         <options>
           <option name="Video Mode" value="1280 x 720 @ 32-bit color" />
           <option name="Full Screen" value="Yes" />
           <option name="VSync" value="No" />
           <option name="Anti aliasing" value="None" />
           <option name="Floating-point mode" value="Fastest" />
           <option name="Allow NVPerfHUD" value="No" />
           <option name="Save Generated Shaders" value="No" />
           <option name="Use Content Pipeline" value="No" />
         </options>
       </renderSystem>
       <renderSystem name="DirectX9">
         <options>
           <option name="Video Mode" value="800 x 600 @ 32-bit colour" />
           <option name="Full Screen" value="No" />
           <option name="VSync" value="No" />
           <option name="Anti aliasing" value="None" />
           <option name="Floating-point mode" value="Fastest" />
           <option name="Allow NVPerfHUD" value="No" />
         </options>
       </renderSystem>
       <renderSystem name="OpenGL">
         <options>
           <option name="Video Mode" value="1280 x 720" />
           <option name="Color Depth" value="" />
           <option name="Display Frequency" value="N/A" />
           <option name="Full Screen" value="Yes" />
           <option name="FSAA" value="" />
           <option name="VSync" value="No" />
           <option name="RTT Preferred Mode" value="FBO" />
         </options>
       </renderSystem>
     </renderSystems>
   </axiom>
 </configuration>

在Main方法下添加代码：

  static void Main()
         {
             myGame my = new myGame();
             my.Run();
         }

将材质文件Material放在debug同一级目录下，将dll放在Debug目录下，运行效果如下。

奇怪的是同样的D3D、Vs配置在XP系统中无法运行！