Class GeoMath

数学ユーティリティー

数学関連の関数または定数を定義するユーティリティークラスである。このクラスは static メンバーしか持たない。

Properties

`Static` `Readonly` DEGREE

DEGREE: number = 0.017453292519943295769

1度に対応するラジアンの数値

この数値は π / 180 である。度数を DEGREE で掛け合せることによってラジアンに変換することができる。

`Static` `Readonly` EARTH_RADIUS

EARTH_RADIUS: number = 6378137

地球の半径

Inou 球面座標系で定義された、地球の半径 (Meters) である。

`Static` `Readonly` LOG2PI

LOG2PI: number = 1.6514961294723187980

log2(π)

`Static` `Private` _xaxis

_xaxis: Vector3 = ...

`Static` `Private` _yaxis

_yaxis: Vector3 = ...

`Static` `Private` _zaxis

_zaxis: Vector3 = ...

Methods

`Static` add2

add2(a, b, dst): Vector2
2 次ベクトルの和を計算
Parameters
- a: Vector2
  左のベクトル
- b: Vector2
  右のベクトル
- dst: Vector2
  計算結果を格納するバッファ
Returns Vector2
a と b の和
- Defined in packages/mapray/src/GeoMath.ts:282

`Static` add3

add3(a, b, dst): Vector3
3 次ベクトルの和を計算
Parameters
- a: Vector3
  左のベクトル
- b: Vector3
  右のベクトル
- dst: Vector3
  計算結果を格納するバッファ
Returns Vector3
a と b の和
- Defined in packages/mapray/src/GeoMath.ts:297

`Static` clamp

clamp(x, min, max): number
値を指定区間内に制限
Parameters
- x: number
  値
- min: number
  最小値
- max: number
  最大値
Returns number
min <= x <= max のとき x, x < min のとき min, x > max のとき max
- Defined in packages/mapray/src/GeoMath.ts:1135

`Static` conjugate_quat

conjugate_quat(q, dst): Vector4
四元数の複素共役を計算
Parameters
- q: Vector4
  四元数
- dst: Vector4
  結果を代入する四元数
Returns Vector4
dst
- Defined in packages/mapray/src/GeoMath.ts:1334

`Static` copyMatrix

copyMatrix(src, dst): Matrix
行列を代入

src を dst に代入する。
Parameters
- src: Matrix
  代入元
- dst: Matrix
  代入先
Returns Matrix
dst
- Defined in packages/mapray/src/GeoMath.ts:122

`Static` copyVector2

copyVector2<T>(src, dst): T
2 次ベクトルを代入

src を dst に代入する。
Type Parameters
- T extends Float32Array | Float64Array | [x: number, y: number, z: number, w: number] | [x: number, y: number, z: number] | [x: number, y: number]
Parameters
- src: Float32Array | Float64Array | [x: number, y: number, z: number, w: number] | [x: number, y: number, z: number] | [x: number, y: number]
  代入元
- dst: T
  代入先
Returns T
dst
- Defined in packages/mapray/src/GeoMath.ts:173

`Static` copyVector3

copyVector3<T>(src, dst): T
3 次ベクトルを代入

src を dst に代入する。
Type Parameters
- T extends Float32Array | Float64Array | [x: number, y: number, z: number, w: number] | [x: number, y: number, z: number]
Parameters
- src: Float32Array | Float64Array | [x: number, y: number, z: number, w: number] | [x: number, y: number, z: number]
  代入元
- dst: T
  代入先
Returns T
dst
- Defined in packages/mapray/src/GeoMath.ts:156

`Static` copyVector4

copyVector4(src, dst): Vector4
4 次ベクトルを代入

src を dst に代入する。
Parameters
- src: Vector4
  代入元
- dst: Vector4
  代入先
Returns Vector4
dst
- Defined in packages/mapray/src/GeoMath.ts:139

`Static` createMatrix

createMatrix(mat?): Matrix
行列オブジェクトを作成

mat を複製する。ただし mat を省略したときは、すべての要素が 0 の行列を生成する。
Parameters
- Optional mat: Matrix
  入力行列
Returns Matrix
新しい行列
- Defined in packages/mapray/src/GeoMath.ts:22

`Static` createVector2

