PV3D2.0基本教學二

設定PV3D類別檔, 可以參考奶老師的第一篇教學
PV3D2.0基本教學一
PV3D世界是由幾個基本的物件組合而成, 如果你有3D動畫的製作經驗, 應該很好理解,
如果沒有也沒關係, 後面的許多範例會一一介紹到。
Viewport3D：
視圖窗口, 簡單來說可以想像是Flash裡畫布的大小, 也可以理解成算圖的尺寸。
Scene3D：整個3D的場景, 之後建立的3D物件都是被加入至其中。
Camera3D：PV3D的鏡頭, Camera3D是用來拍攝Scene3D的畫面。
BasicRenderEngine：算圖類別, 把所有的數據值結果運算成圖像。
像想一下你座在一台電視機前, 電視機的螢幕尺吋就是Viewport3D的大小
電視台的攝影棚就是Scene3D, 攝影機就是Camera3D, 當電視機收到訊號,
透過訊號轉換將數據運算成圖像, 這個工作就像是BasicRenderEngine類別。
流程即是BasicRenderEngine 運算Camera3D所看到的Scene3D世界,
並將畫面呈現在Viewport3D。
一次要記住四個類別對第一次使用PV3D的使用者可能會有些害怕。
新版本的PV3D 提供了一個整合的視圖類別BasicView。

該類別是繼承Sprite, 所以可以被加入至可視物件容器裡。
BasicView類別已包含了Scene3D,Camera3D,Renderer,Viewport四種物件,
不需要再另外建構。
因為PV3D畫面需要不斷的被更新, 透過Event.ENTER_FRAME事件不斷運算,即可一直更新畫面。
建立PV3D世界的步驟。
1.建立一個類別檔當作文件檔當別使用, 該類別必需是繼承MovieClip或是Sprite。
public class 類別名稱 extends MovieClip
2.匯入PV3D所需的類別。
import org.papervision3d.view.BasicView;
要一次匯入該類別包下的所有類別, 可以使用星號來代示。
import org.papervision3d.view.*;
3.宣告PV3D所需的相關變數
private var view:BasicView;
view變數, 型別為BasicView。
4.建立init3DEngine 函式, 用來初始化BasicView物件, 同時偵聽Event.ENTER_FRAME事件。
private function init3DEngine():void{
view = new BasicView(0, 0, true, true, "Target")
//建構BasicView物件。
this.addChild(view);
//將view物件加入至目前的可視物件容器裡。
this.addEventListener(Event.ENTER_FRAME, onEventRender3D); ;
//偵聽Event.ENTER_FRAME事件。
}
5.偵聽者函式onEventRender3D, 用來運算場景畫面。
private function onEventRender3D(e:Event){
view.singleRender();
//執行view物件的singleRender函式。
}
6.建立init3DObject函式, 用來建立其他PV3D物件。
private function init3DObject ():void{
//在這建立其他的PV3D物件
}
7.在建構函式執行init3DEngine,init3DObject函式。
發怖後即可看到輸出訊息。
INFO: Papervision3D Public Beta 2.0 - Great White (December 3rd, 2008)
INFO: Viewport autoScaleToStage : Papervision has changed the Stage scale mode.
完整程式碼：

package{ 
import flash.display.MovieClip;
//匯入MovieClip類別。
import flash.events.Event;
//匯入事件類別。
import org.papervision3d.view.BasicView;
//匯入BasicView類別。
public class A01_BasicDocument extends MovieClip { 
//A01_BasicDocument類別, 繼承MovieClip。  
private var view:BasicView;  
//宣告view變數為BasicView物件。  
public function A01_BasicDocument():void{
//建構函式, 該類別被實體化時, 會執行一次。
//可以把要初始化的值或物件寫在這。 
init3DEngine(); //執行initPV3DEngine函式。
init3DObject(); //執行initPV3DObject函式。
}
private function init3DEngine():void{
//此函式的用意，是用來建立PV3D所需的基本物件類別。
//在此建構BasicView物件、設定Camera參數。
view = new BasicView(0, 0, true, true, "Target");     
//建構BasicView物件   
//參數值(
//viewport寬度, viewport高度, 是否自動對齊場景中間
//, 是否開啟滑鼠感應功能,camera類別) 
//viewport寬度和viewport高度設定為0的話，
//表示寬高是跟著整個場景的大小。   
//PV3D的Camera有二種類型：
//Target：目標Camera，不論鏡頭怎麼移動，永遠看著目標點。
//Free ：自由Camera，可以任意的移動和旋轉鏡頭。
this.addChild(view);   
//BasicView是繼承Sprite物件，可被加入至顯示物件容器裡。   
this.addEventListener(Event.ENTER_FRAME, onEventRender3D);    
//偵聽ENTER_FRAME事件。
}
private function init3DObject():void{
//init3DObject函式, 用來建立PV3D物件、材質及偵聽事件。
}
private function onEventRender3D(e:Event):void {   
view.singleRender();
//運算view物件。
//使用算圖類別，運算Camera所看到的Scene3D世界
//並將結果呈顯在view裡。
}
}
}