在A3D中显示Box
绘制一个Box
参考《配置A3D开发环境》我们讲解测试环境的代码。新建一个项目Demo。打开Main.as，输入如下代码（加粗）：
package
{
importalternativa.engine3d.core.Camera3D;
importalternativa.engine3d.core.Object3D;
importalternativa.engine3d.primitives.Box;
import flash.display.Sprite;
importflash.events.Event;
importflash.display.Stage3D;
/**
* ...
*@author yl
*/
public class Mainextends Sprite
{
//创建一个容器，存放3D场景的所有对象
private var rootContainer:Object3D = new Object3D();
privatevar camera:Camera3D;//创建摄像机
privatevar stage3D:Stage3D;//创建Stage3D对象
privatevar box:Box;//定义一个Box对象
……
}
开始的时候我们在package里面导入了需要用到的类，然后在Main类里定义了4个变量。
（1）Object3D是所有A3D中对象的基类。它是一个容器，能存放其他的3D对象。和MovieClip一样，我们能通过addChild方法来存放其他的3D对象。它拥有和MovieClip相似的属性，如x、y、z、rotationX等。
（2）Camera3D继承自Object3D。它被设计成渲染场景，它在屏幕上不输出任何东西，正确的显示3D对象是显示器的事情。我们看不见不在可可视范围外（场景外）的所有对象，它剔除所有不在可视区域的多边形，这样能节省CPU资源。下面有一段关于Camera3D的通俗解释：
Camera3D：三维摄像机。对于利用Camera来完成三维动画的想法，我一直觉得很是高明。想象一下，我们的眼睛就是摄像机。如果我们想观察一个物体的各个侧面，我们会用手转动这个物体，然后观察。我们为何不换一种思路，把物体放在那，而眼镜（自己的头）绕着物体转呢？这也就是Camera3D的作用。不但我们可以控制场景中物体的任意动画，我们也可以控制摄像机的不同位置与角度。想想CS，不就像是自己拿着摄像机在看一个三维世界吗？这样的设计更合理，也更具与人性的特点。那如何来控制摄像机呢？在A3D中也为我们设计了一下特定的类，后面的教程中将会给大家介绍。同时，在3D中，摄像机必须与View（视窗），相结合使用。那什么又是视窗呢？
引自：http://www.zcool.com.cn/article/ZMTEwMzY=.html
（3）Box是A3D中的3D对象，继承自Object3D。
（4）Stage3D 是Adobe在Flash Player11中引入的一套新的ActionScript API，这套API允许Flash利用硬件渲染3D画面。
以前，在Flash中的3D渲染是不经过硬件加速的。事实上，在Flash Player11以前的所有3D渲染都是软件渲染模式，也就是依靠CPU来完成的。软件渲染模式非常的慢，而且不能用来渲染很细节化的3D场景。
随着Flash Player 11的发布，新的机会来了。开发者可以充分利用3D硬件加速，而不是靠CPU来完成渲染。这种新的渲染模式把渲染工作交给了计算机的视频处理器，也就是所谓的GPU来处理。GPU是一种专门用来处理3D对象的硬件。
关于Stage3D的更多信息可以参考《Stage3D是如何工作的》。
通过下图我们详细了解一下Stage3D类。
1）支持硬件渲染的图像不包含在传统的 DisplayTree 中。 相反，它存在于一个特殊的 stage 中： stage3d。 任何应用程序都可以有四种不同的 stage3d 元素，应用程序至少需要一个Stage3D。它们全部作为层放置在彼此之上，但是却都位于 DisplayTree 之下。 这就保证了平面 Flash 对象总是与3D 图像重叠。可以通过下面代码获取：stage3D = stage.stage3Ds [0];
2）Stage3D willalways be behind any DisplayObject'a, that is, we can not place the spritebehind 3D graphics ...
3）Stage3D有一个Context3D属性。所有在3D场景中的对象都要上传自GPU内存Context3D。当所有的资源被加载完成和Content3D被建立，才能在显示器上显示图形。
publicfunction Main() {
……
stage3D= stage.stage3Ds[0];//获取stage3D对象
//创建Content3D后，调用onContextCreate
stage3D.addEventListener(Event.CONTEXT3D_CREATE,onContextCreate);
stage3D.requestContext3D();
}
（5）View类。View在构造方法中有定义：
privatefunction init(e:Event = null):void {
removeEventListener(Event.ADDED_TO_STAGE,init);
// entrypoint
stage.align= "TL";//设置SWF在播放器或浏览器中的当前对齐方式，TL表示居顶左侧
//创建摄像机，0.1表示近裁剪距离，10000表示远裁剪距离
camera = new Camera3D(0.1, 10000);
//创建视窗，所有显示对象可由这个视窗观察
camera.view = new View(stage.stageWidth,stage.stageHeight);
……
//view不需要放入3D场景中，只需将摄像机观察的视窗加载进Sprite（显示列表）
addChild(camera.view);
}
现在我们只需要注意加粗的语句，View是一个视窗。我们来想想一下，你面前有扇门，门上有一个正方形小孔，你想通过小孔看看门后房子里是什么东西，而你和门之间有一段距离，就如下面的那张图。为了看得更全，你可以移动自己的眼镜（Camera3D），但是，你能看见的范围却只有那个孔那么大。这就是视窗View与摄像机Camera3D之间的关系，我们使用：camera.view 来组合他们的关系。视窗是用来观察场景（Scene3D.root）空间的一个窗口，所以视窗不用放在3D场景之中。
依据上图，总结一下前面的知识点。在一个A3D项目中
（1）至少有一个Stage3D对象，可以通过stage舞台类获取：
stage3D = stage.stage3Ds[0];//获取stage3D对象
（2）将所有显示的3D对象放入Object3D容器中（包括摄像机Camera3D）
private functioninit(e:Event = null):void {
……
rootContainer.addChild(camera);//将摄像机加载进容器
box = new Box(500, 500, 500, 5, 5, 5);
var material:FillMaterial = newFillMaterial(0xFF7700);
box.setMaterialToAllSurfaces(material);
rootContainer.addChild(box);//将box加载进容器
……
}
（3）将视窗加载进显示列表
……
//view不需要放入3D场景中，只需将摄像机观察的视窗加载进Sprite（显示列表）
addChild(camera.view);
……
（4）将所有的3D对象上传到GPU的内存Contex3D
（5）渲染stage3D
下面是后面2步的代码实现。
private function onContextCreate(e:Event):void {
//遍历在容器中所有资源
for each(var resource:Resource in rootContainer.getResources(true)) {
resource.upload(stage3D.context3D);//所有资源上传自GPU内存Content3D
}
stage.addEventListener(Event.ENTER_FRAME, onEnterFrame);
}
private function onEnterFrame(e:Event):void {
//camera.rotationZ-= 0.01;
camera.render(stage3D);//渲染Stage3D，显示在Content3D的对象
}