createVector2(vec?): Vector2
2 次ベクトルの生成 vec を複製して 2 次ベクトルを生成する。ただし vec を省略したときは、すべての要素が 0 のベクトルを生成する。
Parameters
- Optional vec: Vector2
  入力ベクトル
Returns Vector2
新しいベクトル
- Defined in packages/mapray/src/GeoMath.ts:96

`Static` createVector3

createVector3(vec?): Vector3
3 次ベクトルの生成 vec を複製して 3 次ベクトルを生成する。ただし vec を省略したときは、すべての要素が 0 のベクトルを生成する。
Parameters
- Optional vec: Vector3
  入力ベクトル
Returns Vector3
新しいベクトル
- Defined in packages/mapray/src/GeoMath.ts:72

`Static` createVector4

createVector4(vec?): Vector4
4 次ベクトルの生成

vec を複製して 4 次ベクトルを生成する。ただし vec を省略したときは、すべての要素が 0 のベクトルを生成する。
Parameters
- Optional vec: Vector4
  入力ベクトル
Returns Vector4
新しいベクトル
- Defined in packages/mapray/src/GeoMath.ts:48

`Static` cross3

cross3(a, b, dst): Vector3
3次ベクトルの外積を計算
Parameters
- a: Vector3
  左のベクトル
- b: Vector3
  右のベクトル
- dst: Vector3
  a と b の外積を代入するベクトル
Returns Vector3
dst
- Defined in packages/mapray/src/GeoMath.ts:380

`Static` dot2

dot2(a, b): number
2 次ベクトルの内積を計算
Parameters
- a: Vector2
  左のベクトル
- b: Vector2
  右のベクトル
Returns number
a と b の内積
- Defined in packages/mapray/src/GeoMath.ts:343

`Static` dot3

dot3(a, b): number
3 次ベクトルの内積を計算
Parameters
- a: Vector3
  左のベクトル
- b: Vector3
  右のベクトル
Returns number
a と b の内積
- Defined in packages/mapray/src/GeoMath.ts:355

`Static` dot4

dot4(a, b): number
4 次ベクトルの内積を計算
Parameters
- a: Vector4
  左のベクトル
- b: Vector4
  右のベクトル
Returns number
a と b の内積
- Defined in packages/mapray/src/GeoMath.ts:367

`Static` frustum_matrix

frustum_matrix(left, right, bottom, top, nearVal, farVal, dst): Matrix
座標変換行列を計算 (視点座標系 → クリップ同次座標系)
Parameters
- left: number
- right: number
- bottom: number
- top: number
- nearVal: number
- farVal: number
- dst: Matrix
  結果を代入する行列
Returns Matrix
dst

See
https://www.opengl.org/sdk/docs/man2/xhtml/glFrustum.xml
- Defined in packages/mapray/src/GeoMath.ts:929

`Static` gocs_to_iscs

gocs_to_iscs(src, dst): GeoPointData
地心直交座標を Inou 球面座標に変換
Parameters
- src: Vector3
  入力 GOCS 座標 (Meters)
- dst: GeoPointData
  出力 ISCS 座標
Returns GeoPointData
dst

Deprecated
mapray.GeoPoint.setFromGocs の使用を推奨
- Defined in packages/mapray/src/GeoMath.ts:882

`Static` gudermannian

gudermannian(x): number
グーデルマン関数
Parameters
- x: number
  数値
Returns number
gd( x )
- Defined in packages/mapray/src/GeoMath.ts:1111

`Static` invGudermannian

invGudermannian(x): number
逆グーデルマン関数
Parameters
- x: number
  数値
Returns number
gd^-1( x )
- Defined in packages/mapray/src/GeoMath.ts:1122

`Static` inverse_A

inverse_A(mat, dst): Matrix
逆行列を計算 (アフィン変換)
Parameters
- mat: Matrix
  行列
- dst: Matrix
  結果を代入する行列
Returns Matrix
dst
- Defined in packages/mapray/src/GeoMath.ts:659

`Static` inverse_quat

inverse_quat(q, dst): Vector4
逆四元数の計算
Parameters
- q: Vector4
  四元数
- dst: Vector4
  結果を代入する四元数
Returns Vector4
dst
- Defined in packages/mapray/src/GeoMath.ts:1349

`Static` isVector2

