@cesium/engine 2.2.0 → 2.4.0

package/Build/Workers/package.js

@@ -1,7 +1,7 @@
 /**
  * @license
  * Cesium - https://github.com/CesiumGS/cesium
- * Version 1.104
+ * Version 1.105.1
  *
  * Copyright 2011-2022 Cesium Contributors
  *

package/Build/Workers/transferTypedArrayTest.js

@@ -1,7 +1,7 @@
 /**
  * @license
  * Cesium - https://github.com/CesiumGS/cesium
- * Version 1.104
+ * Version 1.105.1
  *
  * Copyright 2011-2022 Cesium Contributors
  *

package/Build/Workers/upsampleQuantizedTerrainMesh.js

@@ -1,4 +1,4 @@
-define(['./AttributeCompression-8a5a065e', './Transforms-9052372a', './Matrix2-1e403d0e', './Matrix3-fa806b97', './defaultValue-fe22d8c0', './TerrainEncoding-82882059', './IndexDatatype-b8f3e09d', './Check-6ede7e26', './Math-dad82b4d', './OrientedBoundingBox-96fe1752', './createTaskProcessorWorker', './ComponentDatatype-cf1fa08e', './WebGLConstants-0b1ce7ba', './combine-d9581036', './RuntimeError-ef395448', './EllipsoidTangentPlane-857186be', './AxisAlignedBoundingBox-379015ef', './IntersectionTests-b4d02d4d', './Plane-c27e1ac6'], (function (AttributeCompression, Transforms, Matrix2, Matrix3, defaultValue, TerrainEncoding, IndexDatatype, Check, Math$1, OrientedBoundingBox, createTaskProcessorWorker, ComponentDatatype, WebGLConstants, combine, RuntimeError, EllipsoidTangentPlane, AxisAlignedBoundingBox, IntersectionTests, Plane) { 'use strict';
+define(['./AttributeCompression-f9f6c717', './Transforms-e2d4a55a', './Matrix2-e1298525', './Matrix3-41c58dde', './defaultValue-fe22d8c0', './TerrainEncoding-c8e029a2', './IndexDatatype-2643aa47', './Check-6ede7e26', './Math-0a2ac845', './OrientedBoundingBox-29fb0fcd', './createTaskProcessorWorker', './ComponentDatatype-cf1fa08e', './WebGLConstants-0b1ce7ba', './combine-d9581036', './RuntimeError-ef395448', './EllipsoidTangentPlane-546c0d5e', './AxisAlignedBoundingBox-4bfd84f3', './IntersectionTests-85350792', './Plane-4c3d403b'], (function (AttributeCompression, Transforms, Matrix2, Matrix3, defaultValue, TerrainEncoding, IndexDatatype, Check, Math$1, OrientedBoundingBox, createTaskProcessorWorker, ComponentDatatype, WebGLConstants, combine, RuntimeError, EllipsoidTangentPlane, AxisAlignedBoundingBox, IntersectionTests, Plane) { 'use strict';
 
   /**
    * Contains functions for operating on 2D triangles.

package/Source/Core/BingMapsGeocoderService.js

@@ -1,4 +1,5 @@
 import Check from "./Check.js";
+import Credit from "./Credit.js";
 import defaultValue from "./defaultValue.js";
 import Rectangle from "./Rectangle.js";
 import Resource from "./Resource.js";
@@ -39,6 +40,11 @@ function BingMapsGeocoderService(options) {
     url: url,
     queryParameters: queryParameters,
   });
+
+  this._credit = new Credit(
+    `<img src="http:\/\/dev.virtualearth.net\/Branding\/logo_powered_by.png"\/>`,
+    false
+  );
 }
 
 Object.defineProperties(BingMapsGeocoderService.prototype, {
@@ -65,6 +71,18 @@ Object.defineProperties(BingMapsGeocoderService.prototype, {
       return this._key;
     },
   },
+  /**
+   * Gets the credit to display after a geocode is performed. Typically this is used to credit
+   * the geocoder service.
+   * @memberof BingMapsGeocoderService.prototype
+   * @type {Credit|undefined}
+   * @readonly
+   */
+  credit: {
+    get: function () {
+      return this._credit;
+    },
+  },
 });
 
 /**
@@ -73,7 +91,7 @@ Object.defineProperties(BingMapsGeocoderService.prototype, {
  * @param {string} query The query to be sent to the geocoder service
  * @returns {Promise<GeocoderService.Result[]>}
  */
