Plane

new Cesium.Plane(normal, distance)

海森法线形式的平面,定义为
ax + by + cz + d = 0
其中 (a, b, c) 是平面的法线,d 是到平面的有符号 距离,(x, y, z) 是平面上的任意点。
Name Type Description
normal Cartesian3 平面的法线(已归一化)。
distance number 从原点到平面的最短距离。distance 的符号 决定了原点在平面的哪一侧。如果 distance 为正数,原点位于 法线方向的半空间;如果为负数,原点位于 法线相反的半空间;如果为零,平面通过原点。
Throws:
Example:
// 平面 x=0
const plane = new Cesium.Plane(Cesium.Cartesian3.UNIT_X, 0.0);

Members

static constant Cesium.Plane.ORIGIN_XY_PLANE : Plane

初始化为通过原点的 XY 平面,法线方向为正 Z。

static constant Cesium.Plane.ORIGIN_YZ_PLANE : Plane

初始化为通过原点的 YZ 平面,法线方向为正 X。

static constant Cesium.Plane.ORIGIN_ZX_PLANE : Plane

初始化为通过原点的 ZX 平面,法线方向为正 Y。

distance : number

从原点到平面的最短距离。distance 的符号 决定了原点在平面的哪一侧。如果 distance 为正数,原点位于 法线方向的半空间;如果为负数,原点位于 法线相反的半空间;如果为零,平面通过原点。
平面的法线。

Methods

static Cesium.Plane.clone(plane, result)Plane

复制一个 Plane 实例。
Name Type Description
plane Plane 要复制的平面。
result Plane optional 存储结果的对象。
Returns:
修改后的结果参数,如果未提供则返回新的 Plane 实例。

static Cesium.Plane.equals(left, right)boolean

比较提供的两个平面(通过法线和距离),如果相等则返回 true,否则返回 false
Name Type Description
left Plane 第一个平面。
right Plane 第二个平面。
Returns:
如果 left 和 right 相等则返回 true,否则返回 false

static Cesium.Plane.fromCartesian4(coefficients, result)Plane

从一般方程创建平面。
Name Type Description
coefficients Cartesian4 平面的系数(已归一化)。
result Plane optional 存储结果的对象。
Returns:
新的平面实例或修改的结果参数。
Throws:

static Cesium.Plane.fromPointNormal(point, normal, result)Plane

从法线和平面上的点创建平面。
Name Type Description
point Cartesian3 平面上的点。
normal Cartesian3 平面的法线(已归一化)。
result Plane optional 存储结果的对象。
Returns:
新的平面实例或修改的结果参数。
Throws:
Example:
const point = Cesium.Cartesian3.fromDegrees(-72.0, 40.0);
const normal = ellipsoid.geodeticSurfaceNormal(point);
const tangentPlane = Cesium.Plane.fromPointNormal(point, normal);

static Cesium.Plane.getPointDistance(plane, point)number

计算点到平面的有符号最短距离。 距离的符号决定了点在平面的哪一侧。 如果距离为正数,点位于法线方向的半空间; 如果为负数,点位于法线相反的半空间; 如果为零,平面通过该点。
Name Type Description
plane Plane 平面。
point Cartesian3 点。
Returns:
点到平面的有符号最短距离。

static Cesium.Plane.projectPointOntoPlane(plane, point, result)Cartesian3

将点投影到平面上。
Name Type Description
plane Plane 要投影到的平面。
point Cartesian3 要投影到平面上的点。
result Cartesian3 optional 结果点。如果未定义,将创建新的 Cartesian3。
Returns:
修改后的结果参数,如果未提供则返回新的 Cartesian3 实例。

static Cesium.Plane.transform(plane, transform, result)Plane

使用给定的变换矩阵变换平面。
Name Type Description
plane Plane 平面。
transform Matrix4 变换矩阵。
result Plane optional 存储结果的对象。
Returns:
经过给定变换矩阵变换后的平面。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.