isVector2(vec): vec is Vector2
2次ベクトルであるかを判定
Parameters
- vec: Float32Array | Float64Array | [x: number, y: number, z: number, w: number] | [x: number, y: number, z: number] | [x: number, y: number]
Returns vec is Vector2
- Defined in packages/mapray/src/GeoMath.ts:1179

`Static` isVector3

isVector3(vec): vec is Vector3
3次ベクトルであるかを判定
Parameters
- vec: Float32Array | Float64Array | [x: number, y: number, z: number, w: number] | [x: number, y: number, z: number] | [x: number, y: number]
Returns vec is Vector3
- Defined in packages/mapray/src/GeoMath.ts:1188

`Static` isVector4

isVector4(vec): vec is Vector4
4次ベクトルであるかを判定
Parameters
- vec: Float32Array | Float64Array | [x: number, y: number, z: number, w: number] | [x: number, y: number, z: number] | [x: number, y: number]
Returns vec is Vector4
- Defined in packages/mapray/src/GeoMath.ts:1197

`Static` iscs_to_gocs_matrix

iscs_to_gocs_matrix(position, dst): Matrix
座標変換行列を計算 (Inou 球面座標系 → 地心直交座標系)

原点が position の直交座標系 (LOCS) から地心直交座標系 (GOCS) に変換する行列を計算する。 position.height + GeoMath.EARTH_RADIUS > 0 かつ position.latitude == 0 のとき、LOCS の Z 軸は上方向、Y 軸は北方向、X 軸は東方向となる。
Parameters
- position: GeoPointData
  位置 (Inou 球面座標系)
- dst: Matrix
  結果を代入する行列
Returns Matrix
dst

Deprecated
mapray.GeoPoint.getMlocsToGocsMatrix の使用を推奨
- Defined in packages/mapray/src/GeoMath.ts:835

`Static` kml_model_matrix

kml_model_matrix(heading, tilt, roll, scale, dst): Matrix
KML 互換のモデル変換行列

変換は scale -> roll -> tilt -> heading の順に行われる。
Parameters
- heading: number
  Z 軸を中心に Y 軸から X 軸の方向の回転角 (Degrees)
- tilt: number
  X 軸を中心に Z 軸から Y 軸の方向の回転角 (Degrees)
- roll: number
  Y 軸を中心に X 軸から Z 軸の方向の回転角 (Degrees)
- scale: Vector3
  スケール
- dst: Matrix
  結果を代入する行列
Returns Matrix
dst

Package
See
https://developers.google.com/kml/documentation/kmlreference#model

Deprecated
mapray.Orientation.getTransformMatrix の使用を推奨
- Defined in packages/mapray/src/GeoMath.ts:1064

`Static` length2

length2(vec): number
2 次ベクトルの長さを計算
Parameters
- vec: Vector2
  ベクトル
Returns number
ベクトルの長さ
- Defined in packages/mapray/src/GeoMath.ts:248

`Static` length3

length3(vec): number
3 次ベクトルの長さを計算
Parameters
- vec: Vector3
  ベクトル
Returns number
ベクトルの長さ
- Defined in packages/mapray/src/GeoMath.ts:259

`Static` length4

length4(vec): number
4 次ベクトルの長さを計算
Parameters
- vec: Vector4
  ベクトル
Returns number
ベクトルの長さ
- Defined in packages/mapray/src/GeoMath.ts:269

`Static` lengthSquared2

lengthSquared2(vec): number
2 次ベクトルの長さの2乗を計算
Parameters
- vec: Vector2
  ベクトル
Returns number
ベクトルの長さの2乗
- Defined in packages/mapray/src/GeoMath.ts:216

`Static` lengthSquared3

lengthSquared3(vec): number
3 次ベクトルの長さの2乗を計算
Parameters
- vec: Vector3
  ベクトル
Returns number
ベクトルの長さの2乗
- Defined in packages/mapray/src/GeoMath.ts:227

`Static` lengthSquared4

lengthSquared4(vec): number
4 次ベクトルの長さの2乗を計算
Parameters
- vec: Vector4
  ベクトル
Returns number
ベクトルの長さの2乗
- Defined in packages/mapray/src/GeoMath.ts:237

`Static` linearInterpolate2

linearInterpolate2(a, b, t, dst): Vector2
2次ベクトルの線形補間を計算
Parameters
- a: Vector2
  ベクトル
