@vcmap/core 6.1.11 → 6.2.0-rc.2

package/dist/src/overrideClassRegistry.d.ts

@@ -1,5 +1,5 @@
 import VcsEvent from './vcsEvent.js';
-import { default as ClassRegistry, Ctor, AbstractCtor } from './classRegistry.js';
+import type { default as ClassRegistry, CtorType, AbstractCtor } from './classRegistry.js';
 declare class OverrideClassRegistry<T extends AbstractCtor> {
     private _coreClassRegistry;
     private _classMap;
@@ -17,7 +17,7 @@ declare class OverrideClassRegistry<T extends AbstractCtor> {
     /**
      * Register a class for a given module by name. If the class already exists, it will be replaced and replaced called with the classeName.
      */
-    registerClass(moduleId: string, className: string, ctor: Ctor<T>): void;
+    registerClass(moduleId: string, className: string, ctor: CtorType<T>): void;
     /**
      * Unregister a previously registered class. You can only unregister classes added to this registry, not the underlying core registry.
      * If when registering this class you have replaced class, it will be re-instated and replaced called.
@@ -27,7 +27,7 @@ declare class OverrideClassRegistry<T extends AbstractCtor> {
     /**
      * Gets the constructor for a registered class or undefined, if no such class was registerd
      */
-    getClass(className: string): Ctor<T> | undefined;
+    getClass(className: string): CtorType<T> | undefined;
     hasClass(className: string): boolean;
     /**
      * Create an object of the given className. The constructor is passed args.

package/dist/src/overrideClassRegistry.js

@@ -108,6 +108,7 @@ class OverrideClassRegistry {
      */
     create(className, ...args) {
         check(className, String);
+        // eslint-disable-next-line @typescript-eslint/naming-convention
         const Constructor = this.getClass(className);
         if (!Constructor) {
             logger().error(`could not find constructor ${className}`);

package/dist/src/overrideClassRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"overrideClassRegistry.js","sourceRoot":"","sources":["../../src/overrideClassRegistry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"overrideClassRegistry.js","sourceRoot":"","sources":["../../src/overrideClassRegistry.ts"],"names":[],"mappings":"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"}

package/dist/src/panorama/fieldOfView.d.ts

@@ -0,0 +1,57 @@
+import type { Extent } from 'ol/extent.js';
+import type { Camera, Cartesian2, Matrix4 } from '@vcmap-cesium/engine';
+import { Cartesian3 } from '@vcmap-cesium/engine';
+/**
+ * The field of view of a camera in global cartesian coordinates
+ */
+export type Fov = {
+    top: Cartesian3;
+    right: Cartesian3;
+    bottom: Cartesian3;
+    left: Cartesian3;
+    topLeft: Cartesian3;
+    topRight: Cartesian3;
+    bottomLeft: Cartesian3;
+    bottomRight: Cartesian3;
+    center: Cartesian3;
+};
+/**
+ * The field of view of a camera in image spherical coordinates ordered ([phi, theta]).
+ * See the sphericalCoordinates module for more information on how for more information.
+ */
+export type ProjectedFov = Record<keyof Fov, [number, number]>;
+export declare function createEmptyFov(): Fov;
+export declare function createEmptyProjectedFov(): ProjectedFov;
+/**
+ * Returns the field of view of a camera in global cartesian coordinates assuming a perspective frustum & a distance of 1.
+ * an interpretation of https://gamedev.stackexchange.com/a/55248
+ * technically only used for debugging outside of this module.
+ */
+export declare function getFov(camera: Camera, result?: Fov): Fov;
+/**
+ * Returns the field of view of a camera projected into the image spherical coordinates
+ * technically only used for debugging outside of this module.
+ * @param camera
+ * @param invModelMatrix - the inverse model matrix of the image.
+ * @returns The projected fov in image spherical coordinates.
+ */
+export declare function getProjectedFov(camera: Camera, invModelMatrix: Matrix4): ProjectedFov;
+/**
+ * Returns the extent of the fov in image spherical coordinates. May return two extents, if the FOV wraps around along the longitude.
+ * it DOES NOT handle the case where the fov wraps around the poles (the pole is in the fov).
+ * Furthermore, the camera has to be aligned with the up axis of the sphere. it is not allowed to be rolled.
+ * @param camera
+ * @param invModelMatrix - the inverse model matrix of the panorama image to create the projected fov for
+ * @returns The extent of the fov in image spherical coordinates and the center. if providing more than on extent, the first will be up until 2 * PI and the second starting at 0.
+ */
+export declare function getFovImageSphericalExtent(camera: Camera, invModelMatrix: Matrix4): {
+    extents: [Extent] | [Extent, Extent];
+    center: [number, number];
+};
+/**
+ * creates a ray from the camera to the window position and try to intersect it with the unit sphere.
+ * @param windowPosition
+ * @param camera
+ * @param invModelMatrix
+ */
+export declare function windowPositionToImageSpherical(windowPosition: Cartesian2, camera: Camera, invModelMatrix: Matrix4): [number, number] | undefined;

package/dist/src/panorama/fieldOfView.js

@@ -0,0 +1,135 @@
+import { Cartesian3, Math as CesiumMath } from '@vcmap-cesium/engine';
+import { globalCartesianToImageSpherical } from './sphericalCoordinates.js';
+export function createEmptyFov() {
+    return {
+        top: new Cartesian3(),
+        right: new Cartesian3(),
+        bottom: new Cartesian3(),
+        left: new Cartesian3(),
+        topLeft: new Cartesian3(),
+        topRight: new Cartesian3(),
+        bottomLeft: new Cartesian3(),
+        bottomRight: new Cartesian3(),
+        center: new Cartesian3(),
+    };
+}
+export function createEmptyProjectedFov() {
+    return {
+        top: [0, 0],
+        right: [0, 0],
+        bottom: [0, 0],
+        left: [0, 0],
+        topLeft: [0, 0],
+        topRight: [0, 0],
+        bottomLeft: [0, 0],
+        bottomRight: [0, 0],
+        center: [0, 0],
+    };
+}
+const scratchUpHalfHeight = new Cartesian3();
+const scratchRightHalfWidth = new Cartesian3();
+/**
+ * Returns the field of view of a camera in global cartesian coordinates assuming a perspective frustum & a distance of 1.
+ * an interpretation of https://gamedev.stackexchange.com/a/55248
+ * technically only used for debugging outside of this module.
+ */
+export function getFov(camera, result) {
+    const frustum = camera.frustum;
+    const hNear = 2 * Math.tan(frustum.fov / 2) * frustum.near;
+    const wNear = hNear * frustum.aspectRatio;
+    const hNearHalf = hNear / 2;
+    const wNearHalf = wNear / 2;
+    const output = result ?? createEmptyFov();
+    const cNear = Cartesian3.add(camera.position, Cartesian3.multiplyByScalar(camera.direction, frustum.near, output.center), output.center);
+    const upHalf = Cartesian3.multiplyByScalar(camera.up, hNearHalf, scratchUpHalfHeight);
+    const rightHalf = Cartesian3.multiplyByScalar(camera.right, wNearHalf, scratchRightHalfWidth);
+    output.top = Cartesian3.add(cNear, upHalf, output.top);
+    output.right = Cartesian3.add(cNear, rightHalf, output.right);
+    output.bottom = Cartesian3.subtract(cNear, upHalf, output.bottom);
+    output.left = Cartesian3.subtract(cNear, rightHalf, output.left);
+    output.topLeft = Cartesian3.subtract(Cartesian3.add(cNear, upHalf, output.topLeft), rightHalf, output.topLeft);
+    output.topRight = Cartesian3.add(Cartesian3.add(cNear, upHalf, output.topRight), rightHalf, output.topRight);
+    output.bottomLeft = Cartesian3.subtract(Cartesian3.subtract(cNear, upHalf, output.bottomLeft), rightHalf, output.bottomLeft);
+    output.bottomRight = Cartesian3.add(Cartesian3.subtract(cNear, upHalf, output.bottomRight), rightHalf, output.bottomRight);
+    output.center = cNear;
+    return output;
+}
+function projectFov(fov, invModelMatrix, result) {
+    const projected = result ?? createEmptyProjectedFov();
+    for (const [key, corner] of Object.entries(fov)) {
+        projected[key] = globalCartesianToImageSpherical(corner, invModelMatrix);
+    }
+    return projected;
+}
+/**
+ * Returns the field of view of a camera projected into the image spherical coordinates
+ * technically only used for debugging outside of this module.
+ * @param camera
+ * @param invModelMatrix - the inverse model matrix of the image.
+ * @returns The projected fov in image spherical coordinates.
+ */
+export function getProjectedFov(camera, invModelMatrix) {
+    const fov = getFov(camera);
+    return projectFov(fov, invModelMatrix);
+}
+const scratchExtentFov = createEmptyFov();
+const scratchExtentProjectedFov = createEmptyProjectedFov();
+function getRightBound(projectedFov) {
+    return Math.max(projectedFov.right[0], projectedFov.topRight[0], projectedFov.bottomRight[0]);
+}
+function getLeftBound(projectedFov) {
+    return Math.min(projectedFov.left[0], projectedFov.topLeft[0], projectedFov.bottomLeft[0]);
+}
+function getTopBound(projectedFov) {
+    return Math.min(projectedFov.top[1], projectedFov.topLeft[1], projectedFov.topRight[1]);
+}
+function getBottomBound(projectedFov) {
+    return Math.max(projectedFov.bottom[1], projectedFov.bottomLeft[1], projectedFov.bottomRight[1]);
+}
+/**
+ * Returns the extent of the fov in image spherical coordinates. May return two extents, if the FOV wraps around along the longitude.
+ * it DOES NOT handle the case where the fov wraps around the poles (the pole is in the fov).
+ * Furthermore, the camera has to be aligned with the up axis of the sphere. it is not allowed to be rolled.
+ * @param camera
+ * @param invModelMatrix - the inverse model matrix of the panorama image to create the projected fov for
+ * @returns The extent of the fov in image spherical coordinates and the center. if providing more than on extent, the first will be up until 2 * PI and the second starting at 0.
+ */
+export function getFovImageSphericalExtent(camera, invModelMatrix) {
+    const fov = getFov(camera, scratchExtentFov);
+    const projectedFov = projectFov(fov, invModelMatrix, scratchExtentProjectedFov);
+    const simpleExtent = [
+        getLeftBound(projectedFov),
+        getTopBound(projectedFov),
+        getRightBound(projectedFov),
+        getBottomBound(projectedFov),
+    ];
+    let extents;
+    if (simpleExtent[0] > simpleExtent[2]) {
+        extents = [
+            [simpleExtent[0], simpleExtent[1], CesiumMath.TWO_PI, simpleExtent[3]],
+            [0, simpleExtent[1], simpleExtent[2], simpleExtent[3]],
+        ];
+    }
+    else {
+        extents = [simpleExtent];
+    }
+    return {
+        extents,
+        center: projectedFov.center,
+    };
+}
+/**
+ * creates a ray from the camera to the window position and try to intersect it with the unit sphere.
+ * @param windowPosition
+ * @param camera
+ * @param invModelMatrix
+ */
+export function windowPositionToImageSpherical(windowPosition, camera, invModelMatrix) {
+    const ray = camera.getPickRay(windowPosition);
+    if (!ray) {
+        return undefined;
+    }
+    const intersectionPoint = Cartesian3.add(ray.origin, ray.direction, new Cartesian3());
+    return globalCartesianToImageSpherical(intersectionPoint, invModelMatrix);
+}
+//# sourceMappingURL=fieldOfView.js.map

package/dist/src/panorama/fieldOfView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldOfView.js","sourceRoot":"","sources":["../../../src/panorama/fieldOfView.ts"],"names":[],"mappings":"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"}

package/dist/src/panorama/panoramaCameraController.d.ts

@@ -0,0 +1,35 @@
+import type PanoramaMap from '../map/panoramaMap.js';
+/**
+ * maximum pitch allowed for the camera in radians
+ */
+export declare const MAX_PITCH: number;
+/**
+ * minimum pitch allowed for the camera in radians
+ */
+export declare const MIN_PITCH: number;
+/**
+ * maximum field of view allowed for the camera in radians
+ */
+export declare const MAX_FOV: number;
+/**
+ * minimum field of view allowed for the camera in radians
+ */
+export declare const MIN_FOV: number;
+/**
+ * The panorama camera controller allows to control the camera of a panorama map
+ * by dragging the mouse and zooming in and out with the mouse wheel.
+ */
+export type PanoramaCameraController = {
+    /**
+     * Zooms in, until MIN_FOV of 10 degrees is reached
+     * @param [step=0.1] - optional step in radians
+     */
+    zoomIn: (step?: number) => void;
+    /**
+     * Zooms out, until MAX_FOV of 120 degrees is reached
+     * @param [step=0.1] - optional step in radians
+     */
+    zoomOut: (step?: number) => void;
+    destroy: () => void;
+};
+export declare function createPanoramaCameraController(map: PanoramaMap): PanoramaCameraController;

package/dist/src/panorama/panoramaCameraController.js

@@ -0,0 +1,146 @@
+import { Cartesian2, Math as CesiumMath, ScreenSpaceEventType, } from '@vcmap-cesium/engine';
+import { windowPositionToImageSpherical } from './fieldOfView.js';
+import { PointerEventType, PointerKeyType, } from '../interaction/interactionType.js';
+/**
+ * maximum pitch allowed for the camera in radians
+ */
+export const MAX_PITCH = CesiumMath.toRadians(85);
+/**
+ * minimum pitch allowed for the camera in radians
+ */
+export const MIN_PITCH = -MAX_PITCH;
+/**
+ * maximum field of view allowed for the camera in radians
+ */
+export const MAX_FOV = CesiumMath.toRadians(120);
+/**
+ * minimum field of view allowed for the camera in radians
+ */
+export const MIN_FOV = CesiumMath.toRadians(10);
+/**
+ * decay factor for the inertia delay
+ */
+const INERTIA_DECAY = 0.8;
+/**
+ * number of frames to decay the inertia
+ */
+const DECAY_FRAMES = 60;
+export function createPanoramaCameraController(map) {
+    const widget = map.getCesiumWidget();
+    const { camera } = widget;
+    const frustum = camera.frustum;
+    const pointerInput = {
+        startPosition: new Cartesian2(),
+        position: new Cartesian2(),
+        leftDown: false,
+    };
+    map.pointerInteractionEvent.addEventListener((event) => {
+        if (event.pointer === PointerKeyType.LEFT) {
+            if (event.pointerEvent === PointerEventType.DOWN) {
+                pointerInput.leftDown = true;
+                // set the spherical position of the pointer on the sphere here.
+                pointerInput.position = event.windowPosition.clone(pointerInput.position);
+                pointerInput.startPosition = event.windowPosition.clone(pointerInput.startPosition);
+            }
+            else {
+                pointerInput.leftDown = false;
+            }
+        }
+        else if (event.pointerEvent === PointerEventType.MOVE &&
+            pointerInput.leftDown) {
+            pointerInput.position = event.windowPosition.clone(pointerInput.position);
+        }
+    });
+    function panoZoom(event, step = 0.1) {
+        if (event > 0 && frustum.fov > MIN_FOV) {
+            frustum.fov -= step;
+            if (frustum.fov < MIN_FOV) {
+                frustum.fov = MIN_FOV;
+            }
+            map.panoramaView.render();
+        }
+        else if (event < 0 && frustum.fov < MAX_FOV) {
+            frustum.fov += step;
+            if (frustum.fov > MAX_FOV) {
+                frustum.fov = MAX_FOV;
+            }
+            map.panoramaView.render();
+        }
+    }
+    map.screenSpaceEventHandler.setInputAction((event) => {
+        if (!map.movementPointerEventsDisabled) {
+            panoZoom(event);
+        }
+    }, ScreenSpaceEventType.WHEEL);
+    let yInertia = 0;
+    let xInertia = 0;
+    let decay = 0;
+    function ensurePitch() {
+        if (camera.pitch > MAX_PITCH) {
+            camera.look(camera.right, camera.pitch - MAX_PITCH);
+        }
+        else if (camera.pitch < MIN_PITCH) {
+            camera.look(camera.right, camera.pitch - MIN_PITCH);
+        }
+    }
+    let currentImage = map.currentPanoramaImage;
+    const imageListener = map.currentImageChanged.addEventListener((image) => {
+        currentImage = image;
+    });
+    let animationFrameHandle;
+    const loop = () => {
+        if (currentImage &&
+            !widget.scene.screenSpaceCameraController.enableInputs &&
+            !map.movementPointerEventsDisabled) {
+            if (pointerInput.leftDown) {
+                const { position, startPosition } = pointerInput;
+                const startImagePosition = windowPositionToImageSpherical(startPosition, camera, currentImage.invModelMatrix);
+                const newImagePosition = windowPositionToImageSpherical(position, camera, currentImage.invModelMatrix);
+                if (startImagePosition && newImagePosition) {
+                    let diffX = startImagePosition[0] - newImagePosition[0];
+                    if (diffX > CesiumMath.PI) {
+                        diffX -= CesiumMath.TWO_PI;
+                    }
+                    else if (diffX < -CesiumMath.PI) {
+                        diffX += CesiumMath.TWO_PI;
+                    }
+                    const diffY = startImagePosition[1] - newImagePosition[1];
+                    widget.camera.look(currentImage.up, diffX);
+                    widget.camera.look(camera.right, diffY);
+                    yInertia = diffY;
+                    xInertia = diffX;
+                    decay = 0;
+                    ensurePitch();
+                    pointerInput.startPosition = position.clone(startPosition);
+                }
+            }
+            else if (decay < DECAY_FRAMES) {
+                decay += 1;
+                xInertia *= INERTIA_DECAY;
+                widget.camera.look(currentImage.up, xInertia);
+                yInertia *= INERTIA_DECAY;
+                widget.camera.look(camera.right, yInertia);
+                ensurePitch();
+            }
+        }
+        animationFrameHandle = requestAnimationFrame(loop);
+    };
+    loop();
+    return {
+        zoomIn(step = 0.1) {
+            if (!map.movementApiCallsDisabled) {
+                panoZoom(1, step);
+            }
+        },
+        zoomOut(step = 0.1) {
+            if (!map.movementApiCallsDisabled) {
+                panoZoom(-1, step);
+            }
+        },
+        destroy() {
+            cancelAnimationFrame(animationFrameHandle);
+            imageListener();
+        },
+    };
+}
+//# sourceMappingURL=panoramaCameraController.js.map

package/dist/src/panorama/panoramaCameraController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"panoramaCameraController.js","sourceRoot":"","sources":["../../../src/panorama/panoramaCameraController.ts"],"names":[],"mappings":"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"}

package/dist/src/panorama/panoramaImage.d.ts

@@ -0,0 +1,135 @@
+import { Cartesian3, HeadingPitchRoll, Matrix4 } from '@vcmap-cesium/engine';
+import type { Pool, GeoTIFF } from 'geotiff';
+import type { Size } from 'ol/size.js';
+import type { PanoramaImageDecoder, PanoramaTileProvider } from './panoramaTileProvider.js';
+import type PanoramaDatasetLayer from '../layer/panoramaDatasetLayer.js';
+type PanoramaGDALMetadata = {
+    /**
+     * The metadata version
+     */
+    version: string;
+    /**
+     * position ECEF
+     */
+    position: Cartesian3;
+    /**
+     * HeadingPitchRoll in radians
+     */
+    orientation: HeadingPitchRoll;
+    /**
+     * This image has depth information available
+     */
+    hasDepth: boolean;
+    /**
+     * This image has intensity information available
+     */
+    hasIntensity: boolean;
+};
+type PanoramaImageMetadata = {
+    tileSize: Size;
+    minLevel: number;
+    maxLevel: number;
+};
+export type DepthGDALMetadata = {
+    version: string;
+    min: number;
+    max: number;
+};
+export type PanoramaFileDirectoryMetadata = {
+    type: 'image' | 'depth';
+};
+/**
+ * The panorama image represents all resources associated with a panorama image.
+ * When created, it extracts all available metadata from the base geotiff resource
+ * and loads associated structures, such as the tile provider for RGB and intensity images (if available & on demand)
+ * and the panorama depth of the image (if available).
+ */
+export type PanoramaImage = Readonly<PanoramaImageMetadata & Omit<PanoramaGDALMetadata, 'version'>> & {
+    /**
+     * The image name
+     */
+    readonly name: string;
+    readonly up: Cartesian3;
+    readonly modelMatrix: Matrix4;
+    readonly invModelMatrix: Matrix4;
+    readonly image: GeoTIFF;
+    /**
+     * The tile provider for the RGB images
+     */
+    readonly tileProvider: PanoramaTileProvider;
+    /**
+     * The maximum depth of the image. Either taken from the depth image header or the default
+     */
+    readonly maxDepth: number;
+    /**
+     * The parent dataset, if available
+     */
+    readonly dataset?: PanoramaDatasetLayer;
+    /**
+     * Tries to determine the global position at the given image spherical coordinate. Will return undefined, if the image has no depth.
+     * Uses the current level on the tile provider
+     * @param coordinate
+     * @param result
+     */
+    getPositionAtImageCoordinate(coordinate: [number, number], result?: Cartesian3): Promise<Cartesian3 | undefined>;
+    /**
+     * Tries to determine the global position at the given image spherical coordinate. Will return undefined, if the image has no depth
+     * Uses the heighest available depth data, but is more resource intense
+     * @param coordinate
+     * @param result
+     */
+    getPositionAtImageCoordinateMostDetailed(coordinate: [number, number], result?: Cartesian3): Promise<Cartesian3 | undefined>;
+    destroy(): void;
+};
+/**
+ * additional image creating options, mainly used for testing.
+ */
+export type CreatePanoramaImageOptions = {
+    /**
+     * The dataset an image may belong to
+     */
+    dataset?: PanoramaDatasetLayer;
+    /**
+     * The root URL for the image. This is used to load the intensity and depth images.
+     */
+    absoluteRootUrl?: string;
+    /**
+     * a preloaded depth image for this RGB image.
+     */
+    depthImage?: GeoTIFF;
+    /**
+     * a preloaded intensity image for this RGB image.
+     */
+    intensityImage?: GeoTIFF;
+    /**
+     * the name of the image. This is used to load intensity and depth images. if not provided, a uuid is used.
+     */
+    name?: string;
+    /**
+     * an optional pool or decoder to be passed to the tile provider. mainly used in testing
+     */
+    poolOrDecoder?: Pool | PanoramaImageDecoder;
+    /**
+     * The size of the tile cache. If not provided, the default is used.
+     */
+    tileCacheSize?: number;
+    /**
+     * The concurrency of the tile provider. If not provided, the default is used.
+     */
+    providerConcurrency?: number;
+};
+/**
+ * This is an internal function to create a panorama image for specific use cases (e.g. testing).
+ * In most cases, you should use {@link createPanoramaImageFromURL} directly.
+ * Creates a panorama image from a GeoTIFF image. The image should contain the metadata in the GDAL metadata format.
+ * @param rgbImage - the RGB image
+ * @param [options]
+ */
+export declare function createPanoramaImage(rgbImage: GeoTIFF, options?: CreatePanoramaImageOptions): Promise<PanoramaImage>;
+/**
+ * Creates a panorama image from a URL. The URL must point to a RGB image with the name ending in "_rgb.tif".
+ * @param rgbImageUrl - the url to the RGB image
+ * @param [dataset] - the dataset to which the image belongs, if applicable
+ */
+export declare function createPanoramaImageFromURL(rgbImageUrl: string, dataset?: PanoramaDatasetLayer): Promise<PanoramaImage>;
+export {};