@vcmap/core 5.0.0-rc.9 → 5.0.1

package/dist/src/util/overrideCollection.js

@@ -0,0 +1,176 @@
+import { check } from '@vcsuite/check';
+import { getLogger as getLoggerByName } from '@vcsuite/logger';
+import Collection from './collection.js';
+import VcsEvent from '../vcsEvent.js';
+import { moduleIdSymbol } from '../moduleIdSymbol.js';
+function getLogger() {
+    return getLoggerByName('OverrideCollection');
+}
+/**
+ * A symbol added to override collections.
+ */
+export const isOverrideCollection = Symbol('OverrideCollection');
+/**
+ * @param  collection
+ * @param  getDynamicModuleId - function to get the current dynamic module id
+ * @param  serializeItem - optional function to serialize an item, defaults to returning item.toJSON or item: i => (i.toJSON || i)
+ * @param  deserializeItem - optional deserialization function. defaults to returning the passed object: i => i
+ * @param  ctor - optional constructor to validate deserialized items against. if passed, deserializeItem must be an instance of ctor.
+ * @param  determineShadowIndex - return the index where a shadow should be inserted. only has relevance, if the collection is indexed. previous and current index may be null.
+ */
+function makeOverrideCollection(collection, getDynamicModuleId, serializeItem, deserializeItem, ctor, determineShadowIndex) {
+    check(collection, Collection);
+    const overrideCollection = collection;
+    if (overrideCollection[isOverrideCollection]) {
+        throw new Error('Cannot transform collection, collection already is an OverrideCollection');
+    }
+    overrideCollection[isOverrideCollection] = true;
+    const deserialize = deserializeItem || ((i) => i);
+    const serialize = serializeItem ||
+        ((i) => i.toJSON ? i.toJSON() : structuredClone(i));
+    const getShadowIndex = determineShadowIndex ||
+        ((_item, _shadow, currentIndex) => currentIndex);
+    overrideCollection.shadowMap = new Map();
+    overrideCollection.override = function override(item) {
+        let shadow;
+        let index;
+        const itemId = item[overrideCollection.uniqueKey];
+        if (overrideCollection.hasKey(itemId)) {
+            shadow = overrideCollection.getByKey(itemId);
+            // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+            // @ts-ignore
+            // eslint-disable-next-line no-underscore-dangle
+            index = overrideCollection._remove(shadow);
+            if (!overrideCollection.shadowMap.has(itemId)) {
+                overrideCollection.shadowMap.set(itemId, []);
+            }
+            const shadowsArray = overrideCollection.shadowMap.get(itemId);
+            const serializedShadow = serialize(shadow);
+            serializedShadow[moduleIdSymbol] = shadow[moduleIdSymbol];
+            shadowsArray.push(serializedShadow);
+        }
+        const usedIndex = shadow ? getShadowIndex(shadow, item, index) : null;
+        if (shadow) {
+            overrideCollection.replaced.raiseEvent({ old: shadow, new: item });
+            if (shadow.destroy) {
+                shadow.destroy();
+            }
+        }
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        if (overrideCollection.add(item, usedIndex) >= 0) {
+            return item;
+        }
+        return null;
+    };
+    overrideCollection.parseItems = async function parseItems(configArray, moduleId) {
+        if (Array.isArray(configArray)) {
+            const instanceArray = await Promise.all(configArray.map(async (config) => {
+                const item = await deserialize(config);
+                if (!item || (ctor && !(item instanceof ctor))) {
+                    getLogger().warning(`Could not load item ${
+                    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                    // @ts-ignore
+                    String(config[overrideCollection.uniqueKey])} of type ${String(config.type)}`);
+                    return null;
+                }
+                item[moduleIdSymbol] = moduleId;
+                return item;
+            }));
+            instanceArray
+                .filter((i) => i)
+                .forEach((i) => {
+                overrideCollection.override(i);
+            });
+        }
+    };
+    overrideCollection.getSerializedByKey = function getSerializedByKey(key) {
+        const item = overrideCollection.getByKey(key);
+        if (item) {
+            return serialize(item);
+        }
+        return undefined;
+    };
+    overrideCollection.removed.addEventListener(async (item) => {
+        const itemId = item[overrideCollection.uniqueKey];
+        if (overrideCollection.shadowMap.has(itemId)) {
+            const serializedShadow = overrideCollection.shadowMap
+                .get(itemId)
+                .pop();
+            if (serializedShadow) {
+                const reincarnation = await deserialize(serializedShadow);
+                if (!reincarnation) {
+                    getLogger().error('failed to deserialize item');
+                    return;
+                }
+                reincarnation[moduleIdSymbol] = serializedShadow[moduleIdSymbol];
+                const index = getShadowIndex(reincarnation, item, 
+                // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                // @ts-ignore
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+                item[overrideCollection.previousIndexSymbol]);
+                // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                // @ts-ignore
+                overrideCollection.add(reincarnation, index);
+            }
+            if (overrideCollection.shadowMap.get(itemId)?.length === 0) {
+                overrideCollection.shadowMap.delete(itemId);
+            }
+        }
+    });
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore // problem with listener type and generic
+    overrideCollection.added.addEventListener((item) => {
+        if (!item[moduleIdSymbol]) {
+            item[moduleIdSymbol] = getDynamicModuleId();
+        }
+    });
+    overrideCollection.removeModule = function removeModule(moduleId) {
+        overrideCollection.shadowMap.forEach((shadowsArray, name) => {
+            const newShadowsArray = shadowsArray.filter((c) => c[moduleIdSymbol] !== moduleId);
+            if (newShadowsArray.length === 0) {
+                overrideCollection.shadowMap.delete(name);
+            }
+            else if (newShadowsArray.length !== shadowsArray.length) {
+                overrideCollection.shadowMap.set(name, newShadowsArray);
+            }
+        });
+        [...overrideCollection]
+            .filter((item) => item[moduleIdSymbol] === moduleId)
+            .forEach((item) => {
+            overrideCollection.remove(item);
+            if (item.destroy) {
+                item.destroy();
+            }
+        });
+    };
+    overrideCollection.replaced = new VcsEvent();
+    /**
+     * @param {string} moduleId
+     * @returns {Object[]}
+     */
+    overrideCollection.serializeModule = function serializeModule(moduleId) {
+        return [...overrideCollection]
+            .map((item) => {
+            if (item[moduleIdSymbol] === moduleId) {
+                return serialize(item);
+            }
+            const itemId = item[overrideCollection.uniqueKey];
+            if (overrideCollection.shadowMap.has(itemId)) {
+                const array = overrideCollection.shadowMap.get(itemId);
+                return array.find((i) => i[moduleIdSymbol] === moduleId);
+            }
+            return null;
+        })
+            .filter((i) => i);
+    };
+    const originalDestroy = overrideCollection.destroy.bind(overrideCollection);
+    overrideCollection.destroy = function destroy() {
+        originalDestroy();
+        overrideCollection.shadowMap.clear();
+        overrideCollection.replaced.destroy();
+    };
+    return overrideCollection;
+}
+export default makeOverrideCollection;
+//# sourceMappingURL=overrideCollection.js.map