- b: Vector2
  ベクトル
- t: number
  補間パラメータ
- dst: Vector2
  計算結果を代入するベクトル
Returns Vector2
dst
- Defined in packages/mapray/src/GeoMath.ts:482

`Static` linearInterpolate3

linearInterpolate3(a, b, t, dst): Vector3
3次ベクトルの線形補間を計算
Parameters
- a: Vector3
  ベクトル
- b: Vector3
  ベクトル
- t: number
  補間パラメータ
- dst: Vector3
  計算結果を代入するベクトル
Returns Vector3
dst
- Defined in packages/mapray/src/GeoMath.ts:499

`Static` linearInterpolate4

linearInterpolate4(a, b, t, dst): Vector4
4次ベクトルの線形補間を計算
Parameters
- a: Vector4
  ベクトル
- b: Vector4
  ベクトル
- t: number
  補間パラメータ
- dst: Vector4
  計算結果を代入するベクトル
Returns Vector4
dst
- Defined in packages/mapray/src/GeoMath.ts:517

`Static` lookat_matrix

lookat_matrix(eye, center, up, dst): Matrix
座標変換行列を計算 (右手座標系 → 視点座標系)
Parameters
- eye: Vector3
  視点の位置
- center: Vector3
  注視点の位置
- up: Vector3
  上方向ベクトル
- dst: Matrix
  結果を代入する行列
Returns Matrix
dst
- Defined in packages/mapray/src/GeoMath.ts:964

`Static` matrix_to_quat

matrix_to_quat(mat, dst): Vector4
行列と同じ回転を表す四元数を計算
Parameters
- mat: Matrix
  行列
- dst: Vector4
  結果を代入する四元数
Returns Vector4
dst
- Defined in packages/mapray/src/GeoMath.ts:1230

`Static` mul_AA

mul_AA(a, b, dst): Matrix
行列の積を計算 (アフィン変換 x アフィン変換)
Parameters
- a: Matrix
  左の行列
- b: Matrix
  右の行列
- dst: Matrix
  結果を代入する行列
Returns Matrix
dst
- Defined in packages/mapray/src/GeoMath.ts:535

`Static` mul_GA

mul_GA(a, b, dst): Matrix
行列の積を計算 (一般変換 x アフィン変換)
Parameters
- a: Matrix
  左の行列
- b: Matrix
  右の行列
- dst: Matrix
  結果を代入する行列
Returns Matrix
dst
- Defined in packages/mapray/src/GeoMath.ts:576

`Static` mul_PzA

mul_PzA(a, b, dst): Matrix
行列の積を計算 (投影変換 x アフィン変換)
Parameters
- a: Matrix
  左の行列
- b: Matrix
  右の行列
- dst: Matrix
  結果を代入する行列
Returns Matrix
dst
- Defined in packages/mapray/src/GeoMath.ts:618

`Static` mul_quat

mul_quat(p, q, dst): Vector4
四元数の積を計算
Parameters
- p: Vector4
  左の四元数
- q: Vector4
  右の四元数
- dst: Vector4
  結果を代入する四元数
Returns Vector4
dst
- Defined in packages/mapray/src/GeoMath.ts:1315

`Static` normalize2

normalize2(vec, dst): Vector2
2次ベクトルの正規化を計算
Parameters
- vec: Vector2
  ベクトル
- dst: Vector2
  正規化された値を代入するベクトル
Returns Vector2
dst
- Defined in packages/mapray/src/GeoMath.ts:398

`Static` normalize3

normalize3(vec, dst): Vector3
3次ベクトルの正規化を計算
Parameters
- vec: Vector3
  ベクトル
- dst: Vector3
  正規化された値を代入するベクトル
Returns Vector3
dst
- Defined in packages/mapray/src/GeoMath.ts:410

`Static` normalize4

normalize4(vec, dst): Vector4
4次ベクトルの正規化を計算
Parameters
- vec: Vector4
  ベクトル
- dst: Vector4
  正規化された値を代入するベクトル
Returns Vector4
dst
- Defined in packages/mapray/src/GeoMath.ts:421

`Static` normalizePlane

normalizePlane(plane, dst): Vector4
平面ベクトルの正規化を計算

法線部 (最初の 3 要素) の長さが 1 になるように平面ベクトル plane を正規化し、dst に代入する。
Parameters
- plane: Vector4
  平面ベクトル
