GeoMath | @mapray

数学ユーティリティー

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

Hierarchy

GeoMath

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 add3

add3(a: Vector3, b: Vector3, dst: Vector3): Vector3

- Defined in packages/mapray/src/GeoMath.ts:240
3 次ベクトルの和を計算

Parameters
- a: Vector3
  
  左のベクトル
- b: Vector3
  
  右のベクトル
- dst: Vector3
  
  計算結果を格納するバッファ
Returns Vector3
a と b の和

Static clamp

clamp(x: number, min: number, max: number): number

- Defined in packages/mapray/src/GeoMath.ts:929
値を指定区間内に制限

Parameters
- x: number
  
  値
- min: number
  
  最小値
- max: number
  
  最大値
Returns number
min <= x <= max のとき x, x < min のとき min, x > max のとき max

Static copyMatrix

copyMatrix(src: Matrix, dst: Matrix): Matrix

- Defined in packages/mapray/src/GeoMath.ts:122
行列を代入

src を dst に代入する。

Parameters
- src: Matrix
  
  代入元
- dst: Matrix
  
  代入先
Returns Matrix
dst

Static copyVector2

copyVector2(src: Vector2, dst: Vector2): Vector2

- Defined in packages/mapray/src/GeoMath.ts:173
2 次ベクトルを代入

src を dst に代入する。

Parameters
- src: Vector2
  
  代入元
- dst: Vector2
  
  代入先
Returns Vector2
dst

Static copyVector3

copyVector3(src: Vector3, dst: Vector3): Vector3

- Defined in packages/mapray/src/GeoMath.ts:156
3 次ベクトルを代入

src を dst に代入する。

Parameters
- src: Vector3
  
  代入元
- dst: Vector3
  
  代入先
Returns Vector3
dst

Static copyVector4

copyVector4(src: Vector4, dst: Vector4): Vector4

- Defined in packages/mapray/src/GeoMath.ts:139
4 次ベクトルを代入

src を dst に代入する。

Parameters
- src: Vector4
  
  代入元
- dst: Vector4
  
  代入先
Returns Vector4
dst

Static createMatrix

createMatrix(mat?: Matrix): Matrix

- Defined in packages/mapray/src/GeoMath.ts:22
行列オブジェクトを作成

mat を複製する。ただし mat を省略したときは、すべての要素が 0 の行列を生成する。

Parameters
- Optional mat: Matrix
  
  入力行列
Returns Matrix
新しい行列

Static createVector2

createVector2(vec?: Vector2): Vector2

- Defined in packages/mapray/src/GeoMath.ts:96
2 次ベクトルの生成 vec を複製して 2 次ベクトルを生成する。ただし vec を省略したときは、すべての要素が 0 のベクトルを生成する。

Parameters
- Optional vec: Vector2
  
  入力ベクトル
Returns Vector2
新しいベクトル

Static createVector3

createVector3(vec?: Vector3): Vector3

- Defined in packages/mapray/src/GeoMath.ts:72
3 次ベクトルの生成 vec を複製して 3 次ベクトルを生成する。ただし vec を省略したときは、すべての要素が 0 のベクトルを生成する。

Parameters
- Optional vec: Vector3
  
  入力ベクトル
Returns Vector3
新しいベクトル

Static createVector4

createVector4(vec?: Vector4): Vector4

- Defined in packages/mapray/src/GeoMath.ts:48
4 次ベクトルの生成

vec を複製して 4 次ベクトルを生成する。ただし vec を省略したときは、すべての要素が 0 のベクトルを生成する。

Parameters
- Optional vec: Vector4
  
  入力ベクトル
Returns Vector4
新しいベクトル

Static cross3

cross3(a: Vector3, b: Vector3, dst: Vector3): Vector3

- Defined in packages/mapray/src/GeoMath.ts:284
3次ベクトルの外積を計算

Parameters
- a: Vector3
  
  左のベクトル
