メインコンテンツへスキップ

ベクトル3

3Dベクトルを表すインターフェイス。 3Dベクトルは(x, y, z)座標で表現され、空間内の点、方向ベクトル、または3つの順序付けられた次元を持つ他のタイプのデータを表すことができる。 3Dベクトルは、同次座標計算を使用して4x4行列（Mat4）と乗算することができ、効率的な3Dジオメトリ計算を可能にします。 Vec3オブジェクトは、ecs.math.vec3 Vec3Factory、または他のVec3オブジェクトの操作によって作成されます。

ソース​

Vec3Source インターフェースは、x, y, z プロパティを持つオブジェクトを表す。 さらに、Vec3SourceはVec3アルゴリズムの引数として使用できる。つまり、 {x: number, y: number, z: number} プロパティを持つオブジェクトなら何でも使用できる。

プロパティ一覧​

Vec3は以下の列挙可能な特性を持つ:

readonly x: number`` ベクトルのx成分にアクセスする。

readonly y: number`` ベクトルのy成分にアクセスする。

読み取り専用 z: number`` ベクトルのz成分にアクセスする。

工場​

より​

Vec3、またはx、yのプロパティを持つ他のオブジェクトからVec3を作成します。

ecs.math.vec3.from({x, y}: {x: number, y: number, z: number}}) // -> vec3

ひとつ​

すべての要素が1に設定されたvec3を作成する。 これは ``vec3.from({x: 1, y: 1, z: 1})``` と等価である。

ecs.math.vec3.one() // -> vec3

scale​

すべての要素がスケール値 s に設定された vec3 を作成します。 これは ``vec3.from({x: s, y: s, z: s})``` と等価である。

ecs.math.vec3.scale(s: number) // -> vec3

キシ​

x, y, z値からVec3を作成する。 これは ``vec3.from({x, y, z})``` と等価である。

ecs.math.vec3.xyz(x: 数, y: 数, z: 数) // -> vec3

ゼロ​

すべての要素がゼロに設定されたvec3を作成する。 これは ``vec3.from({x: 0, y: 0, z: 0})``` と等価である。

ecs.math.vec3.zero() // -> vec3

不変​

以下のメソッドは、Vec3の現在値に基づいて計算を実行するが、その内容は変更しない。 Vec3型を返すメソッドは新しいオブジェクトを返す。 イミュータブルAPIは一般的に、ミュータブルAPIよりも安全で、可読性が高く、エラーが起こりにくいが、フレームごとに何千ものオブジェクトが割り当てられるような状況では非効率的かもしれない。

メモ

ガベージ・コレクションがパフォーマンスに影響する場合は、後述するMutable APIの使用を検討してください。

クローン​

このベクトルと同じ成分を持つ新しいベクトルを作成する。

existingVec3.clone() // -> vec3

クロス​

このベクトルと別のベクトルの外積を計算する。

existingVec3.cross(v: Vec3Source) // -> vec3

データ​

ベクトルを同次配列（4次元）としてアクセスする。

既存Vec3.data() // -> 数[]

距離​

このベクトルと別のベクトルとのユークリッド距離を計算する。

existingVec3.distanceTo(v: Vec3Source) // -> vec3

分水嶺​

要素ごとのベクトル除算。

existingVec3.divide(v: Vec3Source) // -> vec3

ドット​

このベクトルと別のベクトルの内積を計算する。

existingVec3.dot(v: Vec3Source) // -> vec3

イコール​

2つのベクトルが等しいかどうかを、指定された浮動小数点数の許容誤差でチェックする。

existingVec3.equals(v: Vec3Source, tolerance: number) // -> boolean

長さ​

ベクトルの長さ。

existingVec3.length() // -> 数

マイナス​

このベクトルからベクトルを引く。

existingVec3.minus(v: Vec3Source) // -> vec3

ミックス​

このベクトルと別のベクトル v の間の線形補間を計算し、その結果が thisVec * (1 - t) + v * t となるように係数 t を指定する。 係数tは0から1の間でなければならない。

existingVec3.mix(v: Vec3Source, t: number) // -> vec3

ノーマライズ​

このベクトルと同じ方向で、長さが 1 の新しいベクトルを返す。

existingVec3.normalize() // -> vec3

プラス​