package/dist/src/util/overrideCollection.js.map

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

package/dist/src/util/projection.d.ts

@@ -0,0 +1,98 @@
+import { Projection as OLProjection } from 'ol/proj.js';
+import type { Coordinate } from 'ol/coordinate.js';
+export type ProjectionOptions = {
+    type?: string;
+    /**
+     * EPSG of the projection, for example: "EPSG:4326" if not specified, uses the framework projection
+     */
+    epsg?: string | number;
+    /**
+     * definition of the projection. See for example: {@link http://spatialreference.org/ref/epsg/4326/proj4/} proj4
+     */
+    proj4?: string;
+    /**
+     * aliases to define
+     */
+    alias?: string[];
+    /**
+     * an alternate prefix to use for custom projection
+     */
+    prefix?: string;
+};
+export type CorrectTransformFunction = (arg0: number[], arg1?: number[], arg2?: number) => number[];
+export declare const wgs84ToMercatorTransformer: CorrectTransformFunction;
+export declare const mercatorToWgs84Transformer: CorrectTransformFunction;
+/**
+ * Set the default projections epsg and proj4. Does not update
+ * projection created prior to this functions call.
+ */
+export declare function setDefaultProjectionOptions(options: ProjectionOptions): void;
+/**
+ * Projection Class, if no valid options are given, the Projection will initialize with the Framework default Projection
+ * For example:
+ *     <pre><code>
+ *         {
+ *          "epsg" : "EPSG:25833"
+ *          "proj4" : "+proj=utm +zone=33 +ellps=GRS80 +units=m +no_defs"
+ *         }
+ *     </code></pre>
+ */
+declare class Projection {
+    static get className(): string;
+    private _proj4;
+    private _epsg;
+    private _alias;
+    private _prefix;
+    constructor(options?: ProjectionOptions);
+    get epsg(): string;
+    get proj4(): string | undefined;
+    get proj(): OLProjection;
+    equals(projection: Projection): boolean;
+    static transform(dest: Projection, source: Projection, coords: Coordinate): Coordinate;
+    transformTo(dest: Projection, coords: Coordinate): Coordinate;
+    static transformCoordinates(dest: Projection, source: Projection, coords: Coordinate[]): Coordinate[];
+    /**
+     * returns a function to transform coordinates from source to dest
+     */
+    static getTransformer(dest: Projection, source: Projection): CorrectTransformFunction;
+    transformFrom(source: Projection, coords: Coordinate): Coordinate;
+    /**
+     * Returns the object literal representation of this object
+     */
+    toJSON(): ProjectionOptions;
+    /**
+     * Fast transform from Web-Mercator to WGS84
+     * @param  inPlace - whether to transform in place
+     */
+    static mercatorToWgs84(coords: Coordinate, inPlace?: boolean): Coordinate;
+    /**
+     * Fast transform from WGS84 to Web-Mercator
+     * @param  inPlace - whether to transform in place
+     */
+    static wgs84ToMercator(coords: Coordinate, inPlace?: boolean): Coordinate;
+    /**
+     * validates projection options, combination of epsg code and proj4
+     */
+    static validateOptions(options: ProjectionOptions): boolean;
+    /**
+     * parses an epsg code returns empty string if no code has been found
+     * for example:
+     * parseEPSGCode('epsg:4326') ==> '4326'
+     * parseEPSGCode('epsg:4326', 'EPSG:') ==> 'EPSG:4326'
+     * parseEPSGCode('asdasd', 'EPSG:') ==> ''
+     */
+    static parseEPSGCode(value?: string | number, prefix?: string): string;
+}
+export default Projection;
+/**
+ * Returns the default Projection.
+ */
+export declare function getDefaultProjection(): Projection;
+/**
+ * wgs84 Projection EPSG Code: 4326
+ */
+export declare const wgs84Projection: Projection;
+/**
+ * mercator Projection EPSG Code: 3857
+ */
+export declare const mercatorProjection: Projection;

