papervision3D介绍及入门

papervision3D介绍及入门
2009年11月27日
　　在讲材质贴图直接，我们就先回顾下一个基本的PV3D程序结构。
　　首先，我们会有一个类，不管在Flash 9 CS3中还是Flex Builder的ActionScript项目中，都会有一个类做为整个Flash程序的入口。在Flash 9 CS3中，可以在底部的Flash属性栏里找到主类的设置选项。
　　我喜欢把我的主类命名为Main，其实命名位什么都无所谓的，只要记得保持文件名和类名一致就可以  。不过记得主类一定要继承自Sprite类。
　　Java代码 
　　
　　
　　package {       import flash.display.Sprite;           public class Main extends Sprite       {           public function Main()           {               }       }   }   package {    import flash.display.Sprite;     public class Main extends Sprite    {        public function Main()        {         }    }}
　　上面就是我们的主类的代码了，Main()函数是Main类的构造函数，就是说当你执行new Main();时，Flash虚拟机会调用这个函数，初始化Main类的对象(类的实例叫对象，达达是人这个类的一个实例，所以是个对象….)。所以，Main()函数就是我们整个Flash的入口了（如果你的类叫做AA，那你的入口就是AA()请不要和C语言的Main函数混淆），这里面的程序最先被执行，所以我们可以在这里面放一些初始化PV3D的代码。下面我们就一步步初始化PV3D。
　　首先，PV3D的3D舞台需要一个容器，用来容纳整个3D舞台。这个容器至少是Sprite类型的，因为Sprite是AS3或者说Flash9里，显示对象的最小单位，这也是我们的主类一定要继承自Sprite的原因，因为它需要被显示。
　　我们现在定义一个容器变量_container，初始化它并把它加到主类的显示列表里。我习惯实例变量用小写开头，前面加下划线 
　　Java代码 
　　
　　
　　package {      import flash.display.Sprite;        public class Main extends Sprite      {          private var _container :Sprite;            public function Main()          {              // 创建3D舞台的容器              _container = new Sprite();              _container.x = 100;              _container.y = 100;                //将它显示出来              addChild( _container );          }      }      package {    import flash.display.Sprite;     public class Main extends Sprite    {        private var _container :Sprite;         public function Main()        {            // 创建3D舞台的容器            _container = new Sprite();            _container.x = 100;            _container.y = 100;             //将它显示出来            addChild( _container );        }    }}
　　我们有了容器，现在需要一个3D舞台。
　　Java代码 
　　
　　
　　package {      import flash.display.Sprite;        import org.papervision3d.scenes.MovieScene3D;          public class Main extends Sprite      {          private var _container :Sprite;          private var _scene :MovieScene3D;            public function Main()          {              // 创建3D舞台的容器              _container = new Sprite();              _container.x = 100;              _container.y = 100;                //将它显示出来              addChild( _container );                // 创建3D舞台              _scene = new MovieScene3D( _container );          }      }      package {    import flash.display.Sprite;     import org.papervision3d.scenes.MovieScene3D;      public class Main extends Sprite    {        private var _container :Sprite;        private var _scene :MovieScene3D;         public function Main()        {            // 创建3D舞台的容器            _container = new Sprite();            _container.x = 100;            _container.y = 100;             //将它显示出来            addChild( _container );             // 创建3D舞台            _scene = new MovieScene3D( _container );        }    }}
　　然后我们需要在舞台上放一个摄像头，他代表我们的眼睛，他能看到的就是你看到的。
　　Java代码 
　　
　　
　　package {      import flash.display.Sprite;        import org.papervision3d.scenes.MovieScene3D;      import org.papervision3d.cameras.Camera3D;        public class Main extends Sprite      {          private var _container :Sprite;          private var _scene :MovieScene3D;          private var _camera :Camera3D;            public function Main()          {              // 创建3D舞台的容器              _container = new Sprite();              _container.x = 100;              _container.y = 100;                //将它显示出来              addChild( _container );                // 创建3D舞台              _scene = new MovieScene3D( _container );                // 创建摄像头              _camera = new Camera3D();              _camera.z = -500;              _camera.zoom = 5;                //把摄像头看到的显示出来              _scene.renderCamera(_camera);          }      }    package {    import flash.display.Sprite;     import org.papervision3d.scenes.MovieScene3D;    import org.papervision3d.cameras.Camera3D;     public class Main extends Sprite    {        private var _container :Sprite;        private var _scene :MovieScene3D;        private var _camera :Camera3D;         public function Main()        {            // 创建3D舞台的容器            _container = new Sprite();            _container.x = 100;            _container.y = 100;             //将它显示出来            addChild( _container );             // 创建3D舞台            _scene = new MovieScene3D( _container );             // 创建摄像头            _camera = new Camera3D();            _camera.z = -500;            _camera.zoom = 5;             //把摄像头看到的显示出来            _scene.renderCamera(_camera);        }    }}
　　现在我们需要有一个3D对象，把它显示出来我们才算成功  。PV3D的所有3D对象都是继承自displayObject3D，就像Flash里的Sprite一样它是最小单位。如果学过面向对象编程，你就会知道父类型的变量可以引用子类型的对象。比如MovieClip是Sprite的子类，那底下的代码是成立的：
　　Java代码 
　　
　　
　　var temp:Sprite  = new MovieClip();    var temp:Sprite  = new MovieClip();
　　考虑到我们程序的通用性，我们的显示对象使用displayObject3D类型，后面初始化时候你可以把它初始化成任意displayObject3D的子类型对象。
　　光一个3D显示对象还是不够的，它需要有个“皮”，你才能看到它….所以，我们同时需要一个材质贴图（至少需要一个，如果是立方体，就需要六个面的贴图）。PV3D中所有材质贴图的基类是MaterialObject3D，所以考虑到通用性…..我就不多说了。
　　Java代码 
　　
　　
　　package {      import flash.display.Sprite;        import org.papervision3d.scenes.MovieScene3D;      import org.papervision3d.cameras.Camera3D;        import org.papervision3d.core.proto.MaterialObject3D;      import org.papervision3d.objec-ts.DisplayObject3D;        import org.papervision3d.materials.WireframeMaterial;      import org.papervision3d.objec-ts.Sphere;        public class Main extends Sprite      {          private var _container :Sprite;          private var _scene :MovieScene3D;          private var _camera :Camera3D;            private var _material:MaterialObject3D;          private var _displayObj:DisplayObject3D;            public function Main()          {              // 创建3D舞台的容器              _container = new Sprite();              _container.x = 100;              _container.y = 100;                //将它显示出来              addChild( _container );                // 创建3D舞台              _scene = new MovieScene3D( _container );                // 创建摄像头              _camera = new Camera3D();              _camera.z = -500;              _camera.zoom = 5;                //黑色的线框材质              _material = new WireframeMaterial(0x000000);                //弄个球玩玩              _displayObj = new Sphere(_material,  80, 10, 10);                //把显示对象添加到舞台              _scene.addChild(_displayObj);                //把摄像头看到的显示出来              _scene.renderCamera(_camera);          }      }      package {    import flash.display.Sprite;     import org.papervision3d.scenes.MovieScene3D;    import org.papervision3d.cameras.Camera3D;     import org.papervision3d.core.proto.MaterialObject3D;    import org.papervision3d.objec-ts.DisplayObject3D;     import org.papervision3d.materials.WireframeMaterial;    import org.papervision3d.objec-ts.Sphere;     public class Main extends Sprite    {        private var _container :Sprite;        private var _scene :MovieScene3D;        private var _camera :Camera3D;         private var _material:MaterialObject3D;        private var _displayObj:DisplayObject3D;         public function Main()        {            // 创建3D舞台的容器            _container = new Sprite();            _container.x = 100;            _container.y = 100;             //将它显示出来            addChild( _container );             // 创建3D舞台            _scene = new MovieScene3D( _container );             // 创建摄像头            _camera = new Camera3D();            _camera.z = -500;            _camera.zoom = 5;             //黑色的线框材质            _material = new WireframeMaterial(0x000000);             //弄个球玩玩            _displayObj = new Sphere(_material,  80, 10, 10);             //把显示对象添加到舞台            _scene.addChild(_displayObj);             //把摄像头看到的显示出来            _scene.renderCamera(_camera);        }    }}
　　把程序运行起来，你可以放在Flex Builder的ActionScript项目中运行，也可以在Flash里把影片的主类设置成我们现在写的代码，不要说你不会Flex Builder就做不了PV3D，这和Flex一点关系都没有的。
　　运行起来你应该会看到一个像这的球：
　　现在我们要让球动起来。记得我之前说的吗？PV3D主要是以帧为单位来控制变化，所以我们需要一个方法可以控制到每一帧。AS3中我们只要注册一个Event.ENTER_FRAME事件的监听程序就可以监听到每一帧开始的时刻。然后，我们可以在我们的监听函数里，做我们需要做的，比如计算，或着让显示对象移动旋转等。
　　而PV3D要求每次舞台发生变化时都要显式的调用舞台对象的renderCamera，重新绘制，否则内容始终是不重绘的。
　　下面是我们的新代码，注意加了一句调用addEventListener的代码，和一个OnEnterFrame函数。
　　Java代码 
　　
　　
　　package {       import flash.display.Sprite;           import org.papervision3d.scenes.MovieScene3D;       import org.papervision3d.cameras.Camera3D;           import org.papervision3d.core.proto.MaterialObject3D;       import org.papervision3d.objec-ts.DisplayObject3D;           import org.papervision3d.materials.WireframeMaterial;       import org.papervision3d.objec-ts.Sphere;       import flash.events.Event;           public class Main extends Sprite       {           private var _container :Sprite;           private var _scene :MovieScene3D;           private var _camera :Camera3D;               private var _material:MaterialObject3D;           private var _displayObj:DisplayObject3D;               public function Main()           {               // 创建3D舞台的容器               _container = new Sprite();               _container.x = 100;               _container.y = 100;                   //将它显示出来               addChild( _container );                   // 创建3D舞台               _scene = new MovieScene3D( _container );                   // 创建摄像头               _camera = new Camera3D();               _camera.z = -500;               _camera.zoom = 5;                   //黑色的线框材质               _material = new WireframeMaterial(0x000000);                   //弄个球玩玩               _displayObj = new Sphere(_material,  80, 10, 10);                   //把显示对象添加到舞台               _scene.addChild(_displayObj);                   //把摄像头看到的显示出来               _scene.renderCamera(_camera);                   this.addEventListener(Event.ENTER_FRAME, OnEnterFrame);           }               private function OnEnterFrame(event:Event):void{               //以Y轴为轴旋转               _displayObj.rotationY += 5;                   _scene.renderCamera(_camera);           }       }   }   package {    import flash.display.Sprite;     import org.papervision3d.scenes.MovieScene3D;    import org.papervision3d.cameras.Camera3D;     import org.papervision3d.core.proto.MaterialObject3D;    import org.papervision3d.objec-ts.DisplayObject3D;     import org.papervision3d.materials.WireframeMaterial;    import org.papervision3d.objec-ts.Sphere;    import flash.events.Event;     public class Main extends Sprite    {        private var _container :Sprite;        private var _scene :MovieScene3D;        private var _camera :Camera3D;         private var _material:MaterialObject3D;        private var _displayObj:DisplayObject3D;         public function Main()        {            // 创建3D舞台的容器            _container = new Sprite();            _container.x = 100;            _container.y = 100;             //将它显示出来            addChild( _container );             // 创建3D舞台            _scene = new MovieScene3D( _container );             // 创建摄像头            _camera = new Camera3D();            _camera.z = -500;            _camera.zoom = 5;             //黑色的线框材质            _material = new WireframeMaterial(0x000000);             //弄个球玩玩            _displayObj = new Sphere(_material,  80, 10, 10);             //把显示对象添加到舞台            _scene.addChild(_displayObj);             //把摄像头看到的显示出来            _scene.renderCamera(_camera);             this.addEventListener(Event.ENTER_FRAME, OnEnterFrame);        }         private function OnEnterFrame(event:Event):void{            //以Y轴为轴旋转            _displayObj.rotationY += 5;             _scene.renderCamera(_camera);        }    }}
　　现在你就能看到球转啊转的样子：
　　花了很大篇幅重新复习了一遍PV3D程序的基础结构….现在可以开始讲讲基本的材质贴图了。其实我们上面的程序就已用到了线框材质贴图。除了线框材质外，PV3D还支持颜色材质，位图材质等，所有这些材质贴图的类都在org.papervision3d.materials包里。
　　我们给上面的程序换上一个黄色的材质贴图看看会是什么样。只要把new WireframeMaterial(0×000000);改成new ColorMaterial(0xFFFF00);然后记得import org.papervision3d.materials.ColorMaterial;就OK了。
　　你的效果应该会和我的一样：
　　再试试位图文件材质，把new ColorMaterial(0xFFFF00);改成new BitmapFileMaterial(”texture.jpg”);这里的”texture.jpg”是我的贴图文件路径，你需要根据你的需要设置，记得这个路径是url格式，不是文件系统路径。
　　贴图效果(不能用ifram-e，所以只能麻烦大家点链接了)：http://flex.unbe.cn/PV3D/Try06_ColorMaterial4/Main.html