- b: Vector3
  
  右のベクトル
- dst: Vector3
  
  a と b の外積を代入するベクトル
Returns Vector3
dst

Static dot3

dot3(a: Vector3, b: Vector3): number

- Defined in packages/mapray/src/GeoMath.ts:271
3 次ベクトルの内積を計算

Parameters
- a: Vector3
  
  左のベクトル
- b: Vector3
  
  右のベクトル
Returns number
a と b の内積

Static frustum_matrix

frustum_matrix(left: number, right: number, bottom: number, top: number, nearVal: number, farVal: number, dst: Matrix): Matrix

- Defined in packages/mapray/src/GeoMath.ts:723
座標変換行列を計算 (視点座標系 → クリップ同次座標系)

see
https://www.opengl.org/sdk/docs/man2/xhtml/glFrustum.xml

Parameters
- left: number
- right: number
- bottom: number
- top: number
- nearVal: number
- farVal: number
- dst: Matrix
  
  結果を代入する行列
Returns Matrix
dst

Static gocs_to_iscs

gocs_to_iscs(src: Vector3, dst: GeoPointData): GeoPointData

- Defined in packages/mapray/src/GeoMath.ts:676
地心直交座標を Inou 球面座標に変換

deprecated
mapray.GeoPoint.setFromGocs の使用を推奨

Parameters
- src: Vector3
  
  入力 GOCS 座標 (Meters)
- dst: GeoPointData
  
  出力 ISCS 座標
Returns GeoPointData
dst

Static gudermannian

gudermannian(x: number): number

- Defined in packages/mapray/src/GeoMath.ts:905
グーデルマン関数

Parameters
- x: number
  
  数値
Returns number
gd( x )

Static invGudermannian

invGudermannian(x: number): number

- Defined in packages/mapray/src/GeoMath.ts:916
逆グーデルマン関数

Parameters
- x: number
  
  数値
Returns number
gd^-1( x )

Static inverse_A

inverse_A(mat: Matrix, dst: Matrix): Matrix

- Defined in packages/mapray/src/GeoMath.ts:455
逆行列を計算 (アフィン変換)

Parameters
- mat: Matrix
  
  行列
- dst: Matrix
  
  結果を代入する行列
Returns Matrix
dst

Static isVector2

isVector2(vec: Float64Array | Float32Array | [x: number, y: number] | [x: number, y: number, z: number] | [x: number, y: number, z: number, w: number]): vec is Vector2

- Defined in packages/mapray/src/GeoMath.ts:973
2次ベクトルであるかを判定

Parameters
- vec: Float64Array | Float32Array | [x: number, y: number] | [x: number, y: number, z: number] | [x: number, y: number, z: number, w: number]
Returns vec is Vector2

Static isVector3

isVector3(vec: Float64Array | Float32Array | [x: number, y: number] | [x: number, y: number, z: number] | [x: number, y: number, z: number, w: number]): vec is Vector3

- Defined in packages/mapray/src/GeoMath.ts:982
3次ベクトルであるかを判定

Parameters
- vec: Float64Array | Float32Array | [x: number, y: number] | [x: number, y: number, z: number] | [x: number, y: number, z: number, w: number]
Returns vec is Vector3

Static isVector4

isVector4(vec: Float64Array | Float32Array | [x: number, y: number] | [x: number, y: number, z: number] | [x: number, y: number, z: number, w: number]): vec is Vector4

- Defined in packages/mapray/src/GeoMath.ts:991
4次ベクトルであるかを判定

Parameters
- vec: Float64Array | Float32Array | [x: number, y: number] | [x: number, y: number, z: number] | [x: number, y: number, z: number, w: number]
Returns vec is Vector4

Static iscs_to_gocs_matrix

iscs_to_gocs_matrix(position: GeoPointData, dst: Matrix): Matrix

- Defined in packages/mapray/src/GeoMath.ts:629
座標変換行列を計算 (Inou 球面座標系 → 地心直交座標系)