package/dist/src/util/projection.js

@@ -0,0 +1,207 @@
+import { getTransform, get as getProjection, equivalent, } from 'ol/proj.js';
+import { register } from 'ol/proj/proj4.js';
+import proj4 from 'proj4';
+import { check } from '@vcsuite/check';
+export const wgs84ToMercatorTransformer = getTransform('EPSG:4326', 'EPSG:3857');
+export const mercatorToWgs84Transformer = getTransform('EPSG:3857', 'EPSG:4326');
+let defaultProjectionOption = {
+    epsg: 'EPSG:4326',
+};
+function parseEPSGCode(value, prefix = 'EPSG:') {
+    if (value) {
+        const regex = new RegExp(`^(?:${prefix})?(\\d+)`, 'i');
+        const matches = `${value}`.match(regex);
+        if (matches && matches[1]) {
+            return `${prefix}${matches[1]}`;
+        }
+    }
+    return '';
+}
+function validateProjectionOptions(options) {
+    let proj = null;
+    if (options.epsg) {
+        try {
+            proj = proj4(parseEPSGCode(options.epsg));
+        }
+        catch (error) {
+            proj = null;
+        }
+    }
+    if (options.proj4) {
+        try {
+            proj = proj4(options.proj4);
+        }
+        catch (error) {
+            proj = null;
+        }
+    }
+    return proj != null;
+}
+function registerProjection(options) {
+    const saneOptions = {
+        prefix: options.prefix,
+    };
+    if (options.epsg) {
+        saneOptions.epsg = parseEPSGCode(options.epsg, options.prefix);
+        if (saneOptions.epsg) {
+            if (options.proj4) {
+                saneOptions.proj4 = options.proj4;
+                proj4.defs(saneOptions.epsg, options.proj4);
+                register(proj4);
+            }
+            if (options.alias && Array.isArray(options.alias)) {
+                saneOptions.alias = options.alias;
+                saneOptions.alias.forEach((alias) => {
+                    proj4.defs(alias, proj4.defs(saneOptions.epsg));
+                    register(proj4);
+                });
+            }
+        }
+    }
+    return saneOptions;
+}
+/**
+ * Set the default projections epsg and proj4. Does not update
+ * projection created prior to this functions call.
+ */
+export function setDefaultProjectionOptions(options) {
+    check(options, { epsg: [String, Number], proj4: [String, undefined, null] });
+    if (!validateProjectionOptions(options)) {
+        throw new Error('Cannot set invalid projection options as default options');
+    }
+    defaultProjectionOption = registerProjection(options);
+}
+/**
+ * Projection Class, if no valid options are given, the Projection will initialize with the Framework default Projection
+ * For example:
+ *     <pre><code>
+ *         {
+ *          "epsg" : "EPSG:25833"
+ *          "proj4" : "+proj=utm +zone=33 +ellps=GRS80 +units=m +no_defs"
+ *         }
+ *     </code></pre>
+ */
+class Projection {
+    static get className() {
+        return 'Projection';
+    }
+    _proj4;
+    _epsg;
+    _alias;
+    _prefix;
+    constructor(options = { epsg: '' }) {
+        const saneOptions = registerProjection(options);
+        this._proj4 = saneOptions.proj4;
+        this._epsg = String(saneOptions.epsg);
+        if (!this.proj) {
+            this._epsg = Projection.parseEPSGCode(defaultProjectionOption.epsg);
+        }
+        this._alias = saneOptions.alias;
+        this._prefix = saneOptions.prefix;
+    }
+    get epsg() {
+        return this._epsg;
+    }
+    get proj4() {
+        return this._proj4;
+    }
+    get proj() {
+        return getProjection(this.epsg);
+    }
+    equals(projection) {
+        return equivalent(this.proj, projection.proj);
+    }
+    static transform(dest, source, coords) {
+        const transformer = getTransform(source.proj, dest.proj);
+        const newCoords = [0, 0];
+        transformer([coords[0], coords[1]], newCoords, 2);
+        if (coords.length > 2) {
+            newCoords.push(coords[2]);
+        }
+        return newCoords;
+    }
+    transformTo(dest, coords) {
+        return Projection.transform(dest, this, coords);
+    }
+    static transformCoordinates(dest, source, coords) {
+        const newCoords = [];
+        for (let i = 0; i < coords.length; i++) {
+            newCoords.push(Projection.transform(dest, source, coords[i]));
+        }
+        return newCoords;
+    }
+    /**
+     * returns a function to transform coordinates from source to dest
+     */
+    static getTransformer(dest, source) {
+        return getTransform(source.proj, dest.proj);
+    }
+    transformFrom(source, coords) {
+        return Projection.transform(this, source, coords);
+    }
+    /**
+     * Returns the object literal representation of this object
+     */
+    toJSON() {
+        const configObject = {
+            type: Projection.className,
+            epsg: this.epsg,
+        };
+        if (this.proj4) {
+            configObject.proj4 = this.proj4;
+        }
+        if (Array.isArray(this._alias) && this._alias.length > 0) {
+            configObject.alias = this._alias.slice();
+        }
+        if (this._prefix) {
+            configObject.prefix = this._prefix;
+        }
+        return configObject;
+    }
+    /**
+     * Fast transform from Web-Mercator to WGS84
+     * @param  inPlace - whether to transform in place
+     */
+    static mercatorToWgs84(coords, inPlace) {
+        return mercatorToWgs84Transformer(coords, inPlace ? coords : undefined, coords.length);
+    }
+    /**
+     * Fast transform from WGS84 to Web-Mercator
+     * @param  inPlace - whether to transform in place
+     */
+    static wgs84ToMercator(coords, inPlace) {
+        return wgs84ToMercatorTransformer(coords, inPlace ? coords : undefined, coords.length);
+    }
+    /**
+     * validates projection options, combination of epsg code and proj4
+     */
+    static validateOptions(options) {
+        return validateProjectionOptions(options);
+    }
+    /**
+     * parses an epsg code returns empty string if no code has been found
+     * for example:
+     * parseEPSGCode('epsg:4326') ==> '4326'
+     * parseEPSGCode('epsg:4326', 'EPSG:') ==> 'EPSG:4326'
+     * parseEPSGCode('asdasd', 'EPSG:') ==> ''
+     */
+    static parseEPSGCode(value, prefix = 'EPSG:') {
+        return parseEPSGCode(value, prefix);
+    }
+}
+export default Projection;
+/**
+ * Returns the default Projection.
+ */
+export function getDefaultProjection() {
+    return new Projection(defaultProjectionOption);
+}
+/**
+ * wgs84 Projection EPSG Code: 4326
+ */
+export const wgs84Projection = new Projection({ epsg: 4326 });
+/**
+ * mercator Projection EPSG Code: 3857
+ */
+export const mercatorProjection = new Projection({ epsg: 3857 });
+//# sourceMappingURL=projection.js.map

