You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

742 lines
21 KiB
JavaScript

import Cartesian3 from "../Core/Cartesian3.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";
import Ellipsoid from "../Core/Ellipsoid.js";
import getJsonFromTypedArray from "../Core/getJsonFromTypedArray.js";
import ComponentDatatype from "../Core/ComponentDatatype.js";
import CesiumMath from "../Core/Math.js";
import Matrix4 from "../Core/Matrix4.js";
import Rectangle from "../Core/Rectangle.js";
import RuntimeError from "../Core/RuntimeError.js";
import when from "../ThirdParty/when.js";
import Cesium3DTileBatchTable from "./Cesium3DTileBatchTable.js";
import Cesium3DTileFeatureTable from "./Cesium3DTileFeatureTable.js";
import Vector3DTilePoints from "./Vector3DTilePoints.js";
import Vector3DTilePolygons from "./Vector3DTilePolygons.js";
import Vector3DTilePolylines from "./Vector3DTilePolylines.js";
import Vector3DTileClampedPolylines from "./Vector3DTileClampedPolylines.js";
import decodeVectorPolylinePositions from "../Core/decodeVectorPolylinePositions.js";
/**
* Represents the contents of a
* {@link https://github.com/CesiumGS/3d-tiles/tree/vctr/TileFormats/VectorData|Vector}
* tile in a {@link https://github.com/CesiumGS/3d-tiles/tree/master/specification|3D Tiles} tileset.
* <p>
* Implements the {@link Cesium3DTileContent} interface.
* </p>
*
* @alias Vector3DTileContent
* @constructor
*
* @private
*/
function Vector3DTileContent(tileset, tile, resource, arrayBuffer, byteOffset) {
this._tileset = tileset;
this._tile = tile;
this._resource = resource;
this._polygons = undefined;
this._polylines = undefined;
this._points = undefined;
this._contentReadyPromise = undefined;
this._readyPromise = when.defer();
this._batchTable = undefined;
this._features = undefined;
/**
* Part of the {@link Cesium3DTileContent} interface.
*/
this.featurePropertiesDirty = false;
initialize(this, arrayBuffer, byteOffset);
}
Object.defineProperties(Vector3DTileContent.prototype, {
featuresLength: {
get: function () {
return defined(this._batchTable) ? this._batchTable.featuresLength : 0;
},
},
pointsLength: {
get: function () {
if (defined(this._points)) {
return this._points.pointsLength;
}
return 0;
},
},
trianglesLength: {
get: function () {
var trianglesLength = 0;
if (defined(this._polygons)) {
trianglesLength += this._polygons.trianglesLength;
}
if (defined(this._polylines)) {
trianglesLength += this._polylines.trianglesLength;
}
return trianglesLength;
},
},
geometryByteLength: {
get: function () {
var geometryByteLength = 0;
if (defined(this._polygons)) {
geometryByteLength += this._polygons.geometryByteLength;
}
if (defined(this._polylines)) {
geometryByteLength += this._polylines.geometryByteLength;
}
return geometryByteLength;
},
},
texturesByteLength: {
get: function () {
if (defined(this._points)) {
return this._points.texturesByteLength;
}
return 0;
},
},
batchTableByteLength: {
get: function () {
return defined(this._batchTable) ? this._batchTable.memorySizeInBytes : 0;
},
},
innerContents: {
get: function () {
return undefined;
},
},
readyPromise: {
get: function () {
return this._readyPromise.promise;
},
},
tileset: {
get: function () {
return this._tileset;
},
},
tile: {
get: function () {
return this._tile;
},
},
url: {
get: function () {
return this._resource.getUrlComponent(true);
},
},
batchTable: {
get: function () {
return this._batchTable;
},
},
});
function createColorChangedCallback(content) {
return function (batchId, color) {
if (defined(content._polygons)) {
content._polygons.updateCommands(batchId, color);
}
};
}
function getBatchIds(featureTableJson, featureTableBinary) {
var polygonBatchIds;
var polylineBatchIds;
var pointBatchIds;
var i;
var numberOfPolygons = defaultValue(featureTableJson.POLYGONS_LENGTH, 0);
var numberOfPolylines = defaultValue(featureTableJson.POLYLINES_LENGTH, 0);
var numberOfPoints = defaultValue(featureTableJson.POINTS_LENGTH, 0);
if (numberOfPolygons > 0 && defined(featureTableJson.POLYGON_BATCH_IDS)) {
var polygonBatchIdsByteOffset =
featureTableBinary.byteOffset +
featureTableJson.POLYGON_BATCH_IDS.byteOffset;
polygonBatchIds = new Uint16Array(
featureTableBinary.buffer,
polygonBatchIdsByteOffset,
numberOfPolygons
);
}
if (numberOfPolylines > 0 && defined(featureTableJson.POLYLINE_BATCH_IDS)) {
var polylineBatchIdsByteOffset =
featureTableBinary.byteOffset +
featureTableJson.POLYLINE_BATCH_IDS.byteOffset;
polylineBatchIds = new Uint16Array(
featureTableBinary.buffer,
polylineBatchIdsByteOffset,
numberOfPolylines
);
}
if (numberOfPoints > 0 && defined(featureTableJson.POINT_BATCH_IDS)) {
var pointBatchIdsByteOffset =
featureTableBinary.byteOffset +
featureTableJson.POINT_BATCH_IDS.byteOffset;
pointBatchIds = new Uint16Array(
featureTableBinary.buffer,
pointBatchIdsByteOffset,
numberOfPoints
);
}
var atLeastOneDefined =
defined(polygonBatchIds) ||
defined(polylineBatchIds) ||
defined(pointBatchIds);
var atLeastOneUndefined =
(numberOfPolygons > 0 && !defined(polygonBatchIds)) ||
(numberOfPolylines > 0 && !defined(polylineBatchIds)) ||
(numberOfPoints > 0 && !defined(pointBatchIds));
if (atLeastOneDefined && atLeastOneUndefined) {
throw new RuntimeError(
"If one group of batch ids is defined, then all batch ids must be defined."
);
}
var allUndefinedBatchIds =
!defined(polygonBatchIds) &&
!defined(polylineBatchIds) &&
!defined(pointBatchIds);
if (allUndefinedBatchIds) {
var id = 0;
if (!defined(polygonBatchIds) && numberOfPolygons > 0) {
polygonBatchIds = new Uint16Array(numberOfPolygons);
for (i = 0; i < numberOfPolygons; ++i) {
polygonBatchIds[i] = id++;
}
}
if (!defined(polylineBatchIds) && numberOfPolylines > 0) {
polylineBatchIds = new Uint16Array(numberOfPolylines);
for (i = 0; i < numberOfPolylines; ++i) {
polylineBatchIds[i] = id++;
}
}
if (!defined(pointBatchIds) && numberOfPoints > 0) {
pointBatchIds = new Uint16Array(numberOfPoints);
for (i = 0; i < numberOfPoints; ++i) {
pointBatchIds[i] = id++;
}
}
}
return {
polygons: polygonBatchIds,
polylines: polylineBatchIds,
points: pointBatchIds,
};
}
var sizeOfUint32 = Uint32Array.BYTES_PER_ELEMENT;
function createFloatingPolylines(options) {
return new Vector3DTilePolylines(options);
}
function createClampedPolylines(options) {
return new Vector3DTileClampedPolylines(options);
}
function initialize(content, arrayBuffer, byteOffset) {
byteOffset = defaultValue(byteOffset, 0);
var uint8Array = new Uint8Array(arrayBuffer);
var view = new DataView(arrayBuffer);
byteOffset += sizeOfUint32; // Skip magic number
var version = view.getUint32(byteOffset, true);
if (version !== 1) {
throw new RuntimeError(
"Only Vector tile version 1 is supported. Version " +
version +
" is not."
);
}
byteOffset += sizeOfUint32;
var byteLength = view.getUint32(byteOffset, true);
byteOffset += sizeOfUint32;
if (byteLength === 0) {
content._readyPromise.resolve(content);
return;
}
var featureTableJSONByteLength = view.getUint32(byteOffset, true);
byteOffset += sizeOfUint32;
if (featureTableJSONByteLength === 0) {
throw new RuntimeError(
"Feature table must have a byte length greater than zero"
);
}
var featureTableBinaryByteLength = view.getUint32(byteOffset, true);
byteOffset += sizeOfUint32;
var batchTableJSONByteLength = view.getUint32(byteOffset, true);
byteOffset += sizeOfUint32;
var batchTableBinaryByteLength = view.getUint32(byteOffset, true);
byteOffset += sizeOfUint32;
var indicesByteLength = view.getUint32(byteOffset, true);
byteOffset += sizeOfUint32;
var positionByteLength = view.getUint32(byteOffset, true);
byteOffset += sizeOfUint32;
var polylinePositionByteLength = view.getUint32(byteOffset, true);
byteOffset += sizeOfUint32;
var pointsPositionByteLength = view.getUint32(byteOffset, true);
byteOffset += sizeOfUint32;
var featureTableJson = getJsonFromTypedArray(
uint8Array,
byteOffset,
featureTableJSONByteLength
);
byteOffset += featureTableJSONByteLength;
var featureTableBinary = new Uint8Array(
arrayBuffer,
byteOffset,
featureTableBinaryByteLength
);
byteOffset += featureTableBinaryByteLength;
var batchTableJson;
var batchTableBinary;
if (batchTableJSONByteLength > 0) {
// PERFORMANCE_IDEA: is it possible to allocate this on-demand? Perhaps keep the
// arraybuffer/string compressed in memory and then decompress it when it is first accessed.
//
// We could also make another request for it, but that would make the property set/get
// API async, and would double the number of numbers in some cases.
batchTableJson = getJsonFromTypedArray(
uint8Array,
byteOffset,
batchTableJSONByteLength
);
byteOffset += batchTableJSONByteLength;
if (batchTableBinaryByteLength > 0) {
// Has a batch table binary
batchTableBinary = new Uint8Array(
arrayBuffer,
byteOffset,
batchTableBinaryByteLength
);
// Copy the batchTableBinary section and let the underlying ArrayBuffer be freed
batchTableBinary = new Uint8Array(batchTableBinary);
byteOffset += batchTableBinaryByteLength;
}
}
var numberOfPolygons = defaultValue(featureTableJson.POLYGONS_LENGTH, 0);
var numberOfPolylines = defaultValue(featureTableJson.POLYLINES_LENGTH, 0);
var numberOfPoints = defaultValue(featureTableJson.POINTS_LENGTH, 0);
var totalPrimitives = numberOfPolygons + numberOfPolylines + numberOfPoints;
var batchTable = new Cesium3DTileBatchTable(
content,
totalPrimitives,
batchTableJson,
batchTableBinary,
createColorChangedCallback(content)
);
content._batchTable = batchTable;
if (totalPrimitives === 0) {
return;
}
var featureTable = new Cesium3DTileFeatureTable(
featureTableJson,
featureTableBinary
);
var region = featureTable.getGlobalProperty("REGION");
if (!defined(region)) {
throw new RuntimeError(
"Feature table global property: REGION must be defined"
);
}
var rectangle = Rectangle.unpack(region);
var minHeight = region[4];
var maxHeight = region[5];
var modelMatrix = content._tile.computedTransform;
var center = featureTable.getGlobalProperty(
"RTC_CENTER",
ComponentDatatype.FLOAT,
3
);
if (defined(center)) {
center = Cartesian3.unpack(center);
Matrix4.multiplyByPoint(modelMatrix, center, center);
} else {
center = Rectangle.center(rectangle);
center.height = CesiumMath.lerp(minHeight, maxHeight, 0.5);
center = Ellipsoid.WGS84.cartographicToCartesian(center);
}
var batchIds = getBatchIds(featureTableJson, featureTableBinary);
byteOffset += byteOffset % 4;
if (numberOfPolygons > 0) {
featureTable.featuresLength = numberOfPolygons;
var polygonCounts = defaultValue(
featureTable.getPropertyArray(
"POLYGON_COUNTS",
ComponentDatatype.UNSIGNED_INT,
1
),
featureTable.getPropertyArray(
"POLYGON_COUNT",
ComponentDatatype.UNSIGNED_INT,
1
) // Workaround for old vector tilesets using the non-plural name
);
if (!defined(polygonCounts)) {
throw new RuntimeError(
"Feature table property: POLYGON_COUNTS must be defined when POLYGONS_LENGTH is greater than 0"
);
}
var polygonIndexCounts = defaultValue(
featureTable.getPropertyArray(
"POLYGON_INDEX_COUNTS",
ComponentDatatype.UNSIGNED_INT,
1
),
featureTable.getPropertyArray(
"POLYGON_INDEX_COUNT",
ComponentDatatype.UNSIGNED_INT,
1
) // Workaround for old vector tilesets using the non-plural name
);
if (!defined(polygonIndexCounts)) {
throw new RuntimeError(
"Feature table property: POLYGON_INDEX_COUNTS must be defined when POLYGONS_LENGTH is greater than 0"
);
}
// Use the counts array to determine how many position values we want. If we used the byte length then
// zero padding values would be included and cause the delta zig-zag decoding to fail
var numPolygonPositions = polygonCounts.reduce(function (total, count) {
return total + count * 2;
}, 0);
var numPolygonIndices = polygonIndexCounts.reduce(function (total, count) {
return total + count;
}, 0);
var indices = new Uint32Array(arrayBuffer, byteOffset, numPolygonIndices);
byteOffset += indicesByteLength;
var polygonPositions = new Uint16Array(
arrayBuffer,
byteOffset,
numPolygonPositions
);
byteOffset += positionByteLength;
var polygonMinimumHeights;
var polygonMaximumHeights;
if (
defined(featureTableJson.POLYGON_MINIMUM_HEIGHTS) &&
defined(featureTableJson.POLYGON_MAXIMUM_HEIGHTS)
) {
polygonMinimumHeights = featureTable.getPropertyArray(
"POLYGON_MINIMUM_HEIGHTS",
ComponentDatatype.FLOAT,
1
);
polygonMaximumHeights = featureTable.getPropertyArray(
"POLYGON_MAXIMUM_HEIGHTS",
ComponentDatatype.FLOAT,
1
);
}
content._polygons = new Vector3DTilePolygons({
positions: polygonPositions,
counts: polygonCounts,
indexCounts: polygonIndexCounts,
indices: indices,
minimumHeight: minHeight,
maximumHeight: maxHeight,
polygonMinimumHeights: polygonMinimumHeights,
polygonMaximumHeights: polygonMaximumHeights,
center: center,
rectangle: rectangle,
boundingVolume: content.tile.boundingVolume.boundingVolume,
batchTable: batchTable,
batchIds: batchIds.polygons,
modelMatrix: modelMatrix,
});
}
if (numberOfPolylines > 0) {
featureTable.featuresLength = numberOfPolylines;
var polylineCounts = defaultValue(
featureTable.getPropertyArray(
"POLYLINE_COUNTS",
ComponentDatatype.UNSIGNED_INT,
1
),
featureTable.getPropertyArray(
"POLYLINE_COUNT",
ComponentDatatype.UNSIGNED_INT,
1
) // Workaround for old vector tilesets using the non-plural name
);
if (!defined(polylineCounts)) {
throw new RuntimeError(
"Feature table property: POLYLINE_COUNTS must be defined when POLYLINES_LENGTH is greater than 0"
);
}
var widths = featureTable.getPropertyArray(
"POLYLINE_WIDTHS",
ComponentDatatype.UNSIGNED_SHORT,
1
);
if (!defined(widths)) {
widths = new Uint16Array(numberOfPolylines);
for (var i = 0; i < numberOfPolylines; ++i) {
widths[i] = 2.0;
}
}
// Use the counts array to determine how many position values we want. If we used the byte length then
// zero padding values would be included and cause the delta zig-zag decoding to fail
var numPolylinePositions = polylineCounts.reduce(function (total, count) {
return total + count * 3;
}, 0);
var polylinePositions = new Uint16Array(
arrayBuffer,
byteOffset,
numPolylinePositions
);
byteOffset += polylinePositionByteLength;
var tileset = content._tileset;
var examineVectorLinesFunction = tileset.examineVectorLinesFunction;
if (defined(examineVectorLinesFunction)) {
var decodedPositions = decodeVectorPolylinePositions(
new Uint16Array(polylinePositions),
rectangle,
minHeight,
maxHeight,
Ellipsoid.WGS84
);
examineVectorLines(
decodedPositions,
polylineCounts,
batchIds.polylines,
batchTable,
content.url,
examineVectorLinesFunction
);
}
var createPolylines = createFloatingPolylines;
if (defined(tileset.classificationType)) {
createPolylines = createClampedPolylines;
}
content._polylines = createPolylines({
positions: polylinePositions,
widths: widths,
counts: polylineCounts,
batchIds: batchIds.polylines,
minimumHeight: minHeight,
maximumHeight: maxHeight,
center: center,
rectangle: rectangle,
boundingVolume: content.tile.boundingVolume.boundingVolume,
batchTable: batchTable,
tileset: tileset,
});
}
if (numberOfPoints > 0) {
var pointPositions = new Uint16Array(
arrayBuffer,
byteOffset,
numberOfPoints * 3
);
byteOffset += pointsPositionByteLength;
content._points = new Vector3DTilePoints({
positions: pointPositions,
batchIds: batchIds.points,
minimumHeight: minHeight,
maximumHeight: maxHeight,
rectangle: rectangle,
batchTable: batchTable,
});
}
}
function createFeatures(content) {
var featuresLength = content.featuresLength;
if (!defined(content._features) && featuresLength > 0) {
var features = new Array(featuresLength);
if (defined(content._polygons)) {
content._polygons.createFeatures(content, features);
}
if (defined(content._polylines)) {
content._polylines.createFeatures(content, features);
}
if (defined(content._points)) {
content._points.createFeatures(content, features);
}
content._features = features;
}
}
Vector3DTileContent.prototype.hasProperty = function (batchId, name) {
return this._batchTable.hasProperty(batchId, name);
};
Vector3DTileContent.prototype.getFeature = function (batchId) {
//>>includeStart('debug', pragmas.debug);
var featuresLength = this.featuresLength;
if (!defined(batchId) || batchId < 0 || batchId >= featuresLength) {
throw new DeveloperError(
"batchId is required and between zero and featuresLength - 1 (" +
(featuresLength - 1) +
")."
);
}
//>>includeEnd('debug');
createFeatures(this);
return this._features[batchId];
};
Vector3DTileContent.prototype.applyDebugSettings = function (enabled, color) {
if (defined(this._polygons)) {
this._polygons.applyDebugSettings(enabled, color);
}
if (defined(this._polylines)) {
this._polylines.applyDebugSettings(enabled, color);
}
if (defined(this._points)) {
this._points.applyDebugSettings(enabled, color);
}
};
Vector3DTileContent.prototype.applyStyle = function (style) {
createFeatures(this);
if (defined(this._polygons)) {
this._polygons.applyStyle(style, this._features);
}
if (defined(this._polylines)) {
this._polylines.applyStyle(style, this._features);
}
if (defined(this._points)) {
this._points.applyStyle(style, this._features);
}
};
Vector3DTileContent.prototype.update = function (tileset, frameState) {
var ready = true;
if (defined(this._polygons)) {
this._polygons.classificationType = this._tileset.classificationType;
this._polygons.debugWireframe = this._tileset.debugWireframe;
this._polygons.update(frameState);
ready = ready && this._polygons._ready;
}
if (defined(this._polylines)) {
this._polylines.update(frameState);
ready = ready && this._polylines._ready;
}
if (defined(this._points)) {
this._points.update(frameState);
ready = ready && this._points._ready;
}
if (defined(this._batchTable) && ready) {
this._batchTable.update(tileset, frameState);
}
if (!defined(this._contentReadyPromise)) {
var pointsPromise = defined(this._points)
? this._points.readyPromise
: undefined;
var polygonPromise = defined(this._polygons)
? this._polygons.readyPromise
: undefined;
var polylinePromise = defined(this._polylines)
? this._polylines.readyPromise
: undefined;
var that = this;
this._contentReadyPromise = when
.all([pointsPromise, polygonPromise, polylinePromise])
.then(function () {
that._readyPromise.resolve(that);
})
.otherwise(function (error) {
that._readyPromise.reject(error);
});
}
};
Vector3DTileContent.prototype.isDestroyed = function () {
return false;
};
Vector3DTileContent.prototype.destroy = function () {
this._polygons = this._polygons && this._polygons.destroy();
this._polylines = this._polylines && this._polylines.destroy();
this._points = this._points && this._points.destroy();
this._batchTable = this._batchTable && this._batchTable.destroy();
return destroyObject(this);
};
function examineVectorLines(
positions,
counts,
batchIds,
batchTable,
url,
callback
) {
var countsLength = counts.length;
var polylineStart = 0;
for (var i = 0; i < countsLength; i++) {
var count = counts[i] * 3;
var linePositions = positions.slice(polylineStart, polylineStart + count);
polylineStart += count;
callback(linePositions, batchIds[i], url, batchTable);
}
}
export default Vector3DTileContent;