@npm9912/v-map 0.1.0

package/dist/collection/components/v-map-layer-terrain-geotiff/v-map-layer-terrain-geotiff.js

@@ -0,0 +1,735 @@
+// src/components/v-map-layer-terrain-geotiff/v-map-layer-terrain-geotiff.tsx
+import { h, } from "@stencil/core";
+import { VMapLayerHelper } from "../../layer/v-map-layer-helper";
+import { log } from "../../utils/logger";
+import MSG from "../../utils/messages";
+const MSG_COMPONENT = 'v-map-layer-terrain-geotiff - ';
+export class VMapLayerTerrainGeotiff {
+    el;
+    /** Current load state of the layer. */
+    loadState = 'idle';
+    /**
+     * URL to the GeoTIFF file containing elevation data.
+     */
+    url = null;
+    /**
+     * Quell-Projektion des GeoTIFF (z. B. "EPSG:32632" oder proj4-String)
+     */
+    projection = null;
+    /**
+     * Erzwingt die Verwendung der projection-Prop, ignoriert GeoKeys
+     */
+    forceProjection = false;
+    visible = true;
+    /**
+     * Opacity of the terrain layer (0–1).
+     * @default 1
+     */
+    opacity = 1.0;
+    /**
+     * Z-index for layer stacking order. Higher values render on top.
+     */
+    zIndex = 100;
+    /**
+     * NoData value to discard (overriding any nodata values in the metadata).
+     */
+    nodata = null;
+    /**
+     * Mesh error tolerance in meters (Martini).
+     * Smaller values = more detailed mesh, but slower.
+     * @default 4.0
+     */
+    meshMaxError = 4.0;
+    /**
+     * Enable wireframe mode (show only mesh lines).
+     * @default false
+     */
+    wireframe = false;
+    /**
+     * Optional texture URL (can be an image or tile URL).
+     */
+    texture = null;
+    /**
+     * Color for the terrain (if no texture is provided).
+     * [r, g, b] with values 0-255.
+     * @default [255, 255, 255]
+     */
+    color = null;
+    /**
+     * ColorMap for elevation data visualization.
+     * Only relevant when no texture is set.
+     */
+    colorMap = null;
+    /**
+     * Value range for colormap normalization [min, max].
+     */
+    valueRange = null;
+    /**
+     * Elevation exaggeration factor.
+     * @default 1.0
+     */
+    elevationScale = 1.0;
+    /**
+     * Rendering mode for GeoTIFF terrain.
+     * @default terrain
+     */
+    renderMode = 'terrain';
+    /**
+     * Minimum zoom level.
+     */
+    minZoom = 0;
+    /**
+     * Maximum zoom level.
+     */
+    maxZoom = 24;
+    /**
+     * Tile size in pixels.
+     * @default 256
+     */
+    tileSize = 256;
+    /**
+     * Fired when the terrain layer is ready.
+     * @event ready
+     */
+    ready;
+    didLoad = false;
+    hasLoadedOnce = false;
+    helper;
+    setLoadState(state) {
+        this.loadState = state;
+    }
+    /** Returns the last error detail, if any. */
+    async getError() {
+        return this.helper?.getError();
+    }
+    async onUrlChanged() {
+        log(MSG_COMPONENT + 'onUrlChanged');
+        await this.helper?.updateLayer({
+            type: 'terrain-geotiff',
+            data: this.createLayerConfig(),
+        });
+    }
+    async onVisibleChanged() {
+        log(MSG_COMPONENT + 'onVisibleChanged');
+        await this.helper?.setVisible(this.visible);
+    }
+    async onOpacityChanged() {
+        log(MSG_COMPONENT + 'onOpacityChanged');
+        await this.helper?.setOpacity(this.opacity);
+    }
+    async onZIndexChanged() {
+        log(MSG_COMPONENT + 'onZIndexChanged');
+        await this.helper?.setZIndex(this.zIndex);
+    }
+    async onPropertyChanged() {
+        log(MSG_COMPONENT + 'onPropertyChanged');
+        await this.helper?.updateLayer({
+            type: 'terrain-geotiff',
+            data: this.createLayerConfig(),
+        });
+    }
+    isReady() {
+        return this.didLoad;
+    }
+    /**
+     * Returns the internal layer ID used by the map provider.
+     */
+    async getLayerId() {
+        return this.helper.getLayerId();
+    }
+    createLayerConfig() {
+        return {
+            type: 'terrain-geotiff',
+            visible: this.visible,
+            zIndex: this.zIndex,
+            opacity: this.opacity,
+            url: this.url,
+            projection: this.projection,
+            forceProjection: this.forceProjection,
+            nodata: this.nodata,
+            meshMaxError: this.meshMaxError,
+            wireframe: this.wireframe,
+            texture: this.texture,
+            color: this.color,
+            colorMap: this.colorMap,
+            valueRange: this.valueRange,
+            elevationScale: this.elevationScale,
+            renderMode: this.renderMode,
+            minZoom: this.minZoom,
+            maxZoom: this.maxZoom,
+            tileSize: this.tileSize,
+        };
+    }
+    async connectedCallback() {
+        log(MSG_COMPONENT + MSG.COMPONENT_CONNECTED_CALLBACK);
+        if (!this.hasLoadedOnce)
+            return;
+        this.helper.startLoading();
+        await this.helper.initLayer(() => this.createLayerConfig(), this.el.id);
+    }
+    async disconnectedCallback() {
+        log(MSG_COMPONENT + MSG.COMPONENT_DISCONNECTED_CALLBACK);
+        await this.helper?.dispose();
+    }
+    async componentWillLoad() {
+        log(MSG_COMPONENT + MSG.COMPONENT_WILL_LOAD);
+        this.helper = new VMapLayerHelper(this.el, this);
+    }
+    async componentDidLoad() {
+        log(MSG_COMPONENT + MSG.COMPONENT_DID_LOAD);
+        this.helper.startLoading();
+        await this.helper.initLayer(() => this.createLayerConfig(), this.el.id);
+        this.hasLoadedOnce = true;
+        this.didLoad = true;
+        this.ready.emit();
+    }
+    async componentWillRender() {
+        log(MSG_COMPONENT + MSG.COMPONENT_WILL_RENDER);
+    }
+    render() {
+        return h("slot", { key: 'ec36579674879e6def334a8fc18a471aea8f286a' });
+    }
+    static get is() { return "v-map-layer-terrain-geotiff"; }
+    static get encapsulation() { return "shadow"; }
+    static get originalStyleUrls() {
+        return {
+            "$": ["v-map-layer-terrain-geotiff.css"]
+        };
+    }
+    static get styleUrls() {
+        return {
+            "$": ["v-map-layer-terrain-geotiff.css"]
+        };
+    }
+    static get properties() {
+        return {
+            "loadState": {
+                "type": "string",
+                "mutable": true,
+                "complexType": {
+                    "original": "'idle' | 'loading' | 'ready' | 'error'",
+                    "resolved": "\"error\" | \"idle\" | \"loading\" | \"ready\"",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Current load state of the layer."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "load-state",
+                "defaultValue": "'idle'"
+            },
+            "url": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "URL to the GeoTIFF file containing elevation data."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "url",
+                "defaultValue": "null"
+            },
+            "projection": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Quell-Projektion des GeoTIFF (z. B. \"EPSG:32632\" oder proj4-String)"
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "projection",
+                "defaultValue": "null"
+            },
+            "forceProjection": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Erzwingt die Verwendung der projection-Prop, ignoriert GeoKeys"
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "force-projection",
+                "defaultValue": "false"
+            },
+            "visible": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Sichtbarkeit des Layers"
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "visible",
+                "defaultValue": "true"
+            },
+            "opacity": {
+                "type": "number",
+                "mutable": false,
+                "complexType": {
+                    "original": "number",
+                    "resolved": "number",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "default",
+                            "text": "1"
+                        }],
+                    "text": "Opacity of the terrain layer (0\u20131)."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "opacity",
+                "defaultValue": "1.0"
+            },
+            "zIndex": {
+                "type": "number",
+                "mutable": false,
+                "complexType": {
+                    "original": "number",
+                    "resolved": "number",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Z-index for layer stacking order. Higher values render on top."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "z-index",
+                "defaultValue": "100"
+            },
+            "nodata": {
+                "type": "number",
+                "mutable": false,
+                "complexType": {
+                    "original": "number",
+                    "resolved": "number",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "NoData value to discard (overriding any nodata values in the metadata)."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "nodata",
+                "defaultValue": "null"
+            },
+            "meshMaxError": {
+                "type": "number",
+                "mutable": false,
+                "complexType": {
+                    "original": "number",
+                    "resolved": "number",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [{
+                            "name": "default",
+                            "text": "4.0"
+                        }],
+                    "text": "Mesh error tolerance in meters (Martini).\nSmaller values = more detailed mesh, but slower."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "mesh-max-error",
+                "defaultValue": "4.0"
+            },
+            "wireframe": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [{
+                            "name": "default",
+                            "text": "false"
+                        }],
+                    "text": "Enable wireframe mode (show only mesh lines)."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "wireframe",
+                "defaultValue": "false"
+            },
+            "texture": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Optional texture URL (can be an image or tile URL)."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "texture",
+                "defaultValue": "null"
+            },
+            "color": {
+                "type": "unknown",
+                "mutable": false,
+                "complexType": {
+                    "original": "[number, number, number]",
+                    "resolved": "[number, number, number]",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [{
+                            "name": "default",
+                            "text": "[255, 255, 255]"
+                        }],
+                    "text": "Color for the terrain (if no texture is provided).\n[r, g, b] with values 0-255."
+                },
+                "getter": false,
+                "setter": false,
+                "defaultValue": "null"
+            },
+            "colorMap": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string | GeoStylerColorMap",
+                    "resolved": "ColorMap | string",
+                    "references": {
+                        "GeoStylerColorMap": {
+                            "location": "import",
+                            "path": "geostyler-style",
+                            "id": "node_modules::ColorMap",
+                            "referenceLocation": "ColorMap"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "ColorMap for elevation data visualization.\nOnly relevant when no texture is set."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "color-map",
+                "defaultValue": "null"
+            },
+            "valueRange": {
+                "type": "unknown",
+                "mutable": false,
+                "complexType": {
+                    "original": "[number, number]",
+                    "resolved": "[number, number]",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Value range for colormap normalization [min, max]."
+                },
+                "getter": false,
+                "setter": false,
+                "defaultValue": "null"
+            },
+            "elevationScale": {
+                "type": "number",
+                "mutable": false,
+                "complexType": {
+                    "original": "number",
+                    "resolved": "number",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [{
+                            "name": "default",
+                            "text": "1.0"
+                        }],
+                    "text": "Elevation exaggeration factor."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "elevation-scale",
+                "defaultValue": "1.0"
+            },
+            "renderMode": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "'terrain' | 'colormap'",
+                    "resolved": "\"colormap\" | \"terrain\"",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [{
+                            "name": "default",
+                            "text": "terrain"
+                        }],
+                    "text": "Rendering mode for GeoTIFF terrain."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "render-mode",
+                "defaultValue": "'terrain'"
+            },
+            "minZoom": {
+                "type": "number",
+                "mutable": false,
+                "complexType": {
+                    "original": "number",
+                    "resolved": "number",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Minimum zoom level."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "min-zoom",
+                "defaultValue": "0"
+            },
+            "maxZoom": {
+                "type": "number",
+                "mutable": false,
+                "complexType": {
+                    "original": "number",
+                    "resolved": "number",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Maximum zoom level."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "max-zoom",
+                "defaultValue": "24"
+            },
+            "tileSize": {
+                "type": "number",
+                "mutable": false,
+                "complexType": {
+                    "original": "number",
+                    "resolved": "number",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [{
+                            "name": "default",
+                            "text": "256"
+                        }],
+                    "text": "Tile size in pixels."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "tile-size",
+                "defaultValue": "256"
+            }
+        };
+    }
+    static get events() {
+        return [{
+                "method": "ready",
+                "name": "ready",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [{
+                            "name": "event",
+                            "text": "ready"
+                        }],
+                    "text": "Fired when the terrain layer is ready."
+                },
+                "complexType": {
+                    "original": "void",
+                    "resolved": "void",
+                    "references": {}
+                }
+            }];
+    }
+    static get methods() {
+        return {
+            "getError": {
+                "complexType": {
+                    "signature": "() => Promise<VMapErrorDetail | undefined>",
+                    "parameters": [],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        },
+                        "VMapErrorDetail": {
+                            "location": "import",
+                            "path": "../../utils/events",
+                            "id": "src/utils/events.ts::VMapErrorDetail",
+                            "referenceLocation": "VMapErrorDetail"
+                        }
+                    },
+                    "return": "Promise<VMapErrorDetail>"
+                },
+                "docs": {
+                    "text": "Returns the last error detail, if any.",
+                    "tags": []
+                }
+            },
+            "getLayerId": {
+                "complexType": {
+                    "signature": "() => Promise<string>",
+                    "parameters": [],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        }
+                    },
+                    "return": "Promise<string>"
+                },
+                "docs": {
+                    "text": "Returns the internal layer ID used by the map provider.",
+                    "tags": []
+                }
+            }
+        };
+    }
+    static get elementRef() { return "el"; }
+    static get watchers() {
+        return [{
+                "propName": "url",
+                "methodName": "onUrlChanged"
+            }, {
+                "propName": "visible",
+                "methodName": "onVisibleChanged"
+            }, {
+                "propName": "opacity",
+                "methodName": "onOpacityChanged"
+            }, {
+                "propName": "zIndex",
+                "methodName": "onZIndexChanged"
+            }, {
+                "propName": "projection",
+                "methodName": "onPropertyChanged"
+            }, {
+                "propName": "forceProjection",
+                "methodName": "onPropertyChanged"
+            }, {
+                "propName": "nodata",
+                "methodName": "onPropertyChanged"
+            }, {
+                "propName": "meshMaxError",
+                "methodName": "onPropertyChanged"
+            }, {
+                "propName": "wireframe",
+                "methodName": "onPropertyChanged"
+            }, {
+                "propName": "texture",
+                "methodName": "onPropertyChanged"
+            }, {
+                "propName": "color",
+                "methodName": "onPropertyChanged"
+            }, {
+                "propName": "colorMap",
+                "methodName": "onPropertyChanged"
+            }, {
+                "propName": "valueRange",
+                "methodName": "onPropertyChanged"
+            }, {
+                "propName": "elevationScale",
+                "methodName": "onPropertyChanged"
+            }, {
+                "propName": "renderMode",
+                "methodName": "onPropertyChanged"
+            }, {
+                "propName": "minZoom",
+                "methodName": "onPropertyChanged"
+            }, {
+                "propName": "maxZoom",
+                "methodName": "onPropertyChanged"
+            }, {
+                "propName": "tileSize",
+                "methodName": "onPropertyChanged"
+            }];
+    }
+}