bruce-cesium 6.9.7 → 6.9.9

package/dist/lib/rendering/texture-frame-series-animator.js

@@ -0,0 +1,281 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TextureFrameSeriesAnimator = void 0;
+const bruce_models_1 = require("bruce-models");
+const Cesium = require("cesium");
+const image_utils_1 = require("../internal/image-utils");
+var TextureFrameSeriesAnimator;
+(function (TextureFrameSeriesAnimator) {
+    /**
+     * Detects whether a ClientFile's `Data.generation` metadata describes a frame archive rather than a single static image,
+     * so a caller can decide whether to construct an Animator or fall back to the existing static-texture path.
+     * @param data ClientFile.Data (the `IFile.Data` field), as returned by ClientFile.Get().
+     */
+    function IsFrameArchiveMetadata(data) {
+        return Boolean(data && data.generation && Array.isArray(data.generation.Frames) && data.generation.Frames.length > 0);
+    }
+    TextureFrameSeriesAnimator.IsFrameArchiveMetadata = IsFrameArchiveMetadata;
+    const DEFAULT_CROSSFADE_MS = 900;
+    const DEFAULT_LOW_COLOR = { red: 255, green: 255, blue: 255, alpha: 0.12 };
+    const DEFAULT_HIGH_COLOR = { red: 21, green: 96, blue: 196, alpha: 0.92 };
+    class Animator {
+        constructor(options) {
+            var _a;
+            this.removeOnTick = null;
+            this.removeCrossfadeTick = null;
+            this.disposed = false;
+            this.currentFrameIndex = -1;
+            // Single-in-flight fetch queue: only one Range GET outstanding at a time, and the NEXT one
+            // is chosen right before sending, this is what makes reprioritizing mid-scrub take effect
+            // immediately instead of draining a backlog of stale requests first.
+            this.inFlightIndex = -1;
+            this.pendingIndex = -1;
+            this.displayedPixels = null;
+            this.fadeFromPixels = null;
+            this.fadeToIndex = -1;
+            this.fadeToDims = null;
+            this.fadeStartMs = null;
+            // Two-canvas pool: Cesium compares image references each frame, so alternating between
+            // pool[0]/pool[1] gives a new object reference whenever we actually present a new frame,
+            // forcing Cesium to re-upload the texture only when something changed.
+            this.pool = [document.createElement("canvas"), document.createElement("canvas")];
+            this.poolIdx = 0;
+            if (!options.entity.polygon) {
+                throw new Error("TextureFrameSeriesAnimator requires an entity with polygon graphics.");
+            }
+            if (!options.frames || options.frames.length === 0) {
+                throw new Error("TextureFrameSeriesAnimator requires at least one frame.");
+            }
+            this.viewer = options.viewer;
+            this.entity = options.entity;
+            this.archiveUrl = options.archiveUrl;
+            this.frames = options.frames;
+            this.crossfadeMs = (_a = options.crossfadeMs) !== null && _a !== void 0 ? _a : DEFAULT_CROSSFADE_MS;
+            const mask = options.textureColorMask;
+            this.lowColor = (mask && bruce_models_1.Color.ColorFromStr(mask.minColor)) || DEFAULT_LOW_COLOR;
+            this.highColor = (mask && bruce_models_1.Color.ColorFromStr(mask.maxColor)) || DEFAULT_HIGH_COLOR;
+            this.frameDates = this.frames.map((f) => Cesium.JulianDate.fromIso8601(f.Timestamp));
+            this.frameCache = new Array(this.frames.length).fill(null);
+            this.frameDims = new Array(this.frames.length).fill(null);
+            this.originalMaterial = options.entity.polygon.material;
+            this.imageProperty = new Cesium.CallbackProperty(() => this.pool[this.poolIdx], false);
+            options.entity.polygon.material = new Cesium.ImageMaterialProperty({ image: this.imageProperty, transparent: true });
+            this.removeCrossfadeTick = this.viewer.scene.postUpdate.addEventListener(() => this.tickCrossfade());
+            this.removeOnTick = this.viewer.clock.onTick.addEventListener((clock) => this.onClockTick(clock.currentTime));
+            this.onClockTick(this.viewer.clock.currentTime);
+        }
+        /**
+         * Explicit teardown: stops driving the entity's material, abandons any in-flight/pending fetch (results are simply ignored when they land),
+         * and restores whatever material the entity had before construction. Never called automatically.
+         */
+        Dispose() {
+            if (this.disposed) {
+                return;
+            }
+            this.disposed = true;
+            if (this.removeOnTick) {
+                this.removeOnTick();
+                this.removeOnTick = null;
+            }
+            if (this.removeCrossfadeTick) {
+                this.removeCrossfadeTick();
+                this.removeCrossfadeTick = null;
+            }
+            if (this.entity && this.entity.polygon) {
+                this.entity.polygon.material = this.originalMaterial;
+            }
+        }
+        IsDisposed() {
+            return this.disposed;
+        }
+        /**
+         * The archive URL this instance was constructed with,
+         * lets a caller re-rendering the same entity tell whether an existing instance is already correct, without reaching into private state.
+         */
+        GetArchiveUrl() {
+            return this.archiveUrl;
+        }
+        onClockTick(currentTime) {
+            if (this.disposed) {
+                return;
+            }
+            this.swapToFrame(this.findFrameIndex(currentTime));
+        }
+        // Binary-search the frame whose timestamp is <= currentTime.
+        findFrameIndex(currentTime) {
+            const dates = this.frameDates;
+            let lo = 0;
+            let hi = dates.length - 1;
+            if (Cesium.JulianDate.lessThanOrEquals(currentTime, dates[0])) {
+                return 0;
+            }
+            if (Cesium.JulianDate.greaterThanOrEquals(currentTime, dates[hi])) {
+                return hi;
+            }
+            while (lo < hi) {
+                const mid = (lo + hi + 1) >> 1;
+                if (Cesium.JulianDate.lessThanOrEquals(dates[mid], currentTime)) {
+                    lo = mid;
+                }
+                else {
+                    hi = mid - 1;
+                }
+            }
+            return lo;
+        }
+        // Called with the discrete target frame (never a fractional/interpolated index).
+        // Scrubbing rapidly just retargets what's fetched next.
+        swapToFrame(idx) {
+            if (idx === this.currentFrameIndex) {
+                return;
+            }
+            this.currentFrameIndex = idx;
+            if (this.frameCache[idx]) {
+                this.beginCrossfadeTo(idx);
+                return;
+            }
+            this.ensureFrame(idx);
+        }
+        ensureFrame(idx) {
+            if (this.frameCache[idx]) {
+                return;
+            }
+            if (this.inFlightIndex === idx) {
+                return;
+            }
+            this.pendingIndex = idx;
+            this.pumpFetchQueue();
+        }
+        // Nearest still-uncached frame to wherever the viewer CURRENTLY is.
+        nearestUncachedFrame() {
+            const n = this.frameCache.length;
+            if (this.currentFrameIndex < 0) {
+                return this.frameCache[0] ? -1 : 0;
+            }
+            for (let d = 0; d < n; d++) {
+                const forward = this.currentFrameIndex + d;
+                if (forward < n && !this.frameCache[forward]) {
+                    return forward;
+                }
+                const backward = this.currentFrameIndex - d;
+                if (backward >= 0 && !this.frameCache[backward]) {
+                    return backward;
+                }
+            }
+            return -1;
+        }
+        pumpFetchQueue() {
+            if (this.disposed || this.inFlightIndex !== -1) {
+                return;
+            }
+            let next = -1;
+            if (this.pendingIndex !== -1) {
+                next = this.pendingIndex;
+                this.pendingIndex = -1;
+            }
+            else {
+                next = this.nearestUncachedFrame();
+            }
+            if (next === -1) {
+                return;
+            }
+            this.inFlightIndex = next;
+            this.fetchAndTint(next)
+                .catch(() => {
+                // Eating it.
+            })
+                .finally(() => {
+                this.inFlightIndex = -1;
+                if (!this.disposed) {
+                    this.pumpFetchQueue();
+                }
+            });
+        }
+        async fetchAndTint(idx) {
+            const entry = this.frames[idx];
+            const start = entry.ByteOffset;
+            const end = entry.ByteOffset + entry.ByteLength - 1;
+            const response = await fetch(this.archiveUrl, { headers: { Range: `bytes=${start}-${end}` } });
+            const buffer = await response.arrayBuffer();
+            if (this.disposed) {
+                return;
+            }
+            const decoded = await this.decodeAndTint(buffer);
+            if (this.disposed) {
+                return;
+            }
+            this.frameCache[idx] = decoded.pixels;
+            this.frameDims[idx] = { width: decoded.width, height: decoded.height };
+            if (idx === this.currentFrameIndex) {
+                this.beginCrossfadeTo(idx);
+            }
+        }
+        /**
+         * Decodes one frame's raw PNG bytes (as returned by a Range GET) and applies the grayscale color mask.
+         */
+        async decodeAndTint(buffer) {
+            const blob = new Blob([buffer], { type: "image/png" });
+            const objectUrl = URL.createObjectURL(blob);
+            let image;
+            try {
+                image = await (0, image_utils_1.loadImage)(objectUrl);
+            }
+            finally {
+                URL.revokeObjectURL(objectUrl);
+            }
+            const canvas = document.createElement("canvas");
+            canvas.width = image.width;
+            canvas.height = image.height;
+            const ctx = canvas.getContext("2d");
+            ctx.drawImage(image, 0, 0);
+            const imageData = ctx.getImageData(0, 0, canvas.width, canvas.height);
+            (0, image_utils_1.ApplyGrayscaleColorMask)(imageData, this.lowColor, this.highColor);
+            return { pixels: imageData.data, width: canvas.width, height: canvas.height };
+        }
+        beginCrossfadeTo(idx) {
+            const to = this.frameCache[idx];
+            this.fadeFromPixels = this.displayedPixels === null ? new Uint8ClampedArray(to.length) : this.displayedPixels;
+            this.fadeToIndex = idx;
+            this.fadeToDims = this.frameDims[idx];
+            this.fadeStartMs = Now();
+        }
+        tickCrossfade() {
+            if (this.disposed || this.fadeStartMs === null) {
+                return;
+            }
+            const t = Math.min(1, (Now() - this.fadeStartMs) / this.crossfadeMs);
+            const eased = easeInOutQuad(t);
+            const from = this.fadeFromPixels;
+            const to = this.frameCache[this.fadeToIndex];
+            const n = Math.min(from.length, to.length);
+            const blended = new Uint8ClampedArray(to.length);
+            for (let i = 0; i < n; i++) {
+                blended[i] = from[i] + (to[i] - from[i]) * eased;
+            }
+            this.presentPixels(blended, this.fadeToDims);
+            if (t >= 1) {
+                this.fadeStartMs = null;
+                this.fadeFromPixels = null;
+            }
+        }
+        presentPixels(pixels, dims) {
+            this.poolIdx = 1 - this.poolIdx;
+            const target = this.pool[this.poolIdx];
+            target.width = dims.width;
+            target.height = dims.height;
+            const ctx = target.getContext("2d");
+            const imgData = ctx.createImageData(dims.width, dims.height);
+            imgData.data.set(pixels);
+            ctx.putImageData(imgData, 0, 0);
+            this.displayedPixels = pixels;
+        }
+    }
+    TextureFrameSeriesAnimator.Animator = Animator;
+    function easeInOutQuad(t) {
+        return t < 0.5 ? 2 * t * t : 1 - Math.pow(-2 * t + 2, 2) / 2;
+    }
+    function Now() {
+        return typeof performance !== "undefined" ? performance.now() : Date.now();
+    }
+})(TextureFrameSeriesAnimator = exports.TextureFrameSeriesAnimator || (exports.TextureFrameSeriesAnimator = {}));
+//# sourceMappingURL=texture-frame-series-animator.js.map

