 Plane

new Cesium.Plane(normal, distance) Core/Plane.js 44

A plane in Hessian Normal Form defined by
```ax + by + cz + d = 0
```
where (a, b, c) is the plane's `normal`, d is the signed `distance` to the plane, and (x, y, z) is any point on the plane.
Name Type Description
`normal` Cartesian3 The plane's normal (normalized).
`distance` Number The shortest distance from the origin to the plane. The sign of `distance` determines which side of the plane the origin is on. If `distance` is positive, the origin is in the half-space in the direction of the normal; if negative, the origin is in the half-space opposite to the normal; if zero, the plane passes through the origin.
Example:
``````// The plane x=0
var plane = new Cesium.Plane(Cesium.Cartesian3.UNIT_X, 0.0);``````

Members

staticconstantCesium.Plane.ORIGIN_XY_PLANE : Plane Core/Plane.js 253

A constant initialized to the XY plane passing through the origin, with normal in positive Z.

staticconstantCesium.Plane.ORIGIN_YZ_PLANE : Plane Core/Plane.js 261

A constant initialized to the YZ plane passing through the origin, with normal in positive X.

staticconstantCesium.Plane.ORIGIN_ZX_PLANE : Plane Core/Plane.js 269

A constant initialized to the ZX plane passing through the origin, with normal in positive Y.

distance : Number Core/Plane.js 69

The shortest distance from the origin to the plane. The sign of `distance` determines which side of the plane the origin is on. If `distance` is positive, the origin is in the half-space in the direction of the normal; if negative, the origin is in the half-space opposite to the normal; if zero, the plane passes through the origin.

normal : Cartesian3 Core/Plane.js 58

The plane's normal.

Methods

staticCesium.Plane.clone(plane, result) → Plane Core/Plane.js 215

Duplicates a Plane instance.
Name Type Description
`plane` Plane The plane to duplicate.
`result` Plane optional The object onto which to store the result.
Returns:
The modified result parameter or a new Plane instance if one was not provided.

staticCesium.Plane.equals(left, right) → Boolean Core/Plane.js 238

Compares the provided Planes by normal and distance and returns `true` if they are equal, `false` otherwise.
Name Type Description
`left` Plane The first plane.
`right` Plane The second plane.
Returns:
`true` if left and right are equal, `false` otherwise.

staticCesium.Plane.fromCartesian4(coefficients, result) → Plane Core/Plane.js 117

Creates a plane from the general equation
Name Type Description
`coefficients` Cartesian4 The plane's normal (normalized).
`result` Plane optional The object onto which to store the result.
Returns:
A new plane instance or the modified result parameter.

staticCesium.Plane.fromPointNormal(point, normal, result) → Plane Core/Plane.js 87

Creates a plane from a normal and a point on the plane.
Name Type Description
`point` Cartesian3 The point on the plane.
`normal` Cartesian3 The plane's normal (normalized).
`result` Plane optional The object onto which to store the result.
Returns:
A new plane instance or the modified result parameter.
Example:
``````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 Core/Plane.js 150

Computes the signed shortest distance of a point to a plane. The sign of the distance determines which side of the plane the point is on. If the distance is positive, the point is in the half-space in the direction of the normal; if negative, the point is in the half-space opposite to the normal; if zero, the plane passes through the point.
Name Type Description
`plane` Plane The plane.
`point` Cartesian3 The point.
Returns:
The signed shortest distance of the point to the plane.

staticCesium.Plane.projectPointOntoPlane(plane, point, result) → Cartesian3 Core/Plane.js 167

Projects a point onto the plane.
Name Type Description
`plane` Plane The plane to project the point onto
`point` Cartesian3 The point to project onto the plane
`result` Cartesian3 optional The result point. If undefined, a new Cartesian3 will be created.
Returns:
The modified result parameter or a new Cartesian3 instance if one was not provided.

staticCesium.Plane.transform(plane, transform, result) → Plane Core/Plane.js 193

Transforms the plane by the given transformation matrix.
Name Type Description
`plane` Plane The plane.
`transform` Matrix4 The transformation matrix.
`result` Plane optional The object into which to store the result.
Returns:
The plane transformed by the given transformation matrix.