bruce-cesium 3.0.8 → 3.1.0

package/dist/bruce-cesium.es5.js

@@ -1,6 +1,6 @@
 import { BruceEvent, Cartes, ProjectViewTile, Carto, Entity as Entity$1, Geometry, Tileset, MathUtils, LRUCache, ZoomControl, Style, EntityTag, Calculator, EntityLod, EntityType, ClientFile, ObjectUtils, Bounds, EntityRelationType, DelayQueue, EntityCoords, Api, EntitySource, MenuItem, EntityRelation, ENVIRONMENT, ProjectView, ProjectViewBookmark, ProjectViewLegacyTile, ProgramKey, Camera, AbstractApi, EntityAttachment, EntityAttachmentType, EntityAttribute } from 'bruce-models';
 import * as Cesium from 'cesium';
-import { Cartographic, Cartesian2, CallbackProperty, Cartesian3, Color, Rectangle, Math as Math$1, JulianDate, SceneMode, Entity, Primitive, Cesium3DTileFeature, Cesium3DTileColorBlendMode, HeadingPitchRange, HeightReference, DistanceDisplayCondition, NearFarScalar, HorizontalOrigin, VerticalOrigin, ClassificationType, ArcType, CornerType, ShadowMode, PolygonHierarchy, PolylineGraphics, HeadingPitchRoll, Transforms, ColorBlendMode, Model, createOsmBuildings, Cesium3DTileStyle, KmlDataSource, SceneTransforms, OrthographicFrustum, EasingFunction, EllipsoidTerrainProvider, CesiumInspector, defined, createWorldTerrain, CesiumTerrainProvider, BingMapsImageryProvider, BingMapsStyle, MapboxImageryProvider, MapboxStyleImageryProvider, ArcGisMapServerImageryProvider, OpenStreetMapImageryProvider, GridImageryProvider, GeographicTilingScheme, ImageryLayer, UrlTemplateImageryProvider, TileMapServiceImageryProvider, IonImageryProvider, EllipsoidGeodesic, sampleTerrainMostDetailed, Cesium3DTileset, ScreenSpaceEventHandler, ScreenSpaceEventType, PolygonPipeline, Matrix4, Matrix3, IonResource, Ion, ColorMaterialProperty, GeometryInstance, BoundingSphere, Intersect } from 'cesium';
+import { Cartographic, Cartesian2, CallbackProperty, Cartesian3, Color, Rectangle, Math as Math$1, HeightReference, DistanceDisplayCondition, NearFarScalar, Entity, HorizontalOrigin, VerticalOrigin, ClassificationType, ArcType, CornerType, ShadowMode, PolygonHierarchy, PolylineGraphics, HeadingPitchRoll, Transforms, ColorBlendMode, Model, JulianDate, SceneMode, Primitive, Cesium3DTileFeature, Cesium3DTileColorBlendMode, HeadingPitchRange, createOsmBuildings, Cesium3DTileStyle, KmlDataSource, SceneTransforms, OrthographicFrustum, EasingFunction, createWorldTerrain, EllipsoidTerrainProvider, CesiumTerrainProvider, BingMapsImageryProvider, BingMapsStyle, MapboxImageryProvider, MapboxStyleImageryProvider, ArcGisMapServerImageryProvider, OpenStreetMapImageryProvider, GridImageryProvider, GeographicTilingScheme, ImageryLayer, UrlTemplateImageryProvider, TileMapServiceImageryProvider, IonImageryProvider, Cesium3DTileset, Matrix4, Matrix3, IonResource, Ion, CesiumInspector, defined, PolygonPipeline, EllipsoidGeodesic, sampleTerrainMostDetailed, ColorMaterialProperty, GeometryInstance, ScreenSpaceEventHandler, ScreenSpaceEventType, BoundingSphere, Intersect } from 'cesium';
 
 var TIME_LAG = 300;
 var POSITION_CHECK_TIMER = 950;
