VertexBuffer3D - Adobe ActionScript® 3（AS3 ）API リファレンス

パッケージ	flash.display3D
クラス	public class VertexBuffer3D
継承	VertexBuffer3D Object

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

Flash Player 11, AIR 3

VertexBuffer3D クラスは、レンダリングコンテキスにアップロードされる頂点データセットを表します。

VertexBuffer3D オブジェクトを使用して、頂点セットの各ポイントに関連付けられているデータを定義します。ベクトル配列または ByteArray から頂点データをアップロードすることができます（アップロードすると、元の配列のデータは参照されないので、元の配列を変更したり削除したりしても頂点データは変更されません）。

各頂点に関連付けられているデータはアプリケーションで定義される形式で、頂点シェーダープログラム用の入力として使用されます。Context3D の setVertexBufferAt() 関数を使用して、頂点プログラムの入力に属する値を特定します。頂点プログラムでは、最大 8 個の入力（頂点属性レジスタとも呼ばれます）を使用できます。各入力には 1 ～ 4 個の 32 bit 値が必要になります。例えば、頂点の [x,y,z] 位置座標は、3 個の 32 bit 値を含むベクトルとして頂点プログラムに渡されます。Context3DVertexBufferFormat クラスは、シェーダーの入力でサポートされる形式の定数を定義します。各ポイントに対し、最大 64 個の 32 bit 値（256 バイト）のデータを提供できます（ただし、この場合、1 つの頂点シェーダーですべてのデータを使用することはできません）。

また、setVertexBufferAt() 関数も後続の drawTriangles() 呼び出しのレンダリングに使用する頂点バッファーを特定します。別の頂点バッファーのデータをレンダリングするには、該当する引数を使用して、再度 setVertexBufferAt() を呼び出します（複数の頂点バッファーに同一ポイントのデータを保存できます。例えば、1 つのバッファーに位置データを保存し、別のバッファーにテクスチャ座標を保存できますが、通常、ポイントのすべてのデータが 1 つのバッファーから送信されると、レンダリングが効率的に行われます）。

Context3D の drawTriangles() メソッドに渡された Index3DBuffer オブジェクトにより、頂点データが整理されて三角形が生成されます。インデックスバッファーのそれぞれの値は、頂点バッファーの頂点に対するインデックスです。一連の 3 つのインデックスで順に 1 つの三角形を定義します。

VertexBuffer3D オブジェクトを直接作成することはできません。代わりに、Context3D の createVertexBuffer() メソッドを使用します。

頂点バッファーに関連付けられているレンダリングコンテキストのリソースを解放するには、オブジェクトの dispose() メソッドを呼び出します。

例を表示

	プロパティ	定義元
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。	Object

	メソッド	定義元
		dispose():void このオブジェクトに関連付けられているすべてのリソースを解放します。	VertexBuffer3D
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		toLocaleString():String ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。	Object
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		uploadFromByteArray(data:ByteArray, byteArrayOffset:int, startVertex:int, numVertices:int):void バイト配列のレンダリングコンテキストにポイントセットのデータをアップロードします。	VertexBuffer3D
		uploadFromVector(data:Vector.<Number>, startVertex:int, numVertices:int):void ベクトル配列のレンダリングコンテキストにポイントセットのデータをアップロードします。	VertexBuffer3D
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object

dispose

()

メソッド

public function dispose():void

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

Flash Player 11, AIR 3

このオブジェクトに関連付けられているすべてのリソースを解放します。頂点バッファーを破棄すると、このオブジェクトを使用した upload() の呼び出しやレンダリングは失敗します。

uploadFromByteArray

()

メソッド

public function uploadFromByteArray(data:ByteArray, byteArrayOffset:int, startVertex:int, numVertices:int):void

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

Flash Player 11, AIR 3

バイト配列のレンダリングコンテキストにポイントセットのデータをアップロードします。

