bruce-cesium 7.0.8 → 7.1.0

package/dist/bruce-cesium.es5.js

@@ -1,6 +1,6 @@
 import * as Cesium from 'cesium';
-import { Cartographic, ColorMaterialProperty, Entity, Color, ConstantProperty, CallbackProperty, Primitive, Cesium3DTileFeature, DistanceDisplayCondition, HeightReference, ColorBlendMode, HeadingPitchRoll, Math as Math$1, Transforms, ShadowMode, Cartesian3, ClassificationType, Model, ArcType, CornerType, ConstantPositionProperty, HorizontalOrigin, VerticalOrigin, ImageMaterialProperty, PolygonHierarchy, PolylineGraphics, Cartesian2, SceneTransforms, NearFarScalar, JulianDate, Quaternion, Matrix3, KmlDataSource, Matrix4, Rectangle, SceneMode, GeoJsonDataSource, Cesium3DTileStyle, Cesium3DTileColorBlendMode, HeadingPitchRange, Ion, IonResource, Cesium3DTileset, OrthographicFrustum, EasingFunction, EllipsoidTerrainProvider, IonImageryProvider, createWorldImagery, createWorldImageryAsync, BingMapsImageryProvider, BingMapsStyle, MapboxImageryProvider, MapboxStyleImageryProvider, ArcGisMapServerImageryProvider, OpenStreetMapImageryProvider, UrlTemplateImageryProvider, GridImageryProvider, GeographicTilingScheme, ImageryLayer, TileMapServiceImageryProvider, CesiumTerrainProvider, EllipsoidGeodesic, sampleTerrainMostDetailed, defined, PolygonPipeline, ModelGraphics, PolygonGraphics, CorridorGraphics, PointGraphics, BillboardGraphics, EllipseGraphics, PolylineDashMaterialProperty, CesiumInspector, ClockRange, ScreenSpaceEventHandler, ScreenSpaceEventType, BoundingSphere, CustomDataSource, GeometryInstance, Fullscreen, Intersect, CzmlDataSource } from 'cesium';
-import { Cartes, Entity as Entity$1, ENVIRONMENT, Calculator, ClientFile, EntityLod, EntityTag, EntityType, LRUCache, ObjectUtils, Style, Carto, Geometry, Api, MenuItem, ProjectView, ProjectViewBookmark, Tileset, ZoomControl, Bounds, Color as Color$1, BruceEvent, EntityCoords, DelayQueue, EntityHistoricData, DataLab, EntityRelation, AccountConcept, RecordChangeFeed, BruceApi, ProgramKey, EntitySource, Camera, ProjectViewTile, ProjectViewLegacyTile, Session, EntityAttachment, EntityAttachmentType, EntityAttribute, MathUtils, EntityRelationType } from 'bruce-models';
+import { Cartographic, Entity, DistanceDisplayCondition, HeightReference, ColorBlendMode, Color, CallbackProperty, HeadingPitchRoll, Math as Math$1, Transforms, ShadowMode, ConstantProperty, Cartesian3, ClassificationType, Model, ArcType, CornerType, ConstantPositionProperty, ColorMaterialProperty, Primitive, Cesium3DTileFeature, JulianDate, Quaternion, Matrix4, ImageMaterialProperty, PolygonHierarchy, PolylineGraphics, HorizontalOrigin, VerticalOrigin, Cartesian2, SceneTransforms, NearFarScalar, Matrix3, Rectangle, KmlDataSource, GeoJsonDataSource, SceneMode, Cesium3DTileStyle, HeadingPitchRange, Ion, IonResource, Cesium3DTileset, Cesium3DTileColorBlendMode, BoundingSphere, Intersect, EllipsoidTerrainProvider, IonImageryProvider, createWorldImagery, createWorldImageryAsync, BingMapsImageryProvider, BingMapsStyle, MapboxImageryProvider, MapboxStyleImageryProvider, ArcGisMapServerImageryProvider, OpenStreetMapImageryProvider, UrlTemplateImageryProvider, GridImageryProvider, GeographicTilingScheme, ImageryLayer, TileMapServiceImageryProvider, CesiumTerrainProvider, OrthographicFrustum, EasingFunction, EllipsoidGeodesic, sampleTerrainMostDetailed, defined, ModelGraphics, PolygonGraphics, CorridorGraphics, PointGraphics, BillboardGraphics, EllipseGraphics, PolylineDashMaterialProperty, PolygonPipeline, CustomDataSource, CesiumInspector, ClockRange, GeometryInstance, ScreenSpaceEventHandler, ScreenSpaceEventType, Fullscreen, CzmlDataSource } from 'cesium';
+import { Cartes, Entity as Entity$1, ENVIRONMENT, Calculator, ClientFile, EntityLod, EntityTag, EntityType, LRUCache, ObjectUtils, Style, Carto, Geometry, Bounds, Color as Color$1, MenuItem, ProjectView, ProjectViewBookmark, Tileset, ZoomControl, Api, BruceEvent, EntityCoords, DataLab, DelayQueue, EntityHistoricData, BruceApi, EntityRelation, AccountConcept, RecordChangeFeed, EntitySource, ProgramKey, ProjectViewTile, ProjectViewLegacyTile, Camera, EntityAttachment, EntityAttachmentType, EntityAttribute, MathUtils, Session, EntityRelationType } from 'bruce-models';
 
 /**
  * Ensures a number is returned from a given value.
@@ -6323,6 +6323,7 @@ const LAST_RECHECK_KEY = Symbol("LAST_RECHECK_KEY");
 // Attached to a cesium viewer to indicate a re-check should be done.
 // This is to override the cache that avoids re-checking when the camera hasn't moved.
 const SHOULD_RECHECK_KEY = Symbol("SHOULD_RECHECK_KEY");
+const RECHECK_KICK_KEY = Symbol("RECHECK_KICK_KEY");
 /**
  * We will recheck if the camera has turned or moved enough.
  * @param viewer
@@ -6469,6 +6470,8 @@ function runCullChecker(register) {
         }
         const toRemove = [];
         const toAdd = [];
+        // Entities the register has to re-evaluate, because the culler cannot restore a `show` it did not set.
+        const toRefresh = new Set();
         const isIsolatedAny = register.GetIsIsolatedAny();
         const slice = entityIds.splice(0, CHECK_BATCH);
         for (let i = 0; i < slice.length; i++) {
@@ -6517,6 +6520,12 @@ function runCullChecker(register) {
                             (!isIsolatedAny || state.isolated)) {
                             toAdd.push(part);
                         }
+                        else if (part.show === false &&
+                            rego.overrideShow != false &&
+                            !state.hidden &&
+                            (!isIsolatedAny || state.isolated)) {
+                            toRefresh.add(entityId);
+                        }
                     }
                 }
             }
@@ -6527,6 +6536,11 @@ function runCullChecker(register) {
         if (toAdd.length > 0) {
             addEntities(viewer, toAdd);
         }
+        if (toRefresh.size > 0) {
+            register.ForceUpdate({
+                entityIds: Array.from(toRefresh)
+            });
+        }
         if (entityIds.length <= 0) {
             clearInterval(checkInterval);
             checkInterval = null;
@@ -6613,6 +6627,7 @@ var VisualRegisterCuller;
             runCullChecker(register);
             lastCullCheck = new Date();
         }, 1000);
+        register.Viewer[RECHECK_KICK_KEY] = () => { var _a; return (_a = checkQueue === null || checkQueue === void 0 ? void 0 : checkQueue.Call) === null || _a === void 0 ? void 0 : _a.call(checkQueue); };
         let moveStartRemoval = register.Viewer.camera.moveStart.addEventListener(() => {
             var _a;
             (_a = checkQueue.Call) === null || _a === void 0 ? void 0 : _a.call(checkQueue);
@@ -6655,6 +6670,9 @@ var VisualRegisterCuller;
             checkWaiting = false;
             checkQueue === null || checkQueue === void 0 ? void 0 : checkQueue.Dispose();
             checkQueue = null;
+            if (register.Viewer) {
+                delete register.Viewer[RECHECK_KICK_KEY];
+            }
         };
     }
     VisualRegisterCuller.Monitor = Monitor;
@@ -6745,13 +6763,25 @@ var VisualRegisterCuller;
             return false;
         }
         if (visual instanceof Entity) {
-            return visual[VisualRegisterCuller.VISUAL_CULL_KEY] == true;
+            if (visual[VisualRegisterCuller.VISUAL_CULL_KEY] != true) {
+                return false;
+            }
+            // Invalidated, so the decision above was measured from geometry that no longer describes this.
+            return boundingSphereCache.Get(visual.id) != null;
         }
         return false;
     }
     VisualRegisterCuller.IsCulled = IsCulled;
+    /**
+     * Asks for the next cull pass to actually re-measure, and brings that pass forward.
+     */
     function MarkShouldRecheck(viewer) {
+        var _a, _b;
+        if (!viewer || ((_a = viewer.isDestroyed) === null || _a === void 0 ? void 0 : _a.call(viewer))) {
+            return;
+        }
         viewer[SHOULD_RECHECK_KEY] = true;
+        (_b = viewer[RECHECK_KICK_KEY]) === null || _b === void 0 ? void 0 : _b.call(viewer);
     }
     VisualRegisterCuller.MarkShouldRecheck = MarkShouldRecheck;
 })(VisualRegisterCuller || (VisualRegisterCuller = {}));
