@cesium/engine 9.1.0 → 10.0.0

package/Source/Core/Cartographic.js

@@ -83,6 +83,7 @@ Cartographic.fromDegrees = function (longitude, latitude, height, result) {
   Check.typeOf.number("longitude", longitude);
   Check.typeOf.number("latitude", latitude);
   //>>includeEnd('debug');
+
   longitude = CesiumMath.toRadians(longitude);
   latitude = CesiumMath.toRadians(latitude);
 
@@ -92,37 +93,39 @@ Cartographic.fromDegrees = function (longitude, latitude, height, result) {
 const cartesianToCartographicN = new Cartesian3();
 const cartesianToCartographicP = new Cartesian3();
 const cartesianToCartographicH = new Cartesian3();
-const wgs84OneOverRadii = new Cartesian3(
+
+// To avoid circular dependencies, these are set by Ellipsoid when Ellipsoid.default is set.
+Cartographic._ellipsoidOneOverRadii = new Cartesian3(
   1.0 / 6378137.0,
   1.0 / 6378137.0,
   1.0 / 6356752.3142451793
 );
-const wgs84OneOverRadiiSquared = new Cartesian3(
+Cartographic._ellipsoidOneOverRadiiSquared = new Cartesian3(
   1.0 / (6378137.0 * 6378137.0),
   1.0 / (6378137.0 * 6378137.0),
   1.0 / (6356752.3142451793 * 6356752.3142451793)
 );
-const wgs84CenterToleranceSquared = CesiumMath.EPSILON1;
+Cartographic._ellipsoidCenterToleranceSquared = CesiumMath.EPSILON1;
 
 /**
  * Creates a new Cartographic instance from a Cartesian position. The values in the
  * resulting object will be in radians.
  *
  * @param {Cartesian3} cartesian The Cartesian position to convert to cartographic representation.
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid on which the position lies.
+ * @param {Ellipsoid} [ellipsoid=Ellipsoid.default] The ellipsoid on which the position lies.
  * @param {Cartographic} [result] The object onto which to store the result.
  * @returns {Cartographic} The modified result parameter, new Cartographic instance if none was provided, or undefined if the cartesian is at the center of the ellipsoid.
  */
 Cartographic.fromCartesian = function (cartesian, ellipsoid, result) {
   const oneOverRadii = defined(ellipsoid)
     ? ellipsoid.oneOverRadii
-    : wgs84OneOverRadii;
+    : Cartographic._ellipsoidOneOverRadii;
   const oneOverRadiiSquared = defined(ellipsoid)
     ? ellipsoid.oneOverRadiiSquared
-    : wgs84OneOverRadiiSquared;
+    : Cartographic._ellipsoidOneOverRadiiSquared;
   const centerToleranceSquared = defined(ellipsoid)
     ? ellipsoid._centerToleranceSquared
-    : wgs84CenterToleranceSquared;
+    : Cartographic._ellipsoidCenterToleranceSquared;
 
   //`cartesian is required.` is thrown from scaleToGeodeticSurface
   const p = scaleToGeodeticSurface(
@@ -165,7 +168,7 @@ Cartographic.fromCartesian = function (cartesian, ellipsoid, result) {
  * object should be in radians.
  *
  * @param {Cartographic} cartographic Input to be converted into a Cartesian3 output.
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid on which the position lies.
+ * @param {Ellipsoid} [ellipsoid=Ellipsoid.default] The ellipsoid on which the position lies.
  * @param {Cartesian3} [result] The object onto which to store the result.
  * @returns {Cartesian3} The position
  */

package/Source/Core/CesiumTerrainProvider.js

@@ -5,6 +5,7 @@ import Check from "./Check.js";
 import Credit from "./Credit.js";
 import defaultValue from "./defaultValue.js";
 import defined from "./defined.js";
+import Ellipsoid from "./Ellipsoid.js";
 import Event from "./Event.js";
 import GeographicTilingScheme from "./GeographicTilingScheme.js";
 import WebMercatorTilingScheme from "./WebMercatorTilingScheme.js";
@@ -45,7 +46,7 @@ function LayerInformation(layer) {
  * @property {boolean} [requestVertexNormals=false] Flag that indicates if the client should request additional lighting information from the server, in the form of per vertex normals if available.
  * @property {boolean} [requestWaterMask=false] Flag that indicates if the client should request per tile water masks from the server, if available.
  * @property {boolean} [requestMetadata=true] Flag that indicates if the client should request per tile metadata from the server, if available.
- * @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.
  */
 
@@ -61,7 +62,7 @@ function TerrainProviderBuilder(options) {
   this.requestVertexNormals = defaultValue(options.requestVertexNormals, false);
   this.requestWaterMask = defaultValue(options.requestWaterMask, false);
   this.requestMetadata = defaultValue(options.requestMetadata, true);
-  this.ellipsoid = options.ellipsoid;
+  this.ellipsoid = defaultValue(options.ellipsoid, Ellipsoid.default);
 
   this.heightmapWidth = 65;
   this.heightmapStructure = undefined;

package/Source/Core/CircleGeometry.js

@@ -15,7 +15,7 @@ import VertexFormat from "./VertexFormat.js";
  * @param {object} options Object with the following properties:
  * @param {Cartesian3} options.center The circle's center point in the fixed frame.
  * @param {number} options.radius The radius in meters.
- * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid the circle will be on.
+ * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.default] The ellipsoid the circle will be on.
  * @param {number} [options.height=0.0] The distance in meters between the circle and the ellipsoid surface.
  * @param {number} [options.granularity=0.02] The angular distance between points on the circle in radians.
  * @param {VertexFormat} [options.vertexFormat=VertexFormat.DEFAULT] The vertex attributes to be computed.
@@ -90,7 +90,7 @@ const scratchEllipseGeometry = new EllipseGeometry({
 const scratchOptions = {
   center: new Cartesian3(),
   radius: undefined,
-  ellipsoid: Ellipsoid.clone(Ellipsoid.UNIT_SPHERE),
+  ellipsoid: Ellipsoid.clone(Ellipsoid.default),
   height: undefined,
   extrudedHeight: undefined,
   granularity: undefined,
@@ -123,6 +123,10 @@ CircleGeometry.unpack = function (array, startingIndex, result) {
     ellipseGeometry._ellipsoid,
     scratchOptions.ellipsoid
   );
+  scratchOptions.ellipsoid = Ellipsoid.clone(
+    ellipseGeometry._ellipsoid,
+    scratchEllipseGeometry._ellipsoid
+  );
   scratchOptions.height = ellipseGeometry._height;
   scratchOptions.extrudedHeight = ellipseGeometry._extrudedHeight;
   scratchOptions.granularity = ellipseGeometry._granularity;

package/Source/Core/CircleOutlineGeometry.js

@@ -14,7 +14,7 @@ import Ellipsoid from "./Ellipsoid.js";
  * @param {object} options Object with the following properties:
  * @param {Cartesian3} options.center The circle's center point in the fixed frame.
  * @param {number} options.radius The radius in meters.
- * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid the circle will be on.
+ * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.default] The ellipsoid the circle will be on.
  * @param {number} [options.height=0.0] The distance in meters between the circle and the ellipsoid surface.
  * @param {number} [options.granularity=0.02] The angular distance between points on the circle in radians.
  * @param {number} [options.extrudedHeight=0.0] The distance in meters between the circle's extruded face and the ellipsoid surface.

package/Source/Core/CoplanarPolygonGeometry.js

@@ -231,7 +231,7 @@ function createGeometryFromPolygon(
  * @param {PolygonHierarchy} options.polygonHierarchy A polygon hierarchy that can include holes.
  * @param {number} [options.stRotation=0.0] The rotation of the texture coordinates, in radians. A positive rotation is counter-clockwise.
  * @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 {PolygonHierarchy} [options.textureCoordinates] Texture coordinates as a {@link PolygonHierarchy} of {@link Cartesian2} points.
  *
  * @example
@@ -259,7 +259,7 @@ function CoplanarPolygonGeometry(options) {
   this._polygonHierarchy = polygonHierarchy;
   this._stRotation = defaultValue(options.stRotation, 0.0);
   this._ellipsoid = Ellipsoid.clone(
-    defaultValue(options.ellipsoid, Ellipsoid.WGS84)
+    defaultValue(options.ellipsoid, Ellipsoid.default)
   );
   this._workerName = "createCoplanarPolygonGeometry";
   this._textureCoordinates = textureCoordinates;
@@ -291,7 +291,7 @@ function CoplanarPolygonGeometry(options) {
  * @param {Cartesian3[]} options.positions An array of positions that defined the corner points of the polygon.
  * @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 {PolygonHierarchy} [options.textureCoordinates] Texture coordinates as a {@link PolygonHierarchy} of {@link Cartesian2} points.
  * @returns {CoplanarPolygonGeometry}
  *

package/Source/Core/CorridorGeometry.js

@@ -1050,7 +1050,7 @@ function computeRectangle(positions, ellipsoid, width, cornerType, result) {
  * @param {object} options Object with the following properties:
  * @param {Cartesian3[]} options.positions An array of positions that define the center of the corridor.
  * @param {number} options.width The distance between the edges of the corridor in meters.
- * @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 {number} [options.height=0] The distance in meters between the ellipsoid surface and the positions.
  * @param {number} [options.extrudedHeight] The distance in meters between the ellipsoid surface and the extruded face.
@@ -1084,7 +1084,7 @@ function CorridorGeometry(options) {
 
   this._positions = positions;
   this._ellipsoid = Ellipsoid.clone(
-    defaultValue(options.ellipsoid, Ellipsoid.WGS84)
+    defaultValue(options.ellipsoid, Ellipsoid.default)
   );
   this._vertexFormat = VertexFormat.clone(
     defaultValue(options.vertexFormat, VertexFormat.DEFAULT)
@@ -1246,7 +1246,7 @@ CorridorGeometry.unpack = function (array, startingIndex, result) {
  * @param {object} options Object with the following properties:
  * @param {Cartesian3[]} options.positions An array of positions that define the center of the corridor.
  * @param {number} options.width The distance between the edges of the corridor in meters.
- * @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 {CornerType} [options.cornerType=CornerType.ROUNDED] Determines the style of the corners.
  * @param {Rectangle} [result] An object in which to store the result.
  *
@@ -1262,7 +1262,7 @@ CorridorGeometry.computeRectangle = function (options, result) {
   Check.defined("options.width", width);
   //>>includeEnd('debug');
 
-  const ellipsoid = defaultValue(options.ellipsoid, Ellipsoid.WGS84);
+  const ellipsoid = defaultValue(options.ellipsoid, Ellipsoid.default);
   const cornerType = defaultValue(options.cornerType, CornerType.ROUNDED);
 
   return computeRectangle(positions, ellipsoid, width, cornerType, result);

package/Source/Core/CorridorOutlineGeometry.js

@@ -361,7 +361,7 @@ function computePositionsExtruded(params) {
  * @param {object} options Object with the following properties:
  * @param {Cartesian3[]} options.positions An array of positions that define the center of the corridor outline.
  * @param {number} options.width The distance between the edges of the corridor outline.
- * @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 {number} [options.height=0] The distance in meters between the positions and the ellipsoid surface.
  * @param {number} [options.extrudedHeight] The distance in meters between the extruded face and the ellipsoid surface.
@@ -390,7 +390,7 @@ function CorridorOutlineGeometry(options) {
 
   this._positions = positions;
   this._ellipsoid = Ellipsoid.clone(
-    defaultValue(options.ellipsoid, Ellipsoid.WGS84)
+    defaultValue(options.ellipsoid, Ellipsoid.default)
   );
   this._width = width;
   this._height = Math.max(height, extrudedHeight);

package/Source/Core/Credit.js

@@ -9,7 +9,7 @@ const creditToId = {};
 /**
  * A credit contains data pertaining to how to display attributions/credits for certain content on the screen.
  * @param {string} html An string representing an html code snippet
- * @param {boolean} [showOnScreen=false] If true, the credit will be visible in the main credit container.  Otherwise, it will appear in a popover
+ * @param {boolean} [showOnScreen=false] If true, the credit will be visible in the main credit container.  Otherwise, it will appear in a popover. All credits are displayed `inline`, if you have an image we recommend sizing it correctly to match the text or use css to `vertical-align` it.
  *
  * @alias Credit
  * @constructor
@@ -18,7 +18,7 @@ const creditToId = {};
  *
  * @example
  * // Create a credit with a tooltip, image and link
- * const credit = new Cesium.Credit('<a href="https://cesium.com/" target="_blank"><img src="/images/cesium_logo.png" title="Cesium"/></a>');
+ * const credit = new Cesium.Credit('<a href="https://cesium.com/" target="_blank"><img src="/images/cesium_logo.png"  style="vertical-align: -7px" title="Cesium"/></a>');
  */
 function Credit(html, showOnScreen) {
   //>>includeStart('debug', pragmas.debug);
@@ -95,6 +95,7 @@ Object.defineProperties(Credit.prototype, {
         const html = DOMPurify.sanitize(this._html);
 
         const div = document.createElement("div");
+        div.className = "cesium-credit-wrapper";
         div._creditId = this._id;
         div.style.display = "inline";
         div.innerHTML = html;

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.eyJqdGkiOiJkYzAzYzE4NS0yZmJiLTQ5NzUtOWJlYS0zNjdkMzc2ODBmZDgiLCJpZCI6MjU5LCJpYXQiOjE3MTQ1NzE1MDN9.tIhlyfC7MHSWrQmoAqkvQdXMbg3igaC2HIbQp1HKCVM";
+  "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIyYTI3ZDMxOS1mODc4LTQ5NzktOGUzNy04OTA0ZGI5MmM1NGIiLCJpZCI6MjU5LCJpYXQiOjE3MTk4NDM5OTN9.FDHD-mZOIAzA9J_kzOz6AkKK2PHzl2yoMbFqbpsfH6Q";
 /**
  * Default settings for accessing the Cesium ion API.
  *

package/Source/Core/Math.js

@@ -205,7 +205,6 @@ CesiumMath.FOUR_GIGABYTES = 4 * 1024 * 1024 * 1024;
  * @param {number} value The value to return the sign of.
  * @returns {number} The sign of value.
  */
-// eslint-disable-next-line es/no-math-sign
 CesiumMath.sign = defaultValue(Math.sign, function sign(value) {
   value = +value; // coerce to number
   if (value === 0 || value !== value) {
@@ -292,7 +291,6 @@ CesiumMath.normalize = function (value, rangeMinimum, rangeMaximum) {
  * @param {number} value The number whose hyperbolic sine is to be returned.
  * @returns {number} The hyperbolic sine of <code>value</code>.
  */
-// eslint-disable-next-line es/no-math-sinh
 CesiumMath.sinh = defaultValue(Math.sinh, function sinh(value) {
   return (Math.exp(value) - Math.exp(-value)) / 2.0;
 });
@@ -317,7 +315,6 @@ CesiumMath.sinh = defaultValue(Math.sinh, function sinh(value) {
  * @param {number} value The number whose hyperbolic cosine is to be returned.
  * @returns {number} The hyperbolic cosine of <code>value</code>.
  */
-// eslint-disable-next-line es/no-math-cosh
 CesiumMath.cosh = defaultValue(Math.cosh, function cosh(value) {
   return (Math.exp(value) + Math.exp(-value)) / 2.0;
 });
@@ -1034,7 +1031,6 @@ CesiumMath.logBase = function (number, base) {
  * @param {number} [number] The number.
  * @returns {number} The result.
  */
-// eslint-disable-next-line es/no-math-cbrt
 CesiumMath.cbrt = defaultValue(Math.cbrt, function cbrt(number) {
   const result = Math.pow(Math.abs(number), 1.0 / 3.0);
   return number < 0.0 ? -result : result;
@@ -1047,7 +1043,6 @@ CesiumMath.cbrt = defaultValue(Math.cbrt, function cbrt(number) {
  * @param {number} number The number.
  * @returns {number} The result.
  */
-// eslint-disable-next-line es/no-math-log2
 CesiumMath.log2 = defaultValue(Math.log2, function log2(number) {
   return Math.log(number) * Math.LOG2E;
 });