bruce-cesium 7.5.8 → 7.6.0

package/dist/types/rendering/texture-value-labels.d.ts

@@ -1,5 +1,6 @@
 import * as Cesium from "cesium";
 import { TextureFrameSeriesAnimator } from "./texture-frame-series-animator";
+import { VisualsRegister } from "./visuals-register";
 /**
  * Prints a value texture's own numbers over the cells they belong to.
  */
@@ -35,6 +36,22 @@ export declare namespace TextureValueLabels {
         South: number;
         North: number;
     }
+    /**
+     * Value pixels, one texel per cell, value in R (and G when packed) and coverage in A.
+     */
+    interface IRaster {
+        data: Uint8ClampedArray;
+        width: number;
+        height: number;
+    }
+    /**
+     * Who the hover label is shown for, and the register that owns hover labels.
+     */
+    interface IHoverTarget {
+        register: VisualsRegister.Register;
+        entityId: string;
+        menuItemId?: string;
+    }
     interface IOptions {
         viewer: Cesium.Viewer;
         extent: IExtent;
@@ -45,6 +62,9 @@ export declare namespace TextureValueLabels {
             lon: number;
             lat: number;
         }[];
+        heightAt?: (lon: number, lat: number) => number | null;
+        heightKey?: () => unknown;
+        hover?: IHoverTarget;
     }
     /**
      * One cell's numbers, in the attribute's own units.
@@ -72,7 +92,7 @@ export declare namespace TextureValueLabels {
      */
     function ReadingAt(params: {
         metadata?: TextureFrameSeriesAnimator.IFrameArchiveMetadata;
-        source: ImageData;
+        source: IRaster;
         floor?: ImageData | null;
         ceiling?: ImageData | null;
         at: number;
@@ -110,23 +130,44 @@ export declare namespace TextureValueLabels {
         private clipRing?;
         private source;
         private painted;
+        private paintedRamp;
         private floor;
         private ceiling;
+        private readonly heightAt?;
+        private readonly heightKey?;
+        private readonly hover?;
         private disposed;
-        private drawn;
         private stride;
+        private readonly cellLabels;
+        private lingerTimer;
+        private drawnView;
+        private drawnInputs;
+        private readonly scratchWorld;
+        private readonly scratchWindow;
+        private readonly scratchClip;
+        private viewProjection;
+        private readonly viewProjectionScratch;
+        private hovering;
+        private hoverFrame;
+        private hoverAt;
+        private readonly onPointerMove;
+        private readonly onPointerLeave;
         constructor(options: IOptions);
         SetExtent(extent: IExtent): void;
         /**
-         * The current frame's decoded values, as the animator's value canvas already provides them.
+         * The current frame's decoded values.
          * @param source value pixels, one texel per cell
          */
-        SetSource(source: ImageData | null): void;
+        SetSource(source: IRaster | null): void;
         /**
          * The tinted pixels of the same frame, so the grid can skip cells the ramp painted nothing in.
-         * @param painted RGBA of the presented frame, or null to fall back to coverage alone
+         * @param painted RGBA of the presented frame, or null to fall back to the ramp or coverage alone
          */
         SetPainted(painted: Uint8ClampedArray | null): void;
+        /**
+         * The surface's 256 step RGBA ramp, for telling whether a cell was painted without a tinted frame.
+         */
+        SetPaintedRamp(ramp: Uint8Array | null): void;
         /**
          * The archive's per-cell extremes, when it publishes them. Without these a label can still
          * print the current reading, just not the range behind it.
@@ -136,26 +177,33 @@ export declare namespace TextureValueLabels {
         Clear(): void;
         Dispose(): void;
         /**
-         * Redraws every visible label. Cheap enough to call per rendered frame, because the cell
-         * count it considers is bounded by the view rather than by the texture.
+         * Redraws the grid and syncs the value labels, when anything they are drawn from has changed.
          */
         Render(): void;
+        private labelCells;
+        private syncCellLabels;
+        private clearCellLabels;
+        private updateHover;
+        private releaseHover;
+        private readingUnder;
+        private cellUnder;
         private drawGrid;
         private applyRingClip;
-        private tileCellOutline;
         private drawTileGrid;
         private groundAtScreenCentre;
         private coveredAt;
         private isCovered;
-        private widestLabel;
-        private cellOutline;
-        private drawLabel;
+        private labelLines;
         private readNear;
         private paintedAt;
         private readAt;
+        private texelAt;
         private lonAt;
         private latAt;
         private visibleTexels;
+        private surfaceHeight;
+        private projectCell;
         private project;
+        private projectInto;
     }
 }

package/dist/types/rendering/visuals-register.d.ts

@@ -576,9 +576,15 @@ export declare namespace VisualsRegister {
                 y: number;
             };
             createIfMissing?: boolean;
+            text?: string;
+            pos3d?: Cesium.Cartesian3;
         } | null): void;
         ClearLabelHover: () => void;
         private CheckLabelHoverBounds;
+        GetLabelHoverTarget(): Readonly<{
+            entityId: string;
+            menuItemId?: string;
+        }> | undefined;
         IsLabelHovered(entityId: string, menuItemId?: string): boolean;
         GetLabelHoverPosition(entityId: string, menuItemId?: string): Readonly<{
             x: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bruce-cesium",
-  "version": "7.5.8",
+  "version": "7.6.0",
   "description": "",
   "keywords": [],
   "main": "dist/bruce-cesium.umd.js",