原点が position の直交座標系 (LOCS) から地心直交座標系 (GOCS) に変換する行列を計算する。 position.height + GeoMath.EARTH_RADIUS > 0 かつ position.latitude == 0 のとき、LOCS の Z 軸は上方向、Y 軸は北方向、X 軸は東方向となる。

deprecated
mapray.GeoPoint.getMlocsToGocsMatrix の使用を推奨

Parameters
- position: GeoPointData
  
  位置 (Inou 球面座標系)
- dst: Matrix
  
  結果を代入する行列
Returns Matrix
dst

Static kml_model_matrix

kml_model_matrix(heading: number, tilt: number, roll: number, scale: Vector3, dst: Matrix): Matrix

- Defined in packages/mapray/src/GeoMath.ts:858
KML 互換のモデル変換行列

変換は scale -> roll -> tilt -> heading の順に行われる。

package
see
https://developers.google.com/kml/documentation/kmlreference#model

deprecated
mapray.Orientation.getTransformMatrix の使用を推奨

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

Static length3

length3(vec: Vector3): number

- Defined in packages/mapray/src/GeoMath.ts:227
3 次ベクトルの長さを計算

Parameters
- vec: Vector3
  
  ベクトル
Returns number
ベクトルの長さ

Static lengthSquared3

lengthSquared3(vec: Vector3): number

- Defined in packages/mapray/src/GeoMath.ts:216
3 次ベクトルの長さの2乗を計算

Parameters
- vec: Vector3
  
  ベクトル
Returns number
ベクトルの長さの2乗

Static lookat_matrix

lookat_matrix(eye: Vector3, center: Vector3, up: Vector3, dst: Matrix): Matrix

- Defined in packages/mapray/src/GeoMath.ts:758
座標変換行列を計算 (右手座標系 → 視点座標系)

Parameters
- eye: Vector3
  
  視点の位置
- center: Vector3
  
  注視点の位置
- up: Vector3
  
  上方向ベクトル
- dst: Matrix
  
  結果を代入する行列
Returns Matrix
dst

Static mul_AA

mul_AA(a: Matrix, b: Matrix, dst: Matrix): Matrix

- Defined in packages/mapray/src/GeoMath.ts:331
行列の積を計算 (アフィン変換 x アフィン変換)

Parameters
- a: Matrix
  
  左の行列
- b: Matrix
  
  右の行列
- dst: Matrix
  
  結果を代入する行列
Returns Matrix
dst

Static mul_GA

mul_GA(a: Matrix, b: Matrix, dst: Matrix): Matrix

- Defined in packages/mapray/src/GeoMath.ts:372
行列の積を計算 (一般変換 x アフィン変換)

Parameters
- a: Matrix
  
  左の行列
- b: Matrix
  
  右の行列
- dst: Matrix
  
  結果を代入する行列
Returns Matrix
dst

Static mul_PzA

mul_PzA(a: Matrix, b: Matrix, dst: Matrix): Matrix

- Defined in packages/mapray/src/GeoMath.ts:414
行列の積を計算 (投影変換 x アフィン変換)

Parameters
- a: Matrix
  
  左の行列
- b: Matrix
  
  右の行列
- dst: Matrix
  
  結果を代入する行列
Returns Matrix
dst

Static normalize3

normalize3(vec: Vector3, dst: Vector3): Vector3

- Defined in packages/mapray/src/GeoMath.ts:302
3次ベクトルの正規化を計算

Parameters
- vec: Vector3
  
  ベクトル
- dst: Vector3
  
  正規化された値を代入するベクトル
Returns Vector3
dst

Static normalizePlane

normalizePlane(plane: Vector4, dst: Vector4): Vector4

- Defined in packages/mapray/src/GeoMath.ts:602
平面ベクトルの正規化を計算

法線部 (最初の 3 要素) の長さが 1 になるように平面ベクトル plane を正規化し、dst に代入する。

