［Return］

Plane

バージョン：Alternativa 3D 8.17.0

Alternativa3D 8 では 8.17.0 から、デフォルトの図形（プリミティブ）として、板である Plane が用意されています。
これを基本のソースを元に表示してみましょう

package
{
	import flash.display.Sprite;
	import flash.display.Stage3D;
	import flash.events.Event;

	import alternativa.engine3d.core.Camera3D;
	import alternativa.engine3d.core.Object3D;
	import alternativa.engine3d.core.Resource;
	import alternativa.engine3d.core.View;

	import alternativa.engine3d.primitives.Plane;
	import alternativa.engine3d.materials.FillMaterial;

	public class Main extends Sprite
	{
		private var stage3D:Stage3D; // Stage3D
		private var camera:Camera3D; // カメラ
		private var scene:Object3D; // 3D空間

		private var plane:Plane; // 板

		//
		//　コンストラクタ（クラスの定義処理）
		//
		public function Main()
		{
			// ステージに追加されたら、初期化処理を呼ぶ
			addEventListener(Event.ADDED_TO_STAGE, init);
		}

		//
		//　初期化
		//
		private function init(ev:Event):void
		{
			// 3D の空間を定義
 			scene = new Object3D();

			// 3D カメラ作成
			camera = new Camera3D(1, 10000);

			// カメラが描画する範囲（view）をステージサイズに設定
			camera.view = new View(stage.stageWidth, stage.stageHeight);
			camera.rotationX = 180 * Math.PI / 180;
			addChild(camera.view);

			// 統計情報の表示
			addChild(camera.diagram);

			//
			// カメラの座標設定
			//
			camera.x = 0;
			camera.y = 0;
			camera.z = 100;

			// カメラの座標設定
			scene.addChild(camera);

			// 0 番目の Stage3D を利用
			stage3D = stage.stage3Ds[0];

			// Context3D が作成された際に呼ばれるハンドラを設定
			stage3D.addEventListener(Event.CONTEXT3D_CREATE, onContextCreate);

			// Stage3D に Context3D の作成を要求
			stage3D.requestContext3D();
		}

		//
		//　Stage3D に Context3D の準備が出来たときに呼ばれるイベントハンドラ
		//
		private function onContextCreate(e:Event):void
		{
			//　イベントリスナーを削除
			stage3D.removeEventListener(Event.CONTEXT3D_CREATE, onContextCreate);

			//
			//　Plane を空間に追加
			//
			plane = new Plane(25, 25, 1, 1, true, false, new FillMaterial(0x0000ff, 1.0), new FillMaterial(0xff0000, 1.0));
			scene.addChild(plane);

			// scene にある 3D リソースを取得して、Context3D にアップロード
			var resources:Vector.<Resource> = scene.getResources(true);

			for each (var resource:Resource in resources)
			{
				resource.upload(stage3D.context3D);
			}

			//
			//　毎フレーム毎の処理を設定
			//
			addEventListener(Event.ENTER_FRAME, onEnterFrameHandler);
		}

		//
		//　毎フレーム毎の処理のイベントハンドラ
		//
		private function onEnterFrameHandler(ev:Event):void
		{
			// カメラで見えているものを Stage3D に描画する
			camera.render(stage3D);
		}
	}
}

基本から追加されたのは、下記の三ヶ所です。

import alternativa.engine3d.primitives.Plane;
import alternativa.engine3d.materials.FillMaterial;

private var plane:Plane; // 板

plane = new Plane(25, 25, 1, 1, true, false, new FillMaterial(0x0000ff, 1.0), new FillMaterial(0xff0000, 1.0));
scene.addChild(plane);

Plane を作成し、空間に配置します。
配置する場所は指定していませんので、デフォルトの場所である原点（0, 0, 0）に配置されます。

Plane の面には、ベタ塗りの素材である「FillMaterial」を割り当てます。
このため画面上には、赤のベタ塗りの四角が表示されます。

FillMaterial はライトが無くてもベタ塗りとして表示されますので、図形が表示されているかどうかを区別するのには、分かりやすい素材です。

板を置いたのに、なんで平面的な四角なの？と思われた方もいらっしゃるかもしれませんが、それは板とカメラから見ている視点との関係です。
板を回したり、カメラの位置を動かしたりすると、板が立体的になっていることが分かります。

試しに、毎フレームごとに板の回転軸の値を変えて、板を回してみましょう。

//
//　毎フレーム毎の処理のイベントハンドラ
//
private function onEnterFrameHandler(ev:Event):void
{
	//　板を回す
	plane.rotationY += 0.5 * Math.PI / 180;

	// カメラで見えているものを Stage3D に描画する
	camera.render(stage3D);
}

ベタ塗りですけれど、ちゃんと板が配置されていて、それが回っているのが分かりますね。

Plane では、作成時に表と裏の面のマテリアルを個別に設定出来ますので、ここでは裏側を青にしています。
これにより、表と裏の違いが分かりやすくなっています。

マテリアルをテクスチャーを使ったものに変更して、ライトを追加すると、より立体的に見せることが出来ます。
その辺は、マテリアルやライトの使い方になりますので、そちらで紹介します。

ツイート

［Return］