与所提供的椭球体在所提供的原点处相切的平面。如果原点不在椭球表面上，则将使用其表面投影。如果原点位于椭球体的中心，则会抛出异常。 A plane tangent to the provided ellipsoid at the provided origin. If origin is not on the surface of the ellipsoid, it's surface projection will be used. If origin is at the center of the ellipsoid, an exception will be thrown.
| 名称 Name | 类型 Type | 默认值 Default | 说明 Description |
|---|---|---|---|
origin |
Cartesian3 | 椭球表面上与切平面相切的点。 The point on the surface of the ellipsoid where the tangent plane touches. | |
ellipsoid |
Ellipsoid |
Ellipsoid.default
|
可选 optional 要使用的椭球体。 The ellipsoid to use. |
抛出： Throws:
-
DeveloperError ：原点不能位于椭球体的中心。 : origin must not be at the center of the ellipsoid.
成员 Members
获取椭球体。 Gets the ellipsoid.
获取原点。 Gets the origin.
readonly plane : Plane
获取与椭球体相切的平面。 Gets the plane which is tangent to the ellipsoid.
readonly xAxis : Cartesian3
获取切平面的局部 X 轴（东）。 Gets the local X-axis (east) of the tangent plane.
readonly yAxis : Cartesian3
获取切平面的局部 Y 轴（北）。 Gets the local Y-axis (north) of the tangent plane.
readonly zAxis : Cartesian3
获取切平面的局部 Z 轴（向上）。 Gets the local Z-axis (up) of the tangent plane.
方法 Methods
static Cesium.EllipsoidTangentPlane.fromPoints(cartesians, ellipsoid) → EllipsoidTangentPlane
从提供的椭球体和提供的笛卡尔坐标的中心点创建一个新实例。 Creates a new instance from the provided ellipsoid and the center point of the provided Cartesians.
| 名称 Name | 类型 Type | 默认值 Default | 说明 Description |
|---|---|---|---|
cartesians |
Array.<Cartesian3> | 中心点周围的位置列表。 The list of positions surrounding the center point. | |
ellipsoid |
Ellipsoid |
Ellipsoid.default
|
可选 optional 要使用的椭球体。 The ellipsoid to use. |
返回： Returns:
EllipsoidTangentPlane 的新实例。 The new instance of EllipsoidTangentPlane.
projectPointOntoEllipsoid(cartesian, result) → Cartesian3
计算提供的 2D 位置到 3D 椭球体上的投影。 Computes the projection of the provided 2D position onto the 3D ellipsoid.
| 名称 Name | 类型 Type | 说明 Description |
|---|---|---|
cartesian |
Cartesian2 | 要投影的点。 The points to project. |
result |
Cartesian3 | 可选 optional 用于存储结果的 Cartesian3 实例。 The Cartesian3 instance to store result. |
返回： Returns:
修改后的结果参数或新的 Cartesian3 实例（如果未提供）。 The modified result parameter or a new Cartesian3 instance if none was provided.
projectPointOntoPlane(cartesian, result) → Cartesian2
计算所提供的 3D 位置在 2D 平面上的投影，从 Computes the projection of the provided 3D position onto the 2D plane, radially outward from the
EllipsoidTangentPlane.ellipsoid 坐标系原点。 coordinate system origin.
| 名称 Name | 类型 Type | 说明 Description |
|---|---|---|
cartesian |
Cartesian3 | 项目的要点。 The point to project. |
result |
Cartesian2 | 可选 optional 用于存储结果的对象。 The object onto which to store the result. |
返回： Returns:
修改后的结果参数或新的 Cartesian2 实例（如果未提供）。如果没有交点则未定义 The modified result parameter or a new Cartesian2 instance if none was provided. Undefined if there is no intersection point
projectPointsOntoEllipsoid(cartesians, result) → Array.<Cartesian3>
计算所提供的 2D 位置到 3D 椭球体上的投影。 Computes the projection of the provided 2D positions onto the 3D ellipsoid.
| 名称 Name | 类型 Type | 说明 Description |
|---|---|---|
cartesians |
Array.<Cartesian2> | 要投影的点的数组。 The array of points to project. |
result |
Array.<Cartesian3> | 可选 optional 用于存储结果的 Cartesian3 实例的数组。 The array of Cartesian3 instances onto which to store results. |
返回： Returns:
修改后的结果参数或 Cartesian3 实例的新数组（如果未提供）。 The modified result parameter or a new array of Cartesian3 instances if none was provided.
projectPointsOntoPlane(cartesians, result) → Array.<Cartesian2>
计算所提供的 3D 位置到 2D 平面（如果可能）上的投影，从全局原点径向向外。结果数组可能比输入数组短 - 如果单个投影不可能，则不会包含在内。 Computes the projection of the provided 3D positions onto the 2D plane (where possible), radially outward from the global origin. The resulting array may be shorter than the input array - if a single projection is impossible it will not be included.
| 名称 Name | 类型 Type | 说明 Description |
|---|---|---|
cartesians |
Array.<Cartesian3> | 要投影的点的数组。 The array of points to project. |
result |
Array.<Cartesian2> | 可选 optional 用于存储结果的 Cartesian2 实例的数组。 The array of Cartesian2 instances onto which to store results. |
返回： Returns:
修改后的结果参数或 Cartesian2 实例的新数组（如果未提供）。 The modified result parameter or a new array of Cartesian2 instances if none was provided.
- EllipsoidTangentPlane.projectPointOntoPlane
另见： See:
projectPointsToNearestOnPlane(cartesians, result) → Array.<Cartesian2>
计算所提供的 3D 位置沿平面法线到 2D 平面的投影。 Computes the projection of the provided 3D positions onto the 2D plane, along the plane normal.
| 名称 Name | 类型 Type | 说明 Description |
|---|---|---|
cartesians |
Array.<Cartesian3> | 要投影的点的数组。 The array of points to project. |
result |
Array.<Cartesian2> | 可选 optional 用于存储结果的 Cartesian2 实例的数组。 The array of Cartesian2 instances onto which to store results. |
返回： Returns:
修改后的结果参数或 Cartesian2 实例的新数组（如果未提供）。这将具有相同的长度 The modified result parameter or a new array of Cartesian2 instances if none was provided. This will have the same length as
cartesians.
- EllipsoidTangentPlane.projectPointToNearestOnPlane
另见： See:
projectPointToNearestOnPlane(cartesian, result) → Cartesian2
计算所提供的 3D 位置沿平面法线到 2D 平面的投影。 Computes the projection of the provided 3D position onto the 2D plane, along the plane normal.
| 名称 Name | 类型 Type | 说明 Description |
|---|---|---|
cartesian |
Cartesian3 | 项目的要点。 The point to project. |
result |
Cartesian2 | 可选 optional 用于存储结果的对象。 The object onto which to store the result. |
返回： Returns:
修改后的结果参数或新的 Cartesian2 实例（如果未提供）。 The modified result parameter or a new Cartesian2 instance if none was provided.