package/dist/src/util/projection.js.map

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

package/dist/src/util/urlHelpers.d.ts

@@ -0,0 +1 @@
+export declare function isSameOrigin(source: string): boolean;

package/dist/src/util/urlHelpers.js

@@ -0,0 +1,12 @@
+// eslint-disable-next-line import/prefer-default-export
+export function isSameOrigin(source) {
+    const { location } = window;
+    const url = new URL(source, `${location.protocol}//${location.host}${location.pathname}`);
+    // for instance data: URIs have no host information and are implicitly same origin
+    // see https://developer.mozilla.org/en-US/docs/Web/Security/Same-origin_policy#inherited_origins
+    if (!url.host) {
+        return true;
+    }
+    return url.protocol === location.protocol && url.host === location.host;
+}
+//# sourceMappingURL=urlHelpers.js.map

package/dist/src/util/urlHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlHelpers.js","sourceRoot":"","sources":["../../../src/util/urlHelpers.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAC5B,MAAM,GAAG,GAAG,IAAI,GAAG,CACjB,MAAM,EACN,GAAG,QAAQ,CAAC,QAAQ,KAAK,QAAQ,CAAC,IAAI,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAC7D,CAAC;IACF,kFAAkF;IAClF,iGAAiG;IACjG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;QACb,OAAO,IAAI,CAAC;KACb;IACD,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC;AAC1E,CAAC"}