- dst: Vector4
  正規化された値を代入するベクトル
Returns Vector4
dst
- Defined in packages/mapray/src/GeoMath.ts:808

`Static` quat_to_matrix

quat_to_matrix(scale, quat, dst): Matrix
四元数と同じ回転を表す行列を計算。平行移動成分は (0, 0, 0) になります。
Parameters
- scale: Vector3
  スケール
- quat: Vector4
  四元数
- dst: Matrix
  結果を代入する行列
Returns Matrix
dst
- Defined in packages/mapray/src/GeoMath.ts:1278

`Static` rotation_matrix

rotation_matrix(axis, angle, dst): Matrix
任意軸回りの回転行列

axis を Z 軸方向とすると、X 軸から Y 軸の方向に angle 度回転させる変換行列を返す。
Parameters
- axis: Vector3
  回転軸 (単位ベクトル)
- angle: number
  回転角 (Degrees)
- dst: Matrix
  結果を代入する行列
Returns Matrix
dst
- Defined in packages/mapray/src/GeoMath.ts:1013

`Static` rotation_quat

rotation_quat(axis, angle, dst): Vector4
任意軸周りに回転する四元数を計算
Parameters
- axis: Vector3
  回転軸
- angle: number
  回転角 (Degrees)
- dst: Vector4
  結果を代入する四元数
Returns Vector4
dst
- Defined in packages/mapray/src/GeoMath.ts:1210

`Static` scale2

scale2(a, vec, dst): Vector2
2次ベクトルのスカラ倍を計算
Parameters
- a: number
  スカラ
- vec: Vector2
  ベクトル
- dst: Vector2
  計算結果を代入するベクトル
Returns Vector2
dst
- Defined in packages/mapray/src/GeoMath.ts:434

`Static` scale3

scale3(a, vec, dst): Vector3
3次ベクトルのスカラ倍を計算
Parameters
- a: number
  スカラ
- vec: Vector3
  ベクトル
- dst: Vector3
  計算結果を代入するベクトル
Returns Vector3
dst
- Defined in packages/mapray/src/GeoMath.ts:449

`Static` scale4

scale4(a, vec, dst): Vector4
4次ベクトルのスカラ倍を計算
Parameters
- a: number
  スカラ
- vec: Vector4
  ベクトル
- dst: Vector4
  計算結果を代入するベクトル
Returns Vector4
dst
- Defined in packages/mapray/src/GeoMath.ts:464

`Static` setIdentity

setIdentity(dst): Matrix
恒等行列を設定
Parameters
- dst: Matrix
  結果を代入する行列
Returns Matrix
dst
- Defined in packages/mapray/src/GeoMath.ts:186

`Static` slerp_quat

slerp_quat(q1, q2, alpha, dst): Vector4
球面線形補間を計算
Parameters
- q1: Vector4
  四元数(単位ベクトル)
- q2: Vector4
  四元数(単位ベクトル)
- alpha: number
  補間、0 ≤ alpha ≤ 1
- dst: Vector4
  結果を代入する四元数
Returns Vector4
dst
- Defined in packages/mapray/src/GeoMath.ts:1367

`Static` sub2

sub2(a, b, dst): Vector2
2 次ベクトルの差を計算
Parameters
- a: Vector2
  左のベクトル
- b: Vector2
  右のベクトル
- dst: Vector2
  計算結果を格納するバッファ
Returns Vector2
a と b の差
- Defined in packages/mapray/src/GeoMath.ts:313

`Static` sub3

sub3(a, b, dst): Vector3
3 次ベクトルの差を計算
Parameters
- a: Vector3
  左のベクトル
- b: Vector3
  右のベクトル
- dst: Vector3
  計算結果を格納するバッファ
Returns Vector3
a と b の差
- Defined in packages/mapray/src/GeoMath.ts:328

`Static` transformDirection_A

transformDirection_A(mat, dir, dst): Vector3
方向を変換 (アフィン変換)

方向 dir を変換行列 mat により座標変換して dst に代入する。

mat は dir が想定する座標系から、ある座標系へ方向ベクトルを変換するための行列である。
Parameters
- mat: Matrix
  変換行列
- dir: Vector3
  方向
- dst: Vector3
  結果を代入するベクトル