パラメーター

	`data:ByteArray` — 頂点データを含むバイト配列。各データ値は 4 バイト長です。1 つの頂点に含める値の数は、バッファーの作成時に、Context3D の `createVertexBuffer3D()` メソッドに渡す `data32PerVertex` パラメーターを使用して指定されます。データのバイト長は、`byteArrayOffset` + （1 つの頂点に含まれる値の数の 4 倍） x （頂点の数）になる必要があります。ByteArray オブジェクトではリトルエンディアン形式を使用する必要があります。

	`byteArrayOffset:int` — データの先頭からスキップするバイト数。

	`startVertex:int` — 最初にロードする頂点のインデックス。startVertex の値が 0 以外であれば、この値を頂点データのサブ領域のロードに使用できます。

	`numVertices:int` — `data` からロードする頂点の数。

例外

	`TypeError` — Null ポインターエラーです：`data` が null の場合。

	`RangeError` — 入力サイズが正しくありません：`byteArrayOffset` が 0 より小さい、`byteArrayOffset` が `data` の長さ以上、または`data` 内のエレメントの数 - `byteArrayOffset` が `Context3D::createVertexBuffer()` で指定される `numVertices``data32pervertex`4 よりも小さい場合。

	`Error` — 3768：バックグラウンドでの実行中、`Stage3D` API は使用できません。

uploadFromVector

()

メソッド

public function uploadFromVector(data:Vector.<Number>, startVertex:int, numVertices:int):void

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

Flash Player 11, AIR 3

ベクトル配列のレンダリングコンテキストにポイントセットのデータをアップロードします。

パラメーター

	`data:Vector.<Number>` — 32 bit 値のベクトル。1 つの頂点は、ベクトルに連続して保存される多くの値から構成されます。1 つの頂点に含める値の数は、バッファーの作成時に、Context3D の `createVertexBuffer3D()` メソッドに渡す `data32PerVertex` パラメーターを使用して指定されます。ベクトルの長さは、1 つのベクトルに含まれる値の数に頂点の数を乗じた値になる必要があります。

	`startVertex:int` — 最初にロードする頂点のインデックス。`startVertex` の値が 0 以外であれば、この値を頂点データのサブ領域のロードに使用できます。

	`numVertices:int` — `data` によって示される頂点の数。

例外

	`TypeError` — Null ポインターエラーです：`data` が null の場合。

	`RangeError` — 入力サイズが正しくありません：`data` 内のエレメントの数が `Context3D::createVertexBuffer()` で指定される `numVertices` * `data32PerVertex` よりも小さい、または `startVertex` + `numVertices` が `Context3D::createVertexBuffer()` で指定される `numVertices` よりも大きい場合。

例この例の使用方法

Context3D_createVertex.as

次の例は、頂点データバッファーを作成し読み込む方法を示しています。この例のバッファーには、1 つの頂点につき 2 種類のデータが含まれています。x、y、z 座標で表される位置と、rgb 成分で表されるカラーです。頂点バッファーの作成後、この例では setVertexBufferAt() メソッドを呼び出して、最初の 3 組のデータポイントが va0 で 3 つの浮動小数点値として頂点プログラムに渡されること、および 2 つ目の 3 組のデータポイントが va1 として渡されることを指定します。頂点プログラムでは、この方法で最大 8 つの入力（頂点属性レジスタとも呼ばれます）を定義できます。

const dataPerVertex:int = 6;
var vertexData:Vector.<Number> = Vector.<Number>(
    [
      // x, y, z    r, g, b format
         0, 0, 0,   1, 1, 1,
        -1, 1, 0,   0, 0,.5,
         1, 1, 0,   0, 0, 1,
         1,-1, 0,  .5, 0, 0,
        -1,-1, 0,   1, 0, 0
    ]
);
var vertexes:VertexBuffer3D = renderContext.createVertexBuffer( vertexData.length/dataPerVertex, dataPerVertex );
vertexes.uploadFromVector( vertexData, 0, vertexData.length/dataPerVertex );
            
//Identify vertex data inputs for vertex program
renderContext.setVertexBufferAt( 0, vertexes, 0, Context3DVertexBufferFormat.FLOAT_3 ); //Defines shader input va0 as the position data
renderContext.setVertexBufferAt( 1, vertexes, 3, Context3DVertexBufferFormat.FLOAT_3 ); //Defines shader input va1 as the color data

法律上の注意 | プライバシーポリシー

VertexBuffer3D - AS3

パッケージx

言語エレメント

付録

パッケージ flash.display3D

dispose

uploadFromByteArray

uploadFromVector