@gisatcz/deckgl-geolib 2.5.0-dev.2 → 2.5.0-dev.4

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

@@ -50,13 +50,13 @@ declare class CogTiles {
      * @returns {number} The index of the image in the COG that best matches the specified zoom level.
      */
     getImageIndexForZoomLevel(zoom: number): number;
-    getTileFromImage(tileX: number, tileY: number, zoom: number, fetchSize?: number): Promise<(Uint8Array<ArrayBuffer> | Float32Array<ArrayBuffer> | Int8Array<ArrayBuffer> | Int16Array<ArrayBuffer> | Uint16Array<ArrayBuffer> | Int32Array<ArrayBuffer> | Uint32Array<ArrayBuffer> | Float64Array<ArrayBuffer>)[] | import("geotiff").TypedArrayWithDimensions[]>;
+    getTileFromImage(tileX: number, tileY: number, zoom: number, fetchSize?: number, signal?: AbortSignal): Promise<(Uint8Array<ArrayBuffer> | Float32Array<ArrayBuffer> | Int8Array<ArrayBuffer> | Int16Array<ArrayBuffer> | Uint16Array<ArrayBuffer> | Int32Array<ArrayBuffer> | Uint32Array<ArrayBuffer> | Float64Array<ArrayBuffer>)[] | import("geotiff").TypedArrayWithDimensions[]>;
     /**
      * Creates a blank tile buffer filled with the "No Data" value.
      * @param size The width/height of the square tile (e.g., 256 or 257)
      */
     createEmptyTile(size?: number): Float32Array<ArrayBuffer>;
-    getTile(x: number, y: number, z: number, bounds: Bounds, meshMaxError: number): Promise<TileResult | null>;
+    getTile(x: number, y: number, z: number, bounds?: Bounds, meshMaxError?: number, signal?: AbortSignal): Promise<TileResult | null>;
     /**
      * Determines the data type (e.g., "Int32", "Float64") of a GeoTIFF image
      * by reading its TIFF tags.

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/dist/esm/types/index.d.ts

@@ -1,3 +1,4 @@
 export { CogBitmapLayer, CogTerrainLayer } from './layers/index';
 export { CogTiles, GeoImage } from './core/index';
+export { suppressGlobalAbortErrors } from './utils/suppressAbortErrors';
 export type { GeoImageOptions } from './core/index';

package/dist/esm/types/utils/suppressAbortErrors.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Suppresses unhandled AbortErrors from deck.gl tile cancellation.
+ *
+ * NOTE: The library's main entry point installs this handler automatically
+ * when the package is imported via its primary build (for example
+ * `import '@gisatcz/deckgl-geolib'`). This default prevents console spam during
+ * normal tile cancellation (pan/zoom) for the vast majority of consumers.
+ *
+ * If you need to control installation manually (for example when importing
+ * internals or for custom lifecycle control), import and call the exported
+ * function yourself:
+ *
+ *   import { suppressGlobalAbortErrors } from '@gisatcz/deckgl-geolib';
+ *   suppressGlobalAbortErrors();
+ *
+ * Warning: This suppresses ALL unhandled AbortErrors (including from your own
+ * code). If you need finer control, implement a custom `unhandledrejection`
+ * handler instead.
+ *
+ * The listener is attached only once and only in browser environments,
+ * making this function idempotent and safe to call multiple times.
+ */
+export declare function suppressGlobalAbortErrors(): void;

package/package.json

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