Returns Vector3
dst
- Defined in packages/mapray/src/GeoMath.ts:753

`Static` transformPlane_A

transformPlane_A(mat, plane, dst): Vector4
平面ベクトルを変換 (アフィン変換)

mat には平面ベクトルを変換する行列を指定する。位置ベクトルを変換する行列が M なら、平面ベクトルを変換する行列は M^-1 を指定する。

dst には plane * mat が代入される。
Parameters
- mat: Matrix
  変換行列
- plane: Vector4
  平面ベクトル
- dst: Vector4
  結果を代入するベクトル
Returns Vector4
dst
- Defined in packages/mapray/src/GeoMath.ts:781

`Static` transformPosition_A

transformPosition_A<T>(mat, pos, dst): T
位置を変換 (アフィン変換)

位置 pos を変換行列 mat により座標変換して dst に代入する。

mat は pos が想定する座標系から、ある座標系へ位置ベクトルを変換するための行列である。
Type Parameters
- T extends Float32Array | Float64Array | [x: number, y: number, z: number] | [x: number, y: number]
Parameters
- mat: Matrix
  変換行列
- pos: Float32Array | Float64Array | [x: number, y: number, z: number] | [x: number, y: number]
  位置
- dst: T
  結果を代入するベクトル
Returns T
dst
- Defined in packages/mapray/src/GeoMath.ts:723

Class GeoMath

Index

Properties

Methods

Properties

Static Readonly DEGREE

Static Readonly EARTH_RADIUS

Static Readonly LOG2PI

Static Private _xaxis

Static Private _yaxis

Static Private _zaxis

Methods

Static add2

Parameters

a: Vector2

b: Vector2

dst: Vector2

Returns Vector2

Static add3

Parameters

a: Vector3

b: Vector3

dst: Vector3

Returns Vector3

Static clamp

Parameters

x: number

min: number

max: number

Returns number

Static conjugate_quat

Parameters

q: Vector4

dst: Vector4

Returns Vector4

Static copyMatrix

Parameters

src: Matrix

dst: Matrix

Returns Matrix

Static copyVector2

Type Parameters

T extends Float32Array | Float64Array | [x: number, y: number, z: number, w: number] | [x: number, y: number, z: number] | [x: number, y: number]

Parameters

src: Float32Array | Float64Array | [x: number, y: number, z: number, w: number] | [x: number, y: number, z: number] | [x: number, y: number]

dst: T

Returns T

Static copyVector3

Type Parameters

T extends Float32Array | Float64Array | [x: number, y: number, z: number, w: number] | [x: number, y: number, z: number]

Parameters

src: Float32Array | Float64Array | [x: number, y: number, z: number, w: number] | [x: number, y: number, z: number]

dst: T

Returns T

Static copyVector4

Parameters

src: Vector4

dst: Vector4

Returns Vector4

Static createMatrix

Parameters

Optional mat: Matrix

Returns Matrix

Static createVector2

Parameters

Optional vec: Vector2

Returns Vector2

Static createVector3

Parameters

Optional vec: Vector3

Returns Vector3

Static createVector4

Parameters

Optional vec: Vector4

Returns Vector4

Static cross3

Parameters

a: Vector3

b: Vector3

dst: Vector3

`Static` `Readonly` DEGREE

`Static` `Readonly` EARTH_RADIUS

`Static` `Readonly` LOG2PI

`Static` `Private` _xaxis

`Static` `Private` _yaxis

`Static` `Private` _zaxis

`Static` add2

`Static` add3

`Static` clamp

`Static` conjugate_quat

`Static` copyMatrix

`Static` copyVector2

`Static` copyVector3

`Static` copyVector4

`Static` createMatrix

`Optional` mat: Matrix

`Static` createVector2

`Optional` vec: Vector2

`Static` createVector3

`Optional` vec: Vector3

`Static` createVector4

`Optional` vec: Vector4

`Static` cross3

`Static` dot2

`Static` dot3

`Static` dot4

`Static` frustum_matrix

`Static` gocs_to_iscs

`Static` gudermannian

`Static` invGudermannian

`Static` inverse_A

`Static` inverse_quat

`Static` isVector2

`Static` isVector3

`Static` isVector4

`Static` iscs_to_gocs_matrix

`Static` kml_model_matrix