package/dist/lib/rendering/texture-frame-series-animator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"texture-frame-series-animator.js","sourceRoot":"","sources":["../../../src/rendering/texture-frame-series-animator.ts"],"names":[],"mappings":"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"}

package/dist/types/bruce-cesium.d.ts

@@ -60,7 +60,7 @@ export * from "./widgets/widget-info-view";
 export * from "./widgets/widget-left-panel";
 export * from "./widgets/widget-nav-compass";
 export * from "./widgets/widget-view-bar";
-export declare const VERSION = "6.9.7";
+export declare const VERSION = "6.9.9";
 /**
  * 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.

package/dist/types/internal/image-utils.d.ts

@@ -0,0 +1,10 @@
+import { Color } from "bruce-models";
+/**
+ * Remaps a (assumed grayscale, server-rendered black-to-white) image's pixels into a gradient between minColor/maxColor,
+ * preserving source alpha blended with the mask's own alpha.
+ * @param imageData
+ * @param minColor
+ * @param maxColor
+ */
+export declare function ApplyGrayscaleColorMask(imageData: ImageData, minColor: Color.IColor, maxColor: Color.IColor): void;
+export declare function loadImage(src: string): Promise<HTMLImageElement>;

package/dist/types/internal/series-segment.d.ts

@@ -0,0 +1,10 @@
+export interface ISeriesSegment {
+    key: string;
+    min: Date;
+    max: Date;
+    label?: string;
+}
+export interface ISeriesUpdate {
+    itemId: string;
+    segments: ISeriesSegment[];
+}

