@fxi/zartigl 0.10.2 → 0.10.4

package/dist/zartigl.d.ts

@@ -582,6 +582,11 @@ declare type LocalizedText = Record<string, string>;
 export declare interface MapxWidgetSnippetOptions {
     layerId: string;
     layerKind: CatalogEntry["kind"];
+    /** Legend header (MapX widget only); MapX derives it from the layer when unset. */
+    title?: LocalizedText | string;
+    subtitle?: LocalizedText | string;
+    /** Shown as the legend title's tooltip. */
+    description?: LocalizedText | string;
     /**
      * The layer's own style, the catalog `defaults`: only override keys that
      * differ from it are written. Unknown, the whole override is written.
@@ -622,6 +627,7 @@ export declare class ParticleSimulation {
     private drawProgram;
     private fadeProgram;
     private compositeProgram;
+    private glowProgram;
     private gridProgram;
     private gridGlobeProgram;
     private particleStateTextures;
@@ -642,6 +648,8 @@ export declare class ParticleSimulation {
     private screenFramebuffers;
     private screenWidth;
     private screenHeight;
+    private glowTexture;
+    private glowFramebuffer;
     private quadBuffer;
     private rasterGridBuffer;
     private rasterGridIndexBuffer;
@@ -652,6 +660,7 @@ export declare class ParticleSimulation {
     private drawLocs;
     private fadeLocs;
     private compositeLocs;
+    private glowLocs;
     private gridLocs;
     private gridGlobeLocs;
     constructor(params?: Partial<SimulationParams>);
@@ -682,6 +691,12 @@ export declare class ParticleSimulation {
         east: number;
         north: number;
     }, isGlobe?: boolean, globeCenter?: [number, number, number], clippingPlane?: [number, number, number, number], velocityPair?: VelocityTexturePair): void;
+    /**
+     * Reduce the latest trails into the glow texture (glow.glsl), then rebind
+     * `framebuffer` with the full viewport.
+     */
+    private renderGlow;
+    private deleteGlowTarget;
     renderGrid(velocityTexUnit: number, velocityMin: [number, number], velocityMax: [number, number], matrix: Iterable<number>, worldSize: number, worldCopyOffsets: number[], geoBounds: {
         west: number;
         south: number;
@@ -716,6 +731,8 @@ export declare class ParticleSimulation {
     setColorGrade(grade: Partial<ColorGrade>): void;
     /** Missing values take the defaults; see resolveBackdrop. */
     setBackdrop(backdrop: Partial<BackdropStyle>): void;
+    /** Halo strength, clamped to [0, 1]; 0 frees the glow texture. */
+    setGlow(v: number): void;
     setScalarMode(v: boolean): void;
     setRgba8MaxParticleZoom(v: number): void;
     /**
@@ -753,6 +770,7 @@ export declare interface ParticleSimulationDebugInfo {
     vibrance: number;
     colorGrade: ColorGrade;
     backdrop: BackdropStyle;
+    glow: number;
     scalarMode: boolean;
     devicePixelRatio?: number;
     webgl: WebGLRendererInfo | null;
@@ -773,6 +791,8 @@ declare interface ParticleStyle {
     grade: ParticleGrade;
     /** Solid color under the trails; replaced as a whole, not merged. */
     backdrop: BackdropStyle;
+    /** Halo of the trails' own color, [0, 1]; 0 is off. */
+    glow: number;
 }
 
 /** Partial particle style; a partial backdrop takes the defaults' keys. */
@@ -975,6 +995,8 @@ declare interface SimulationParams {
     colorGrade: ColorGrade;
     /** Solid color under the trails, on valid cells; off by default. */
     backdrop: BackdropStyle;
+    /** Halo of the trails' color, [0, 1]; 0 (default) skips its pass. */
+    glow: number;
     scalarMode: boolean;
     particleState: ParticleStateMode;
     rgba8MaxParticleZoom: number;
@@ -1185,6 +1207,7 @@ export declare class VectorLayer implements CustomLayerInterface {
     setVibrance(v: number): void;
     setColorGrade(grade: Partial<ColorGrade>): void;
     setBackdrop(backdrop: Partial<BackdropStyle>): void;
+    setGlow(v: number): void;
     getDebugInfo(): VectorLayerDebugInfo;
     on<K extends keyof LayerEventMap_2>(event: K, handler: LayerEventMap_2[K]): this;
     off<K extends keyof LayerEventMap_2>(event: K, handler: LayerEventMap_2[K]): this;
@@ -1244,6 +1267,8 @@ export declare interface VectorLayerOptions {
     colorGrade?: Partial<ColorGrade>;
     /** Solid color under the trails, on valid cells. Omitted: off. */
     backdrop?: Partial<BackdropStyle>;
+    /** Halo of the trails' color, [0, 1]. Default 0 (off). */
+    glow?: number;
     unit?: string;
 }
 
@@ -1846,6 +1871,8 @@ export declare interface ZartiglSettings {
     colorGrade: Partial<ColorGrade>;
     /** Solid color under particle trails, on valid cells; off by default. */
     backdrop: Partial<BackdropStyle>;
+    /** Halo of the particle trails' color, [0, 1]; 0 by default. */
+    glow: number;
     /** Fixed physical-value domain for scalar colors. Null uses frame extrema. */
     colorDomain: [number, number] | null;
     /** Transparent ends of the color range, as in RasterStyle. */