@cesium/engine 9.2.0 → 10.0.0

package/Source/Core/CustomHeightmapTerrainProvider.js

@@ -35,9 +35,9 @@ import TerrainProvider from "./TerrainProvider.js";
  * @param {TilingScheme} [options.tilingScheme] The tiling scheme specifying how the ellipsoidal
  * surface is broken into tiles. If this parameter is not provided, a {@link GeographicTilingScheme}
  * is used.
- * @param {Ellipsoid} [options.ellipsoid] The ellipsoid.  If the tilingScheme is specified,
+ * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.default] The ellipsoid.  If the tilingScheme is specified,
  * this parameter is ignored and the tiling scheme's ellipsoid is used instead. If neither
- * parameter is specified, the WGS84 ellipsoid is used.
+ * parameter is specified, the default ellipsoid is used.
  * @param {Credit|string} [options.credit] A credit for the data source, which is displayed on the canvas.
  *
  * @example
@@ -67,7 +67,7 @@ function CustomHeightmapTerrainProvider(options) {
   this._tilingScheme = options.tilingScheme;
   if (!defined(this._tilingScheme)) {
     this._tilingScheme = new GeographicTilingScheme({
-      ellipsoid: defaultValue(options.ellipsoid, Ellipsoid.WGS84),
+      ellipsoid: defaultValue(options.ellipsoid, Ellipsoid.default),
     });
   }
 
@@ -160,6 +160,20 @@ Object.defineProperties(CustomHeightmapTerrainProvider.prototype, {
     },
   },
 
+  /**
+   * Gets an object that can be used to determine availability of terrain from this provider, such as
+   * at points and in rectangles. This property may be undefined if availability
+   * information is not available.
+   * @memberof CustomHeightmapTerrainProvider.prototype
+   * @type {TileAvailability}
+   * @readonly
+   */
+  availability: {
+    get: function () {
+      return undefined;
+    },
+  },
+
   /**
    * Gets the number of columns per heightmap tile.
    * @memberof CustomHeightmapTerrainProvider.prototype

package/Source/Core/EllipseGeometry.js

@@ -892,7 +892,7 @@ function computeRectangle(
  * @param {Cartesian3} options.center The ellipse's center point in the fixed frame.
  * @param {number} options.semiMajorAxis The length of the ellipse's semi-major axis in meters.
  * @param {number} options.semiMinorAxis The length of the ellipse's semi-minor axis in meters.
- * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid the ellipse will be on.
+ * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.default] The ellipsoid the ellipse will be on.
  * @param {number} [options.height=0.0] The distance in meters between the ellipse and the ellipsoid surface.
  * @param {number} [options.extrudedHeight] The distance in meters between the ellipse's extruded face and the ellipsoid surface.
  * @param {number} [options.rotation=0.0] The angle of rotation counter-clockwise from north.
@@ -921,7 +921,7 @@ function EllipseGeometry(options) {
   options = defaultValue(options, defaultValue.EMPTY_OBJECT);
 
   const center = options.center;
-  const ellipsoid = defaultValue(options.ellipsoid, Ellipsoid.WGS84);
+  const ellipsoid = defaultValue(options.ellipsoid, Ellipsoid.default);
   const semiMajorAxis = options.semiMajorAxis;
   const semiMinorAxis = options.semiMinorAxis;
   const granularity = defaultValue(
@@ -1109,7 +1109,7 @@ EllipseGeometry.unpack = function (array, startingIndex, result) {
  * @param {Cartesian3} options.center The ellipse's center point in the fixed frame.
  * @param {number} options.semiMajorAxis The length of the ellipse's semi-major axis in meters.
  * @param {number} options.semiMinorAxis The length of the ellipse's semi-minor axis in meters.
- * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid the ellipse will be on.
+ * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.default] The ellipsoid the ellipse will be on.
  * @param {number} [options.rotation=0.0] The angle of rotation counter-clockwise from north.
  * @param {number} [options.granularity=CesiumMath.RADIANS_PER_DEGREE] The angular distance between points on the ellipse in radians.
  * @param {Rectangle} [result] An object in which to store the result
@@ -1120,7 +1120,7 @@ EllipseGeometry.computeRectangle = function (options, result) {
   options = defaultValue(options, defaultValue.EMPTY_OBJECT);
 
   const center = options.center;
-  const ellipsoid = defaultValue(options.ellipsoid, Ellipsoid.WGS84);
+  const ellipsoid = defaultValue(options.ellipsoid, Ellipsoid.default);
   const semiMajorAxis = options.semiMajorAxis;
   const semiMinorAxis = options.semiMinorAxis;
   const granularity = defaultValue(

package/Source/Core/EllipseOutlineGeometry.js

@@ -188,7 +188,7 @@ function computeExtrudedEllipse(options) {
  * @param {Cartesian3} options.center The ellipse's center point in the fixed frame.
  * @param {number} options.semiMajorAxis The length of the ellipse's semi-major axis in meters.
  * @param {number} options.semiMinorAxis The length of the ellipse's semi-minor axis in meters.
- * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid the ellipse will be on.
+ * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.default] The ellipsoid the ellipse will be on.
  * @param {number} [options.height=0.0] The distance in meters between the ellipse and the ellipsoid surface.
  * @param {number} [options.extrudedHeight] The distance in meters between the ellipse's extruded face and the ellipsoid surface.
  * @param {number} [options.rotation=0.0] The angle from north (counter-clockwise) in radians.
@@ -214,7 +214,7 @@ function EllipseOutlineGeometry(options) {
   options = defaultValue(options, defaultValue.EMPTY_OBJECT);
 
   const center = options.center;
-  const ellipsoid = defaultValue(options.ellipsoid, Ellipsoid.WGS84);
+  const ellipsoid = defaultValue(options.ellipsoid, Ellipsoid.default);
   const semiMajorAxis = options.semiMajorAxis;
   const semiMinorAxis = options.semiMinorAxis;
   const granularity = defaultValue(

package/Source/Core/Ellipsoid.js

@@ -255,6 +255,40 @@ Ellipsoid.MOON = Object.freeze(
   )
 );
 
+Ellipsoid._default = Ellipsoid.WGS84;
+Object.defineProperties(Ellipsoid, {
+  /**
+   * The default ellipsoid used when not otherwise specified.
+   * @memberof Ellipsoid
+   * @type {Ellipsoid}
+   * @example
+   * Cesium.Ellipsoid.default = Cesium.Ellipsoid.MOON;
+   *
+   * // Apollo 11 landing site
+   * const position = Cesium.Cartesian3.fromRadians(
+   *   0.67416,
+   *   23.47315,
+   * );
+   */
+  default: {
+    get: function () {
+      return Ellipsoid._default;
+    },
+    set: function (value) {
+      //>>includeStart('debug', pragmas.debug);
+      Check.typeOf.object("value", value);
+      //>>includeEnd('debug');
+
+      Ellipsoid._default = value;
+      Cartesian3._ellipsoidRadiiSquared = value.radiiSquared;
+      Cartographic._ellipsoidOneOverRadii = value.oneOverRadii;
+      Cartographic._ellipsoidOneOverRadiiSquared = value.oneOverRadiiSquared;
+      Cartographic._ellipsoidCenterToleranceSquared =
+        value._centerToleranceSquared;
+    },
+  },
+});
+
 /**
  * Duplicates an Ellipsoid instance.
  *

package/Source/Core/EllipsoidGeodesic.js

@@ -280,10 +280,10 @@ function computeProperties(ellipsoidGeodesic, start, end, ellipsoid) {
  *
  * @param {Cartographic} [start] The initial planetodetic point on the path.
  * @param {Cartographic} [end] The final planetodetic point on the path.
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid on which the geodesic lies.
+ * @param {Ellipsoid} [ellipsoid=Ellipsoid.default] The ellipsoid on which the geodesic lies.
  */
 function EllipsoidGeodesic(start, end, ellipsoid) {
-  const e = defaultValue(ellipsoid, Ellipsoid.WGS84);
+  const e = defaultValue(ellipsoid, Ellipsoid.default);
   this._ellipsoid = e;
   this._start = new Cartographic();
   this._end = new Cartographic();

package/Source/Core/EllipsoidRhumbLine.js

@@ -385,12 +385,12 @@ function interpolateUsingSurfaceDistance(
  *
  * @param {Cartographic} [start] The initial planetodetic point on the path.
  * @param {Cartographic} [end] The final planetodetic point on the path.
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid on which the rhumb line lies.
+ * @param {Ellipsoid} [ellipsoid=Ellipsoid.default] The ellipsoid on which the rhumb line lies.
  *
  * @exception {DeveloperError} angle between start and end must be at least 0.0125 radians.
  */
 function EllipsoidRhumbLine(start, end, ellipsoid) {
-  const e = defaultValue(ellipsoid, Ellipsoid.WGS84);
+  const e = defaultValue(ellipsoid, Ellipsoid.default);
   this._ellipsoid = e;
   this._start = new Cartographic();
   this._end = new Cartographic();
@@ -481,7 +481,7 @@ Object.defineProperties(EllipsoidRhumbLine.prototype, {
  * @param {Cartographic} start The initial planetodetic point on the path.
  * @param {number} heading The heading in radians.
  * @param {number} distance The rhumb line distance between the start and end point.
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid on which the rhumb line lies.
+ * @param {Ellipsoid} [ellipsoid=Ellipsoid.default] The ellipsoid on which the rhumb line lies.
  * @param {EllipsoidRhumbLine} [result] The object in which to store the result.
  * @returns {EllipsoidRhumbLine} The EllipsoidRhumbLine object.
  */
@@ -499,7 +499,7 @@ EllipsoidRhumbLine.fromStartHeadingDistance = function (
   Check.typeOf.number.greaterThan("distance", distance, 0.0);
   //>>includeEnd('debug');
 
-  const e = defaultValue(ellipsoid, Ellipsoid.WGS84);
+  const e = defaultValue(ellipsoid, Ellipsoid.default);
   const major = e.maximumRadius;
   const minor = e.minimumRadius;
   const majorSquared = major * major;

package/Source/Core/EllipsoidTangentPlane.js

@@ -22,7 +22,7 @@ const scratchCart4 = new Cartesian4();
  * @constructor
  *
  * @param {Cartesian3} origin The point on the surface of the ellipsoid where the tangent plane touches.
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid to use.
+ * @param {Ellipsoid} [ellipsoid=Ellipsoid.default] The ellipsoid to use.
  *
  * @exception {DeveloperError} origin must not be at the center of the ellipsoid.
  */
@@ -31,7 +31,7 @@ function EllipsoidTangentPlane(origin, ellipsoid) {
   Check.defined("origin", origin);
   //>>includeEnd('debug');
 
-  ellipsoid = defaultValue(ellipsoid, Ellipsoid.WGS84);
+  ellipsoid = defaultValue(ellipsoid, Ellipsoid.default);
   origin = ellipsoid.scaleToGeodeticSurface(origin);
 
   //>>includeStart('debug', pragmas.debug);
@@ -136,7 +136,7 @@ const tmp = new AxisAlignedBoundingBox();
  * point of the provided Cartesians.
  *
  * @param {Cartesian3[]} cartesians The list of positions surrounding the center point.
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid to use.
+ * @param {Ellipsoid} [ellipsoid=Ellipsoid.default] The ellipsoid to use.
  * @returns {EllipsoidTangentPlane} The new instance of EllipsoidTangentPlane.
  */
 EllipsoidTangentPlane.fromPoints = function (cartesians, ellipsoid) {

package/Source/Core/EllipsoidTerrainProvider.js

@@ -17,9 +17,9 @@ import TerrainProvider from "./TerrainProvider.js";
  * @param {TilingScheme} [options.tilingScheme] The tiling scheme specifying how the ellipsoidal
  * surface is broken into tiles.  If this parameter is not provided, a {@link GeographicTilingScheme}
  * is used.
- * @param {Ellipsoid} [options.ellipsoid] The ellipsoid.  If the tilingScheme is specified,
+ * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.default] The ellipsoid.  If the tilingScheme is specified,
  * this parameter is ignored and the tiling scheme's ellipsoid is used instead. If neither
- * parameter is specified, the WGS84 ellipsoid is used.
+ * parameter is specified, the default ellipsoid is used.
  *
  * @see TerrainProvider
  */
@@ -29,7 +29,7 @@ function EllipsoidTerrainProvider(options) {
   this._tilingScheme = options.tilingScheme;
   if (!defined(this._tilingScheme)) {
     this._tilingScheme = new GeographicTilingScheme({
-      ellipsoid: defaultValue(options.ellipsoid, Ellipsoid.WGS84),
+      ellipsoid: defaultValue(options.ellipsoid, Ellipsoid.default),
     });
   }
 

package/Source/Core/GeographicProjection.js

@@ -8,18 +8,18 @@ import Ellipsoid from "./Ellipsoid.js";
 /**
  * A simple map projection where longitude and latitude are linearly mapped to X and Y by multiplying
  * them by the {@link Ellipsoid#maximumRadius}.  This projection
- * is commonly known as geographic, equirectangular, equidistant cylindrical, or plate carrée.  It
+ * is commonly known as geographic, equirectangular, equidistant cylindrical, or plate carrée. When using the WGS84 ellipsoid, it
  * is also known as EPSG:4326.
  *
  * @alias GeographicProjection
  * @constructor
  *
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid.
+ * @param {Ellipsoid} [ellipsoid=Ellipsoid.default] The ellipsoid.
  *
  * @see WebMercatorProjection
  */
 function GeographicProjection(ellipsoid) {
-  this._ellipsoid = defaultValue(ellipsoid, Ellipsoid.WGS84);
+  this._ellipsoid = defaultValue(ellipsoid, Ellipsoid.default);
   this._semimajorAxis = this._ellipsoid.maximumRadius;
   this._oneOverSemimajorAxis = 1.0 / this._semimajorAxis;
 }
@@ -102,4 +102,5 @@ GeographicProjection.prototype.unproject = function (cartesian, result) {
   result.height = height;
   return result;
 };
+
 export default GeographicProjection;

package/Source/Core/GeographicTilingScheme.js

@@ -16,8 +16,8 @@ import Rectangle from "./Rectangle.js";
  * @constructor
  *
  * @param {object} [options] Object with the following properties:
- * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid whose surface is being tiled. Defaults to
- * the WGS84 ellipsoid.
+ * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.default] The ellipsoid whose surface is being tiled. Defaults to
+ * the default ellipsoid.
  * @param {Rectangle} [options.rectangle=Rectangle.MAX_VALUE] The rectangle, in radians, covered by the tiling scheme.
  * @param {number} [options.numberOfLevelZeroTilesX=2] The number of tiles in the X direction at level zero of
  * the tile tree.
@@ -27,7 +27,7 @@ import Rectangle from "./Rectangle.js";
 function GeographicTilingScheme(options) {
   options = defaultValue(options, defaultValue.EMPTY_OBJECT);
 
-  this._ellipsoid = defaultValue(options.ellipsoid, Ellipsoid.WGS84);
+  this._ellipsoid = defaultValue(options.ellipsoid, Ellipsoid.default);
   this._rectangle = defaultValue(options.rectangle, Rectangle.MAX_VALUE);
   this._projection = new GeographicProjection(this._ellipsoid);
   this._numberOfLevelZeroTilesX = defaultValue(

package/Source/Core/GeometryPipeline.js

@@ -687,7 +687,7 @@ GeometryPipeline.projectTo2D = function (
     projectedValues[index++] = projectedLonLat.z;
   }
 
-  // Rename original cartesians to WGS84 cartesians.
+  // Rename original cartesians to ellipsoid cartesians.
   geometry.attributes[attributeName3D] = attribute;
 
   // Replace original cartesians with 2D projected cartesians
@@ -1902,7 +1902,7 @@ const splitTriangleResult = {
 };
 
 function splitTriangle(p0, p1, p2) {
-  // In WGS84 coordinates, for a triangle approximately on the
+  // In ellipsoid coordinates, for a triangle approximately on the
   // ellipsoid to cross the IDL, first it needs to be on the
   // negative side of the plane x = 0.
   if (p0.x >= 0.0 || p1.x >= 0.0 || p2.x >= 0.0) {

package/Source/Core/GoogleEarthEnterpriseTerrainProvider.js

@@ -69,7 +69,7 @@ TerrainCache.prototype.tidy = function () {
  *
  * Initialization options for GoogleEarthEnterpriseTerrainProvider constructor
  *
- * @property {Ellipsoid} [ellipsoid] The ellipsoid.  If not specified, the WGS84 ellipsoid is used.
+ * @property {Ellipsoid} [ellipsoid=Ellipsoid.default] The ellipsoid.  If not specified, the default ellipsoid is used.
  * @property {Credit|string} [credit] A credit for the data source, which is displayed on the canvas.
  */
 

package/Source/Core/GoogleMaps.js

@@ -33,7 +33,7 @@ GoogleMaps.mapTilesApiEndpoint = new Resource({
 
 GoogleMaps.getDefaultCredit = function () {
   return new Credit(
-    `<img src="https://assets.ion-development.cesium.com/google-credit.png" alt="Google">`,
+    `<img src="https://assets.ion.cesium.com/google-credit.png" style="vertical-align: -5px" alt="Google">`,
     true
   );
 };

package/Source/Core/GroundPolylineGeometry.js

@@ -121,7 +121,7 @@ function GroundPolylineGeometry(options) {
    */
   this.arcType = defaultValue(options.arcType, ArcType.GEODESIC);
 
-  this._ellipsoid = Ellipsoid.WGS84;
+  this._ellipsoid = Ellipsoid.default;
 
   // MapProjections can't be packed, so store the index to a known MapProjection.
   this._projectionIndex = 0;

package/Source/Core/HeightmapTessellator.js

@@ -62,7 +62,7 @@ const maximumScratch = new Cartesian3();
  * @param {boolean} [options.isGeographic=true] True if the heightmap uses a {@link GeographicProjection}, or false if it uses
  *                  a {@link WebMercatorProjection}.
  * @param {Cartesian3} [options.relativeToCenter=Cartesian3.ZERO] The positions will be computed as <code>Cartesian3.subtract(worldPosition, relativeToCenter)</code>.
- * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid to which the heightmap applies.
+ * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.default] The ellipsoid to which the heightmap applies.
  * @param {object} [options.structure] An object describing the structure of the height data.
  * @param {number} [options.structure.heightScale=1.0] The factor by which to multiply height samples in order to obtain
  *                 the height above the heightOffset, in meters.  The heightOffset is added to the resulting
@@ -149,7 +149,7 @@ HeightmapTessellator.computeVertices = function (options) {
   const hasSkirts = skirtHeight > 0.0;
 
   const isGeographic = defaultValue(options.isGeographic, true);
-  const ellipsoid = defaultValue(options.ellipsoid, Ellipsoid.WGS84);
+  const ellipsoid = defaultValue(options.ellipsoid, Ellipsoid.default);
 
   const oneOverGlobeSemimajorAxis = 1.0 / ellipsoid.maximumRadius;
 

package/Source/Core/Ion.js

@@ -4,7 +4,7 @@ import Resource from "./Resource.js";
 
 let defaultTokenCredit;
 const defaultAccessToken =
-  "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI0YjhlOGM0Yy0xNzcwLTQwNWEtODk4Yy0xMGJkODg4MTA5ZGEiLCJpZCI6MjU5LCJpYXQiOjE3MTc0MzM4NjB9.VwBpSnRTNdg_G6uvU-JNsRNcSOCDMKW_j3Nl5E7wfwg";
+  "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIyYTI3ZDMxOS1mODc4LTQ5NzktOGUzNy04OTA0ZGI5MmM1NGIiLCJpZCI6MjU5LCJpYXQiOjE3MTk4NDM5OTN9.FDHD-mZOIAzA9J_kzOz6AkKK2PHzl2yoMbFqbpsfH6Q";
 /**
  * Default settings for accessing the Cesium ion API.
  *

package/Source/Core/Occluder.js

@@ -499,7 +499,7 @@ const computeOccludeePointFromRectangleScratch = [];
  * Computes a point that can be used as the occludee position to the visibility functions from a rectangle.
  *
  * @param {Rectangle} rectangle The rectangle used to create a bounding sphere.
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid used to determine positions of the rectangle.
+ * @param {Ellipsoid} [ellipsoid=Ellipsoid.default] The ellipsoid used to determine positions of the rectangle.
  * @returns {object} An object containing two attributes: <code>occludeePoint</code> and <code>valid</code>
  * which is a boolean value.
  */
@@ -510,7 +510,7 @@ Occluder.computeOccludeePointFromRectangle = function (rectangle, ellipsoid) {
   }
   //>>includeEnd('debug');
 
-  ellipsoid = defaultValue(ellipsoid, Ellipsoid.WGS84);
+  ellipsoid = defaultValue(ellipsoid, Ellipsoid.default);
   const positions = Rectangle.subsample(
     rectangle,
     ellipsoid,
@@ -519,7 +519,7 @@ Occluder.computeOccludeePointFromRectangle = function (rectangle, ellipsoid) {
   );
   const bs = BoundingSphere.fromPoints(positions);
 
-  // TODO: get correct ellipsoid center
+  // Assumes the ellipsoid is centered at the origin
   const ellipsoidCenter = Cartesian3.ZERO;
   if (!Cartesian3.equals(ellipsoidCenter, bs.center)) {
     return Occluder.computeOccludeePoint(

package/Source/Core/OrientedBoundingBox.js

@@ -332,7 +332,7 @@ const scratchPlane = new Plane(Cartesian3.UNIT_X, 0.0);
  * @param {Rectangle} rectangle The cartographic rectangle on the surface of the ellipsoid.
  * @param {number} [minimumHeight=0.0] The minimum height (elevation) within the tile.
  * @param {number} [maximumHeight=0.0] The maximum height (elevation) within the tile.
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid on which the rectangle is defined.
+ * @param {Ellipsoid} [ellipsoid=Ellipsoid.default] The ellipsoid on which the rectangle is defined.
  * @param {OrientedBoundingBox} [result] The object onto which to store the result.
  * @returns {OrientedBoundingBox} The modified result parameter or a new OrientedBoundingBox instance if none was provided.
  *
@@ -373,7 +373,7 @@ OrientedBoundingBox.fromRectangle = function (
 
   minimumHeight = defaultValue(minimumHeight, 0.0);
   maximumHeight = defaultValue(maximumHeight, 0.0);
-  ellipsoid = defaultValue(ellipsoid, Ellipsoid.WGS84);
+  ellipsoid = defaultValue(ellipsoid, Ellipsoid.default);
 
   let minX, maxX, minY, maxY, minZ, maxZ, plane;
 

package/Source/Core/PolygonGeometry.js

@@ -585,7 +585,7 @@ function createGeometryFromPositionsExtruded(
  * @param {number} [options.extrudedHeight] The distance in meters between the polygon's extruded face and the ellipsoid surface.
  * @param {VertexFormat} [options.vertexFormat=VertexFormat.DEFAULT] The vertex attributes to be computed.
  * @param {number} [options.stRotation=0.0] The rotation of the texture coordinates, in radians. A positive rotation is counter-clockwise.
- * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid to be used as a reference.
+ * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.default] The ellipsoid to be used as a reference.
  * @param {number} [options.granularity=CesiumMath.RADIANS_PER_DEGREE] The distance, in radians, between each latitude and longitude. Determines the number of positions in the buffer.
  * @param {boolean} [options.perPositionHeight=false] Use the height of options.positions for each position instead of using options.height to determine the height.
  * @param {boolean} [options.closeTop=true] When false, leaves off the top of an extruded polygon open.
@@ -691,7 +691,7 @@ function PolygonGeometry(options) {
 
   const polygonHierarchy = options.polygonHierarchy;
   const vertexFormat = defaultValue(options.vertexFormat, VertexFormat.DEFAULT);
-  const ellipsoid = defaultValue(options.ellipsoid, Ellipsoid.WGS84);
+  const ellipsoid = defaultValue(options.ellipsoid, Ellipsoid.default);
   const granularity = defaultValue(
     options.granularity,
     CesiumMath.RADIANS_PER_DEGREE
@@ -759,7 +759,7 @@ function PolygonGeometry(options) {
  * @param {number} [options.extrudedHeight] The height of the polygon extrusion.
  * @param {VertexFormat} [options.vertexFormat=VertexFormat.DEFAULT] The vertex attributes to be computed.
  * @param {number} [options.stRotation=0.0] The rotation of the texture coordinates, in radians. A positive rotation is counter-clockwise.
- * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid to be used as a reference.
+ * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.default] The ellipsoid to be used as a reference.
  * @param {number} [options.granularity=CesiumMath.RADIANS_PER_DEGREE] The distance, in radians, between each latitude and longitude. Determines the number of positions in the buffer.
  * @param {boolean} [options.perPositionHeight=false] Use the height of options.positions for each position instead of using options.height to determine the height.
  * @param {boolean} [options.closeTop=true] When false, leaves off the top of an extruded polygon open.
@@ -1040,7 +1040,7 @@ const polygon = {
  * Computes a rectangle which encloses the polygon defined by the list of positions, including cases over the international date line and the poles.
  *
  * @param {Cartesian3[]} positions A linear ring defining the outer boundary of the polygon.
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid to be used as a reference.
+ * @param {Ellipsoid} [ellipsoid=Ellipsoid.default] The ellipsoid to be used as a reference.
  * @param {ArcType} [arcType=ArcType.GEODESIC] The type of line the polygon edges must follow. Valid options are {@link ArcType.GEODESIC} and {@link ArcType.RHUMB}.
  * @param {Rectangle} [result] An object in which to store the result.
  *

package/Source/Core/PolygonGeometryLibrary.js

@@ -362,7 +362,7 @@ PolygonGeometryLibrary.scaleToGeodeticHeightExtruded = function (
   ellipsoid,
   perPositionHeight
 ) {
-  ellipsoid = defaultValue(ellipsoid, Ellipsoid.WGS84);
+  ellipsoid = defaultValue(ellipsoid, Ellipsoid.default);
 
   const n1 = scaleToGeodeticHeightN1;
   let n2 = scaleToGeodeticHeightN2;

package/Source/Core/PolygonOutlineGeometry.js

@@ -273,7 +273,7 @@ function createGeometryFromPositionsExtruded(
  * @param {number} [options.height=0.0] The distance in meters between the polygon and the ellipsoid surface.
  * @param {number} [options.extrudedHeight] The distance in meters between the polygon's extruded face and the ellipsoid surface.
  * @param {VertexFormat} [options.vertexFormat=VertexFormat.DEFAULT] The vertex attributes to be computed.
- * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid to be used as a reference.
+ * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.default] The ellipsoid to be used as a reference.
  * @param {number} [options.granularity=CesiumMath.RADIANS_PER_DEGREE] The distance, in radians, between each latitude and longitude. Determines the number of positions in the buffer.
  * @param {boolean} [options.perPositionHeight=false] Use the height of options.positions for each position instead of using options.height to determine the height.
  * @param {ArcType} [options.arcType=ArcType.GEODESIC] The type of path the outline must follow. Valid options are {@link ArcType.GEODESIC} and {@link ArcType.RHUMB}.
@@ -370,7 +370,7 @@ function PolygonOutlineGeometry(options) {
   //>>includeEnd('debug');
 
   const polygonHierarchy = options.polygonHierarchy;
-  const ellipsoid = defaultValue(options.ellipsoid, Ellipsoid.WGS84);
+  const ellipsoid = defaultValue(options.ellipsoid, Ellipsoid.default);
   const granularity = defaultValue(
     options.granularity,
     CesiumMath.RADIANS_PER_DEGREE
@@ -518,7 +518,7 @@ PolygonOutlineGeometry.unpack = function (array, startingIndex, result) {
  * @param {Cartesian3[]} options.positions An array of positions that defined the corner points of the polygon.
  * @param {number} [options.height=0.0] The height of the polygon.
  * @param {number} [options.extrudedHeight] The height of the polygon extrusion.
- * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid to be used as a reference.
+ * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.default] The ellipsoid to be used as a reference.
  * @param {number} [options.granularity=CesiumMath.RADIANS_PER_DEGREE] The distance, in radians, between each latitude and longitude. Determines the number of positions in the buffer.
  * @param {boolean} [options.perPositionHeight=false] Use the height of options.positions for each position instead of using options.height to determine the height.
  * @param {ArcType} [options.arcType=ArcType.GEODESIC] The type of path the outline must follow. Valid options are {@link LinkType.GEODESIC} and {@link ArcType.RHUMB}.

package/Source/Core/PolygonPipeline.js

@@ -587,7 +587,7 @@ PolygonPipeline.computeRhumbLineSubdivision = function (
  *
  * @param {number[]} positions The array of numbers representing the positions to be scaled
  * @param {number} [height=0.0] The desired height to add to the positions
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid on which the positions lie.
+ * @param {Ellipsoid} [ellipsoid=Ellipsoid.default] The ellipsoid on which the positions lie.
  * @param {boolean} [scaleToSurface=true] <code>true</code> if the positions need to be scaled to the surface before the height is added.
  * @returns {number[]} The input array of positions, scaled to height
  */
@@ -597,7 +597,7 @@ PolygonPipeline.scaleToGeodeticHeight = function (
   ellipsoid,
   scaleToSurface
 ) {
-  ellipsoid = defaultValue(ellipsoid, Ellipsoid.WGS84);
+  ellipsoid = defaultValue(ellipsoid, Ellipsoid.default);
 
   let n = scaleToGeodeticHeightN;
   let p = scaleToGeodeticHeightP;

package/Source/Core/PolylineGeometry.js

@@ -75,7 +75,7 @@ function interpolateColors(p0, p1, color0, color1, numPoints) {
  * @param {ArcType} [options.arcType=ArcType.GEODESIC] The type of line the polyline segments must follow.
  * @param {number} [options.granularity=CesiumMath.RADIANS_PER_DEGREE] The distance, in radians, between each latitude and longitude if options.arcType is not ArcType.NONE. Determines the number of positions in the buffer.
  * @param {VertexFormat} [options.vertexFormat=VertexFormat.DEFAULT] The vertex attributes to be computed.
- * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid to be used as a reference.
+ * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.default] The ellipsoid to be used as a reference.
  *
  * @exception {DeveloperError} At least two positions are required.
  * @exception {DeveloperError} width must be greater than or equal to one.
@@ -134,7 +134,7 @@ function PolylineGeometry(options) {
     CesiumMath.RADIANS_PER_DEGREE
   );
   this._ellipsoid = Ellipsoid.clone(
-    defaultValue(options.ellipsoid, Ellipsoid.WGS84)
+    defaultValue(options.ellipsoid, Ellipsoid.default)
   );
   this._workerName = "createPolylineGeometry";
 

package/Source/Core/PolylinePipeline.js

@@ -311,7 +311,7 @@ PolylinePipeline.wrapLongitude = function (positions, modelMatrix) {
  * @param {Cartesian3[]} options.positions The array of type {Cartesian3} representing positions.
  * @param {number|number[]} [options.height=0.0] A number or array of numbers representing the heights of each position.
  * @param {number} [options.granularity = CesiumMath.RADIANS_PER_DEGREE] The distance, in radians, between each latitude and longitude. Determines the number of positions in the buffer.
- * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid on which the positions lie.
+ * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.default] The ellipsoid on which the positions lie.
  * @returns {number[]} A new array of positions of type {number} that have been subdivided and raised to the surface of the ellipsoid.
  *
  * @example
@@ -337,7 +337,7 @@ PolylinePipeline.generateArc = function (options) {
   //>>includeEnd('debug');
 
   const length = positions.length;
-  const ellipsoid = defaultValue(options.ellipsoid, Ellipsoid.WGS84);
+  const ellipsoid = defaultValue(options.ellipsoid, Ellipsoid.default);
   let height = defaultValue(options.height, 0);
   const hasHeightArray = Array.isArray(height);
 
@@ -418,7 +418,7 @@ const scratchCartographic1 = new Cartographic();
  * @param {Cartesian3[]} options.positions The array of type {Cartesian3} representing positions.
  * @param {number|number[]} [options.height=0.0] A number or array of numbers representing the heights of each position.
  * @param {number} [options.granularity = CesiumMath.RADIANS_PER_DEGREE] The distance, in radians, between each latitude and longitude. Determines the number of positions in the buffer.
- * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid on which the positions lie.
+ * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.default] The ellipsoid on which the positions lie.
  * @returns {number[]} A new array of positions of type {number} that have been subdivided and raised to the surface of the ellipsoid.
  *
  * @example
@@ -444,7 +444,7 @@ PolylinePipeline.generateRhumbArc = function (options) {
   //>>includeEnd('debug');
 
   const length = positions.length;
-  const ellipsoid = defaultValue(options.ellipsoid, Ellipsoid.WGS84);
+  const ellipsoid = defaultValue(options.ellipsoid, Ellipsoid.default);
   let height = defaultValue(options.height, 0);
   const hasHeightArray = Array.isArray(height);
 
@@ -524,7 +524,7 @@ PolylinePipeline.generateRhumbArc = function (options) {
  * @param {Cartesian3[]} options.positions The array of type {Cartesian3} representing positions.
  * @param {number|number[]} [options.height=0.0] A number or array of numbers representing the heights of each position.
  * @param {number} [options.granularity = CesiumMath.RADIANS_PER_DEGREE] The distance, in radians, between each latitude and longitude. Determines the number of positions in the buffer.
- * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid on which the positions lie.
+ * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.default] The ellipsoid on which the positions lie.
  * @returns {Cartesian3[]} A new array of cartesian3 positions that have been subdivided and raised to the surface of the ellipsoid.
  *
  * @example
@@ -554,7 +554,7 @@ PolylinePipeline.generateCartesianArc = function (options) {
  * @param {Cartesian3[]} options.positions The array of type {Cartesian3} representing positions.
  * @param {number|number[]} [options.height=0.0] A number or array of numbers representing the heights of each position.
  * @param {number} [options.granularity = CesiumMath.RADIANS_PER_DEGREE] The distance, in radians, between each latitude and longitude. Determines the number of positions in the buffer.
- * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid on which the positions lie.
+ * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.default] The ellipsoid on which the positions lie.
  * @returns {Cartesian3[]} A new array of cartesian3 positions that have been subdivided and raised to the surface of the ellipsoid.
  *
  * @example

package/Source/Core/PolylineVolumeGeometry.js

@@ -178,7 +178,7 @@ function computeAttributes(
  * @param {object} options Object with the following properties:
  * @param {Cartesian3[]} options.polylinePositions An array of {@link Cartesian3} positions that define the center of the polyline volume.
  * @param {Cartesian2[]} options.shapePositions An array of {@link Cartesian2} positions that define the shape to be extruded along the polyline
- * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid to be used as a reference.
+ * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.default] The ellipsoid to be used as a reference.
  * @param {number} [options.granularity=CesiumMath.RADIANS_PER_DEGREE] The distance, in radians, between each latitude and longitude. Determines the number of positions in the buffer.
  * @param {VertexFormat} [options.vertexFormat=VertexFormat.DEFAULT] The vertex attributes to be computed.
  * @param {CornerType} [options.cornerType=CornerType.ROUNDED] Determines the style of the corners.
@@ -223,7 +223,7 @@ function PolylineVolumeGeometry(options) {
   this._positions = positions;
   this._shape = shape;
   this._ellipsoid = Ellipsoid.clone(
-    defaultValue(options.ellipsoid, Ellipsoid.WGS84)
+    defaultValue(options.ellipsoid, Ellipsoid.default)
   );
   this._cornerType = defaultValue(options.cornerType, CornerType.ROUNDED);
   this._vertexFormat = VertexFormat.clone(

package/Source/Core/PolylineVolumeOutlineGeometry.js

@@ -83,7 +83,7 @@ function computeAttributes(positions, shape) {
  * @param {object} options Object with the following properties:
  * @param {Cartesian3[]} options.polylinePositions An array of positions that define the center of the polyline volume.
  * @param {Cartesian2[]} options.shapePositions An array of positions that define the shape to be extruded along the polyline
- * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid to be used as a reference.
+ * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.default] The ellipsoid to be used as a reference.
  * @param {number} [options.granularity=CesiumMath.RADIANS_PER_DEGREE] The distance, in radians, between each latitude and longitude. Determines the number of positions in the buffer.
  * @param {CornerType} [options.cornerType=CornerType.ROUNDED] Determines the style of the corners.
  *
@@ -124,7 +124,7 @@ function PolylineVolumeOutlineGeometry(options) {
   this._positions = positions;
   this._shape = shape;
   this._ellipsoid = Ellipsoid.clone(
-    defaultValue(options.ellipsoid, Ellipsoid.WGS84)
+    defaultValue(options.ellipsoid, Ellipsoid.default)
   );
   this._cornerType = defaultValue(options.cornerType, CornerType.ROUNDED);
   this._granularity = defaultValue(