-BingMapsGeocoderService.prototype.geocode = function (query) {
+BingMapsGeocoderService.prototype.geocode = async function (query) {
   //>>includeStart('debug', pragmas.debug);
   Check.typeOf.string("query", query);
   //>>includeEnd('debug');

package/Source/Core/CartographicGeocoderService.js

@@ -10,6 +10,21 @@ import Check from "./Check.js";
  */
 function CartographicGeocoderService() {}
 
+Object.defineProperties(CartographicGeocoderService.prototype, {
+  /**
+   * Gets the credit to display after a geocode is performed. Typically this is used to credit
+   * the geocoder service.
+   * @memberof CartographicGeocoderService.prototype
+   * @type {Credit|undefined}
+   * @readonly
+   */
+  credit: {
+    get: function () {
+      return undefined;
+    },
+  },
+});
+
 /**
  * @function
  *

package/Source/Core/Credit.js

@@ -17,7 +17,7 @@ const creditToId = {};
  * @exception {DeveloperError} html is required.
  *
  * @example
- * //Create a credit with a tooltip, image and link
+ * // 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>');
  */
 function Credit(html, showOnScreen) {

package/Source/Core/FrustumGeometry.js

@@ -327,8 +327,9 @@ FrustumGeometry._computeNearFarPlanes = function (
       );
 
       if (!defined(inverseViewProjection)) {
-        if (defined(frustum._offCenterFrustum)) {
-          frustum = frustum._offCenterFrustum;
+        const offCenterFrustum = frustum.offCenterFrustum;
+        if (defined(offCenterFrustum)) {
+          frustum = offCenterFrustum;
         }
 
         const near = frustumSplits[i];

package/Source/Core/GeocoderService.js

@@ -1,9 +1,12 @@
+import Credit from "./Credit.js";
+import defined from "./defined.js";
 import DeveloperError from "./DeveloperError.js";
 
 /**
  * @typedef {object} GeocoderService.Result
  * @property {string} displayName The display name for a location
  * @property {Rectangle|Cartesian3} destination The bounding box for a location
+ * @property {object[]} [attributions]
  */
 
 /**
@@ -16,7 +19,35 @@ import DeveloperError from "./DeveloperError.js";
  * @see PeliasGeocoderService
  * @see OpenCageGeocoderService
  */
-function GeocoderService() {}
+function GeocoderService() {
+  DeveloperError.throwInstantiationError();
+}
+
+Object.defineProperties(GeocoderService.prototype, {
+  /**
+   * Gets the credit to display after a geocode is performed. Typically this is used to credit
+   * the geocoder service.
+   * @memberof GeocoderService.prototype
+   * @type {Credit|undefined}
+   * @readonly
+   */
+  credit: {
+    get: DeveloperError.throwInstantiationError,
+  },
+});
+
+/**
+ * Parses credits from the geocoder result attributions, if present.
+ * @param {GeocoderService.Result} geocoderResult The geocoder result
+ * @returns {Credit[]|undefined} A list of credits if present in the result, otherwise undefined
+ */
+GeocoderService.getCreditsFromResult = function (geocoderResult) {
+  if (defined(geocoderResult.attributions)) {
+    return geocoderResult.attributions.map(Credit.getIonCredit);
+  }
+
+  return undefined;
+};
 
 /**
  * @function

package/Source/Core/GoogleMaps.js

@@ -0,0 +1,56 @@
+import Credit from "./Credit.js";
+import defined from "./defined.js";
+import Resource from "./Resource.js";
+
+let defaultKeyCredit;
+const defaultKey = "AIzaSyBESBYnp1EcqtlAcjMTJ65GjUsJtaCWVXA";
+
+/**
+ * Default settings for accessing the Google Maps API.
+ * <br/>
+ * An API key is only required if you are using any Google Maps APIs, such as {@link createGooglePhotorealistic3DTileset}.
+ * A default key is provided for evaluation purposes only.
+ * Follow instructions for managing API keys for the Google Maps Platform at {@link https://developers.google.com/maps/documentation/embed/get-api-key}
+ *
+ * @see createGooglePhotorealistic3DTileset
+ * @see https://developers.google.com/maps/documentation/embed/get-api-key
+ *
+ * @namespace GoogleMaps
+ */
+const GoogleMaps = {};
+
+/**
+ * Gets or sets the default Google Maps API key.
+ *
+ * @type {string}
+ */
+GoogleMaps.defaultApiKey = defaultKey;
+
+/**
+ * Gets or sets the default Google Map Tiles API endpoint.
+ *
+ * @type {string|Resource}
+ * @default https://tile.googleapis.com/v1/
+ */
+GoogleMaps.mapTilesApiEndpoint = new Resource({
+  url: "https://tile.googleapis.com/v1/",
+});
+
+GoogleMaps.getDefaultApiKeyCredit = function (providedKey) {
+  if (providedKey !== defaultKey) {
+    return undefined;
+  }
+
+  if (!defined(defaultKeyCredit)) {
+    const defaultKeyMessage =
+      '<b> \
+            This application is using CesiumJS\'s default Google Maps API key. Please assign <i>Cesium.GoogleMaps.defaultApiKey</i> \
+            with <a href="https://developers.google.com/maps/documentation/embed/get-api-key">your API key for the Google Maps Platform</a>.</b>';
+
+    defaultKeyCredit = new Credit(defaultKeyMessage, true);
+    defaultKeyCredit._isDefaultToken = true;
+  }
+
+  return defaultKeyCredit;
+};
+export default GoogleMaps;

package/Source/Core/Ion.js

@@ -4,7 +4,7 @@ import Resource from "./Resource.js";
 
 let defaultTokenCredit;
 const defaultAccessToken =
-  "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJkYjk1OWEzOS0wM2UzLTQ1MmItYjVhNi0xOGE2NDAyNDc4ZjYiLCJpZCI6MjU5LCJpYXQiOjE2ODA1MzgxNTl9.ANfifMhFxb5agKqgDghPl1R__jvaz6dcEbkoNFM-txE";
+  "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIwZWQ3OWFlZC1kOTg3LTRlZjctYTAyYy0xNjFmODE1MWE2NGUiLCJpZCI6MjU5LCJpYXQiOjE2ODI5NDYzODh9.DEH4GpqliH-xsDE7h-ZCICtHgnGu32wdSjt4hFqw7lU";
 /**
  * Default settings for accessing the Cesium ion API.
  *
@@ -49,6 +49,7 @@ Ion.getDefaultTokenCredit = function (providedKey) {
             You can sign up for a free ion account at <a href="https://cesium.com">https://cesium.com</a>.</b>';
 
     defaultTokenCredit = new Credit(defaultTokenMessage, true);
+    defaultTokenCredit._isDefaultToken = true;
   }
 
   return defaultTokenCredit;

package/Source/Core/IonGeocoderService.js

@@ -33,7 +33,7 @@ function IonGeocoderService(options) {
 
   const defaultTokenCredit = Ion.getDefaultTokenCredit(accessToken);
   if (defined(defaultTokenCredit)) {
-    options.scene.frameState.creditDisplay.addDefaultCredit(
+    options.scene.frameState.creditDisplay.addStaticCredit(
       Credit.clone(defaultTokenCredit)
     );
   }
@@ -51,6 +51,21 @@ function IonGeocoderService(options) {
   this._pelias = new PeliasGeocoderService(searchEndpoint);
 }
 
+Object.defineProperties(IonGeocoderService.prototype, {
+  /**
+   * Gets the credit to display after a geocode is performed. Typically this is used to credit
+   * the geocoder service.
+   * @memberof IonGeocoderService.prototype
+   * @type {Credit|undefined}
+   * @readonly
+   */
+  credit: {
+    get: function () {
+      return undefined;
+    },
+  },
+});
+
 /**
  * @function
  *
@@ -58,7 +73,7 @@ function IonGeocoderService(options) {
  * @param {GeocodeType} [type=GeocodeType.SEARCH] The type of geocode to perform.
  * @returns {Promise<GeocoderService.Result[]>}
  */
-IonGeocoderService.prototype.geocode = function (query, geocodeType) {
+IonGeocoderService.prototype.geocode = async function (query, geocodeType) {
   return this._pelias.geocode(query, geocodeType);
 };
 export default IonGeocoderService;

package/Source/Core/OpenCageGeocoderService.js

@@ -1,6 +1,7 @@
 import Cartesian3 from "./Cartesian3.js";
 import Check from "./Check.js";
 import combine from "./combine.js";
+import Credit from "./Credit.js";
 import defaultValue from "./defaultValue.js";
 import defined from "./defined.js";
 import Rectangle from "./Rectangle.js";
@@ -48,6 +49,10 @@ function OpenCageGeocoderService(url, apiKey, params) {
   url.setQueryParameters({ key: apiKey });
   this._url = url;
   this._params = defaultValue(params, {});
+  this._credit = new Credit(
+    `Geodata copyright <a href="https://www.openstreetmap.org/">OpenStreetMap</a> contributors`,
+    false
+  );
 }
 
 Object.defineProperties(OpenCageGeocoderService.prototype, {
@@ -73,6 +78,18 @@ Object.defineProperties(OpenCageGeocoderService.prototype, {
       return this._params;
     },
   },
+  /**
+   * Gets the credit to display after a geocode is performed. Typically this is used to credit
+   * the geocoder service.
+   * @memberof OpenCageGeocoderService.prototype
+   * @type {Credit|undefined}
+   * @readonly
+   */
+  credit: {
+    get: function () {
+      return this._credit;
+    },
+  },
 });
 
 /**
@@ -81,7 +98,7 @@ Object.defineProperties(OpenCageGeocoderService.prototype, {
  * @param {string} query The query to be sent to the geocoder service
  * @returns {Promise<GeocoderService.Result[]>}
  */
-OpenCageGeocoderService.prototype.geocode = function (query) {
+OpenCageGeocoderService.prototype.geocode = async function (query) {
   //>>includeStart('debug', pragmas.debug);
   Check.typeOf.string("query", query);
   //>>includeEnd('debug');

package/Source/Core/OrthographicFrustum.js

@@ -184,6 +184,19 @@ Object.defineProperties(OrthographicFrustum.prototype, {
       return this._offCenterFrustum.projectionMatrix;
     },
   },
+  /**
+   * Gets the orthographic projection matrix computed from the view frustum.
+   * @memberof OrthographicFrustum.prototype
+   * @type {OrthographicOffCenterFrustum}
+   * @readonly
+   * @private
+   */
+  offCenterFrustum: {
+    get: function () {
+      update(this);
+      return this._offCenterFrustum;
+    },
+  },
 });
 
 /**

package/Source/Core/PeliasGeocoderService.js

@@ -44,6 +44,18 @@ Object.defineProperties(PeliasGeocoderService.prototype, {
       return this._url;
     },
   },
+  /**
+   * Gets the credit to display after a geocode is performed. Typically this is used to credit
+   * the geocoder service.
+   * @memberof PeliasGeocoderService.prototype
+   * @type {Credit|undefined}
+   * @readonly
+   */
+  credit: {
+    get: function () {
+      return undefined;
+    },
+  },
 });
 
 /**
@@ -53,7 +65,7 @@ Object.defineProperties(PeliasGeocoderService.prototype, {
  * @param {GeocodeType} [type=GeocodeType.SEARCH] The type of geocode to perform.
  * @returns {Promise<GeocoderService.Result[]>}
  */
-PeliasGeocoderService.prototype.geocode = function (query, type) {
+PeliasGeocoderService.prototype.geocode = async function (query, type) {
   //>>includeStart('debug', pragmas.debug);
   Check.typeOf.string("query", query);
   //>>includeEnd('debug');
@@ -86,6 +98,7 @@ PeliasGeocoderService.prototype.geocode = function (query, type) {
       return {
         displayName: resultObject.properties.label,
         destination: destination,
+        attributions: results.attributions,
       };
     });
   });

package/Source/Core/PerspectiveFrustum.js

@@ -274,6 +274,20 @@ Object.defineProperties(PerspectiveFrustum.prototype, {
       return this._sseDenominator;
     },
   },
+
+  /**
+   * Gets the orthographic projection matrix computed from the view frustum.
+   * @memberof PerspectiveFrustum.prototype
+   * @type {PerspectiveOffCenterFrustum}
+   * @readonly
+   * @private
+   */
+  offCenterFrustum: {
+    get: function () {
+      update(this);
+      return this._offCenterFrustum;
+    },
+  },
 });
 
 /**

package/Source/Core/Request.js

@@ -18,6 +18,7 @@ import RequestType from "./RequestType.js";
  * @param {boolean} [options.throttle=false] Whether to throttle and prioritize the request. If false, the request will be sent immediately. If true, the request will be throttled and sent based on priority.
  * @param {boolean} [options.throttleByServer=false] Whether to throttle the request by server.
  * @param {RequestType} [options.type=RequestType.OTHER] The type of request.
+ * @param {string} [options.serverKey] A key used to identify the server that a request is going to.
  */
 function Request(options) {
   options = defaultValue(options, defaultValue.EMPTY_OBJECT);
@@ -105,7 +106,7 @@ function Request(options) {
    *
    * @private
    */
-  this.serverKey = undefined;
+  this.serverKey = options.serverKey;
 
   /**
    * The current state of the request.
@@ -166,7 +167,7 @@ Request.prototype.clone = function (result) {
   result.serverKey = this.serverKey;
 
   // These get defaulted because the cloned request hasn't been issued
-  result.state = this.RequestState.UNISSUED;
+  result.state = RequestState.UNISSUED;
   result.deferred = undefined;
   result.cancelled = false;
 

package/Source/Core/RequestScheduler.js

@@ -65,18 +65,24 @@ RequestScheduler.maximumRequests = 50;
 RequestScheduler.maximumRequestsPerServer = 6;
 
 /**
- * A per server key list of overrides to use for throttling instead of <code>maximumRequestsPerServer</code>
+ * A per server key list of overrides to use for throttling instead of <code>maximumRequestsPerServer</code>.
+ * Useful when streaming data from a known HTTP/2 or HTTP/3 server.
  * @type {object}
  *
  * @example
+ * RequestScheduler.requestsByServer["myserver.com:443"] = 18;
+ *
+ * @example
  * RequestScheduler.requestsByServer = {
- *   'api.cesium.com:443': 18,
- *   'assets.cesium.com:443': 18
+ *   "api.cesium.com:443": 18,
+ *   "assets.cesium.com:443": 18,
  * };
  */
 RequestScheduler.requestsByServer = {
   "api.cesium.com:443": 18,
   "assets.ion.cesium.com:443": 18,
+  "ibasemaps-api.arcgis.com:443": 18,
+  "tile.googleapis.com:443": 18,
 };
 
 /**
@@ -352,7 +358,7 @@ RequestScheduler.getServerKey = function (url) {
 
   let uri = new Uri(url);
   if (uri.scheme() === "") {
-    uri = new Uri(url).absoluteTo(pageUri);
+    uri = uri.absoluteTo(pageUri);
     uri.normalize();
   }