@@ -507,15 +507,23 @@ var DrawingUtils;
      * @returns
      */
     function GetTerrainHeight(params) {
+        var _a;
         return __awaiter(this, void 0, void 0, function () {
-            var pos3d, viewer, sample, height, e_1;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
+            var pos3d, viewer, terrainProviderReady, sample, height, e_1;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
                     case 0:
                         pos3d = params.pos3d, viewer = params.viewer;
-                        _a.label = 1;
+                        _b.label = 1;
                     case 1:
-                        _a.trys.push([1, 3, , 4]);
+                        _b.trys.push([1, 3, , 4]);
+                        terrainProviderReady = Boolean((_a = viewer === null || viewer === void 0 ? void 0 : viewer.terrainProvider) === null || _a === void 0 ? void 0 : _a.ready);
+                        if (!terrainProviderReady) {
+                            return [2 /*return*/, {
+                                    height: 0,
+                                    error: "Terrain provider not ready."
+                                }];
+                        }
                         if (viewer.scene.terrainProvider instanceof EllipsoidTerrainProvider) {
                             return [2 /*return*/, {
                                     height: 0
@@ -523,7 +531,7 @@ var DrawingUtils;
                         }
                         return [4 /*yield*/, sampleTerrainMostDetailed(viewer.scene.terrainProvider, [Cartographic.fromCartesian(pos3d)])];
                     case 2:
-                        sample = _a.sent();
+                        sample = _b.sent();
                         height = (sample === null || sample === void 0 ? void 0 : sample.length) ? sample[0].height : null;
                         if (isNaN(height)) {
                             return [2 /*return*/, {
@@ -535,7 +543,7 @@ var DrawingUtils;
                                 height: height
                             }];
                     case 3:
-                        e_1 = _a.sent();
+                        e_1 = _b.sent();
                         return [2 /*return*/, {
                                 height: 0,
                                 error: e_1
@@ -706,12 +714,17 @@ var DrawingUtils;
      * @param minimumHeight height relative to ground
      */
     function RaisePos3d(viewer, pos3d, minimumHeight) {
+        var _a;
         if (minimumHeight === void 0) { minimumHeight = 0; }
         return __awaiter(this, void 0, void 0, function () {
-            var carto, terrainCarto, sample, terrainHeight;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
+            var terrainProviderReady, carto, terrainCarto, sample, terrainHeight;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
                     case 0:
+                        terrainProviderReady = Boolean((_a = viewer === null || viewer === void 0 ? void 0 : viewer.terrainProvider) === null || _a === void 0 ? void 0 : _a.ready);
+                        if (!terrainProviderReady) {
+                            return [2 /*return*/, pos3d];
+                        }
                         carto = Cartographic.fromCartesian(pos3d);
                         terrainCarto = carto.clone();
                         terrainCarto.height = 0;
@@ -720,12 +733,12 @@ var DrawingUtils;
                         return [3 /*break*/, 3];
                     case 1: return [4 /*yield*/, sampleTerrainMostDetailed(viewer.scene.terrainProvider, [terrainCarto])];
                     case 2:
-                        sample = _a.sent();
+                        sample = _b.sent();
                         terrainHeight = (sample === null || sample === void 0 ? void 0 : sample.length) ? sample[0].height : null;
                         if (terrainHeight != null) {
                             carto.height = Math.max(carto.height, terrainHeight + minimumHeight);
                         }
-                        _a.label = 3;
+                        _b.label = 3;
                     case 3: return [2 /*return*/, Cartesian3.fromRadians(carto.longitude, carto.latitude, carto.height)];
                 }
             });
@@ -806,7 +819,7 @@ var ViewUtils;
     function GatherTerrainTile(params) {
         var viewer = params.viewer;
         var provider = viewer.terrainProvider;
-        if (provider._bMeta) {
+        if (provider === null || provider === void 0 ? void 0 : provider._bMeta) {
             return {
                 terrain: {
                     accountId: provider._bMeta.accountId,
@@ -1112,12 +1125,12 @@ var EntityUtils;
      * @param params
      */
     function GetLocation(params) {
-        var _a;
+        var _a, _b;
         return __awaiter(this, void 0, void 0, function () {
-            var api, viewer, samples, visualRegister, minimumAlt, paddingAlt, MAX_DISTANCE_BETWEEN_SAMPLES, MAX_TERRAIN_SAMPLES, terrainSamples, MAX_API_CALLS, apiCalls, MAX_VALID_SAMPLES, validSamples, MIN_RECT_DIAGONAL_LENGTH, data, processPosHeight, ensureHeightRefs, getEntityPositions, allPosses, i, sample, samplePosses, valid, j, samplePos, k, allPos, distance, rect, factor, marginX, marginY, diagonalLen, terrData, posCarto, height, MIN_POSSES_LEN;
+            var api, viewer, samples, visualRegister, minimumAlt, paddingAlt, MAX_DISTANCE_BETWEEN_SAMPLES, MAX_TERRAIN_SAMPLES, terrainSamples, MAX_API_CALLS, apiCalls, MAX_VALID_SAMPLES, validSamples, MIN_RECT_DIAGONAL_LENGTH, terrainProviderReady, data, processPosHeight, ensureHeightRefs, getEntityPositions, allPosses, i, sample, samplePosses, valid, j, samplePos, k, allPos, distance, rect, factor, marginX, marginY, diagonalLen, terrData, posCarto, height, MIN_POSSES_LEN;
             var _this = this;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
+            return __generator(this, function (_c) {
+                switch (_c.label) {
                     case 0:
                         api = params.api, viewer = params.viewer, samples = params.samples, visualRegister = params.visualRegister, minimumAlt = params.minimumAlt, paddingAlt = params.paddingAlt;
                         if (!paddingAlt) {
@@ -1134,6 +1147,7 @@ var EntityUtils;
                         if (MIN_RECT_DIAGONAL_LENGTH < 1500) {
                             MIN_RECT_DIAGONAL_LENGTH = 1500;
                         }
+                        terrainProviderReady = Boolean((_a = viewer === null || viewer === void 0 ? void 0 : viewer.terrainProvider) === null || _a === void 0 ? void 0 : _a.ready);
                         data = {
                             pos3d: null,
                             rectangle: null
@@ -1143,11 +1157,12 @@ var EntityUtils;
                             return __generator(this, function (_a) {
                                 switch (_a.label) {
                                     case 0:
-                                        if (!(!isNaN(minimumAlt) && minimumAlt != null)) return [3 /*break*/, 5];
+                                        if (!(!isNaN(minimumAlt) && minimumAlt != null)) return [3 /*break*/, 7];
                                         carto = Cartographic.fromCartesian(pos3d);
-                                        if (!(carto === null || carto === void 0 ? void 0 : carto.latitude)) return [3 /*break*/, 4];
+                                        if (!(carto === null || carto === void 0 ? void 0 : carto.latitude)) return [3 /*break*/, 6];
                                         baseHeight = 0;
-                                        if (!(heightRef == null || heightRef == HeightReference.RELATIVE_TO_GROUND || heightRef == HeightReference.NONE)) return [3 /*break*/, 3];
+                                        if (!(heightRef == null || heightRef == HeightReference.RELATIVE_TO_GROUND || heightRef == HeightReference.NONE)) return [3 /*break*/, 5];
+                                        if (!terrainProviderReady) return [3 /*break*/, 4];
                                         if (!(terrainSamples > MAX_TERRAIN_SAMPLES)) return [3 /*break*/, 1];
                                         baseHeight = viewer.scene.globe.getHeight(carto);
                                         return [3 /*break*/, 3];
@@ -1160,7 +1175,11 @@ var EntityUtils;
                                         baseHeight = terrData === null || terrData === void 0 ? void 0 : terrData.height;
                                         terrainSamples += 1;
                                         _a.label = 3;
-                                    case 3:
+                                    case 3: return [3 /*break*/, 5];
+                                    case 4:
+                                        baseHeight = 0;
+                                        _a.label = 5;
+                                    case 5:
                                         if (baseHeight != undefined && !isNaN(baseHeight)) {
                                             height = baseHeight + minimumAlt;
                                             if (height > carto.height) {
@@ -1168,17 +1187,17 @@ var EntityUtils;
                                             }
                                             return [2 /*return*/, Cartesian3.fromRadians(carto.longitude, carto.latitude, carto.height + paddingAlt)];
                                         }
-                                        _a.label = 4;
-                                    case 4: return [3 /*break*/, 6];
-                                    case 5:
+                                        _a.label = 6;
+                                    case 6: return [3 /*break*/, 8];
+                                    case 7:
                                         if (paddingAlt) {
                                             carto = Cartographic.fromCartesian(pos3d);
                                             if (carto === null || carto === void 0 ? void 0 : carto.latitude) {
                                                 return [2 /*return*/, Cartesian3.fromRadians(carto.longitude, carto.latitude, carto.height + paddingAlt)];
                                             }
                                         }
-                                        _a.label = 6;
-                                    case 6: return [2 /*return*/, pos3d];
+                                        _a.label = 8;
+                                    case 8: return [2 /*return*/, pos3d];
                                 }
                             });
                         }); };
@@ -1216,67 +1235,36 @@ var EntityUtils;
                             });
                         }); };
                         getEntityPositions = function (sample) { return __awaiter(_this, void 0, void 0, function () {
-                            var entityId, entity, tileset, tilesetId, lat, lon, e_1, e_2, evaluateRendered, evaluateRecord, renderedPosses, recordPosses, tSettings, pos3d, alt, alt, heading, pitch, roll, matrix4, offset, m1, hpr, transform, transformedOffset;
+                            var entityId, entity, tileset, tilesetId, e_1, evaluateRendered, evaluateRecord, renderedPosses, recordPosses, e_2, tSettings, pos3d, alt, alt, heading, pitch, roll, matrix4, offset, m1, hpr, transform, transformedOffset;
                             var _this = this;
-                            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
-                            return __generator(this, function (_o) {
-                                switch (_o.label) {
+                            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+                            return __generator(this, function (_l) {
+                                switch (_l.label) {
                                     case 0:
                                         entityId = sample.entityId, entity = sample.entity, tileset = sample.tileset, tilesetId = sample.tilesetId;
-                                        if (!!entity) return [3 /*break*/, 9];
-                                        lat = 0;
-                                        lon = 0;
-                                        if (!(apiCalls < MAX_API_CALLS)) return [3 /*break*/, 9];
-                                        // Counting this whole area as a single call because it has a single purpose.
+                                        if (!!entity) return [3 /*break*/, 4];
+                                        if (!(apiCalls < MAX_API_CALLS)) return [3 /*break*/, 4];
                                         apiCalls += 1;
-                                        _o.label = 1;
+                                        _l.label = 1;
                                     case 1:
-                                        _o.trys.push([1, 3, , 4]);
+                                        _l.trys.push([1, 3, , 4]);
                                         return [4 /*yield*/, Entity$1.Get({
                                                 api: api,
                                                 entityId: entityId,
+                                                // Not expanding relative positions at first to see if the entity has valid location just by itself.
                                                 expandLocation: false
                                             })];
                                     case 2:
-                                        entity = (_o.sent()).entity;
-                                        lat = +((_a = entity === null || entity === void 0 ? void 0 : entity.location) === null || _a === void 0 ? void 0 : _a.latitude);
-                                        lon = +((_b = entity === null || entity === void 0 ? void 0 : entity.location) === null || _b === void 0 ? void 0 : _b.longitude);
+                                        entity = (_l.sent()).entity;
                                         return [3 /*break*/, 4];
                                     case 3:
-                                        e_1 = _o.sent();
+                                        e_1 = _l.sent();
                                         console.error(e_1);
                                         return [3 /*break*/, 4];
                                     case 4:
-                                        if (!(entity && (isNaN(lat) || isNaN(lon) || (lat == 0 && lon == 0)))) return [3 /*break*/, 9];
-                                        _o.label = 5;
-                                    case 5:
-                                        _o.trys.push([5, 7, , 9]);
-                                        return [4 /*yield*/, Entity$1.Get({
-                                                api: api,
-                                                entityId: entityId,
-                                                expandLocation: true
-                                            })];
-                                    case 6:
-                                        entity = (_o.sent()).entity;
-                                        return [3 /*break*/, 9];
-                                    case 7:
-                                        e_2 = _o.sent();
-                                        console.warn(e_2);
-                                        return [4 /*yield*/, Entity$1.Get({
-                                                api: api,
-                                                entityId: entityId,
-                                                expandLocation: false
-                                            })];
-                                    case 8:
-                                        entity = (_o.sent()).entity;
-                                        return [3 /*break*/, 9];
-                                    case 9:
                                         if (!entity) {
                                             return [2 /*return*/, []];
                                         }
-                                        if (!tilesetId) {
-                                            tilesetId = ((_c = entity.tilesetID) === null || _c === void 0 ? void 0 : _c.length) ? entity.tilesetID[0] : tilesetId;
-                                        }
                                         evaluateRendered = function () { return __awaiter(_this, void 0, void 0, function () {
                                             var rego, posses, visual, visualHeightRef, hierarchy, hPosses, hPossesSample, step, i, pPosses, pPossesSample, step, i, pPosses, pPossesSample, step, i, pos3d_1;
                                             return __generator(this, function (_a) {
@@ -1299,7 +1287,7 @@ var EntityUtils;
                                                         if (!(hierarchy === null || hierarchy === void 0 ? void 0 : hierarchy.positions)) return [3 /*break*/, 3];
                                                         hPosses = hierarchy.positions.map(function (x) { return x.clone ? x.clone() : x; });
                                                         hPossesSample = [];
-                                                        step = Math.floor(hPosses.length / 5);
+                                                        step = Math.max(1, Math.floor(hPosses.length / 5));
                                                         for (i = 0; i < hPosses.length; i += step) {
                                                             hPossesSample.push(hPosses[i]);
                                                         }
@@ -1318,7 +1306,7 @@ var EntityUtils;
                                                         // Grab 5 positions from the polyline at varied indexes.
                                                         pPosses = pPosses.map(function (x) { return x.clone ? x.clone() : x; });
                                                         pPossesSample = [];
-                                                        step = Math.floor(pPosses.length / 5);
+                                                        step = Math.max(1, Math.floor(pPosses.length / 5));
                                                         for (i = 0; i < pPosses.length; i += step) {
                                                             pPossesSample.push(pPosses[i]);
                                                         }
@@ -1340,7 +1328,7 @@ var EntityUtils;
                                                         // Grab 5 positions from the corridor at varied indexes.
                                                         pPosses = pPosses.map(function (x) { return x.clone ? x.clone() : x; });
                                                         pPossesSample = [];
-                                                        step = Math.floor(pPosses.length / 5);
+                                                        step = Math.max(1, Math.floor(pPosses.length / 5));
                                                         for (i = 0; i < pPosses.length; i += step) {
                                                             pPossesSample.push(pPosses[i]);
                                                         }
@@ -1446,32 +1434,54 @@ var EntityUtils;
                                             });
                                         }); };
                                         return [4 /*yield*/, evaluateRendered()];
-                                    case 10:
-                                        renderedPosses = _o.sent();
+                                    case 5:
+                                        renderedPosses = _l.sent();
                                         if (renderedPosses === null || renderedPosses === void 0 ? void 0 : renderedPosses.length) {
                                             return [2 /*return*/, renderedPosses];
                                         }
                                         return [4 /*yield*/, evaluateRecord()];
-                                    case 11:
-                                        recordPosses = _o.sent();
+                                    case 6:
+                                        recordPosses = _l.sent();
                                         if (recordPosses === null || recordPosses === void 0 ? void 0 : recordPosses.length) {
                                             return [2 /*return*/, recordPosses];
                                         }
-                                        if (!!tileset) return [3 /*break*/, 13];
-                                        if (!(tilesetId && apiCalls < MAX_API_CALLS)) return [3 /*break*/, 13];
+                                        if (!(apiCalls < MAX_API_CALLS)) return [3 /*break*/, 10];
+                                        _l.label = 7;
+                                    case 7:
+                                        _l.trys.push([7, 9, , 10]);
+                                        apiCalls += 1;
+                                        return [4 /*yield*/, Entity$1.Get({
+                                                api: api,
+                                                entityId: entityId,
+                                                // We'll be expanding relative positioning and related tilesets now.
+                                                expandLocation: true
+                                            })];
+                                    case 8:
+                                        entity = (_l.sent()).entity;
+                                        return [3 /*break*/, 10];
+                                    case 9:
+                                        e_2 = _l.sent();
+                                        console.warn(e_2);
+                                        return [3 /*break*/, 10];
+                                    case 10:
+                                        if (!tilesetId) {
+                                            tilesetId = ((_a = entity.tilesetID) === null || _a === void 0 ? void 0 : _a.length) ? entity.tilesetID[0] : tilesetId;
+                                        }
+                                        if (!!tileset) return [3 /*break*/, 12];
+                                        if (!(tilesetId && apiCalls < MAX_API_CALLS)) return [3 /*break*/, 12];
                                         apiCalls += 1;
                                         return [4 /*yield*/, Tileset.Get({
                                                 api: api,
                                                 tilesetId: tilesetId
                                             })];
+                                    case 11:
+                                        tileset = (_l.sent()).tileset;
+                                        _l.label = 12;
                                     case 12:
-                                        tileset = (_o.sent()).tileset;
-                                        _o.label = 13;
-                                    case 13:
                                         tSettings = tileset === null || tileset === void 0 ? void 0 : tileset.settings;
                                         pos3d = null;
-                                        if (!(((_d = entity.location) === null || _d === void 0 ? void 0 : _d.longitude) || ((_e = tSettings === null || tSettings === void 0 ? void 0 : tSettings.location) === null || _e === void 0 ? void 0 : _e.longitude))) return [3 /*break*/, 15];
-                                        if ((_f = entity === null || entity === void 0 ? void 0 : entity.location) === null || _f === void 0 ? void 0 : _f.longitude) {
+                                        if (!(((_b = entity === null || entity === void 0 ? void 0 : entity.location) === null || _b === void 0 ? void 0 : _b.longitude) || ((_c = tSettings === null || tSettings === void 0 ? void 0 : tSettings.location) === null || _c === void 0 ? void 0 : _c.longitude))) return [3 /*break*/, 14];
+                                        if ((_d = entity === null || entity === void 0 ? void 0 : entity.location) === null || _d === void 0 ? void 0 : _d.longitude) {
                                             alt = +entity.location.altitude;
                                             if (isNaN(alt)) {
                                                 alt = 0;
@@ -1485,26 +1495,26 @@ var EntityUtils;
                                             }
                                             pos3d = Cartesian3.fromDegrees(+tSettings.location.longitude, +tSettings.location.latitude, alt);
                                         }
-                                        if (!(entity === null || entity === void 0 ? void 0 : entity.worldPosition)) return [3 /*break*/, 15];
+                                        if (!(entity === null || entity === void 0 ? void 0 : entity.worldPosition)) return [3 /*break*/, 14];
                                         heading = 0;
                                         pitch = 0;
                                         roll = 0;
-                                        if ((_g = entity === null || entity === void 0 ? void 0 : entity.transform) === null || _g === void 0 ? void 0 : _g.heading) {
+                                        if ((_e = entity === null || entity === void 0 ? void 0 : entity.transform) === null || _e === void 0 ? void 0 : _e.heading) {
                                             heading = entity.transform.heading;
                                         }
-                                        else if ((_h = tSettings === null || tSettings === void 0 ? void 0 : tSettings.transform) === null || _h === void 0 ? void 0 : _h.heading) {
+                                        else if ((_f = tSettings === null || tSettings === void 0 ? void 0 : tSettings.transform) === null || _f === void 0 ? void 0 : _f.heading) {
                                             heading = tSettings.transform.heading;
                                         }
-                                        if ((_j = entity === null || entity === void 0 ? void 0 : entity.transform) === null || _j === void 0 ? void 0 : _j.pitch) {
+                                        if ((_g = entity === null || entity === void 0 ? void 0 : entity.transform) === null || _g === void 0 ? void 0 : _g.pitch) {
                                             pitch = entity.transform.pitch;
                                         }
-                                        else if ((_k = tSettings === null || tSettings === void 0 ? void 0 : tSettings.transform) === null || _k === void 0 ? void 0 : _k.pitch) {
+                                        else if ((_h = tSettings === null || tSettings === void 0 ? void 0 : tSettings.transform) === null || _h === void 0 ? void 0 : _h.pitch) {
                                             pitch = tSettings.transform.pitch;
                                         }
-                                        if ((_l = entity === null || entity === void 0 ? void 0 : entity.transform) === null || _l === void 0 ? void 0 : _l.roll) {
+                                        if ((_j = entity === null || entity === void 0 ? void 0 : entity.transform) === null || _j === void 0 ? void 0 : _j.roll) {
                                             roll = entity.transform.roll;
                                         }
-                                        else if ((_m = tSettings === null || tSettings === void 0 ? void 0 : tSettings.transform) === null || _m === void 0 ? void 0 : _m.roll) {
+                                        else if ((_k = tSettings === null || tSettings === void 0 ? void 0 : tSettings.transform) === null || _k === void 0 ? void 0 : _k.roll) {
                                             roll = tSettings.transform.roll;
                                         }
                                         heading = +heading;
@@ -1530,12 +1540,12 @@ var EntityUtils;
                                         transform = Matrix3.fromHeadingPitchRoll(hpr);
                                         transformedOffset = Matrix3.multiplyByVector(transform, offset, new Cartesian3());
                                         pos3d = Matrix4.multiplyByPoint(m1, transformedOffset, new Cartesian3());
-                                        if (!(pos3d === null || pos3d === void 0 ? void 0 : pos3d.x)) return [3 /*break*/, 15];
+                                        if (!(pos3d === null || pos3d === void 0 ? void 0 : pos3d.x)) return [3 /*break*/, 14];
                                         return [4 /*yield*/, processPosHeight(pos3d, HeightReference.NONE)];
+                                    case 13:
+                                        pos3d = _l.sent();
+                                        _l.label = 14;
                                     case 14:
-                                        pos3d = _o.sent();
-                                        _o.label = 15;
-                                    case 15:
                                         if (pos3d) {
                                             return [2 /*return*/, [pos3d]];
                                         }
@@ -1545,13 +1555,13 @@ var EntityUtils;
                         }); };
                         allPosses = [];
                         i = 0;
-                        _b.label = 1;
+                        _c.label = 1;
                     case 1:
                         if (!(i < samples.length)) return [3 /*break*/, 4];
                         sample = samples[i];
                         return [4 /*yield*/, getEntityPositions(sample)];
                     case 2:
-                        samplePosses = _b.sent();
+                        samplePosses = _c.sent();
                         if (samplePosses === null || samplePosses === void 0 ? void 0 : samplePosses.length) {
                             valid = !(allPosses === null || allPosses === void 0 ? void 0 : allPosses.length);
                             if (!valid) {
@@ -1578,7 +1588,7 @@ var EntityUtils;
                                 }
                             }
                         }
-                        _b.label = 3;
+                        _c.label = 3;
                     case 3:
                         i++;
                         return [3 /*break*/, 1];
@@ -1596,7 +1606,7 @@ var EntityUtils;
                             terrData = ViewUtils.GatherTerrainTile({
                                 viewer: viewer
                             });
-                            if (((_a = terrData === null || terrData === void 0 ? void 0 : terrData.terrain) === null || _a === void 0 ? void 0 : _a.tilesetId) == ProjectViewTile.EDefaultTerrain.FlatTerrain) {
+                            if (((_b = terrData === null || terrData === void 0 ? void 0 : terrData.terrain) === null || _b === void 0 ? void 0 : _b.tilesetId) == ProjectViewTile.EDefaultTerrain.FlatTerrain) {
                                 MIN_RECT_DIAGONAL_LENGTH = 0;
                             }
                             posCarto = Cartographic.fromCartesian(allPosses[0]);
@@ -2964,6 +2974,11 @@ var EntityRenderEngine;
             if (viewer.isDestroyed()) {
                 return;
             }
+            // Entity relations have an embedded dispose method.
+            if (entity === null || entity === void 0 ? void 0 : entity._dispose) {
+                entity._dispose();
+                entity._dispose = null;
+            }
             if (entity._parentEntity && !ignoreParent) {
                 doRemove({
                     viewer: viewer,
@@ -2994,6 +3009,10 @@ var EntityRenderEngine;
     EntityRenderEngine.Remove = Remove;
     var Point;
     (function (Point) {
+        function CreateCircleBillboard(params) {
+            return createCircleBillboard(params.size, params.colorCss);
+        }
+        Point.CreateCircleBillboard = CreateCircleBillboard;
         function Render(params) {
             return __awaiter(this, void 0, void 0, function () {
                 var entity, style, type, cEntity, siblings, iconUrlRows, icon, iconUrl_1, res, blob_1, e_4, e_5, iconScale, disableDepthTest, heightRef, radius, bFill, cFill, outline, cOutline, outlineWidth, bOutline, heightRef, pos3d, extrusion, outlineExtrusion, bColor, cColor, size, heightRef, circleBillboard;
@@ -3998,6 +4017,7 @@ var CesiumParabola = /** @class */ (function () {
         this.curPoints = [];
         this.animateInterval = null;
         this.retryTimeout = null;
+        this.hidden = false;
         this.viewer = params.viewer;
         this.pos1 = params.pos1;
         this.pos2 = params.pos2;
@@ -4015,6 +4035,20 @@ var CesiumParabola = /** @class */ (function () {
         }
         this.prepareEntities();
     }
+    Object.defineProperty(CesiumParabola.prototype, "Disposed", {
+        get: function () {
+            return this.disposed;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(CesiumParabola.prototype, "Hidden", {
+        set: function (value) {
+            this.hidden = value;
+        },
+        enumerable: false,
+        configurable: true
+    });
     Object.defineProperty(CesiumParabola.prototype, "curPos1", {
         get: function () {
             return this.pos1 instanceof Function ? this.pos1() : this.pos1;
@@ -4037,7 +4071,10 @@ var CesiumParabola = /** @class */ (function () {
                     return _this.curPoints;
                 }, false),
                 width: this.width,
-                material: Color.fromCssColorString(this.color)
+                material: Color.fromCssColorString(this.color),
+                show: new CallbackProperty(function () {
+                    return !_this.hidden;
+                }, false)
             }
         });
         var p1Entity = new Entity({
@@ -4049,7 +4086,10 @@ var CesiumParabola = /** @class */ (function () {
                 pixelSize: this.width * 1.3,
                 color: Color.fromCssColorString(this.color),
                 outlineColor: Color.WHITE,
-                outlineWidth: 2
+                outlineWidth: 2,
+                show: new CallbackProperty(function () {
+                    return !_this.hidden;
+                }, false)
             }
         });
         var p2Entity = new Entity({
@@ -4061,7 +4101,10 @@ var CesiumParabola = /** @class */ (function () {
                 pixelSize: this.width * 1.8,
                 color: Color.fromCssColorString(this.color),
                 outlineColor: Color.WHITE,
-                outlineWidth: 2
+                outlineWidth: 2,
+                show: new CallbackProperty(function () {
+                    return !_this.hidden;
+                }, false)
             }
         });
         p1Entity.parent = parabola;
@@ -4069,7 +4112,9 @@ var CesiumParabola = /** @class */ (function () {
         var siblings = [p1Entity, p2Entity];
         this.parabola = parabola;
         this.siblings = siblings;
-        this.viewer.entities.add(this.parabola);
+        // The parabola is hidden while this entity is not added.
+        // If we avoid adding it now, then the parent can control if the parabola is visible at first or not.
+        // this.viewer.entities.add(this.parabola);
         this.viewer.entities.add(p1Entity);
         this.viewer.entities.add(p2Entity);
     };
@@ -4498,7 +4543,7 @@ var RelationRenderEngine;
         function Render(params) {
             var _a;
             return __awaiter(this, void 0, void 0, function () {
-                var style, entity, bColor, cColor, width, duration, hDistanceRatio, fromPos, toPos, updatingPosses, updatePosses, parabola, cEntities, cEntity, i, sibling, updateInterval;
+                var style, entity, bColor, cColor, width, duration, hDistanceRatio, fromPos, toPos, updatingPosses, updatePosses, parabola, cEntities, cEntity, i, sibling, updateInterval, disposed;
                 var _this = this;
                 return __generator(this, function (_b) {
                     style = (_a = params.style) === null || _a === void 0 ? void 0 : _a.Settings;
@@ -4571,6 +4616,7 @@ var RelationRenderEngine;
                         duration: duration,
                         heightDistanceRatio: hDistanceRatio
                     });
+                    parabola.Hidden = true;
                     cEntities = parabola.Animate();
                     cEntity = cEntities.parabola;
                     cEntity._siblingGraphics = [];
@@ -4582,14 +4628,29 @@ var RelationRenderEngine;
                         var _a;
                         if (!((_a = params.viewer) === null || _a === void 0 ? void 0 : _a.scene) ||
                             params.viewer.isDestroyed() ||
-                            !params.viewer.entities.contains(cEntity)) {
+                            (!parabola || parabola.Disposed)) {
                             clearInterval(updateInterval);
                             parabola.Dispose();
                             return;
                         }
+                        if (parabola) {
+                            var visible = cEntity && cEntity.show != false && params.viewer.entities.contains(cEntity);
+                            parabola.Hidden = !visible;
+                        }
                         updatePosses();
                         params.viewer.scene.requestRender();
                     }, 1000);
+                    disposed = false;
+                    cEntity._dispose = function () {
+                        if (disposed) {
+                            return;
+                        }
+                        disposed = true;
+                        clearInterval(updateInterval);
+                        if (parabola) {
+                            parabola.Dispose();
+                        }
+                    };
                     return [2 /*return*/, cEntity];
                 });
             });
@@ -10517,6 +10578,10 @@ var SharedGetters;
             if (!getter) {
                 getter = new EntityFilterGetter.Getter(params.api, params.monitor, params.typeId, params.batchSize, params.attrFilter, params.cdn);
                 this.data[cacheKey] = getter;
+                /**
+                 * Debug option.
+                 * This will display the bounds of the cells that are being fetched.
+                 */
                 if (params.viewer && params.debugShowBounds) {
                     // Cell id -> entity.
                     var cellCache_1 = {};
@@ -12105,6 +12170,10 @@ var RelationsRenderManager;
                                 if (cEntity && !_this.viewer.isDestroyed() && _this.viewer.entities.contains(cEntity)) {
                                     _this.viewer.entities.remove(cEntity);
                                 }
+                                if (cEntity === null || cEntity === void 0 ? void 0 : cEntity._dispose) {
+                                    cEntity._dispose();
+                                    cEntity._dispose = null;
+                                }
                             };
                             return [4 /*yield*/, RelationRenderEngine.Render({
                                     apiGetter: this.apiGetter,
@@ -12517,6 +12586,10 @@ var LegacyRelationsRenderManager;
                                 if (cEntity && !_this.viewer.isDestroyed() && _this.viewer.entities.contains(cEntity)) {
                                     _this.viewer.entities.remove(cEntity);
                                 }
+                                if (cEntity === null || cEntity === void 0 ? void 0 : cEntity._dispose) {
+                                    cEntity._dispose();
+                                    cEntity._dispose = null;
+                                }
                             };
                             return [4 /*yield*/, RelationRenderEngine.Render({
                                     apiGetter: this.apiGetter,
@@ -15376,7 +15449,8 @@ function renderNavigator(iteration, params, bookmark, view) {
                         params.manager.VisualsRegister.SetSelected({
                             selected: true,
                             entityIds: selectedIds,
-                            refreshIfSelected: false
+                            refreshIfSelected: false,
+                            requestRender: false
                         });
                     }
                     params.manager.VisualsRegister.ClearHidden();
@@ -15387,7 +15461,8 @@ function renderNavigator(iteration, params, bookmark, view) {
                     if (hiddenIds != null) {
                         params.manager.VisualsRegister.SetHidden({
                             hidden: true,
-                            entityIds: hiddenIds
+                            entityIds: hiddenIds,
+                            requestRender: false
                         });
                     }
                     params.manager.VisualsRegister.ClearIsolated();
@@ -15398,7 +15473,8 @@ function renderNavigator(iteration, params, bookmark, view) {
                     if (isolatedIds != null) {
                         params.manager.VisualsRegister.SetIsolated({
                             isolated: true,
-                            entityIds: isolatedIds
+                            entityIds: isolatedIds,
+                            requestRender: false
                         });
                     }
                     labelledIds = bSettings === null || bSettings === void 0 ? void 0 : bSettings.labelledEntityIds;
@@ -15406,7 +15482,9 @@ function renderNavigator(iteration, params, bookmark, view) {
                         labelledIds = (_2 = defaults === null || defaults === void 0 ? void 0 : defaults.settings) === null || _2 === void 0 ? void 0 : _2.labelledEntityIds;
                     }
                     if (!(labelledIds === null || labelledIds === void 0 ? void 0 : labelledIds.length)) {
-                        params.manager.VisualsRegister.ClearLabelled();
+                        params.manager.VisualsRegister.ClearLabelled({
+                            requestRender: false
+                        });
                     }
                     else {
                         curLabelledIds = params.manager.VisualsRegister.GetLabelled();
@@ -15418,7 +15496,8 @@ function renderNavigator(iteration, params, bookmark, view) {
                         toUnLabel = curLabelledIds.filter(function (id) { return labelledIds.indexOf(id) === -1; });
                         params.manager.VisualsRegister.SetLabelled({
                             labelled: false,
-                            entityIds: toUnLabel
+                            entityIds: toUnLabel,
+                            requestRender: false
                         });
                     }
                     params.manager.VisualsRegister.ClearOpacity();
@@ -15432,7 +15511,8 @@ function renderNavigator(iteration, params, bookmark, view) {
                             if (opacity != 1) {
                                 params.manager.VisualsRegister.SetOpacity({
                                     entityIds: [entityId],
-                                    opacity: opacity
+                                    opacity: opacity,
+                                    requestRender: false
                                 });
                             }
                         }
@@ -15467,6 +15547,7 @@ function renderNavigator(iteration, params, bookmark, view) {
                     if (!relations) {
                         relations = [];
                     }
+                    viewer.scene.requestRender();
                     curEnabled = params.manager.GetEnabledItemIds();
                     newItemIds = (_5 = bSettings === null || bSettings === void 0 ? void 0 : bSettings.menuItemIds) !== null && _5 !== void 0 ? _5 : [];
                     for (_i = 0, curEnabled_1 = curEnabled; _i < curEnabled_1.length; _i++) {
@@ -18455,7 +18536,7 @@ var ViewerUtils;
     ViewerUtils.CreateWidgets = CreateWidgets;
 })(ViewerUtils || (ViewerUtils = {}));
 
-var VERSION$1 = "3.0.8";
+var VERSION$1 = "3.1.0";
 
 export { VERSION$1 as VERSION, CesiumViewMonitor, ViewerUtils, MenuItemManager, EntityRenderEngine, MenuItemCreator, VisualsRegister, RenderManager, EntitiesIdsRenderManager, EntitiesLoadedRenderManager, EntitiesRenderManager, EntityRenderManager, TilesetCadRenderManager, TilesetArbRenderManager, TilesetEntitiesRenderManager, TilesetOsmRenderManager, TilesetPointcloudRenderManager, TilesetGooglePhotosRenderManager, DataSourceStaticKmlManager, RelationsRenderManager, SharedGetters, CesiumParabola, EntityLabel, ViewRenderEngine, TileRenderEngine, TilesetRenderEngine, CESIUM_INSPECTOR_KEY, ViewUtils, DrawingUtils, MeasureUtils, EntityUtils, Draw3dPolygon, Draw3dPolyline };
 //# sourceMappingURL=bruce-cesium.es5.js.map