2つのベクトルを足し合わせる。

existingVec3.plus(v: Vec3Source) // -> vec3

scale​

ベクトルにスカラーを掛ける。

existingVec3.scale(s: number) // -> vec3

回​

要素ごとのベクトル乗算。

existingVec3.times(v: Vec3Source) // -> vec3

ミュータブル​

以下のメソッドは、Vec3の現在値に基づいて計算を行い、その内容をその場で変更する。 これらは、上記のミュータブルAPIのメソッドと並行している。 Vec3型を返すメソッドは、メソッドの連鎖を便利にするために、現在のオブジェクトへの参照を返す。 変更可能なAPIは不変なAPIよりもパフォーマンスが高いが、一般的に安全性や可読性に劣り、エラーが発生しやすい。

セットクロス​

このベクトルと別のベクトルの外積を計算する。 このVec3に結果を格納し、連鎖のためにこのVec3を返す。

existingVec3.setCross(v: Vec3Source) // -> vec3

setDivide​

要素ごとのベクトル除算。 このVec3に結果を格納し、連鎖のためにこのVec3を返す。

existingVec3.setDivide(v: Vec3Source) // -> vec3

セットマイナス​

このベクトルからベクトルを引く。 このVec3に結果を格納し、連鎖のためにこのVec3を返す。

existingVec3.setMinus(v: Vec3Source) // -> vec3

セットミックス​

このベクトルと別のベクトル v の間の線形補間を計算し、その結果が thisVec * (1 - t) + v * t となるように係数 t を指定する。 係数tは0から1の間でなければならない。 このVec3に結果を格納し、連鎖のためにこのVec3を返す。

existingVec3.setMinus(v: Vec3Source, t: number) // -> vec3

セット・ノーマライズ​

ベクトルを同じ方向で、長さ1のバージョンにする。 このVec3に結果を格納し、連鎖のためにこのVec3を返す。

existingVec3.setNormalize() // -> vec3

セットプラス​

2つのベクトルを足し合わせる。 このVec3に結果を格納し、連鎖のためにこのVec3を返す。

existingVec3.setPlus(v: Vec3Source) // -> vec3

セットスケール​

ベクトルにスカラーを掛ける。 このVec3に結果を格納し、連鎖のためにこのVec3を返す。

existingVec3.setPlus(s: number) // -> vec3

セットタイムズ​

要素ごとのベクトル乗算。 このVec3に結果を格納し、連鎖のためにこのVec3を返す。

existingVec3.setTimes(v: Vec3Source) // -> vec3

セットエックス​

Vec3のx成分を設定する。 結果をこの Vec3 に格納し、連鎖のためにこの Vec3 を返す。

existingVec3.setX(v: number) // -> vec3

セットY​

Vec3のy成分を設定する。 このVec3に結果を格納し、連鎖のためにこのVec3を返す。

existingVec3.setY(v: number) // -> vec3

セットZ​

Vec3のz成分を設定する。 結果をこの Vec3 に格納し、連鎖のためにこの Vec3 を返す。

existingVec3.setZ(v: number) // -> vec3

セット​

以下のメソッドは、現在のVec3オブジェクトの値を、その現在の内容に関係なく設定します。

メイクワン​

Vec3をすべて1にする。 このVec3に結果を格納し、連鎖のためにこのVec3を返す。

existingVec3.makeOne() // -> vec3

メイクスケール​

すべての成分がスケール値sに設定されるようにVec3を設定する。 このVec3に結果を格納し、連鎖のためにこのVec3を返す。

existingVec3.makeScale(s: number) // -> vec3

メイクゼロ​

Vec3をすべてゼロにする。 このVec3に結果を格納し、連鎖のためにこのVec3を返す。

existingVec3.makeZero() // -> vec3

セット・フロム​

このVec3を、x、y、zのプロパティを持つ別のVec3または他のオブジェクトと同じ値に設定する。 結果をこの Vec3 に格納し、連鎖のためにこの Vec3 を返す。

existingVec3.setFrom(source: Vec3Source) // -> vec3

setXyz​

Vec3のx、y、z成分を設定する。 このVec3に結果を格納し、連鎖のためにこのVec3を返す。

existingVec3.setFrom(x: 数, y: 数, z: 数) // -> vec3