Parameters
- plane: Vector4
  
  平面ベクトル
- dst: Vector4
  
  正規化された値を代入するベクトル
Returns Vector4
dst

Static rotation_matrix

rotation_matrix(axis: Vector3, angle: number, dst: Matrix): Matrix

- Defined in packages/mapray/src/GeoMath.ts:807
任意軸回りの回転行列

axis を Z 軸方向とすると、X 軸から Y 軸の方向に angle 度回転させる変換行列を返す。

Parameters
- axis: Vector3
  
  回転軸 (単位ベクトル)
- angle: number
  
  回転角 (Degrees)
- dst: Matrix
  
  結果を代入する行列
Returns Matrix
dst

Static scale3

scale3(a: number, vec: Vector3, dst: Vector3): Vector3

- Defined in packages/mapray/src/GeoMath.ts:315
3次ベクトルのスカラ倍を計算

Parameters
- a: number
  
  スカラ
- vec: Vector3
  
  ベクトル
- dst: Vector3
  
  計算結果を代入するベクトル
Returns Vector3
dst

Static setIdentity

setIdentity(dst: Matrix): Matrix

- Defined in packages/mapray/src/GeoMath.ts:186
恒等行列を設定

Parameters
- dst: Matrix
  
  結果を代入する行列
Returns Matrix
dst

Static sub3

sub3(a: Vector3, b: Vector3, dst: Vector3): Vector3

- Defined in packages/mapray/src/GeoMath.ts:256
3 次ベクトルの差を計算

Parameters
- a: Vector3
  
  左のベクトル
- b: Vector3
  
  右のベクトル
- dst: Vector3
  
  計算結果を格納するバッファ
Returns Vector3
a と b の差

Static transformDirection_A

transformDirection_A(mat: Matrix, dir: Vector3, dst: Vector3): Vector3

- Defined in packages/mapray/src/GeoMath.ts:547
方向を変換 (アフィン変換)

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

mat は dir が想定する座標系から、ある座標系へ方向ベクトルを変換するための行列である。

Parameters
- mat: Matrix
  
  変換行列
- dir: Vector3
  
  方向
- dst: Vector3
  
  結果を代入するベクトル
Returns Vector3
dst

Static transformPlane_A

transformPlane_A(mat: Matrix, plane: Vector4, dst: Vector4): Vector4

- Defined in packages/mapray/src/GeoMath.ts:575
平面ベクトルを変換 (アフィン変換)

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

dst には plane * mat が代入される。

Parameters
- mat: Matrix
  
  変換行列
- plane: Vector4
  
  平面ベクトル
- dst: Vector4
  
  結果を代入するベクトル
Returns Vector4
dst

Static transformPosition_A

transformPosition_A(mat: Matrix, pos: Vector3, dst: Vector3): Vector3

- Defined in packages/mapray/src/GeoMath.ts:519
位置を変換 (アフィン変換)

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

mat は pos が想定する座標系から、ある座標系へ位置ベクトルを変換するための行列である。

Parameters
- mat: Matrix
  
  変換行列
- pos: Vector3
  
  位置
- dst: Vector3
  
  結果を代入するベクトル
Returns Vector3
dst

Hierarchy

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 add3

Parameters

a: Vector3

b: Vector3

dst: Vector3

Returns Vector3

Static clamp

Parameters

x: number

min: number

max: number

Returns number

Static copyMatrix

Parameters

src: Matrix

dst: Matrix

Returns Matrix

Static copyVector2

Parameters

src: Vector2

dst: Vector2

Returns Vector2

Static copyVector3

Parameters

src: Vector3

dst: Vector3

Returns Vector3

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

Returns Vector3

Static dot3

Parameters

a: Vector3

b: Vector3

Returns number

Static frustum_matrix

Parameters

left: number

right: number

bottom: number

top: number

nearVal: number

farVal: number

dst: Matrix