麻辣GIS微信平台

更多 GIS 干货

微信关注不错过

Cesium API - Plane 中文文档

本文介绍下Cesium中 Plane API的详细使用说明。

Plane API 调用方法

new Cesium.Plane(normal, distance)
Hessian范式的平面,由
ax + by + cz + d = 0
定义, 其中(a, b, c)是平面的normal, d 是到平面的有符号distance,(x, y, z)是平面上的任意点。
Name Type Description
normal Cartesian3 平面的法线(归一化)。
distance Number 从原点到平面的最短距离。 distance>的符号决定了原点在平面的哪一边。 如果距离为正,则该点在方向为法线的半空间(half-space)内; 如果为负,则该点在与法线相对的半空间(half-space)内; 如果为零,平面通过该点。
异常情况:
示例:
// The plane x=0
var plane = new Cesium.Plane(Cesium.Cartesian3.UNIT_X, 0.0);

成员变量

staticconstantCesium.Plane.ORIGIN_XY_PLANE : Plane
常数,初始化为通过原点的XY平面,法向量在正Z方向。
staticconstantCesium.Plane.ORIGIN_YZ_PLANE : Plane
常数,初始化为通过原点的YZ平面,法向量在正X方向。
staticconstantCesium.Plane.ORIGIN_ZX_PLANE : Plane
常数,初始化为通过原点的ZX平面,法向量在正Y方向。
distance : Number
从原点到平面的最短距离。 distance>的符号决定了原点在平面的哪一边。 如果距离为正,则该点在方向为法线的半空间(half-space)内; 如果为负,则该点在与法线相对的半空间(half-space)内; 如果为零,平面通过该点。
平面的法线。

内置方法

staticCesium.Plane.clone(plane, result)Plane
Duplicates a Plane instance.
Name Type Description
plane Plane The plane to duplicate.
result Plane optional The object onto which to store the result.
返回值:
The modified result parameter or a new Plane instance if one was not provided.
staticCesium.Plane.equals(left, right)Boolean
将提供的平面按法线和距离进行比较,如果相等则返回true,否则返回false
Name Type Description
left Plane 第一个平面。
right Plane 第二个平面。
返回值:
如果两者相等,则为true;否则false
staticCesium.Plane.fromCartesian4(coefficients, result)Plane
从通用方程创建一个平面。
Name Type Description
coefficients Cartesian4 平面的法线(归一化)。
result Plane optional 存储结果的对象。
返回值:
一个新的平面实例或修改后的结果参数。
异常情况:
staticCesium.Plane.fromPointNormal(point, normal, result)Plane
从平面上的法线和点创建一个平面。
Name Type Description
point Cartesian3 平面上的点。
normal Cartesian3 平面的法线(归一化)。
result Plane optional 存储结果的对象。
返回值:
一个新的平面实例或修改后的结果参数。
异常情况:
示例:
var point = Cesium.Cartesian3.fromDegrees(-72.0, 40.0);
var normal = ellipsoid.geodeticSurfaceNormal(point);
var tangentPlane = Cesium.Plane.fromPointNormal(point, normal);
staticCesium.Plane.getPointDistance(plane, point)Number
计算点到平面的有符号的(signed)最短距离。 距离的符号决定了这个点在平面的哪一边。 如果距离为正,则该点在方向为法线的半空间(half-space)内; 如果为负,则该点在与法线相对的半空间(half-space)内; 如果为零,平面通过该点。
Name Type Description
plane Plane 平面。
point Cartesian3 点。
返回值:
点到平面的有符号最短距离。
staticCesium.Plane.projectPointOntoPlane(plane, point, result)Cartesian3
将一个点投影到平面上。
Name Type Description
plane Plane 投影点的平面
point Cartesian3 投影到平面上的点
result Cartesian3 optional 结果点。如果未定义,将创建一个新的Cartesian3。
返回值:
修改后的结果参数,如果没有提供则创建一个新的Cartesian3实例。
staticCesium.Plane.transform(plane, transform, result)Plane
用给定的变换矩阵变换平面。
Name Type Description
plane Plane 要变换的平面。
transform Matrix4 变换矩阵。
result Plane optional 存储结果的对象。
返回值:
被给定的变换矩阵变换后的平面。

其他API

Cesium中文API文档手册(v1.63.1版本)参考:《Cesium中文API文档手册(v1.63.1版本)

相关阅读

麻辣GIS-Sailor

作者:

GIS爱好者,学GIS,更爱玩GIS。

声明

1.本文所分享的所有需要用户下载使用的内容(包括但不限于软件、数据、图片)来自于网络或者麻辣GIS粉丝自行分享,版权归该下载资源的合法拥有者所有,如有侵权请第一时间联系本站删除。

2.下载内容仅限个人学习使用,请切勿用作商用等其他用途,否则后果自负。

手机阅读
公众号关注
知识星球
手机阅读
麻辣GIS微信公众号关注
最新GIS干货
关注麻辣GIS知识星球
私享圈子

留言板(小编看到第一时间回复)