import Check from "../Core/Check.js"; import defaultValue from "../Core/defaultValue.js"; import defined from "../Core/defined.js"; import GroupMetadata from "./GroupMetadata.js"; import TilesetMetadata from "./TilesetMetadata.js"; /** * An object containing metadata about a 3D Tileset. *
* See the {@link https://github.com/CesiumGS/3d-tiles/tree/main/extensions/3DTILES_metadata|3DTILES_metadata Extension} for 3D Tiles. *
*
* This object represents the tileset JSON (3D Tiles 1.1) or the 3DTILES_metadata
object that contains
* the schema ({@link MetadataSchema}), tileset metadata ({@link TilesetMetadata}), group metadata (dictionary of {@link GroupMetadata}), and metadata statistics (dictionary)
*
3DTILES_metadata
extension object that contains the tileset metadata.
* @param {MetadataSchema} options.schema The parsed schema.
*
* @alias Cesium3DTilesetMetadata
* @constructor
* @private
* @experimental This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
*/
function Cesium3DTilesetMetadata(options) {
options = defaultValue(options, defaultValue.EMPTY_OBJECT);
const metadataJson = options.metadataJson;
// The calling code is responsible for loading the schema.
// This keeps metadata parsing synchronous.
const schema = options.schema;
//>>includeStart('debug', pragmas.debug);
Check.typeOf.object("options.metadataJson", metadataJson);
Check.typeOf.object("options.schema", schema);
//>>includeEnd('debug');
// An older schema stored the tileset metadata in the "tileset" property.
const metadata = defaultValue(metadataJson.metadata, metadataJson.tileset);
let tileset;
if (defined(metadata)) {
tileset = new TilesetMetadata({
tileset: metadata,
class: schema.classes[metadata.class],
});
}
let groupIds = [];
const groups = [];
const groupsJson = metadataJson.groups;
if (Array.isArray(groupsJson)) {
const length = groupsJson.length;
for (let i = 0; i < length; i++) {
const group = groupsJson[i];
groups.push(
new GroupMetadata({
group: group,
class: schema.classes[group.class],
})
);
}
} else if (defined(groupsJson)) {
// An older version of group metadata stored groups in a dictionary
// instead of an array.
groupIds = Object.keys(groupsJson).sort();
const length = groupIds.length;
for (let i = 0; i < length; i++) {
const groupId = groupIds[i];
if (groupsJson.hasOwnProperty(groupId)) {
const group = groupsJson[groupId];
groups.push(
new GroupMetadata({
id: groupId,
group: groupsJson[groupId],
class: schema.classes[group.class],
})
);
}
}
}
this._schema = schema;
this._groups = groups;
this._groupIds = groupIds;
this._tileset = tileset;
this._statistics = metadataJson.statistics;
this._extras = metadataJson.extras;
this._extensions = metadataJson.extensions;
}
Object.defineProperties(Cesium3DTilesetMetadata.prototype, {
/**
* Schema containing classes and enums.
*
* @memberof Cesium3DTilesetMetadata.prototype
* @type {MetadataSchema}
* @readonly
* @private
*/
schema: {
get: function () {
return this._schema;
},
},
/**
* Metadata about groups of content.
*
* @memberof Cesium3DTilesetMetadata.prototype
* @type {GroupMetadata[]}
* @readonly
* @private
*/
groups: {
get: function () {
return this._groups;
},
},
/**
* The IDs of the group metadata in the corresponding groups dictionary.
* Only populated if using the legacy schema.
*
* @memberof Cesium3DTilesetMetadata.prototype
* @type {String[]}
* @readonly
* @private
*/
groupIds: {
get: function () {
return this._groupIds;
},
},
/**
* Metadata about the tileset as a whole.
*
* @memberof Cesium3DTilesetMetadata.prototype
* @type {TilesetMetadata}
* @readonly
* @private
*/
tileset: {
get: function () {
return this._tileset;
},
},
/**
* Statistics about the metadata.
* * See the {@link https://github.com/CesiumGS/3d-tiles/blob/main/extensions/3DTILES_metadata/schema/statistics.schema.json|statistics schema reference} * in the 3D Tiles spec for the full set of properties. *
* * @memberof Cesium3DTilesetMetadata.prototype * @type {Object} * @readonly * @private */ statistics: { get: function () { return this._statistics; }, }, /** * Extras in the JSON object. * * @memberof Cesium3DTilesetMetadata.prototype * @type {*} * @readonly * @private */ extras: { get: function () { return this._extras; }, }, /** * Extensions in the JSON object. * * @memberof Cesium3DTilesetMetadata.prototype * @type {Object} * @readonly * @private */ extensions: { get: function () { return this._extensions; }, }, }); export default Cesium3DTilesetMetadata;