package/dist/types/rendering/entity-render-engine-polygon.d.ts

@@ -2,6 +2,7 @@ import { BruceApi, Entity, EntityTag, IDictionary, Style, ZoomControl } from "br
 import * as Cesium from "cesium";
 import { EntityRenderEngine } from "./entity-render-engine";
 import { VisualsRegister } from "./visuals-register";
+import { ISeriesSegment } from "../internal/series-segment";
 export declare namespace EntityRenderEnginePolygon {
     interface IParams {
         rendered?: EntityRenderEngine.ICesiumEntityExt;
@@ -12,10 +13,13 @@ export declare namespace EntityRenderEnginePolygon {
         viewer: Cesium.Viewer;
         maxDistance?: number;
         minDistance?: number;
+        menuItemId?: string;
+        onSeriesDiscovered?: (segment: ISeriesSegment) => void;
     }
     interface IGroupParams {
         apiGetter: BruceApi.IGetter;
         menuItemId: string;
+        onSeriesDiscovered?: (segment: ISeriesSegment) => void;
         entities: Entity.IEntity[];
         zoomItems: IDictionary<ZoomControl.IItem>;
         visualRegister: VisualsRegister.Register;

package/dist/types/rendering/entity-render-engine.d.ts

@@ -5,6 +5,7 @@ import { EntityRenderEnginePoint } from "./entity-render-engine-point";
 import { EntityRenderEngineModel3d } from "./entity-render-engine-model3d";
 import { EntityRenderEnginePolyline } from "./entity-render-engine-polyline";
 import { EntityRenderEnginePolygon } from "./entity-render-engine-polygon";
+import { ISeriesSegment } from "../internal/series-segment";
 export declare function isStyleChanged(rego: VisualsRegister.IVisualRego, zoomItem: ZoomControl.IItem): boolean;
 export declare function isOutlineChanged(rego: VisualsRegister.IVisualRego, entity: Entity.IEntity): boolean;
 /**
@@ -74,6 +75,7 @@ export declare namespace EntityRenderEngine {
         viewer: Cesium.Viewer;
         visualRegister: VisualsRegister.Register;
         menuItemId: string;
+        onSeriesDiscovered?: (segment: ISeriesSegment) => void;
         zoomControl: ZoomControl.IItem[];
         entities: Entity.IEntity[];
         entitiesHistoric?: IDictionary<EntityHistoricData.IData[]>;

package/dist/types/rendering/menu-item-manager.d.ts

@@ -1,5 +1,6 @@
 import { ApiGetters, BruceApi, BruceEvent, Entity, MenuItem } from "bruce-models";
 import * as Cesium from "cesium";
+import * as SeriesSegmentTypes from "../internal/series-segment";
 import { RenderManager } from "./render-managers/render-manager";
 import { VisualsRegister } from "./visuals-register";
 import { CesiumViewMonitor } from "../viewer/cesium-view-monitor";
@@ -19,6 +20,8 @@ export declare namespace MenuItemManager {
         itemId: string;
         isEnabling: boolean;
     }
+    export import ISeriesSegment = SeriesSegmentTypes.ISeriesSegment;
+    export import ISeriesUpdate = SeriesSegmentTypes.ISeriesUpdate;
     class Manager {
         private getters;
         get Getters(): ApiGetters;
@@ -30,6 +33,22 @@ export declare namespace MenuItemManager {
         get VisualsRegister(): VisualsRegister.Register;
         private onUpdate;
         get OnUpdate(): BruceEvent<IMenuItemUpdate>;
+        private seriesSegments;
+        private onSeriesUpdated;
+        get OnSeriesUpdated(): BruceEvent<ISeriesUpdate>;
+        /**
+         * Currently known series segments for a menu item (empty array if none discovered yet).
+         */
+        GetSeriesSegments(itemId: string): ISeriesSegment[];
+        /**
+         * @param itemId
+         * @param segment
+         */
+        RecordSeriesSegment(itemId: string, segment: ISeriesSegment): void;
+        /**
+         * Clears any series segments recorded for a menu item, eg when it's disabled/removed.
+         */
+        ClearSeriesSegments(itemId: string): void;
         private sharedGetters;
         private sharedMonitor;
         private tilesetInitQueue;

package/dist/types/rendering/render-managers/entities/entities-render-manager.d.ts

@@ -1,5 +1,6 @@
 import { BruceApi, Entity, MenuItem, ZoomControl } from "bruce-models";
 import * as Cesium from "cesium";
+import { ISeriesSegment } from "../../../internal/series-segment";
 import { CesiumViewMonitor } from "../../../viewer/cesium-view-monitor";
 import { VisualsRegister } from "../../visuals-register";
 import { SharedGetters } from "../common/shared-getters";
@@ -26,6 +27,7 @@ export declare namespace EntitiesRenderManager {
         private feedPendingUpdateIds;
         private feedUpdateThrottleTimer;
         private visualsManager;
+        private onSeriesDiscovered?;
         private entityCheckQueue;
         private entityCheckQueueIds;
         private entityCheckRemoval;
@@ -48,6 +50,7 @@ export declare namespace EntitiesRenderManager {
             monitor: CesiumViewMonitor.Monitor;
             item: MenuItem.Item.IEntities;
             sharedGetters: SharedGetters.Cache;
+            onSeriesDiscovered?: (segment: ISeriesSegment) => void;
         });
         Init(params?: {
             item: MenuItem.Item.IEntities;

package/dist/types/rendering/texture-frame-series-animator.d.ts

@@ -0,0 +1,93 @@
+import { Style } from "bruce-models";
+import * as Cesium from "cesium";
+export declare namespace TextureFrameSeriesAnimator {
+    /**
+     * One frame's location within the archive's blob file (matches ERDDAPTextureBuilder.FrameEntry).
+     */
+    interface IFrameEntry {
+        Timestamp: string;
+        ByteOffset: number;
+        ByteLength: number;
+    }
+    /**
+     * Shape of ClientFile.Data.generation for a frame-archive texture (as opposed to a single static image).
+     */
+    interface IFrameArchiveMetadata {
+        Frames: IFrameEntry[];
+        ValueMin?: number;
+        ValueMax?: number;
+    }
+    /**
+     * Detects whether a ClientFile's `Data.generation` metadata describes a frame archive rather than a single static image,
+     * so a caller can decide whether to construct an Animator or fall back to the existing static-texture path.
+     * @param data ClientFile.Data (the `IFile.Data` field), as returned by ClientFile.Get().
+     */
+    function IsFrameArchiveMetadata(data: any): data is {
+        generation: IFrameArchiveMetadata;
+    };
+    interface IOptions {
+        viewer: Cesium.Viewer;
+        entity: Cesium.Entity;
+        archiveUrl: string;
+        frames: IFrameEntry[];
+        textureColorMask?: Style.ITextureColorMask;
+        crossfadeMs?: number;
+    }
+    class Animator {
+        private readonly viewer;
+        private readonly entity;
+        private readonly archiveUrl;
+        private readonly frames;
+        private readonly frameDates;
+        private readonly crossfadeMs;
+        private readonly lowColor;
+        private readonly highColor;
+        private readonly originalMaterial;
+        private removeOnTick;
+        private removeCrossfadeTick;
+        private disposed;
+        private frameCache;
+        private frameDims;
+        private currentFrameIndex;
+        private inFlightIndex;
+        private pendingIndex;
+        private displayedPixels;
+        private fadeFromPixels;
+        private fadeToIndex;
+        private fadeToDims;
+        private fadeStartMs;
+        private readonly pool;
+        private poolIdx;
+        private readonly imageProperty;
+        constructor(options: IOptions);
+        /**
+         * Explicit teardown: stops driving the entity's material, abandons any in-flight/pending fetch (results are simply ignored when they land),
+         * and restores whatever material the entity had before construction. Never called automatically.
+         */
+        Dispose(): void;
+        IsDisposed(): boolean;
+        /**
+         * The archive URL this instance was constructed with,
+         * lets a caller re-rendering the same entity tell whether an existing instance is already correct, without reaching into private state.
+         */
+        GetArchiveUrl(): string;
+        private onClockTick;
+        private findFrameIndex;
+        private swapToFrame;
+        private ensureFrame;
+        private nearestUncachedFrame;
+        private pumpFetchQueue;
+        private fetchAndTint;
+        /**
+         * Decodes one frame's raw PNG bytes (as returned by a Range GET) and applies the grayscale color mask.
+         */
+        protected decodeAndTint(buffer: ArrayBuffer): Promise<{
+            pixels: Uint8ClampedArray;
+            width: number;
+            height: number;
+        }>;
+        private beginCrossfadeTo;
+        private tickCrossfade;
+        private presentPixels;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bruce-cesium",
-  "version": "6.9.7",
+  "version": "6.9.9",
   "description": "",
   "keywords": [],
   "main": "dist/bruce-cesium.umd.js",
@@ -81,7 +81,7 @@
   },
   "dependencies": {
     "bruce-cesium": "^6.8.5",
-    "bruce-models": "^7.1.64",
+    "bruce-models": "^7.1.66",
     "tslib": "^2.4.1"
   }
 }