@@ -8210,6 +8240,26 @@ var VisualsRegister;
                 CesiumEntityStyler.UpdateColorSetting("highlight", color);
             }
         }
+        /**
+         * Whether any rego for this entity is currently held as being edited.
+         */
+        IsEditing(params) {
+            const { entityId, menuItemId } = params;
+            const regos = this.rego[entityId];
+            if (!(regos === null || regos === void 0 ? void 0 : regos.length)) {
+                return false;
+            }
+            for (let i = 0; i < regos.length; i++) {
+                const rego = regos[i];
+                if (menuItemId && rego.menuItemId !== menuItemId) {
+                    continue;
+                }
+                if (rego.editing) {
+                    return true;
+                }
+            }
+            return false;
+        }
         /**
          * Marks visuals as being actively edited, which exempts them from culling until it is turned back off.
          */
@@ -8230,12 +8280,15 @@ var VisualsRegister;
                     if (menuItemId && rego.menuItemId !== menuItemId) {
                         continue;
                     }
-                    if (Boolean(rego.editing) == Boolean(editing)) {
+                    const wasEditing = Boolean(rego.editing);
+                    if (wasEditing == Boolean(editing) && editing) {
                         continue;
                     }
                     // Null rather than false, so the rego does not carry a key for every visual ever edited.
                     rego.editing = editing ? true : null;
-                    changed = true;
+                    if (wasEditing != Boolean(editing)) {
+                        changed = true;
+                    }
                     if (editing) {
                         const parts = EntityUtils.GatherEntity({
                             entity: rego.visual
@@ -8254,7 +8307,6 @@ var VisualsRegister;
                         }
                     }
                     else {
-                        // The geometry almost certainly moved, so what was measured before is worthless.
                         VisualRegisterCuller.InvalidateBounds(rego.visual);
                         VisualRegisterCuller.MarkShouldRecheck(this.viewer);
                     }
@@ -8730,6 +8782,9 @@ var VisualsRegister;
             // Tilesets will often add -> remove -> add because of how tiles load in and out of the scene.
             // To avoid flickering, we'll just replace rather than remove -> add.
             if (!rego.tilesetId && params.removePrior != false) {
+                if (!rego.editing && this.IsEditing({ entityId: rego.entityId, menuItemId: rego.menuItemId })) {
+                    rego.editing = true;
+                }
                 this.RemoveRegos({
                     entityId: rego.entityId,
                     menuItemId: rego.menuItemId,
@@ -34757,6 +34812,54 @@ var EntityUtils;
         });
     }
     EntityUtils.GetPosAsync = GetPosAsync;
+    // Graphics that take a heightReference, and so get a cached terrain offset from Cesium.
+    const GROUND_REFERENCED_GRAPHICS = ["ellipse", "polygon", "corridor", "rectangle", "box", "cylinder", "ellipsoid"];
+    const HEIGHT_REFERENCE_KEYS = ["heightReference", "extrudedHeightReference"];
+    /**
+     * Makes a moved graphic sample the ground again at where it now is.
+     *
+     * Reassigning the height references touches an observed property, so the updater discards the stale offset
+     * and builds a new one against the current position.
+     * @returns whether anything was refreshed.
+     */
+    function RefreshGroundClamping(params) {
+        var _a, _b;
+        const { viewer, visual } = params;
+        if (!viewer || ((_a = viewer.isDestroyed) === null || _a === void 0 ? void 0 : _a.call(viewer)) || !(visual instanceof Entity)) {
+            return false;
+        }
+        const parts = GatherEntity({ entity: visual });
+        let refreshed = false;
+        for (let i = 0; i < parts.length; i++) {
+            const part = parts[i];
+            if (!(part instanceof Entity)) {
+                continue;
+            }
+            for (let j = 0; j < GROUND_REFERENCED_GRAPHICS.length; j++) {
+                const graphic = part[GROUND_REFERENCED_GRAPHICS[j]];
+                if (!graphic) {
+                    continue;
+                }
+                for (let k = 0; k < HEIGHT_REFERENCE_KEYS.length; k++) {
+                    const key = HEIGHT_REFERENCE_KEYS[k];
+                    const current = GetValue$1(viewer, graphic[key]);
+                    // Nothing to resample for a graphic that does not follow the ground.
+                    if (current == null || current === HeightReference.NONE) {
+                        continue;
+                    }
+                    // A new property instance rather than the same value written back, since an equal value would
+                    // be dropped as a no-op and the updater would never hear about it.
+                    graphic[key] = new ConstantProperty(current);
+                    refreshed = true;
+                }
+            }
+        }
+        if (refreshed) {
+            (_b = viewer.scene) === null || _b === void 0 ? void 0 : _b.requestRender();
+        }
+        return refreshed;
+    }
+    EntityUtils.RefreshGroundClamping = RefreshGroundClamping;
     /**
      * Returns entity and any associated parent/sibling entities as a flat array.
      * @param entity
@@ -34947,7 +35050,9 @@ var EntityUtils;
             viewer: params.viewer,
             createIfMissing: true
         });
-        const location = await EntityUtils.GetLocation({
+        // A tileset-only fly-to has no entities to sample from, so there's nothing to resolve here.
+        // The tileset's own bounding sphere is used further down instead.
+        const location = (entityIds === null || entityIds === void 0 ? void 0 : entityIds.length) ? await EntityUtils.GetLocation({
             samples: entityIds.map((id) => ({
                 entityId: id,
                 entity: entityLookup.get(id),
@@ -34958,7 +35063,7 @@ var EntityUtils;
             visualRegister: manager.VisualsRegister,
             minimumAlt: params.minimumAlt,
             api: manager.Getters.GetBruceApi()
-        });
+        }) : null;
         if (params.isCancelled && params.isCancelled()) {
             return;
         }
@@ -39695,6 +39800,7 @@ var EntityRenderEngine;
             }
             VisualRegisterCuller.InvalidateBounds(cEntity);
         });
+        VisualRegisterCuller.MarkShouldRecheck(params.viewer);
         return {
             entities: cEntities,
             updated
@@ -40463,7 +40569,7 @@ var StyleUtils;
     StyleUtils.ApplyTypeStyle = ApplyTypeStyle;
 })(StyleUtils || (StyleUtils = {}));
 
-const VERSION = "7.0.8";
+const VERSION = "7.1.0";
 /**
  * Updates the environment instance used by bruce-cesium to one specified.
  * This can be used to ensure that the instance a parent is referencing is shared between bruce-cesium, bruce-models, and the parent app.
@@ -40480,5 +40586,5 @@ const getENVIRONMENT = () => {
     return ENVIRONMENT;
 };
 
-export { VERSION, setENVIRONMENT, getENVIRONMENT, CesiumAnimatedInOut, CesiumAnimatedProperty, isStyleChanged, isOutlineChanged$1 as isOutlineChanged, StyleEffective, EntityRenderEngine, EntityRenderEngineModel3d, EntityRenderEnginePoint, EntityRenderEnginePolygon, EntityRenderEnginePolyline, MenuItemCreator, MenuItemManager, CesiumParabola, EntityLabel, LiveCursor, SharedGetters, DataSourceStaticKmlManager, DataLabRenderManager, EntitiesIdsRenderManager, EntitiesLoadedRenderManager, EntitiesRenderManager, EntityRenderManager, AssemblyRenderManager, GoogleSearchRenderManager, RelationsRenderManager, RenderManager, TilesetArbRenderManager, TilesetCadRenderManager, TilesetEntitiesRenderManager, TilesetGooglePhotosRenderManager, TilesetOsmRenderManager, TilesetPointcloudRenderManager, TileRenderEngine, createTileset, TilesetRenderEngine, ViewRenderEngine, VisualsRegister, XGridsRenderEngine, CesiumEntityStyler, DrawingUtils, EntityUtils, MeasureUtils, StyleUtils, CESIUM_INSPECTOR_KEY, CESIUM_TIMELINE_KEY, CESIUM_TIMELINE_LIVE_KEY, CESIUM_TIMELINE_LIVE_PADDING_KEY, CESIUM_TIMELINE_INTERVAL_KEY, CESIUM_MODEL_SPACE_KEY, DEFAULT_LIVE_PADDING_SECONDS, ViewUtils, CesiumViewMonitor, ViewGroundArea, ViewerEventTracker, ViewerUtils, Draw3dPolygon, Draw3dPolyline, MeasureCreator, Walkthrough, WidgetControlViewBar, WidgetControlViewBarSearch, WidgetLeftPanelTab, WidgetLeftPanelTabBookmarks, Widget, VIEWER_BOOKMARKS_WIDGET_KEY, WidgetBookmarks, WidgetBranding, WidgetCursorBar, WidgetEmbeddedInfoView, WidgetInfoView, VIEWER_LEFT_PANEL_WIDGET_KEY, VIEWER_LEFT_PANEL_CSS_VAR_LEFT, WidgetLeftPanel, WidgetNavCompass$$1 as WidgetNavCompass, VIEWER_VIEW_BAR_WIDGET_KEY, WidgetViewBar };
+export { VERSION, setENVIRONMENT, getENVIRONMENT, CesiumAnimatedInOut, CesiumAnimatedProperty, isStyleChanged, isOutlineChanged$1 as isOutlineChanged, StyleEffective, EntityRenderEngine, EntityRenderEngineModel3d, EntityRenderEnginePoint, EntityRenderEnginePolygon, EntityRenderEnginePolyline, MenuItemCreator, MenuItemManager, CesiumParabola, EntityLabel, LiveCursor, SharedGetters, DataSourceStaticKmlManager, DataLabRenderManager, EntitiesIdsRenderManager, EntitiesLoadedRenderManager, EntitiesRenderManager, EntityRenderManager, AssemblyRenderManager, GoogleSearchRenderManager, RelationsRenderManager, RenderManager, TilesetArbRenderManager, TilesetCadRenderManager, TilesetEntitiesRenderManager, TilesetGooglePhotosRenderManager, TilesetOsmRenderManager, TilesetPointcloudRenderManager, TileRenderEngine, createTileset, TilesetRenderEngine, ViewRenderEngine, VisualRegisterCuller, VisualsRegister, XGridsRenderEngine, CesiumEntityStyler, DrawingUtils, EntityUtils, MeasureUtils, StyleUtils, CESIUM_INSPECTOR_KEY, CESIUM_TIMELINE_KEY, CESIUM_TIMELINE_LIVE_KEY, CESIUM_TIMELINE_LIVE_PADDING_KEY, CESIUM_TIMELINE_INTERVAL_KEY, CESIUM_MODEL_SPACE_KEY, DEFAULT_LIVE_PADDING_SECONDS, ViewUtils, CesiumViewMonitor, ViewGroundArea, ViewerEventTracker, ViewerUtils, Draw3dPolygon, Draw3dPolyline, MeasureCreator, Walkthrough, WidgetControlViewBar, WidgetControlViewBarSearch, WidgetLeftPanelTab, WidgetLeftPanelTabBookmarks, Widget, VIEWER_BOOKMARKS_WIDGET_KEY, WidgetBookmarks, WidgetBranding, WidgetCursorBar, WidgetEmbeddedInfoView, WidgetInfoView, VIEWER_LEFT_PANEL_WIDGET_KEY, VIEWER_LEFT_PANEL_CSS_VAR_LEFT, WidgetLeftPanel, WidgetNavCompass$$1 as WidgetNavCompass, VIEWER_VIEW_BAR_WIDGET_KEY, WidgetViewBar };
 //# sourceMappingURL=bruce-cesium.es5.js.map