@cesium/engine 2.4.0 → 3.0.0

package/Source/Scene/TileCoordinatesImageryProvider.js

@@ -1,7 +1,6 @@
 import Color from "../Core/Color.js";
 import defaultValue from "../Core/defaultValue.js";
 import defined from "../Core/defined.js";
-import deprecationWarning from "../Core/deprecationWarning.js";
 import Event from "../Core/Event.js";
 import GeographicTilingScheme from "../Core/GeographicTilingScheme.js";
 
@@ -39,8 +38,6 @@ function TileCoordinatesImageryProvider(options) {
   this._errorEvent = new Event();
   this._tileWidth = defaultValue(options.tileWidth, 256);
   this._tileHeight = defaultValue(options.tileHeight, 256);
-  this._ready = true;
-  this._readyPromise = Promise.resolve(true);
 
   this._defaultAlpha = undefined;
   this._defaultNightAlpha = undefined;
@@ -167,40 +164,6 @@ Object.defineProperties(TileCoordinatesImageryProvider.prototype, {
     },
   },
 
-  /**
-   * Gets a value indicating whether or not the provider is ready for use.
-   * @memberof TileCoordinatesImageryProvider.prototype
-   * @type {boolean}
-   * @readonly
-   * @deprecated
-   */
-  ready: {
-    get: function () {
-      deprecationWarning(
-        "TileCoordinatesImageryProvider.ready",
-        "TileCoordinatesImageryProvider.ready was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107."
-      );
-      return true;
-    },
-  },
-
-  /**
-   * Gets a promise that resolves to true when the provider is ready for use.
-   * @memberof TileCoordinatesImageryProvider.prototype
-   * @type {Promise<boolean>}
-   * @readonly
-   * @deprecated
-   */
-  readyPromise: {
-    get: function () {
-      deprecationWarning(
-        "TileCoordinatesImageryProvider.readyPromise",
-        "TileCoordinatesImageryProvider.readyPromise was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107."
-      );
-      return this._readyPromise;
-    },
-  },
-
   /**
    * Gets the credit to display when this imagery provider is active.  Typically this is used to credit
    * the source of the imagery.
@@ -229,242 +192,6 @@ Object.defineProperties(TileCoordinatesImageryProvider.prototype, {
       return true;
     },
   },
-
-  /**
-   * The default alpha blending value of this provider, with 0.0 representing fully transparent and
-   * 1.0 representing fully opaque.
-   * @memberof TileCoordinatesImageryProvider.prototype
-   * @type {Number|undefined}
-   * @deprecated
-   */
-  defaultAlpha: {
-    get: function () {
-      deprecationWarning(
-        "TileCoordinatesImageryProvider.defaultAlpha",
-        "TileCoordinatesImageryProvider.defaultAlpha was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use ImageryLayer.alpha instead."
-      );
-      return this._defaultAlpha;
-    },
-    set: function (value) {
-      deprecationWarning(
-        "TileCoordinatesImageryProvider.defaultAlpha",
-        "TileCoordinatesImageryProvider.defaultAlpha was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use ImageryLayer.alpha instead."
-      );
-      this._defaultAlpha = value;
-    },
-  },
-
-  /**
-   * The default alpha blending value on the night side of the globe of this provider, with 0.0 representing fully transparent and
-   * 1.0 representing fully opaque.
-   * @memberof TileCoordinatesImageryProvider.prototype
-   * @type {Number|undefined}
-   * @deprecated
-   */
-  defaultNightAlpha: {
-    get: function () {
-      deprecationWarning(
-        "TileCoordinatesImageryProvider.defaultNightAlpha",
-        "TileCoordinatesImageryProvider.defaultNightAlpha was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use ImageryLayer.nightAlpha instead."
-      );
-      return this._defaultNightAlpha;
-    },
-    set: function (value) {
-      deprecationWarning(
-        "TileCoordinatesImageryProvider.defaultNightAlpha",
-        "TileCoordinatesImageryProvider.defaultNightAlpha was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use ImageryLayer.nightAlpha instead."
-      );
-      this._defaultNightAlpha = value;
-    },
-  },
-
-  /**
-   * The default alpha blending value on the day side of the globe of this provider, with 0.0 representing fully transparent and
-   * 1.0 representing fully opaque.
-   * @memberof TileCoordinatesImageryProvider.prototype
-   * @type {Number|undefined}
-   * @deprecated
-   */
-  defaultDayAlpha: {
-    get: function () {
-      deprecationWarning(
-        "TileCoordinatesImageryProvider.defaultDayAlpha",
-        "TileCoordinatesImageryProvider.defaultDayAlpha was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use ImageryLayer.dayAlpha instead."
-      );
-      return this._defaultDayAlpha;
-    },
-    set: function (value) {
-      deprecationWarning(
-        "TileCoordinatesImageryProvider.defaultDayAlpha",
-        "TileCoordinatesImageryProvider.defaultDayAlpha was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use ImageryLayer.dayAlpha instead."
-      );
-      this._defaultDayAlpha = value;
-    },
-  },
-
-  /**
-   * The default brightness of this provider.  1.0 uses the unmodified imagery color.  Less than 1.0
-   * makes the imagery darker while greater than 1.0 makes it brighter.
-   * @memberof TileCoordinatesImageryProvider.prototype
-   * @type {Number|undefined}
-   * @deprecated
-   */
-  defaultBrightness: {
-    get: function () {
-      deprecationWarning(
-        "TileCoordinatesImageryProvider.defaultBrightness",
-        "TileCoordinatesImageryProvider.defaultBrightness was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use ImageryLayer.brightness instead."
-      );
-      return this._defaultBrightness;
-    },
-    set: function (value) {
-      deprecationWarning(
-        "TileCoordinatesImageryProvider.defaultBrightness",
-        "TileCoordinatesImageryProvider.defaultBrightness was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use ImageryLayer.brightness instead."
-      );
-      this._defaultBrightness = value;
-    },
-  },
-
-  /**
-   * The default contrast of this provider.  1.0 uses the unmodified imagery color.  Less than 1.0 reduces
-   * the contrast while greater than 1.0 increases it.
-   * @memberof TileCoordinatesImageryProvider.prototype
-   * @type {Number|undefined}
-   * @deprecated
-   */
-  defaultContrast: {
-    get: function () {
-      deprecationWarning(
-        "TileCoordinatesImageryProvider.defaultContrast",
-        "TileCoordinatesImageryProvider.defaultContrast was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use ImageryLayer.contrast instead."
-      );
-      return this._defaultContrast;
-    },
-    set: function (value) {
-      deprecationWarning(
-        "TileCoordinatesImageryProvider.defaultContrast",
-        "TileCoordinatesImageryProvider.defaultContrast was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use ImageryLayer.contrast instead."
-      );
-      this._defaultContrast = value;
-    },
-  },
-
-  /**
-   * The default hue of this provider in radians. 0.0 uses the unmodified imagery color.
-   * @memberof TileCoordinatesImageryProvider.prototype
-   * @type {Number|undefined}
-   * @deprecated
-   */
-  defaultHue: {
-    get: function () {
-      deprecationWarning(
-        "TileCoordinatesImageryProvider.defaultHue",
-        "TileCoordinatesImageryProvider.defaultHue was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use ImageryLayer.hue instead."
-      );
-      return this._defaultHue;
-    },
-    set: function (value) {
-      deprecationWarning(
-        "TileCoordinatesImageryProvider.defaultHue",
-        "TileCoordinatesImageryProvider.defaultHue was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use ImageryLayer.hue instead."
-      );
-      this._defaultHue = value;
-    },
-  },
-
-  /**
-   * The default saturation of this provider. 1.0 uses the unmodified imagery color. Less than 1.0 reduces the
-   * saturation while greater than 1.0 increases it.
-   * @memberof TileCoordinatesImageryProvider.prototype
-   * @type {Number|undefined}
-   * @deprecated
-   */
-  defaultSaturation: {
-    get: function () {
-      deprecationWarning(
-        "TileCoordinatesImageryProvider.defaultSaturation",
-        "TileCoordinatesImageryProvider.defaultSaturation was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use ImageryLayer.saturation instead."
-      );
-      return this._defaultSaturation;
-    },
-    set: function (value) {
-      deprecationWarning(
-        "TileCoordinatesImageryProvider.defaultSaturation",
-        "TileCoordinatesImageryProvider.defaultSaturation was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use ImageryLayer.saturation instead."
-      );
-      this._defaultSaturation = value;
-    },
-  },
-
-  /**
-   * The default gamma correction to apply to this provider.  1.0 uses the unmodified imagery color.
-   * @memberof TileCoordinatesImageryProvider.prototype
-   * @type {Number|undefined}
-   * @deprecated
-   */
-  defaultGamma: {
-    get: function () {
-      deprecationWarning(
-        "TileCoordinatesImageryProvider.defaultGamma",
-        "TileCoordinatesImageryProvider.defaultGamma was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use ImageryLayer.gamma instead."
-      );
-      return this._defaultGamma;
-    },
-    set: function (value) {
-      deprecationWarning(
-        "TileCoordinatesImageryProvider.defaultGamma",
-        "TileCoordinatesImageryProvider.defaultGamma was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use ImageryLayer.gamma instead."
-      );
-      this._defaultGamma = value;
-    },
-  },
-
-  /**
-   * The default texture minification filter to apply to this provider.
-   * @memberof TileCoordinatesImageryProvider.prototype
-   * @type {TextureMinificationFilter}
-   * @deprecated
-   */
-  defaultMinificationFilter: {
-    get: function () {
-      deprecationWarning(
-        "TileCoordinatesImageryProvider.defaultMinificationFilter",
-        "TileCoordinatesImageryProvider.defaultMinificationFilter was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use ImageryLayer.minificationFilter instead."
-      );
-      return this._defaultMinificationFilter;
-    },
-    set: function (value) {
-      deprecationWarning(
-        "TileCoordinatesImageryProvider.defaultMinificationFilter",
-        "TileCoordinatesImageryProvider.defaultMinificationFilter was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use ImageryLayer.minificationFilter instead."
-      );
-      this._defaultMinificationFilter = value;
-    },
-  },
-
-  /**
-   * The default texture magnification filter to apply to this provider.
-   * @memberof TileCoordinatesImageryProvider.prototype
-   * @type {TextureMagnificationFilter}
-   * @deprecated
-   */
-  defaultMagnificationFilter: {
-    get: function () {
-      deprecationWarning(
-        "TileCoordinatesImageryProvider.defaultMagnificationFilter",
-        "TileCoordinatesImageryProvider.defaultMagnificationFilter was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use ImageryLayer.magnificationFilter instead."
-      );
-      return this._defaultMagnificationFilter;
-    },
-    set: function (value) {
-      deprecationWarning(
-        "TileCoordinatesImageryProvider.defaultMagnificationFilter",
-        "TileCoordinatesImageryProvider.defaultMagnificationFilter was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use ImageryLayer.magnificationFilter instead."
-      );
-      this._defaultMagnificationFilter = value;
-    },
-  },
 });
 
 /**

package/Source/Scene/TileMapServiceImageryProvider.js

@@ -3,7 +3,6 @@ import Cartographic from "../Core/Cartographic.js";
 import Check from "../Core/Check.js";
 import defaultValue from "../Core/defaultValue.js";
 import defined from "../Core/defined.js";
-import deprecationWarning from "../Core/deprecationWarning.js";
 import GeographicProjection from "../Core/GeographicProjection.js";
 import GeographicTilingScheme from "../Core/GeographicTilingScheme.js";
 import Rectangle from "../Core/Rectangle.js";
@@ -19,7 +18,6 @@ import UrlTemplateImageryProvider from "./UrlTemplateImageryProvider.js";
  *
  * Initialization options for the TileMapServiceImageryProvider constructor
  *
- * @property {Resource|string|Promise<Resource>|Promise<string>} [url] Path to image tiles on server. Deprecated
  * @property {string} [fileExtension='png'] The file extension for images on the server.
  * @property {Credit|string} [credit=''] A credit for the data source, which is displayed on the canvas.
  * @property {number} [minimumLevel=0] The minimum level-of-detail supported by the imagery provider.  Take care when specifying
@@ -52,7 +50,7 @@ import UrlTemplateImageryProvider from "./UrlTemplateImageryProvider.js";
  * @constructor
  * @extends UrlTemplateImageryProvider
  *
- * @param {TileMapServiceImageryProvider.ConstructorOptions} options Object describing initialization options
+ * @param {TileMapServiceImageryProvider.ConstructorOptions} [options] Object describing initialization options
  *
  * @see ArcGisMapServerImageryProvider
  * @see BingMapsImageryProvider
@@ -76,46 +74,7 @@ import UrlTemplateImageryProvider from "./UrlTemplateImageryProvider.js";
  * });
  */
 function TileMapServiceImageryProvider(options) {
-  options = defaultValue(options, defaultValue.EMPTY_OBJECT);
-
-  if (defined(options.url)) {
-    deprecationWarning(
-      "TileMapServiceImageryProvider options.url",
-      "options.url was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use TileMapServiceImageryProvider.fromUrl instead."
-    );
-
-    this._metadataError = undefined;
-    this._ready = false;
-
-    let resource;
-    const that = this;
-    const promise = Promise.resolve(options.url)
-      .then(function (url) {
-        resource = Resource.createIfNeeded(url);
-        resource.appendForwardSlash();
-
-        that._tmsResource = resource;
-        that._xmlResource = resource.getDerivedResource({
-          url: "tilemapresource.xml",
-        });
-
-        return TileMapServiceImageryProvider._requestMetadata(
-          options,
-          that._tmsResource,
-          that._xmlResource,
-          that
-        );
-      })
-      .catch((e) => {
-        return Promise.reject(e);
-      });
-
-    UrlTemplateImageryProvider.call(this, promise);
-    this._promise = promise;
-  }
-
-  // After readyPromise deprecation, this should become just
-  // UrlTemplateImageryProvider.call(this, options);
+  UrlTemplateImageryProvider.call(this, options);
 }
 
 TileMapServiceImageryProvider._requestMetadata = async function (
@@ -187,11 +146,7 @@ TileMapServiceImageryProvider.fromUrl = async function (url, options) {
     xmlResource
   );
 
-  // Once the deprecated behavior is removed, this can become
-  // return new TileMapServiceImageryProvider(metadata);
-  const provider = new TileMapServiceImageryProvider();
-  UrlTemplateImageryProvider.call(provider, metadata);
-  return provider;
+  return new TileMapServiceImageryProvider(metadata);
 };
 
 if (defined(Object.create)) {

package/Source/Scene/Tileset3DTileContent.js

@@ -1,5 +1,4 @@
 import destroyObject from "../Core/destroyObject.js";
-import deprecationWarning from "../Core/deprecationWarning.js";
 
 /**
  * Represents content for a tile in a
@@ -25,7 +24,6 @@ function Tileset3DTileContent(tileset, tile, resource) {
   this._group = undefined;
 
   this._ready = false;
-  this._readyPromise = Promise.resolve(this);
 }
 
 Object.defineProperties(Tileset3DTileContent.prototype, {
@@ -86,26 +84,6 @@ Object.defineProperties(Tileset3DTileContent.prototype, {
     },
   },
 
-  /**
-   * Gets the promise that will be resolved when the tile's content is ready to render.
-   *
-   * @memberof Tileset3DTileContent.prototype
-   *
-   * @type {Promise<Tileset3DTileContent>}
-   * @readonly
-   * @deprecated
-   * @private
-   */
-  readyPromise: {
-    get: function () {
-      deprecationWarning(
-        "Tileset3DTileContent.readyPromise",
-        "Tileset3DTileContent.readyPromise was deprecated in CesiumJS 1.104. It will be removed in 1.107. Wait for Tileset3DTileContent.ready to return true instead."
-      );
-      return this._readyPromise;
-    },
-  },
-
   tileset: {
     get: function () {
       return this._tileset;

package/Source/Scene/TimeDynamicPointCloud.js

@@ -3,7 +3,6 @@ import combine from "../Core/combine.js";
 import defaultValue from "../Core/defaultValue.js";
 import defined from "../Core/defined.js";
 import destroyObject from "../Core/destroyObject.js";
-import deprecationWarning from "../Core/deprecationWarning.js";
 import Event from "../Core/Event.js";
 import getTimestamp from "../Core/getTimestamp.js";
 import JulianDate from "../Core/JulianDate.js";
@@ -182,12 +181,6 @@ function TimeDynamicPointCloud(options) {
   this._nextInterval = undefined;
   this._lastRenderedFrame = undefined;
   this._clockMultiplier = 0.0;
-  this._resolveReadyPromise = undefined;
-  const that = this;
-  // This is here for backwards compatibility and can be removed when readyPromise is removed.
-  this._readyPromise = new Promise(function (resolve) {
-    that._resolveReadyPromise = resolve;
-  });
 
   // For calculating average load time of the last N frames
   this._runningSum = 0.0;
@@ -246,25 +239,6 @@ Object.defineProperties(TimeDynamicPointCloud.prototype, {
       return undefined;
     },
   },
-
-  /**
-   * Gets the promise that will be resolved when the point cloud renders a frame for the first time.
-   *
-   * @memberof TimeDynamicPointCloud.prototype
-   *
-   * @type {Promise<TimeDynamicPointCloud>}
-   * @readonly
-   * @deprecated
-   */
-  readyPromise: {
-    get: function () {
-      deprecationWarning(
-        "TimeDynamicPointCloud.readyPromise",
-        "TimeDynamicPointCloud.readyPromise was deprecated in CesiumJS 1.104. It will be removed in 1.107. Use TimeDynamicPointCloud.frameFailed instead."
-      );
-      return this._readyPromise;
-    },
-  },
 });
 
 function getFragmentShaderLoaded(fs) {
@@ -750,8 +724,6 @@ TimeDynamicPointCloud.prototype.update = function (frameState) {
   const that = this;
   if (defined(frame) && !defined(this._lastRenderedFrame)) {
     frameState.afterRender.push(function () {
-      // This is here for backwards compatibility and can be removed when readyPromise is removed.
-      that._resolveReadyPromise(that);
       return true;
     });
   }