package/dist/src/util/viewpoint.d.ts

@@ -0,0 +1,155 @@
+import type { Coordinate } from 'ol/coordinate.js';
+import { EasingFunction } from '@vcmap-cesium/engine';
+import VcsObject, { VcsObjectOptions } from '../vcsObject.js';
+import Extent from './extent.js';
+/**
+ * compares two numeric properties
+ * @param  left
+ * @param  right
+ * @param  epsilon
+ */
+export declare function propertyEqualsEpsilon(left: number | undefined, right: number | undefined, epsilon: number): boolean;
+/**
+ * compares two angles in 360 degree range
+ * @param  left angle in degree
+ * @param  right angle in degree
+ * @param  epsilon in degree
+ */
+export declare function angleEqualsEpsilon(left: number, right: number, epsilon: number): boolean;
+/**
+ * compares two coordinates componentwise
+ * @param  left
+ * @param  right
+ * @param  epsilon
+ */
+export declare function coordinateEqualsEpsilon(left: Coordinate | undefined | null, right: Coordinate | undefined | null, epsilon: number): boolean;
+export type ViewpointOptions = VcsObjectOptions & {
+    /**
+     * Z value mandatory
+     */
+    cameraPosition?: Coordinate;
+    /**
+     * Z value optional
+     */
+    groundPosition?: Coordinate;
+    /**
+     * distance between the camera position and the target
+     */
+    distance?: number;
+    /**
+     * angle between 0 and 360 degree
+     */
+    heading?: number;
+    /**
+     * angle between 0 and 360 degree
+     */
+    pitch?: number;
+    /**
+     * angle between 0 and 360 degree
+     */
+    roll?: number;
+    /**
+     * if possible the switching to the new viewpoint will be animated
+     */
+    animate?: boolean;
+    /**
+     * animation duration override
+     */
+    duration?: number;
+    /**
+     * a Cesium.EasingFunction name to use for the flight
+     */
+    easingFunctionName?: string;
+};
+export type ViewpointUrlParameters = {
+    cameraPosition?: string;
+    groundPosition?: string;
+    epsg?: string;
+    proj4?: string;
+    distance?: string;
+    pitch?: string;
+    heading?: string;
+    roll?: string;
+};
+/**
+ * A Viewpoint Object
+ * @group Viewpoint
+ */
+declare class Viewpoint extends VcsObject {
+    static get className(): string;
+    /**
+     * position of the camera (optional) (cameraPosition needs  x, y, and height value)
+     * either a cameraPosition or a groundPosition have to be provided
+     */
+    cameraPosition: Coordinate | null;
+    /**
+     * groundPosition, point on the ground the camera looks at (optional)
+     * either a cameraPosition or a groundPosition have to be provided
+     */
+    groundPosition: Coordinate | null;
+    /**
+     * distance between target and camera position, only needed if a groundPosition is given
+     * is used to move the cameraPosition backwards to get some distance from the ground
+     */
+    distance: number | undefined;
+    /**
+     * heading, angle between 0 and 360 degree 0° = North, 90° = east ...
+     */
+    heading: number;
+    /**
+     * pitch in degrees ranges -90 to 90
+     */
+    pitch: number;
+    /**
+     * roll in degrees, ranges -90 to 90
+     */
+    roll: number;
+    /**
+     * animate this viewpoint when setting it on a map
+     */
+    animate: boolean;
+    /**
+     * An optional duration in seconds to override durations when animating this viewpoint
+     */
+    duration: number | undefined;
+    /**
+     * The name of the easing function to use
+     */
+    easingFunctionName: string | undefined;
+    /**
+     * @param  options
+     */
+    constructor(options: ViewpointOptions);
+    get easingFunction(): EasingFunction.Callback | null;
+    /**
+     * @returns  returns a options object. This object can be used to reconstruct a new viewpoint
+     */
+    toJSON(): ViewpointOptions;
+    /**
+     * clones the viewpoint
+     */
+    clone(): Viewpoint;
+    /**
+     * creates a String representation of this viewpoint
+     */
+    toString(): string;
+    /**
+     * Creates a viewpoint based on an extent
+     * @param  extent
+     */
+    static createViewpointFromExtent(extent: import('ol/extent.js').Extent | Extent): Viewpoint | null;
+    /**
+     * creates a new Viewpoint Object from url Paramter
+     * @param  urlParameter
+     */
+    static parseURLparameter(urlParameter: ViewpointUrlParameters): Viewpoint;
+    /**
+     * Checks if this Viewpoint is Valid
+     */
+    isValid(): boolean;
+    /**
+     * compares the provided Viewpoint with this viewpoint componentwise
+     */
+    equals(other: Viewpoint, epsilon?: number): boolean;
+}
+export default Viewpoint;