@cesium/engine 2.0.0 → 2.2.0

package/Source/Scene/TileMapServiceImageryProvider.js

@@ -1,8 +1,9 @@
 import Cartesian2 from "../Core/Cartesian2.js";
 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 DeveloperError from "../Core/DeveloperError.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";
@@ -14,17 +15,17 @@ import WebMercatorTilingScheme from "../Core/WebMercatorTilingScheme.js";
 import UrlTemplateImageryProvider from "./UrlTemplateImageryProvider.js";
 
 /**
- * @typedef {Object} TileMapServiceImageryProvider.ConstructorOptions
+ * @typedef {object} TileMapServiceImageryProvider.ConstructorOptions
  *
  * Initialization options for the TileMapServiceImageryProvider constructor
  *
- * @property {Resource|String|Promise<Resource>|Promise<String>} [url='.'] Path to image tiles on server.
- * @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
+ * @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
  *                 this that the number of tiles at the minimum level is small, such as four or less.  A larger number is likely
  *                 to result in rendering problems.
- * @property {Number} [maximumLevel] The maximum level-of-detail supported by the imagery provider, or undefined if there is no limit.
+ * @property {number} [maximumLevel] The maximum level-of-detail supported by the imagery provider, or undefined if there is no limit.
  * @property {Rectangle} [rectangle=Rectangle.MAX_VALUE] The rectangle, in radians, covered by the image.
  * @property {TilingScheme} [tilingScheme] The tiling scheme specifying how the ellipsoidal
  * surface is broken into tiles.  If this parameter is not provided, a {@link WebMercatorTilingScheme}
@@ -32,13 +33,18 @@ import UrlTemplateImageryProvider from "./UrlTemplateImageryProvider.js";
  * @property {Ellipsoid} [ellipsoid] 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.
- * @property {Number} [tileWidth=256] Pixel width of image tiles.
- * @property {Number} [tileHeight=256] Pixel height of image tiles.
- * @property {Boolean} [flipXY] Older versions of gdal2tiles.py flipped X and Y values in tilemapresource.xml.
+ * @property {number} [tileWidth=256] Pixel width of image tiles.
+ * @property {number} [tileHeight=256] Pixel height of image tiles.
+ * @property {boolean} [flipXY] Older versions of gdal2tiles.py flipped X and Y values in tilemapresource.xml.
+ * @property {TileDiscardPolicy} [tileDiscardPolicy] A policy for discarding tile images according to some criteria
  * Specifying this option will do the same, allowing for loading of these incorrect tilesets.
  */
 
 /**
+ * <div class="notice">
+ * To construct a TileMapServiceImageryProvider, call {@link TileMapServiceImageryProvider.fromUrl}. Do not call the constructor directly.
+ * </div>
+ *
  * An imagery provider that provides tiled imagery as generated by
  * {@link http://www.maptiler.org/|MapTiler}, {@link http://www.klokan.cz/projects/gdal2tiles/|GDAL2Tiles}, etc.
  *
@@ -58,11 +64,11 @@ import UrlTemplateImageryProvider from "./UrlTemplateImageryProvider.js";
  * @see UrlTemplateImageryProvider
  *
  * @example
- * const tms = new Cesium.TileMapServiceImageryProvider({
- *    url : '../images/cesium_maptiler/Cesium_Logo_Color',
- *    fileExtension: 'png',
- *    maximumLevel: 4,
- *    rectangle: new Cesium.Rectangle(
+ * const tms = await Cesium.TileMapServiceImageryProvider.fromUrl(
+ *    "../images/cesium_maptiler/Cesium_Logo_Color", {
+ *      fileExtension: 'png',
+ *      maximumLevel: 4,
+ *      rectangle: new Cesium.Rectangle(
  *        Cesium.Math.toRadians(-120.0),
  *        Cesium.Math.toRadians(20.0),
  *        Cesium.Math.toRadians(-60.0),
@@ -72,43 +78,122 @@ import UrlTemplateImageryProvider from "./UrlTemplateImageryProvider.js";
 function TileMapServiceImageryProvider(options) {
   options = defaultValue(options, defaultValue.EMPTY_OBJECT);
 
-  //>>includeStart('debug', pragmas.debug);
-  if (!defined(options.url)) {
-    throw new DeveloperError("options.url is required.");
-  }
-  //>>includeEnd('debug');
+  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._tmsResource = undefined;
-  this._xmlResource = undefined;
-  this._options = options;
-  this._metadataError = undefined;
-
-  this._metadataSuccess = this._metadataSuccess.bind(this);
-  this._metadataFailure = this._metadataFailure.bind(this);
-  this._requestMetadata = this._requestMetadata.bind(this);
-
-  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",
+    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);
       });
 
-      return that._requestMetadata();
-    })
-    .catch((e) => {
-      return Promise.reject(e);
-    });
+    UrlTemplateImageryProvider.call(this, promise);
+    this._promise = promise;
+  }
 
-  UrlTemplateImageryProvider.call(this, promise);
-  this._promise = promise;
+  // After readyPromise deprecation, this should become just
+  // UrlTemplateImageryProvider.call(this, options);
 }
 
+TileMapServiceImageryProvider._requestMetadata = async function (
+  options,
+  tmsResource,
+  xmlResource,
+  provider
+) {
+  // Try to load remaining parameters from XML
+  try {
+    const xml = await xmlResource.fetchXML();
+    return TileMapServiceImageryProvider._metadataSuccess(
+      xml,
+      options,
+      tmsResource,
+      xmlResource,
+      provider
+    );
+  } catch (e) {
+    if (e instanceof RequestErrorEvent) {
+      return TileMapServiceImageryProvider._metadataFailure(
+        options,
+        tmsResource
+      );
+    }
+
+    throw e;
+  }
+};
+/**
+ * Creates a TileMapServiceImageryProvider from the specified url.
+ *
+ * @param {Resource|String} url Path to image tiles on server.
+ * @param {TileMapServiceImageryProvider.ConstructorOptions} [options] Object describing initialization options.
+ * @returns {Promise<TileMapServiceImageryProvider>} A promise that resolves to the created TileMapServiceImageryProvider.
+ *
+ * @example
+ * const tms = await Cesium.TileMapServiceImageryProvider.fromUrl(
+ *    '../images/cesium_maptiler/Cesium_Logo_Color', {
+ *      fileExtension: 'png',
+ *      maximumLevel: 4,
+ *      rectangle: new Cesium.Rectangle(
+ *        Cesium.Math.toRadians(-120.0),
+ *        Cesium.Math.toRadians(20.0),
+ *        Cesium.Math.toRadians(-60.0),
+ *        Cesium.Math.toRadians(40.0))
+ * });
+ *
+ * @exception {RuntimeError} Unable to find expected tilesets or bbox attributes in tilemapresource.xml
+ * @exception {RuntimeError} tilemapresource.xml specifies an unsupported profile attribute
+ */
+TileMapServiceImageryProvider.fromUrl = async function (url, options) {
+  //>>includeStart('debug', pragmas.debug);
+  Check.defined("url", url);
+  //>>includeEnd('debug');
+
+  const resource = Resource.createIfNeeded(url);
+  resource.appendForwardSlash();
+
+  const tmsResource = resource;
+  const xmlResource = resource.getDerivedResource({
+    url: "tilemapresource.xml",
+  });
+
+  options = defaultValue(options, defaultValue.EMPTY_OBJECT);
+  const metadata = await TileMapServiceImageryProvider._requestMetadata(
+    options,
+    tmsResource,
+    xmlResource
+  );
+
+  // Once the deprecated behavior is removed, this can become
+  // return new TileMapServiceImageryProvider(metadata);
+  const provider = new TileMapServiceImageryProvider();
+  UrlTemplateImageryProvider.call(provider, metadata);
+  return provider;
+};
+
 if (defined(Object.create)) {
   TileMapServiceImageryProvider.prototype = Object.create(
     UrlTemplateImageryProvider.prototype
@@ -116,19 +201,6 @@ if (defined(Object.create)) {
   TileMapServiceImageryProvider.prototype.constructor = TileMapServiceImageryProvider;
 }
 
-TileMapServiceImageryProvider.prototype._requestMetadata = function () {
-  // Try to load remaining parameters from XML
-  return this._xmlResource
-    .fetchXML()
-    .then(this._metadataSuccess)
-    .catch((e) => {
-      if (e instanceof RequestErrorEvent) {
-        return this._metadataFailure();
-      }
-      return Promise.reject(e);
-    });
-};
-
 /**
  * Mutates the properties of a given rectangle so it does not extend outside of the given tiling scheme's rectangle
  * @private
@@ -173,16 +245,29 @@ function calculateSafeMinimumDetailLevel(
   return minimumLevel;
 }
 
-TileMapServiceImageryProvider.prototype._metadataSuccess = function (xml) {
+/**
+ * Parses the results of a successful xml request
+ * @private
+ *
+ * @param {Object} xml
+ * @param {TileMapServiceImageryProvider.ConstructorOptions} options
+ * @param {Resource} tmsResource
+ * @param {Resource} xmlResource
+ * @returns {UrlTemplateImageryProvider.ConstructorOptions}
+ */
+TileMapServiceImageryProvider._metadataSuccess = function (
+  xml,
+  options,
+  tmsResource,
+  xmlResource,
+  provider
+) {
   const tileFormatRegex = /tileformat/i;
   const tileSetRegex = /tileset/i;
   const tileSetsRegex = /tilesets/i;
   const bboxRegex = /boundingbox/i;
   let format, bbox, tilesets;
   const tilesetsList = []; //list of TileSets
-  const xmlResource = this._xmlResource;
-  let metadataError = this._metadataError;
-  const requestMetadata = this._requestMetadata;
 
   // Allowing options properties (already copied to that) to override XML values
 
@@ -209,20 +294,18 @@ TileMapServiceImageryProvider.prototype._metadataSuccess = function (xml) {
   let message;
   if (!defined(tilesets) || !defined(bbox)) {
     message = `Unable to find expected tilesets or bbox attributes in ${xmlResource.url}.`;
-    metadataError = TileProviderError.reportError(
-      metadataError,
-      this,
-      this.errorEvent,
-      message
-    );
-    if (metadataError.retry) {
-      this._metadataError = metadataError;
-      return requestMetadata();
+    if (defined(provider)) {
+      TileProviderError.reportError(
+        undefined,
+        provider,
+        provider.errorEvent,
+        message
+      );
     }
-    return Promise.reject(new RuntimeError(message));
+
+    throw new RuntimeError(message);
   }
 
-  const options = this._options;
   const fileExtension = defaultValue(
     options.fileExtension,
     format.getAttribute("extension")
@@ -262,18 +345,17 @@ TileMapServiceImageryProvider.prototype._metadataSuccess = function (xml) {
         ellipsoid: options.ellipsoid,
       });
     } else {
-      message = `${xmlResource.url}specifies an unsupported profile attribute, ${tilingSchemeName}.`;
-      metadataError = TileProviderError.reportError(
-        metadataError,
-        this,
-        this.errorEvent,
-        message
-      );
-      if (metadataError.retry) {
-        this._metadataError = metadataError;
-        return requestMetadata();
+      message = `${xmlResource.url} specifies an unsupported profile attribute, ${tilingSchemeName}.`;
+      if (defined(provider)) {
+        TileProviderError.reportError(
+          undefined,
+          provider,
+          provider.errorEvent,
+          message
+        );
       }
-      return Promise.reject(new RuntimeError(message));
+
+      throw new RuntimeError(message);
     }
   }
 
@@ -344,11 +426,11 @@ TileMapServiceImageryProvider.prototype._metadataSuccess = function (xml) {
     minimumLevel
   );
 
-  const templateResource = this._tmsResource.getDerivedResource({
+  const templateResource = tmsResource.getDerivedResource({
     url: `{z}/{x}/{reverseY}.${fileExtension}`,
   });
 
-  return Promise.resolve({
+  return {
     url: templateResource,
     tilingScheme: tilingScheme,
     rectangle: rectangle,
@@ -358,12 +440,22 @@ TileMapServiceImageryProvider.prototype._metadataSuccess = function (xml) {
     maximumLevel: maximumLevel,
     tileDiscardPolicy: options.tileDiscardPolicy,
     credit: options.credit,
-  });
+  };
 };
 
-TileMapServiceImageryProvider.prototype._metadataFailure = function () {
+/**
+ * Handle xml request failure by providing the default values
+ * @private
+ *
+ * @param {TileMapServiceImageryProvider.ConstructorOptions} options
+ * @param {Resource} tmsResource
+ * @returns {UrlTemplateImageryProvider.ConstructorOptions}
+ */
+TileMapServiceImageryProvider._metadataFailure = function (
+  options,
+  tmsResource
+) {
   // Can't load XML, still allow options and defaults
-  const options = this._options;
   const fileExtension = defaultValue(options.fileExtension, "png");
   const tileWidth = defaultValue(options.tileWidth, 256);
   const tileHeight = defaultValue(options.tileHeight, 256);
@@ -383,11 +475,11 @@ TileMapServiceImageryProvider.prototype._metadataFailure = function () {
     options.minimumLevel
   );
 
-  const templateResource = this._tmsResource.getDerivedResource({
+  const templateResource = tmsResource.getDerivedResource({
     url: `{z}/{x}/{reverseY}.${fileExtension}`,
   });
 
-  return Promise.resolve({
+  return {
     url: templateResource,
     tilingScheme: tilingScheme,
     rectangle: rectangle,
@@ -397,7 +489,7 @@ TileMapServiceImageryProvider.prototype._metadataFailure = function () {
     maximumLevel: maximumLevel,
     tileDiscardPolicy: options.tileDiscardPolicy,
     credit: options.credit,
-  });
+  };
 };
 
 export default TileMapServiceImageryProvider;

package/Source/Scene/TileMetadata.js

@@ -9,8 +9,8 @@ import MetadataEntity from "./MetadataEntity.js";
  * See the {@link https://github.com/CesiumGS/3d-tiles/tree/main/extensions/3DTILES_metadata|3DTILES_metadata Extension} for 3D Tiles
  * </p>
  *
- * @param {Object} options Object with the following properties:
- * @param {Object} options.tile Either the tile metadata JSON (3D Tiles 1.1), or the extension JSON attached to the tile.
+ * @param {object} options Object with the following properties:
+ * @param {object} options.tile Either the tile metadata JSON (3D Tiles 1.1), or the extension JSON attached to the tile.
  * @param {MetadataClass} options.class The class that the tile metadata conforms to.
  *
  * @alias TileMetadata
@@ -53,7 +53,7 @@ Object.defineProperties(TileMetadata.prototype, {
    * Extra user-defined properties.
    *
    * @memberof TileMetadata.prototype
-   * @type {Object}
+   * @type {object}
    * @readonly
    * @private
    */
@@ -67,7 +67,7 @@ Object.defineProperties(TileMetadata.prototype, {
    * An object containing extensions.
    *
    * @memberof TileMetadata.prototype
-   * @type {Object}
+   * @type {object}
    * @readonly
    * @private
    */
@@ -81,8 +81,8 @@ Object.defineProperties(TileMetadata.prototype, {
 /**
  * Returns whether the tile has this property.
  *
- * @param {String} propertyId The case-sensitive ID of the property.
- * @returns {Boolean} Whether the tile has this property.
+ * @param {string} propertyId The case-sensitive ID of the property.
+ * @returns {boolean} Whether the tile has this property.
  * @private
  */
 TileMetadata.prototype.hasProperty = function (propertyId) {
@@ -92,8 +92,8 @@ TileMetadata.prototype.hasProperty = function (propertyId) {
 /**
  * Returns whether the tile has a property with the given semantic.
  *
- * @param {String} semantic The case-sensitive semantic of the property.
- * @returns {Boolean} Whether the tile has a property with the given semantic.
+ * @param {string} semantic The case-sensitive semantic of the property.
+ * @returns {boolean} Whether the tile has a property with the given semantic.
  * @private
  */
 TileMetadata.prototype.hasPropertyBySemantic = function (semantic) {
@@ -107,8 +107,8 @@ TileMetadata.prototype.hasPropertyBySemantic = function (semantic) {
 /**
  * Returns an array of property IDs.
  *
- * @param {String[]} [results] An array into which to store the results.
- * @returns {String[]} The property IDs.
+ * @param {string[]} [results] An array into which to store the results.
+ * @returns {string[]} The property IDs.
  * @private
  */
 TileMetadata.prototype.getPropertyIds = function (results) {
@@ -121,7 +121,7 @@ TileMetadata.prototype.getPropertyIds = function (results) {
  * If the property is normalized the normalized value is returned.
  * </p>
  *
- * @param {String} propertyId The case-sensitive ID of the property.
+ * @param {string} propertyId The case-sensitive ID of the property.
  * @returns {*} The value of the property or <code>undefined</code> if the tile does not have this property.
  * @private
  */
@@ -135,9 +135,9 @@ TileMetadata.prototype.getProperty = function (propertyId) {
  * If the property is normalized a normalized value must be provided to this function.
  * </p>
  *
- * @param {String} propertyId The case-sensitive ID of the property.
+ * @param {string} propertyId The case-sensitive ID of the property.
  * @param {*} value The value of the property that will be copied.
- * @returns {Boolean} <code>true</code> if the property was set, <code>false</code> otherwise.
+ * @returns {boolean} <code>true</code> if the property was set, <code>false</code> otherwise.
  * @private
  */
 TileMetadata.prototype.setProperty = function (propertyId, value) {
@@ -152,7 +152,7 @@ TileMetadata.prototype.setProperty = function (propertyId, value) {
 /**
  * Returns a copy of the value of the property with the given semantic.
  *
- * @param {String} semantic The case-sensitive semantic of the property.
+ * @param {string} semantic The case-sensitive semantic of the property.
  * @returns {*} The value of the property or <code>undefined</code> if the tile does not have this semantic.
  * @private
  */
@@ -167,9 +167,9 @@ TileMetadata.prototype.getPropertyBySemantic = function (semantic) {
 /**
  * Sets the value of the property with the given semantic.
  *
- * @param {String} semantic The case-sensitive semantic of the property.
+ * @param {string} semantic The case-sensitive semantic of the property.
  * @param {*} value The value of the property that will be copied.
- * @returns {Boolean} <code>true</code> if the property was set, <code>false</code> otherwise.
+ * @returns {boolean} <code>true</code> if the property was set, <code>false</code> otherwise.
  * @private
  */
 TileMetadata.prototype.setPropertyBySemantic = function (semantic, value) {

package/Source/Scene/TileOrientedBoundingBox.js

@@ -106,7 +106,7 @@ Object.defineProperties(TileOrientedBoundingBox.prototype, {
    *
    * @memberof TileOrientedBoundingBox.prototype
    *
-   * @type {Object}
+   * @type {object}
    * @readonly
    */
   boundingVolume: {
@@ -133,7 +133,7 @@ Object.defineProperties(TileOrientedBoundingBox.prototype, {
  * Computes the distance between this bounding box and the camera attached to frameState.
  *
  * @param {FrameState} frameState The frameState to which the camera is attached.
- * @returns {Number} The distance between the camera and the bounding box in meters. Returns 0 if the camera is inside the bounding volume.
+ * @returns {number} The distance between the camera and the bounding box in meters. Returns 0 if the camera is inside the bounding volume.
  */
 TileOrientedBoundingBox.prototype.distanceToCamera = function (frameState) {
   //>>includeStart('debug', pragmas.debug);

package/Source/Scene/TileReplacementQueue.js

@@ -27,7 +27,7 @@ TileReplacementQueue.prototype.markStartOfRenderFrame = function () {
  * tiles.  Tiles that were used last frame will not be unloaded, even if that puts the number
  * of tiles above the specified maximum.
  *
- * @param {Number} maximumTiles The maximum number of tiles in the queue.
+ * @param {number} maximumTiles The maximum number of tiles in the queue.
  */
 TileReplacementQueue.prototype.trimTiles = function (maximumTiles) {
   let tileToTrim = this.tail;

package/Source/Scene/TileSelectionResult.js

@@ -52,7 +52,7 @@ const TileSelectionResult = {
    * or <code>REFINED_AND_KICKED</code>.
    *
    * @param {TileSelectionResult} value The selection result to test.
-   * @returns {Boolean} true if the tile was kicked, no matter if it was originally rendered or refined.
+   * @returns {boolean} true if the tile was kicked, no matter if it was originally rendered or refined.
    */
   wasKicked: function (value) {
     return value >= TileSelectionResult.RENDERED_AND_KICKED;

package/Source/Scene/Tileset3DTileContent.js

@@ -1,4 +1,5 @@
 import destroyObject from "../Core/destroyObject.js";
+import deprecationWarning from "../Core/deprecationWarning.js";
 
 /**
  * Represents content for a tile in a
@@ -13,7 +14,7 @@ import destroyObject from "../Core/destroyObject.js";
  *
  * @private
  */
-function Tileset3DTileContent(tileset, tile, resource, json) {
+function Tileset3DTileContent(tileset, tile, resource) {
   this._tileset = tileset;
   this._tile = tile;
   this._resource = resource;
@@ -23,7 +24,8 @@ function Tileset3DTileContent(tileset, tile, resource, json) {
   this._metadata = undefined;
   this._group = undefined;
 
-  this._readyPromise = initialize(this, json);
+  this._ready = false;
+  this._readyPromise = Promise.resolve(this);
 }
 
 Object.defineProperties(Tileset3DTileContent.prototype, {
@@ -69,8 +71,37 @@ Object.defineProperties(Tileset3DTileContent.prototype, {
     },
   },
 
+  /**
+   * Returns true when the tile's content is ready to render; otherwise false
+   *
+   * @memberof Tileset3DTileContent.prototype
+   *
+   * @type {boolean}
+   * @readonly
+   * @private
+   */
+  ready: {
+    get: function () {
+      return this._ready;
+    },
+  },
+
+  /**
+   * 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;
     },
   },
@@ -118,10 +149,21 @@ Object.defineProperties(Tileset3DTileContent.prototype, {
   },
 });
 
-function initialize(content, json) {
+/**
+ * Creates an instance of Tileset3DTileContent from a parsed JSON object
+ * @param {Cesium3DTileset} tileset
+ * @param {Cesium3DTile} tile
+ * @param {Resource} resource
+ * @param {object} json
+ * @returns {Tileset3DTileContent}
+ */
+Tileset3DTileContent.fromJson = function (tileset, tile, resource, json) {
+  const content = new Tileset3DTileContent(tileset, tile, resource);
   content._tileset.loadTileset(content._resource, json, content._tile);
-  return Promise.resolve(content);
-}
+  content._ready = true;
+
+  return content;
+};
 
 /**
  * Part of the {@link Cesium3DTileContent} interface.  <code>Tileset3DTileContent</code>