@gisatcz/deckgl-geolib 2.5.0-dev.1 → 2.5.0-dev.3

package/dist/esm/types/core/GeoImage.d.ts

@@ -11,6 +11,27 @@ export default class GeoImage {
         bounds: Bounds;
         cellSizeMeters?: number;
     }, options: GeoImageOptions, meshMaxError: number): Promise<TileResult | null>;
+    /**
+     * Resolves the active visualization (coloring) mode after merging user options with defaults.
+     *
+     * Solves three key issues:
+     *
+     * 1. **Mutual exclusivity**: `DefaultGeoImageOptions` sets `useHeatMap: true`. If a user
+     *    explicitly enables a coloring mode without explicitly setting `useHeatMap: false`,
+     *    enforce that only the explicitly-enabled modes are active (all others forced to false).
+     *    This prevents the default `useHeatMap: true` from interfering with user-chosen modes.
+     *
+     * 2. **Bitmap default**: for `type === 'image'` with no user-specified coloring mode,
+     *    keep `useHeatMap: true` from defaults. This provides sensible data-driven visualization.
+     *
+     * 3. **Terrain default**: for `type === 'terrain'` with no user-specified coloring mode and
+     *    no kernel-texture mode (`useSwissRelief` / `useSlope` / `useHillshade`), enable
+     *    `useSingleColor` with `color = terrainColor`. This renders the mesh in the documented
+     *    default colour (grey) without a data-driven texture overlay. When a kernel mode IS
+     *    present but no coloring mode is specified, keep `useHeatMap: true` so the kernel output
+     *    is still colourised.
+     */
+    static resolveVisualizationMode(mergedOptions: GeoImageOptions, userOptions: GeoImageOptions): GeoImageOptions;
     getHeightmap(input: string | {
         bounds: Bounds;
         width: number;

package/dist/esm/types/core/lib/BitmapGenerator.d.ts

@@ -5,6 +5,20 @@ export declare class BitmapGenerator {
      * Key: colorScale config + range, Value: pre-computed RGBA LUT
      */
     private static _swissColorLUTCache;
+    /**
+     * Cache for 8-bit (256-entry) color LUTs.
+     * Shared process-wide across all tiles and datasets when options are fixed (i.e. !useAutoRange).
+     * Key: serialised coloring options, Value: pre-computed 256×RGBA LUT
+     */
+    private static _8bitLUTCache;
+    /**
+     * Cache for float/16-bit (1024-entry) heatmap LUTs.
+     * Shared process-wide across all tiles and datasets when !useAutoRange.
+     * Key: serialised coloring options + range, Value: pre-computed 1024×RGBA LUT
+     */
+    private static _floatLUTCache;
+    /** Build a cache key that captures all options affecting LUT colour output. */
+    private static getLUTCacheKey;
     /**
      * Main entry point: Generates an ImageBitmap from raw raster data.
      */

package/dist/esm/types/core/lib/TerrainGenerator.d.ts

@@ -29,7 +29,7 @@ export declare class TerrainGenerator {
         vertices: any;
         triangles: any;
     };
-    static getMeshAttributes(vertices: Uint16Array | Uint32Array | Float32Array | Float64Array, terrain: Float32Array, width: number, height: number, bounds: Bounds | number[]): {
+    static getMeshAttributes(vertices: Uint16Array | Uint32Array | Float32Array | Float64Array, terrain: Float32Array, width: number, height: number, bounds: Bounds | number[], verticalExaggeration?: number): {
         POSITION: {
             value: Float32Array<ArrayBuffer>;
             size: number;

package/dist/esm/types/core/types.d.ts

@@ -20,7 +20,26 @@ export type GeoImageOptions = {
     /** 0-based index of the channel to visualize (e.g. 0 for the first channel). Alternative to useChannel. */
     useChannelIndex?: number | null;
     noDataValue?: number;
+    /**
+     * Scalar applied to raw raster values before Martini/Delatin tessellation.
+     * Use this to convert or normalize source elevation values into the units that
+     * should be seen by the tessellator (e.g. convert raw values to metres).
+     * Because the scaled values are used during tessellation, changing `multiplier`
+     * also changes the effective mesh density unless `meshMaxError` is adjusted.
+     * `meshMaxError` must be specified in the same units as the post-`multiplier`
+     * elevation values.
+     * Default: 1.0
+     */
     multiplier?: number;
+    /**
+     * Vertical scale factor applied **only** to mesh vertex z positions, after
+     * tessellation. Use this for **visual exaggeration** (make terrain look taller).
+     * Unlike `multiplier`, this does not affect `meshMaxError` — the error threshold
+     * is always evaluated against real-world (post-`multiplier`) elevation values.
+     * The skirt height is scaled by this factor automatically.
+     * Default: 1.0
+     */
+    verticalExaggeration?: number;
     numOfChannels?: number;
     planarConfig?: number;
     tesselator?: 'martini' | 'delatin';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gisatcz/deckgl-geolib",
-  "version": "2.5.0-dev.1",
+  "version": "2.5.0-dev.3",
   "description": "Deck.gl extension for rendering Cloud-Optimized GeoTIFF (COG) data",
   "keywords": [
     "deck.gl",