@cesium/engine 14.0.0 → 16.0.0

package/Source/Renderer/UniformState.js

@@ -4,7 +4,6 @@ import Cartesian3 from "../Core/Cartesian3.js";
 import Cartesian4 from "../Core/Cartesian4.js";
 import Cartographic from "../Core/Cartographic.js";
 import Color from "../Core/Color.js";
-import defaultValue from "../Core/defaultValue.js";
 import defined from "../Core/defined.js";
 import Ellipsoid from "../Core/Ellipsoid.js";
 import EncodedCartesian3 from "../Core/EncodedCartesian3.js";
@@ -1173,7 +1172,7 @@ Object.defineProperties(UniformState.prototype, {
    */
   ellipsoid: {
     get: function () {
-      return defaultValue(this._ellipsoid, Ellipsoid.default);
+      return this._ellipsoid ?? Ellipsoid.default;
     },
   },
 });
@@ -1440,7 +1439,7 @@ UniformState.prototype.update = function (frameState) {
 
   setSunAndMoonDirections(this, frameState);
 
-  const light = defaultValue(frameState.light, defaultLight);
+  const light = frameState.light ?? defaultLight;
   if (light instanceof SunLight) {
     this._lightDirectionWC = Cartesian3.clone(
       this._sunDirectionWC,
@@ -1491,17 +1490,13 @@ UniformState.prototype.update = function (frameState) {
     : undefined;
   this._brdfLut = brdfLut;
 
-  this._environmentMap = defaultValue(
-    frameState.environmentMap,
-    frameState.context.defaultCubeMap,
-  );
+  this._environmentMap =
+    frameState.environmentMap ?? frameState.context.defaultCubeMap;
 
   // IE 11 doesn't optimize out uniforms that are #ifdef'd out. So undefined values for the spherical harmonic
   // coefficients cause a crash.
-  this._sphericalHarmonicCoefficients = defaultValue(
-    frameState.sphericalHarmonicCoefficients,
-    EMPTY_ARRAY,
-  );
+  this._sphericalHarmonicCoefficients =
+    frameState.sphericalHarmonicCoefficients ?? EMPTY_ARRAY;
   this._specularEnvironmentMaps = frameState.specularEnvironmentMaps;
   this._specularEnvironmentMapsMaximumLOD =
     frameState.specularEnvironmentMapsMaximumLOD;

package/Source/Renderer/VertexArray.js

@@ -1,6 +1,6 @@
 import Check from "../Core/Check.js";
 import ComponentDatatype from "../Core/ComponentDatatype.js";
-import defaultValue from "../Core/defaultValue.js";
+import Frozen from "../Core/Frozen.js";
 import defined from "../Core/defined.js";
 import destroyObject from "../Core/destroyObject.js";
 import DeveloperError from "../Core/DeveloperError.js";
@@ -88,19 +88,16 @@ function addAttribute(attributes, attribute, index, context) {
 
   // Shallow copy the attribute; we do not want to copy the vertex buffer.
   const attr = {
-    index: defaultValue(attribute.index, index),
-    enabled: defaultValue(attribute.enabled, true),
+    index: attribute.index ?? index,
+    enabled: attribute.enabled ?? true,
     vertexBuffer: attribute.vertexBuffer,
     value: hasValue ? attribute.value.slice(0) : undefined,
     componentsPerAttribute: componentsPerAttribute,
-    componentDatatype: defaultValue(
-      attribute.componentDatatype,
-      ComponentDatatype.FLOAT,
-    ),
-    normalize: defaultValue(attribute.normalize, false),
-    offsetInBytes: defaultValue(attribute.offsetInBytes, 0),
-    strideInBytes: defaultValue(attribute.strideInBytes, 0),
-    instanceDivisor: defaultValue(attribute.instanceDivisor, 0),
+    componentDatatype: attribute.componentDatatype ?? ComponentDatatype.FLOAT,
+    normalize: attribute.normalize ?? false,
+    offsetInBytes: attribute.offsetInBytes ?? 0,
+    strideInBytes: attribute.strideInBytes ?? 0,
+    instanceDivisor: attribute.instanceDivisor ?? 0,
   };
 
   if (hasVertexBuffer) {
@@ -287,7 +284,7 @@ function bind(gl, attributes, indexBuffer) {
  * @private
  */
 function VertexArray(options) {
-  options = defaultValue(options, defaultValue.EMPTY_OBJECT);
+  options = options ?? Frozen.EMPTY_OBJECT;
 
   //>>includeStart('debug', pragmas.debug);
   Check.defined("options.context", options.context);
@@ -571,25 +568,19 @@ function interleaveAttributes(attributes) {
  * @see ShaderProgram
  */
 VertexArray.fromGeometry = function (options) {
-  options = defaultValue(options, defaultValue.EMPTY_OBJECT);
+  options = options ?? Frozen.EMPTY_OBJECT;
 
   //>>includeStart('debug', pragmas.debug);
   Check.defined("options.context", options.context);
   //>>includeEnd('debug');
 
   const context = options.context;
-  const geometry = defaultValue(options.geometry, defaultValue.EMPTY_OBJECT);
+  const geometry = options.geometry ?? Frozen.EMPTY_OBJECT;
 
-  const bufferUsage = defaultValue(
-    options.bufferUsage,
-    BufferUsage.DYNAMIC_DRAW,
-  );
+  const bufferUsage = options.bufferUsage ?? BufferUsage.DYNAMIC_DRAW;
 
-  const attributeLocations = defaultValue(
-    options.attributeLocations,
-    defaultValue.EMPTY_OBJECT,
-  );
-  const interleave = defaultValue(options.interleave, false);
+  const attributeLocations = options.attributeLocations ?? Frozen.EMPTY_OBJECT;
+  const interleave = options.interleave ?? false;
   const createdVAAttributes = options.vertexArrayAttributes;
 
   let name;

package/Source/Renderer/VertexArrayFacade.js

@@ -1,6 +1,5 @@
 import Check from "../Core/Check.js";
 import ComponentDatatype from "../Core/ComponentDatatype.js";
-import defaultValue from "../Core/defaultValue.js";
 import defined from "../Core/defined.js";
 import destroyObject from "../Core/destroyObject.js";
 import DeveloperError from "../Core/DeveloperError.js";
@@ -21,7 +20,7 @@ function VertexArrayFacade(context, attributes, sizeInVertices, instanced) {
   //>>includeEnd('debug');
 
   const attrs = VertexArrayFacade._verifyAttributes(attributes);
-  sizeInVertices = defaultValue(sizeInVertices, 0);
+  sizeInVertices = sizeInVertices ?? 0;
   const precreatedAttributes = [];
   const attributesByUsage = {};
   let attributesForUsage;
@@ -86,7 +85,7 @@ function VertexArrayFacade(context, attributes, sizeInVertices, instanced) {
   }
 
   this._size = 0;
-  this._instanced = defaultValue(instanced, false);
+  this._instanced = instanced ?? false;
 
   this._precreated = precreatedAttributes;
   this._context = context;
@@ -103,18 +102,15 @@ VertexArrayFacade._verifyAttributes = function (attributes) {
     const attribute = attributes[i];
 
     const attr = {
-      index: defaultValue(attribute.index, i),
-      enabled: defaultValue(attribute.enabled, true),
+      index: attribute.index ?? i,
+      enabled: attribute.enabled ?? true,
       componentsPerAttribute: attribute.componentsPerAttribute,
-      componentDatatype: defaultValue(
-        attribute.componentDatatype,
-        ComponentDatatype.FLOAT,
-      ),
-      normalize: defaultValue(attribute.normalize, false),
+      componentDatatype: attribute.componentDatatype ?? ComponentDatatype.FLOAT,
+      normalize: attribute.normalize ?? false,
 
       // There will be either a vertexBuffer or an [optional] usage.
       vertexBuffer: attribute.vertexBuffer,
-      usage: defaultValue(attribute.usage, BufferUsage.STATIC_DRAW),
+      usage: attribute.usage ?? BufferUsage.STATIC_DRAW,
     };
     attrs.push(attr);
 

package/Source/Scene/Appearance.js

@@ -1,6 +1,6 @@
 import clone from "../Core/clone.js";
 import combine from "../Core/combine.js";
-import defaultValue from "../Core/defaultValue.js";
+import Frozen from "../Core/Frozen.js";
 import defined from "../Core/defined.js";
 import BlendingState from "./BlendingState.js";
 import CullFace from "./CullFace.js";
@@ -31,7 +31,7 @@ import CullFace from "./CullFace.js";
  * @demo {@link https://sandcastle.cesium.com/index.html?src=Geometry%20and%20Appearances.html|Geometry and Appearances Demo}
  */
 function Appearance(options) {
-  options = defaultValue(options, defaultValue.EMPTY_OBJECT);
+  options = options ?? Frozen.EMPTY_OBJECT;
 
   /**
    * The material used to determine the fragment color.  Unlike other {@link Appearance}
@@ -50,12 +50,12 @@ function Appearance(options) {
    *
    * @default true
    */
-  this.translucent = defaultValue(options.translucent, true);
+  this.translucent = options.translucent ?? true;
 
   this._vertexShaderSource = options.vertexShaderSource;
   this._fragmentShaderSource = options.fragmentShaderSource;
   this._renderState = options.renderState;
-  this._closed = defaultValue(options.closed, false);
+  this._closed = options.closed ?? false;
 }
 
 Object.defineProperties(Appearance.prototype, {

package/Source/Scene/ArcGisMapServerImageryProvider.js

@@ -3,7 +3,7 @@ import Cartesian3 from "../Core/Cartesian3.js";
 import Cartographic from "../Core/Cartographic.js";
 import Check from "../Core/Check.js";
 import Credit from "../Core/Credit.js";
-import defaultValue from "../Core/defaultValue.js";
+import Frozen from "../Core/Frozen.js";
 import defined from "../Core/defined.js";
 import Event from "../Core/Event.js";
 import GeographicProjection from "../Core/GeographicProjection.js";
@@ -70,14 +70,13 @@ import DeveloperError from "../Core/DeveloperError.js";
  * @param {ArcGisMapServerImageryProvider.ConstructorOptions} options An object describing initialization options
  */
 function ImageryProviderBuilder(options) {
-  this.useTiles = defaultValue(options.usePreCachedTilesIfAvailable, true);
+  this.useTiles = options.usePreCachedTilesIfAvailable ?? true;
 
   const ellipsoid = options.ellipsoid;
-  this.tilingScheme = defaultValue(
-    options.tilingScheme,
-    new GeographicTilingScheme({ ellipsoid: ellipsoid }),
-  );
-  this.rectangle = defaultValue(options.rectangle, this.tilingScheme.rectangle);
+  this.tilingScheme =
+    options.tilingScheme ??
+    new GeographicTilingScheme({ ellipsoid: ellipsoid });
+  this.rectangle = options.rectangle ?? this.tilingScheme.rectangle;
   this.ellipsoid = ellipsoid;
 
   let credit = options.credit;
@@ -88,8 +87,8 @@ function ImageryProviderBuilder(options) {
   this.tileCredits = undefined;
   this.tileDiscardPolicy = options.tileDiscardPolicy;
 
-  this.tileWidth = defaultValue(options.tileWidth, 256);
-  this.tileHeight = defaultValue(options.tileHeight, 256);
+  this.tileWidth = options.tileWidth ?? 256;
+  this.tileHeight = options.tileHeight ?? 256;
   this.maximumLevel = options.maximumLevel;
 }
 
@@ -300,7 +299,7 @@ async function requestMetadata(resource, imageryProviderBuilder) {
 
  */
 function ArcGisMapServerImageryProvider(options) {
-  options = defaultValue(options, defaultValue.EMPTY_OBJECT);
+  options = options ?? Frozen.EMPTY_OBJECT;
 
   this._defaultAlpha = undefined;
   this._defaultNightAlpha = undefined;
@@ -314,18 +313,14 @@ function ArcGisMapServerImageryProvider(options) {
   this._defaultMagnificationFilter = undefined;
 
   this._tileDiscardPolicy = options.tileDiscardPolicy;
-  this._tileWidth = defaultValue(options.tileWidth, 256);
-  this._tileHeight = defaultValue(options.tileHeight, 256);
+  this._tileWidth = options.tileWidth ?? 256;
+  this._tileHeight = options.tileHeight ?? 256;
   this._maximumLevel = options.maximumLevel;
-  this._tilingScheme = defaultValue(
-    options.tilingScheme,
-    new GeographicTilingScheme({ ellipsoid: options.ellipsoid }),
-  );
-  this._useTiles = defaultValue(options.usePreCachedTilesIfAvailable, true);
-  this._rectangle = defaultValue(
-    options.rectangle,
-    this._tilingScheme.rectangle,
-  );
+  this._tilingScheme =
+    options.tilingScheme ??
+    new GeographicTilingScheme({ ellipsoid: options.ellipsoid });
+  this._useTiles = options.usePreCachedTilesIfAvailable ?? true;
+  this._rectangle = options.rectangle ?? this._tilingScheme.rectangle;
   this._layers = options.layers;
   this._credit = options.credit;
   this._tileCredits = undefined;
@@ -343,7 +338,7 @@ function ArcGisMapServerImageryProvider(options) {
    * @type {boolean}
    * @default true
    */
-  this.enablePickFeatures = defaultValue(options.enablePickFeatures, true);
+  this.enablePickFeatures = options.enablePickFeatures ?? true;
 
   this._errorEvent = new Event();
 }
@@ -383,17 +378,14 @@ ArcGisMapServerImageryProvider.fromBasemapType = async function (
   Check.defined("style", style);
   //>>includeEnd('debug');
 
-  options = defaultValue(options, defaultValue.EMPTY_OBJECT);
+  options = options ?? Frozen.EMPTY_OBJECT;
   let accessToken;
   let server;
   let warningCredit;
   switch (style) {
     case ArcGisBaseMapType.SATELLITE:
       {
-        accessToken = defaultValue(
-          options.token,
-          ArcGisMapService.defaultAccessToken,
-        );
+        accessToken = options.token ?? ArcGisMapService.defaultAccessToken;
         server = Resource.createIfNeeded(
           ArcGisMapService.defaultWorldImageryServer,
         );
@@ -407,10 +399,7 @@ ArcGisMapServerImageryProvider.fromBasemapType = async function (
       break;
     case ArcGisBaseMapType.OCEANS:
       {
-        accessToken = defaultValue(
-          options.token,
-          ArcGisMapService.defaultAccessToken,
-        );
+        accessToken = options.token ?? ArcGisMapService.defaultAccessToken;
         server = Resource.createIfNeeded(
           ArcGisMapService.defaultWorldOceanServer,
         );
@@ -424,10 +413,7 @@ ArcGisMapServerImageryProvider.fromBasemapType = async function (
       break;
     case ArcGisBaseMapType.HILLSHADE:
       {
-        accessToken = defaultValue(
-          options.token,
-          ArcGisMapService.defaultAccessToken,
-        );
+        accessToken = options.token ?? ArcGisMapService.defaultAccessToken;
         server = Resource.createIfNeeded(
           ArcGisMapService.defaultWorldHillshadeServer,
         );
@@ -712,7 +698,7 @@ ArcGisMapServerImageryProvider.fromUrl = async function (url, options) {
   Check.defined("url", url);
   //>>includeEnd('debug');
 
-  options = defaultValue(options, defaultValue.EMPTY_OBJECT);
+  options = options ?? Frozen.EMPTY_OBJECT;
 
   const resource = Resource.createIfNeeded(url);
   resource.appendForwardSlash();
@@ -726,7 +712,7 @@ ArcGisMapServerImageryProvider.fromUrl = async function (url, options) {
   const provider = new ArcGisMapServerImageryProvider(options);
   provider._resource = resource;
   const imageryProviderBuilder = new ImageryProviderBuilder(options);
-  const useTiles = defaultValue(options.usePreCachedTilesIfAvailable, true);
+  const useTiles = options.usePreCachedTilesIfAvailable ?? true;
   if (useTiles) {
     await requestMetadata(resource, imageryProviderBuilder);
   }

package/Source/Scene/ArcGisMapService.js

@@ -4,7 +4,7 @@ import Resource from "../Core/Resource.js";
 
 let defaultTokenCredit;
 const defaultAccessToken =
-  "AAPTxy8BH1VEsoebNVZXo8HurEOF051kAEKlhkOhBEc9BmQqcRjhPIHVEibuj83EgmzqMYMKlkDSXfDI_aVhgS53pQJj5gRndVO3co_eEvHb0zzYJdeBjDAW2_64bW-L6Me4YVq47D8LJswKSJVELWk4g6f3TB8wprt9QrTkB6DlBRIpV-G3oRFCspR8Muj3QGzKWMs-USdfAtfId0Yum55vSTjE2ssMyIRfiNOZaCEpVcs.AT1_aIa2UGdx";
+  "AAPTxy8BH1VEsoebNVZXo8HurEOF051kAEKlhkOhBEc9BmQHrJmkly5GMmeyeds7qlqGckHbEMszNoB_aHL967jpcpMFlqzgl75smE9bSxUFgvbMH9RZ-1bNm94gP0mBkZCj49YnVLAsh3PgcdtfgQwNxkZdUV2dz75e_dsw_O0bYHnpqlqyefjc7B5QgSv6ClYuonoi55ZvXmrydipr6sBClFcIjCyO89XNoxG1N4yuLS0.AT1_EEoMffUB";
 /**
  * Default options for accessing the ArcGIS image tile service.
  *

package/Source/Scene/B3dmParser.js

@@ -1,5 +1,4 @@
 import Check from "../Core/Check.js";
-import defaultValue from "../Core/defaultValue.js";
 import deprecationWarning from "../Core/deprecationWarning.js";
 import getJsonFromTypedArray from "../Core/getJsonFromTypedArray.js";
 import RuntimeError from "../Core/RuntimeError.js";
@@ -25,7 +24,7 @@ const sizeOfUint32 = Uint32Array.BYTES_PER_ELEMENT;
  * @returns {object} Returns an object with the batch length, feature table (binary and json), batch table (binary and json) and glTF parts of the b3dm.
  */
 B3dmParser.parse = function (arrayBuffer, byteOffset) {
-  const byteStart = defaultValue(byteOffset, 0);
+  const byteStart = byteOffset ?? 0;
   //>>includeStart('debug', pragmas.debug);
   Check.defined("arrayBuffer", arrayBuffer);
   //>>includeEnd('debug');
@@ -96,7 +95,7 @@ B3dmParser.parse = function (arrayBuffer, byteOffset) {
   let featureTableJson;
   if (featureTableJsonByteLength === 0) {
     featureTableJson = {
-      BATCH_LENGTH: defaultValue(batchLength, 0),
+      BATCH_LENGTH: batchLength ?? 0,
     };
   } else {
     featureTableJson = getJsonFromTypedArray(

package/Source/Scene/BatchTableHierarchy.js

@@ -4,7 +4,6 @@ import clone from "../Core/clone.js";
 import combine from "../Core/combine.js";
 import ComponentDatatype from "../Core/ComponentDatatype.js";
 import defined from "../Core/defined.js";
-import defaultValue from "../Core/defaultValue.js";
 import DeveloperError from "../Core/DeveloperError.js";
 import getBinaryAccessor from "./getBinaryAccessor.js";
 import RuntimeError from "../Core/RuntimeError.js";
@@ -74,10 +73,8 @@ function initialize(hierarchy, hierarchyJson, binaryBody) {
   let byteLength = 0;
 
   if (defined(classIds.byteOffset)) {
-    classIds.componentType = defaultValue(
-      classIds.componentType,
-      ComponentDatatype.UNSIGNED_SHORT,
-    );
+    classIds.componentType =
+      classIds.componentType ?? ComponentDatatype.UNSIGNED_SHORT;
     classIds.type = AttributeType.SCALAR;
     binaryAccessor = getBinaryAccessor(classIds);
     classIds = binaryAccessor.createArrayBufferView(
@@ -91,10 +88,8 @@ function initialize(hierarchy, hierarchyJson, binaryBody) {
   let parentIndexes;
   if (defined(parentCounts)) {
     if (defined(parentCounts.byteOffset)) {
-      parentCounts.componentType = defaultValue(
-        parentCounts.componentType,
-        ComponentDatatype.UNSIGNED_SHORT,
-      );
+      parentCounts.componentType =
+        parentCounts.componentType ?? ComponentDatatype.UNSIGNED_SHORT;
       parentCounts.type = AttributeType.SCALAR;
       binaryAccessor = getBinaryAccessor(parentCounts);
       parentCounts = binaryAccessor.createArrayBufferView(
@@ -115,10 +110,8 @@ function initialize(hierarchy, hierarchyJson, binaryBody) {
   }
 
   if (defined(parentIds) && defined(parentIds.byteOffset)) {
-    parentIds.componentType = defaultValue(
-      parentIds.componentType,
-      ComponentDatatype.UNSIGNED_SHORT,
-    );
+    parentIds.componentType =
+      parentIds.componentType ?? ComponentDatatype.UNSIGNED_SHORT;
     parentIds.type = AttributeType.SCALAR;
     binaryAccessor = getBinaryAccessor(parentIds);
     parentIds = binaryAccessor.createArrayBufferView(