パッケージflash.geom
クラスpublic class Utils3D
継承Utils3D Inheritance Object

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

Utils3D クラスには、特定の 3 次元マトリックス操作の実装を単純化する静的メソッドが含まれます。

関連項目

flash.geom.Matrix3D
flash.geom.Vector3D
flash.geom.Transform
flash.geom.PerspectiveProjection
flash.display.Graphics
flash.display.GraphicsTrianglePath
Vector


パブリックプロパティ
 プロパティ定義元
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
パブリックメソッド
 メソッド定義元
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
  
pointTowards(percent:Number, mat:Matrix3D, pos:Vector3D, at:Vector3D = null, up:Vector3D = null):Matrix3D
[静的] 位置に対するオブジェクトの方向を補間します。
Utils3D
  
[静的] 投影 Matrix3D オブジェクトを使用して、ある空間座標から別の空間座標に Vector3D オブジェクトを投影します。
Utils3D
  
projectVectors(m:Matrix3D, verts:Vector.<Number>, projectedVerts:Vector.<Number>, uvts:Vector.<Number>):void
[静的] 投影 Matrix3D オブジェクトを使用して、3 次元空間座標のベクター(verts)を 2 次元空間座標のベクター(projectedVerts)に投影します。
Utils3D
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
メソッドの詳細
pointTowards()メソッド
public static function pointTowards(percent:Number, mat:Matrix3D, pos:Vector3D, at:Vector3D = null, up:Vector3D = null):Matrix3D

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

位置に対するオブジェクトの方向を補間します。pointTowards() メソッドは、Matrix3D.pointAt() メソッドと Matrix3D.interpolateTo() メソッドの機能を組み合わせたものです。

pointTowards() メソッドにより、方向をその場で変更できます。表示オブジェクトの Matrix3D を分解し、回転エレメントをターゲットの位置の方に 1 %回転させるエレメントに置き換えます。オブジェクトをそれ自身の方向に移動しつつ、ターゲットの方に増分しながら回転できます。変換メソッドの後に pointTowards() を呼び出すことで、移動するターゲットの後を追って動くオブジェクトのアニメーションを作成できます。まず、オブジェクトをターゲットの方に 1 パーセントポイント向けてから、オブジェクトを軸に沿って増分しながら移動します。

パラメータ

percent:Number — オブジェクトをターゲットの方に増分しながら回転させる 0 ~ 1 の数値です。
 
mat:Matrix3D — 変換されるオブジェクトの Matrix3D プロパティです。
 
pos:Vector3D — ターゲットオブジェクトのワールドを基準とする位置です。ワールド基準により、すべてのオブジェクトが配置される範囲空間と座標を基準とするオブジェクトの変換が定義されます。
 
at:Vector3D (default = null) — 表示オブジェクトの位置を定義する、オブジェクトを基準とするベクターです。オブジェクト基準により、オブジェクト空間、つまりオブジェクトの参照フレームと座標系を基準とするオブジェクトの変換が定義されます。デフォルト値は(0,0,-1)です。
 
up:Vector3D (default = null) — 表示オブジェクトの「上方向」を定義する、オブジェクトを基準とするベクターです。オブジェクトを見下ろして描画する場合、+z 軸は「上方向」へのベクトルになります。オブジェクト基準により、オブジェクト空間、つまりオブジェクトの参照フレームと座標系を基準とするオブジェクトの変換が定義されます。デフォルト値は(0,-1.0)です。

戻り値
Matrix3D — 2 番目のパラメータで指定される、変更された Matrix3D オブジェクトです。pointTowards() メソッドを使用して表示オブジェクトを変換するには、表示オブジェクトの Matrix3D プロパティを返される Matrix3D オブジェクトに設定します。

関連項目

projectVector()メソッド 
public static function projectVector(m:Matrix3D, v:Vector3D):Vector3D

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

投影 Matrix3D オブジェクトを使用して、ある空間座標から別の空間座標に Vector3D オブジェクトを投影します。projectVector() メソッドは Matrix3D.transformVector() メソッドに似ていますが、projectVector() メソッドは、元の Vector3D オブジェクトの xy および z の各エレメントを投影の奥行きの値で除算する点が異なります。 奥行きの値とは、視点からビューまたは視点空間の Vector3D オブジェクトまでの距離です。この距離のデフォルト値は、z エレメントの値です。

パラメータ

m:Matrix3D — 投影変換を実装する投影 Matrix3D オブジェクトです。表示オブジェクトに PerspectiveProjection オブジェクトがある場合、perspectiveProjection.toMatrix() メソッドを使用して、表示オブジェクトの子に適用される投影 Matrix3D オブジェクトを作成できます。 高度な投影の場合は、matrix3D.rawData プロパティを使用してカスタム投影マトリックスを作成します。投影 Matrix3D オブジェクトを作成するためのビルトイン Matrix3D メソッドはありません。
 
v:Vector3D — 新しい空間座標に投影される Vector3D オブジェクトです。

戻り値
Vector3D — 変換された空間座標を持つ新しい Vector3D です。

関連項目

projectVectors()メソッド 
public static function projectVectors(m:Matrix3D, verts:Vector.<Number>, projectedVerts:Vector.<Number>, uvts:Vector.<Number>):void

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

投影 Matrix3D オブジェクトを使用して、3 次元空間座標のベクター(verts)を 2 次元空間座標のベクター(projectedVerts)に投影します。 投影された Vector オブジェクトがパラメータとして使用される前に、事前に割り当てる必要があります。

projectVectors() メソッドは、t 値(uvt データの)も設定します。座標の投影されたベクターのセットごとに uvts データを保持できるベクターを事前に割り当てる必要があります。u 値と v 値(uvt データの)も指定します。uvt データは、テクスチャマッピングに使用される正規化された座標のベクターです。UV 座標では、(0,0)はビットマップの左上隅で、(1,1)はビットマップの右下隅です。

このメソッドは、Graphics.drawTriangles() メソッドおよび GraphicsTrianglePath クラスと組み合わせて使用できます。

パラメータ

m:Matrix3D — 投影変換を実装する投影 Matrix3D オブジェクトです。 Matrix3D.rawData プロパティを使用して、投影 Matrix3D オブジェクトを作成できます。
 
verts:Vector.<Number> — 数値のベクターで、3 つの数値ごとに、3 次元空間の xy および z の各座標を表します。例えば、Vector3D(x,y,z) のようになります。
 
projectedVerts:Vector.<Number> — 数値のベクターで、2 つの数値ごとに、投影された 2 次元座標を表します。例えば、Point(x,y) のようになります。 ベクターを事前に割り当てる必要があります。projectVectors() メソッドは、投影された各ポイントの値を設定します。
 
uvts:Vector.<Number> — 数値のベクターで、3 つの数値ごとに、uv および t の各エレメント(uvt データの)を表します。 uv は、投影された各ポイントのテクスチャ座標です。t 値は投影の奥行きの値、つまり視点からビューまたは視点空間の Vector3D オブジェクトまでの距離です。ベクターを事前に割り当て、u 値と v 値を指定する必要があります。projectVectors メソッドは、投影された各ポイントの t 値を設定します。

関連項目