Plane

由

a x+b y+c z+d=0

定義的Hessian法向形式的平面，其中（a、b、c）是平面的normal，d是平面的符號(hào)distance，并且（x、y、z）是平面上的任何點(diǎn)。

new Plane(normal, distance)

Parameters:

normal (Cartesian3) 平面的法向（標(biāo)準(zhǔn)化）。

distance (Number) 從原點(diǎn)到平面的最短距離。distance的符號(hào)決定原點(diǎn)在平面的哪一側(cè)。如果distance為正，則原點(diǎn)在法向的半空間中；如果為負(fù)，則原點(diǎn)在法向的半空間中；如果為零，則平面通過原點(diǎn)。

Example

// The plane x=0
var plane = new bmgl.Plane(bmgl.Cartesian3.UNIT_X, 0.0);

Throws

DeveloperError : 正常必須規(guī)范化

Members

(static, constant) ORIGIN_XY_PLANE : Plane

一個(gè)常量，初始化為xy平面，通過原點(diǎn)，法向?yàn)檎齴。

(static, constant) ORIGIN_YZ_PLANE : Plane

初始化為通過原點(diǎn)的yz平面的常量，法線為正x。

(static, constant) ORIGIN_ZX_PLANE : Plane

一個(gè)初始化為通過原點(diǎn)的ZX平面的常量，其法向值為正y。

distance : Number

從原點(diǎn)到平面的最短距離。distance的符號(hào)決定原點(diǎn)在平面的哪一側(cè)。如果distance為正，則原點(diǎn)在法向的半空間中；如果為負(fù)，則原點(diǎn)在法向的半空間中；如果為零，則平面通過原點(diǎn)。

normal : Cartesian3

飛機(jī)是正常的。

Methods

(static) clone(plane, result) → {Plane}

復(fù)制平面實(shí)例。

Parameters:

plane (Plane) 要復(fù)制的平面。

result (Plane) 存儲(chǔ)結(jié)果的對(duì)象。

(static) equals(left, right) → {Boolean}

按法向和距離比較提供的平面，如果它們相等，則返回true，否則返回false。

Parameters:

left (Plane) 第一架飛機(jī)。

right (Plane) 第二架飛機(jī)。

(static) fromCartesian4(coefficients, result) → {Plane}

從常規(guī)公式創(chuàng)建平面

Parameters:

coefficients (Cartesian4) 平面的法向（標(biāo)準(zhǔn)化）。

result (Plane) 存儲(chǔ)結(jié)果的對(duì)象。

Throws

DeveloperError : 正常必須規(guī)范化

(static) fromPointNormal(point, normal, result) → {Plane}

從法線和平面上的點(diǎn)創(chuàng)建平面。

Parameters:

point (Cartesian3) 平面上的點(diǎn)。

normal (Cartesian3) 平面的法向（標(biāo)準(zhǔn)化）。

result (Plane) 存儲(chǔ)結(jié)果的對(duì)象。

Example

var point = bmgl.Cartesian3.fromDegrees(-72.0, 40.0);
var normal = ellipsoid.geodeticSurfaceNormal(point);
var tangentPlane = bmgl.Plane.fromPointNormal(point, normal);

Throws

DeveloperError : 正常必須規(guī)范化

(static) getPointDistance(plane, point) → {Number}

計(jì)算點(diǎn)到平面的有符號(hào)最短距離。距離的符號(hào)決定點(diǎn)在平面的哪一側(cè)。如果距離為正，則點(diǎn)在法向的半空間中；如果為負(fù)，則點(diǎn)在法向的半空間中；如果為零，則平面通過該點(diǎn)。

Parameters:

plane (Plane) 飛機(jī)。

point (Cartesian3) 重點(diǎn)。

(static) projectPointOntoPlane(plane, point, result) → {Cartesian3}

將點(diǎn)投影到平面上。

Parameters:

plane (Plane) 將點(diǎn)投影到的平面

point (Cartesian3) 投影到平面上的點(diǎn)

result (Cartesian3) 結(jié)果點(diǎn)。如果未定義，將創(chuàng)建新的cartesian3。

(static) transform(plane, transform, result) → {Plane}

用給定的變換矩陣變換平面。

Parameters:

plane (Plane) 飛機(jī)。

transform (Matrix4) 變換矩陣。

result (Plane) 存儲(chǔ)結(jié)果的對(duì)象。