@combeenation/3d-viewer 12.4.1 → 13.0.0

package/dist/lib-cjs/internal/paintableHelper.js

@@ -0,0 +1,287 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePaintable = exports.paintableParameterObserver = void 0;
+const index_1 = require("../index");
+const is_svg_1 = __importDefault(require("is-svg"));
+const lodash_es_1 = require("lodash-es");
+/**
+ * Observer implementation for "paintable" parameter.
+ * Basically creates a dynamic texture from the source image and assigns it as albedo (or diffuse) texture.
+ */
+function paintableParameterObserver(newValue, materials, scene) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const paintable = parsePaintable(newValue);
+        // check if value is svg or image source, do the conversion accordingly
+        const srcIsSvg = (0, is_svg_1.default)(paintable.src);
+        if (!srcIsSvg && paintable.src.includes('<svg') && paintable.src.includes('</svg>')) {
+            // seems like the user tried to use a SVG string, as <svg> tags are used
+            // inform the user that this is not a valid SVG string
+            throw new index_1.ViewerError({
+                id: index_1.ViewerErrorIds.InvalidParameterValue,
+                message: `Invalid value for parameter "paintable" given:\nsource string is no valid SVG string\nGiven value: ${paintable.src}`,
+            });
+        }
+        let imageSource;
+        try {
+            imageSource = srcIsSvg ? yield _createImageFromSvg(paintable.src) : yield _createImageFromImgSrc(paintable.src);
+        }
+        catch (_a) {
+            // SVG might be invalid, even if it passes `isSvg` check
+            // in this case the image can't be created and will throw an error, which should be handled by the viewer and
+            // Combeenation viewer control
+            throw new index_1.ViewerError({
+                id: index_1.ViewerErrorIds.InvalidParameterValue,
+                message: `Invalid value for parameter "paintable" given:\nimage can't be created from source string\nGiven value: ${paintable.src}`,
+            });
+        }
+        // apply image source on desired material(s)
+        for (const material of materials) {
+            _drawPaintableOnMaterial(material, imageSource, scene, paintable.options);
+        }
+    });
+}
+exports.paintableParameterObserver = paintableParameterObserver;
+/**
+ * Parser for paintable value.
+ * ATM this is only used internally, but it could theoretically be used to create ones own paintable implementation.
+ *
+ * @param value The value to parse. Examples:
+ *              ```ts
+ *              // Default definition as JSON object:
+ *              '{ "src": "https://path.to/image.jpg", "uScale": 0.5 }'
+ *
+ *              // Short hand definition, only contains source string:
+ *              'https://path.to/image.jpg'
+ *
+ *              // Full content, paintable texture is flipped in both directions
+ *              '{ "src": "https://path.to/image.jpg", "uScale": -1, "vScale": -1, "uOffset": 0, "vOffset": 0 }'
+ *
+ *              // SVG content can be used directly:
+ *              '<svg>...</svg>'
+ *
+ *              // SVG in src property works as well:
+ *              '{ "src": "<svg>...</svg>", "uScale": 0.5 }'
+ *              ```
+ */
+function parsePaintable(value) {
+    if (!(0, lodash_es_1.isString)(value)) {
+        throw new index_1.ViewerError({
+            id: index_1.ViewerErrorIds.InvalidParameterValue,
+            message: `Unable to parse paintable value: not a string\nGiven value: ${value}`,
+        });
+    }
+    const paintableValue = { src: '' };
+    let valObj = null;
+    try {
+        valObj = JSON.parse(value);
+    }
+    catch (_a) {
+        // use string directly
+        paintableValue.src = value;
+        if (value.startsWith('{')) {
+            // seems like the user tried to use a JSON string, as the input starts with {
+            throw new index_1.ViewerError({
+                id: index_1.ViewerErrorIds.InvalidParameterValue,
+                message: `Unable to parse paintable value: not a valid JSON string\nGiven value: ${value}`,
+            });
+        }
+    }
+    if (valObj) {
+        // input string is JSON, src attribute is required
+        if (!valObj.src) {
+            throw new index_1.ViewerError({
+                id: index_1.ViewerErrorIds.InvalidParameterValue,
+                message: `Unable to parse paintable value: property "src" is missing\nGiven value: ${value}`,
+            });
+        }
+        if (!(0, lodash_es_1.isString)(valObj.src)) {
+            throw new index_1.ViewerError({
+                id: index_1.ViewerErrorIds.InvalidParameterValue,
+                message: `Unable to parse paintable value: property "src" is not a string\nGiven value: ${value}`,
+            });
+        }
+        // split src and options
+        const { src } = valObj, options = __rest(valObj, ["src"]);
+        paintableValue.src = src;
+        // only forward valid paintable options
+        const validOptionKeys = ['uScale', 'vScale', 'uOffset', 'vOffset'];
+        const { validOptions, invalidKeys } = Object.entries(options).reduce((accRes, [curKey, curValue]) => {
+            const isValidKey = validOptionKeys.includes(curKey);
+            if (isValidKey) {
+                accRes.validOptions[curKey] = curValue;
+            }
+            else {
+                accRes.invalidKeys.push(curKey);
+            }
+            return accRes;
+        }, { validOptions: {}, invalidKeys: [] });
+        if (invalidKeys.length) {
+            console.warn('Invalid paintable options provided: ' + invalidKeys.toString());
+        }
+        paintableValue.options = validOptions;
+    }
+    return paintableValue;
+}
+exports.parsePaintable = parsePaintable;
+function _drawPaintableOnMaterial(material, imageSource, scene, options) {
+    var _a, _b, _c, _d;
+    // always take width and height from image source, scaling is done with uvScale properties
+    const widthAndHeight = {
+        width: imageSource.width,
+        height: imageSource.height,
+    };
+    const texture = new index_1.DynamicTexture(`${material.id}.paintable_texture`, widthAndHeight, scene);
+    // draw image on texture
+    const ctx = texture.getContext();
+    ctx.drawImage(imageSource, 0, 0);
+    texture.update();
+    // apply settings from paintable options to tweak position and scaling of image on the texture
+    texture.uScale = (_a = options === null || options === void 0 ? void 0 : options.uScale) !== null && _a !== void 0 ? _a : texture.uScale;
+    texture.vScale = (_b = options === null || options === void 0 ? void 0 : options.vScale) !== null && _b !== void 0 ? _b : texture.vScale;
+    texture.uOffset = (_c = options === null || options === void 0 ? void 0 : options.uOffset) !== null && _c !== void 0 ? _c : texture.uOffset;
+    texture.vOffset = (_d = options === null || options === void 0 ? void 0 : options.vOffset) !== null && _d !== void 0 ? _d : texture.vOffset;
+    // wrap mode is preferred, as it will always show the texture, no matter which position offset is currently chosen
+    // clamp mode requires more knowledge (and patience) when adjusting the uv scale and offset values
+    texture.wrapU = index_1.Texture.WRAP_ADDRESSMODE;
+    texture.wrapV = index_1.Texture.WRAP_ADDRESSMODE;
+    // apply the paintable texture on the dedicated material type
+    const materialCls = material.getClassName();
+    switch (materialCls) {
+        case 'PBRMaterial':
+            material.albedoTexture = texture;
+            break;
+        case 'StandardMaterial':
+            material.diffuseTexture = texture;
+            break;
+        default:
+            throw new Error(`Setting paintable texture for material of instance "${materialCls}" not implemented (yet)`);
+    }
+}
+/**
+ * Creates a HTML image element based on a SVG string, whereas all the embedded assets in the SVG (eg: fonts, images)
+ * are already loaded and exchanged by their base64 representation.\
+ * There the output image can exist as "standalone" image and may be used for example as a paintable.
+ *
+ * !!CAUTION!!: The used functions within this code section are very well evaluated since most alternatives
+ * somehow don't work in Safari, as mentioned in the following BJS forum entries:
+ * - https://forum.babylonjs.com/t/drawing-svg-content-text-into-dynamictexture-doesnt-work-in-safari-v15/25048
+ * - https://forum.babylonjs.com/t/texture-createfrombase64string-doesnt-seem-to-work-for-ios-devices-initially/25502
+ */
+function _createImageFromSvg(svgSrc) {
+    return __awaiter(this, void 0, void 0, function* () {
+        // replace assets with their base64 versions in svg source code
+        const svgWithAssetsEmbedded = yield _embedAssets(svgSrc);
+        // create data string which can be used as an image source
+        const svgEncoded = 'data:image/svg+xml,' + encodeURIComponent(svgWithAssetsEmbedded);
+        return _createImageFromImgSrc(svgEncoded);
+    });
+}
+/**
+ * Creates an HTML image element from a dedicated image source.\
+ * Also waits until the image has loaded.
+ *
+ * !!CAUTION!!: The `setTimeout` after loading is finished is required due to a Safari bug:
+ * - https://bugs.webkit.org/show_bug.cgi?id=39059
+ * - https://bugs.webkit.org/show_bug.cgi?id=219770
+ *
+ * It's not 100% ensured that the timeout solves the issue in every case, but there is no other way unfortunately.\
+ * => Keep an eye on it in future projects
+ *
+ * @param imgSrc Theoretically every source is valid which is also supported by
+ *               [HTMLImageElement.src](https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/src).\
+ *               Known exceptions are SVGs with embedded assets that are provided as object URL. See comments in
+ *               {@link createImageFromSvg} for further details.
+ */
+function _createImageFromImgSrc(imgSrc) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const img = new Image();
+        yield new Promise((resolve, reject) => {
+            img.onload = () => {
+                setTimeout(resolve, 0);
+            };
+            img.onerror = () => {
+                reject();
+            };
+            img.crossOrigin = 'anonymous';
+            img.src = imgSrc;
+        });
+        return img;
+    });
+}
+/**
+ * Replaces all supported image & font URLs in the given SVG with their base64 representation.
+ */
+function _embedAssets(svgSrc) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const _imageExtensions = ['png', 'gif', 'jpg', 'jpeg', 'svg', 'bmp'];
+        const _fontExtensions = ['woff2', 'woff', 'ttf', 'otf'];
+        const _assetExtensions = [..._imageExtensions, ..._fontExtensions];
+        // Regex copied from https://stackoverflow.com/a/8943487/1273551, not "stress tested"...
+        const urlRegex = /(\bhttps?:\/\/[-A-Z0-9+&@#/%?=~_|!:,.;]*[-A-Z0-9+&@#/%=~_|])/gi;
+        const allUrls = svgSrc.match(urlRegex);
+        const assetUrls = allUrls.filter(url => {
+            const indexParam = url.indexOf('?');
+            // remove url parameter to recognize extension
+            if (indexParam > -1) {
+                url = url.substring(0, indexParam);
+            }
+            return _assetExtensions.some(extension => url.toLowerCase().endsWith(`.${extension}`));
+        });
+        const assetBase64Fetcher = assetUrls.map(_fetchBase64AssetUrl);
+        const assetFetcherResults = yield Promise.all(assetBase64Fetcher);
+        return assetFetcherResults.reduce((svgSrc, x) => svgSrc.replace(x.url, x.base64), svgSrc);
+    });
+}
+/**
+ * Fetch asset (image or font) and convert it to base64 string representation.
+ */
+function _fetchBase64AssetUrl(assetUrl) {
+    return __awaiter(this, void 0, void 0, function* () {
+        // TODO WTT: Cache known base64 representation and only fetch/convert when not already known.
+        //           Usually the fetch shouldn't hit the network but the browser cache since the SVG was already drawn..
+        const resp = yield fetch(assetUrl);
+        const blob = yield resp.blob();
+        return new Promise((resolve, reject) => {
+            const reader = new FileReader();
+            reader.onloadend = (event) => {
+                const target = event.target;
+                if (!target) {
+                    return reject(`Asset with URL "${assetUrl}" could not be loaded.`);
+                }
+                const result = target.result;
+                if (!result) {
+                    return reject(`Asset with URL "${assetUrl}" returned an empty result.`);
+                }
+                resolve({
+                    url: assetUrl,
+                    base64: result.toString(),
+                });
+            };
+            reader.readAsDataURL(blob);
+        });
+    });
+}
+//# sourceMappingURL=paintableHelper.js.map

package/dist/lib-cjs/internal/paintableHelper.js.map

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

package/dist/lib-cjs/internal/tagsHelper.d.ts

@@ -0,0 +1,12 @@
+import { Material, Node } from '../index';
+/**
+ * This is a wrapper around Babylon.js Tags API, as the API is really clunky to use
+ */
+declare type TagTarget = Node | Material;
+export declare function hasTag(object: TagTarget, tag: string): boolean;
+export declare function getTags(object: TagTarget): string[];
+export declare function setTags(object: TagTarget, tags: string[]): void;
+export declare function deleteAllTags(object: TagTarget): void;
+export declare function setTagsAsString(object: TagTarget, tagsString: string): void;
+export declare function cloneTags(sourceObject: TagTarget, destinationObject: TagTarget): void;
+export {};

package/dist/lib-cjs/internal/tagsHelper.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cloneTags = exports.setTagsAsString = exports.deleteAllTags = exports.setTags = exports.getTags = exports.hasTag = void 0;
+const tags_1 = require("@babylonjs/core/Misc/tags");
+function hasTag(object, tag) {
+    return tags_1.Tags.MatchesQuery(object, tag);
+}
+exports.hasTag = hasTag;
+function getTags(object) {
+    var _a;
+    const tagsObject = (_a = tags_1.Tags.GetTags(object, false)) !== null && _a !== void 0 ? _a : {};
+    const tags = Object.keys(tagsObject);
+    return tags;
+}
+exports.getTags = getTags;
+function setTags(object, tags) {
+    const tagsString = tags.join(' ');
+    tags_1.Tags.AddTagsTo(object, tagsString);
+}
+exports.setTags = setTags;
+function deleteAllTags(object) {
+    const curTags = tags_1.Tags.GetTags(object);
+    if (curTags) {
+        tags_1.Tags.RemoveTagsFrom(object, curTags);
+    }
+}
+exports.deleteAllTags = deleteAllTags;
+function setTagsAsString(object, tagsString) {
+    tags_1.Tags.AddTagsTo(object, tagsString);
+}
+exports.setTagsAsString = setTagsAsString;
+function cloneTags(sourceObject, destinationObject) {
+    if (tags_1.Tags.HasTags(sourceObject)) {
+        tags_1.Tags.AddTagsTo(destinationObject, tags_1.Tags.GetTags(sourceObject, true));
+    }
+}
+exports.cloneTags = cloneTags;
+//# sourceMappingURL=tagsHelper.js.map

package/dist/lib-cjs/internal/tagsHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tagsHelper.js","sourceRoot":"","sources":["../../../src/internal/tagsHelper.ts"],"names":[],"mappings":";;;AACA,oDAAiD;AAQjD,SAAgB,MAAM,CAAC,MAAiB,EAAE,GAAW;IACnD,OAAO,WAAI,CAAC,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACxC,CAAC;AAFD,wBAEC;AAED,SAAgB,OAAO,CAAC,MAAiB;;IACvC,MAAM,UAAU,GAAG,MAAA,WAAI,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,mCAAI,EAAE,CAAC;IACrD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAErC,OAAO,IAAI,CAAC;AACd,CAAC;AALD,0BAKC;AAED,SAAgB,OAAO,CAAC,MAAiB,EAAE,IAAc;IACvD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClC,WAAI,CAAC,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACrC,CAAC;AAHD,0BAGC;AAED,SAAgB,aAAa,CAAC,MAAiB;IAC7C,MAAM,OAAO,GAAG,WAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,OAAO,EAAE;QACX,WAAI,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC;AACH,CAAC;AALD,sCAKC;AAED,SAAgB,eAAe,CAAC,MAAiB,EAAE,UAAkB;IACnE,WAAI,CAAC,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACrC,CAAC;AAFD,0CAEC;AAED,SAAgB,SAAS,CAAC,YAAuB,EAAE,iBAA4B;IAC7E,IAAI,WAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE;QAC9B,WAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,WAAI,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC;KACrE;AACH,CAAC;AAJD,8BAIC"}

package/dist/lib-cjs/manager/cameraManager.d.ts

@@ -0,0 +1,51 @@
+import { AnimationGroup, ArcRotateCamera, ExcludedGeometryList, Vector3, Viewer } from '../index';
+export declare type CameraPosition = {
+    alpha: number;
+    beta: number;
+    radius: number;
+    target: Vector3;
+};
+export declare type AutofocusSettings = {
+    /** Can be used to customize the margins shown around the 3d model. Defaults to 1. */
+    radiusFactor?: number;
+    adjustWheelPrecision?: boolean;
+    adjustPanningSensibility?: boolean;
+    adjustPinchPrecision?: boolean;
+    /** Desired horizontal camera angle, this won't be overwritten by the autofocus function */
+    alpha?: number;
+    /** Desired vertical camera angle, this won't be overwritten by the autofocus function */
+    beta?: number;
+    /** Optional list of geometry to be excluded from consideration */
+    exclude?: ExcludedGeometryList;
+    durationMs?: number;
+};
+/**
+ * Manager for camera related tasks
+ */
+export declare class CameraManager {
+    protected viewer: Viewer;
+    static readonly CAMERA_ANIMATION_NAME = "__cameraAnimation__";
+    /** @internal */
+    static readonly DEFAULT_CAMERA_POSITION: CameraPosition;
+    protected static readonly _AUTOFOCUS_CONSTANTS: {
+        minZ: number;
+        wheelPrecision: number;
+        panningSensibility: number;
+        pinchPrecision: number;
+    };
+    protected static readonly _DEFAULT_AUTOFOCUS_RADIUS_FACTOR = 1;
+    protected static readonly _DEFAULT_CAM_SPEED_MS = 250;
+    /** @internal */
+    constructor(viewer: Viewer);
+    /**
+     * Focuses the camera to see every visible mesh in scene and tries to optimize wheel precision and panning
+     */
+    autofocusActiveCamera(settings?: AutofocusSettings): Promise<void>;
+    /**
+     * Moves the active camera smoothly to certain position
+     *
+     * @param durationMs defaults to 250ms if unset, use 0 for instant movement
+     */
+    moveActiveCameraTo(position: CameraPosition, durationMs?: number): Promise<void>;
+    protected static _addCameraAnimationToGroup(targetProperty: string, from: number | Vector3, to: number | Vector3, framesPerSec: number, dataType: number, animationGroup: AnimationGroup, activeCamera: ArcRotateCamera): void;
+}

package/dist/lib-cjs/manager/cameraManager.js

@@ -0,0 +1,154 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CameraManager = void 0;
+const index_1 = require("../index");
+/**
+ * Manager for camera related tasks
+ */
+class CameraManager {
+    /** @internal */
+    constructor(viewer) {
+        this.viewer = viewer;
+    }
+    /**
+     * Focuses the camera to see every visible mesh in scene and tries to optimize wheel precision and panning
+     */
+    autofocusActiveCamera(settings) {
+        var _a, _b, _c;
+        return __awaiter(this, void 0, void 0, function* () {
+            const activeCamera = this.viewer.scene.activeCamera;
+            if (!(activeCamera instanceof index_1.ArcRotateCamera)) {
+                throw new Error(`Camera type "${activeCamera === null || activeCamera === void 0 ? void 0 : activeCamera.getClassName()}" is not implemented for "autofocusActiveCamera".`);
+            }
+            // get bounding box of all visible meshes, this is the base for the autofocus algorithm
+            const boundingInfo = this.viewer.calculateBoundingInfo(settings === null || settings === void 0 ? void 0 : settings.exclude);
+            // optionally show bounding sphere for debugging purpose
+            this.viewer.eventManager.fireEvent(index_1.ViewerEvent.AutofocusStart, boundingInfo.boundingSphere);
+            const radius = boundingInfo.boundingSphere.radius;
+            const center = boundingInfo.boundingSphere.center;
+            // set lower radius limit on edge of bounding sphere to make sure that we can't dive into the meshes
+            activeCamera.lowerRadiusLimit = radius;
+            // additional settings
+            // constants for division are taken directly from Babylon.js repository
+            activeCamera.minZ = Math.min(radius / CameraManager._AUTOFOCUS_CONSTANTS.minZ, 1);
+            if ((settings === null || settings === void 0 ? void 0 : settings.adjustWheelPrecision) !== false) {
+                activeCamera.wheelPrecision = CameraManager._AUTOFOCUS_CONSTANTS.wheelPrecision / radius;
+            }
+            if ((settings === null || settings === void 0 ? void 0 : settings.adjustPanningSensibility) !== false) {
+                activeCamera.panningSensibility = CameraManager._AUTOFOCUS_CONSTANTS.panningSensibility / radius;
+            }
+            if ((settings === null || settings === void 0 ? void 0 : settings.adjustPinchPrecision) !== false) {
+                activeCamera.pinchPrecision = CameraManager._AUTOFOCUS_CONSTANTS.pinchPrecision / radius;
+            }
+            const radiusFactor = (_a = settings === null || settings === void 0 ? void 0 : settings.radiusFactor) !== null && _a !== void 0 ? _a : CameraManager._DEFAULT_AUTOFOCUS_RADIUS_FACTOR;
+            const alpha = (_b = settings === null || settings === void 0 ? void 0 : settings.alpha) !== null && _b !== void 0 ? _b : CameraManager.DEFAULT_CAMERA_POSITION.alpha;
+            const beta = (_c = settings === null || settings === void 0 ? void 0 : settings.beta) !== null && _c !== void 0 ? _c : CameraManager.DEFAULT_CAMERA_POSITION.beta;
+            // calculation is taken from Babylon.js repository, which on their side took it from this SO post:
+            // http://stackoverflow.com/questions/2866350/move-camera-to-fit-3d-scene
+            // there's a good sketch which explains the calculation quite a bit
+            const aspectRatio = this.viewer.engine.getAspectRatio(activeCamera);
+            const frustumSlopeY = Math.tan(activeCamera.fov / 2);
+            const frustumSlopeX = frustumSlopeY * aspectRatio;
+            const distanceForHorizontalFrustum = radius * Math.sqrt(1 + 1 / (frustumSlopeX * frustumSlopeX));
+            const distanceForVerticalFrustum = radius * Math.sqrt(1 + 1 / (frustumSlopeY * frustumSlopeY));
+            const distance = Math.max(distanceForHorizontalFrustum, distanceForVerticalFrustum);
+            const newCameraPosition = {
+                alpha: alpha,
+                beta: beta,
+                radius: distance * radiusFactor,
+                target: center,
+            };
+            yield this.moveActiveCameraTo(newCameraPosition, settings === null || settings === void 0 ? void 0 : settings.durationMs);
+        });
+    }
+    /**
+     * Moves the active camera smoothly to certain position
+     *
+     * @param durationMs defaults to 250ms if unset, use 0 for instant movement
+     */
+    moveActiveCameraTo(position, durationMs = CameraManager._DEFAULT_CAM_SPEED_MS) {
+        var _a, _b, _c, _d;
+        return __awaiter(this, void 0, void 0, function* () {
+            const activeCamera = this.viewer.scene.activeCamera;
+            if (!(activeCamera instanceof index_1.ArcRotateCamera)) {
+                throw new Error(`Camera type "${activeCamera === null || activeCamera === void 0 ? void 0 : activeCamera.getClassName()}" is not implemented yet for "moveActiveCameraTo".`);
+            }
+            if (durationMs === 0) {
+                // instant movement without animation
+                activeCamera.alpha = (_a = position.alpha) !== null && _a !== void 0 ? _a : activeCamera.alpha;
+                activeCamera.beta = (_b = position.beta) !== null && _b !== void 0 ? _b : activeCamera.beta;
+                activeCamera.radius = (_c = position.radius) !== null && _c !== void 0 ? _c : activeCamera.radius;
+                activeCamera.target = (_d = position.target) !== null && _d !== void 0 ? _d : activeCamera.target;
+            }
+            const framesPerSec = 100;
+            const animationGroup = new index_1.AnimationGroup(CameraManager.CAMERA_ANIMATION_NAME, this.viewer.scene);
+            if (position.alpha !== undefined) {
+                // transform the target's alpha value into the same turn as the current camera position to avoid movements
+                // > 360 degrees
+                const alphaGap = activeCamera.alpha - position.alpha;
+                const cntTurns = Math.round(alphaGap / (2 * Math.PI));
+                const targetAlpha = position.alpha + 2 * Math.PI * cntTurns;
+                CameraManager._addCameraAnimationToGroup('alpha', activeCamera.alpha, targetAlpha, framesPerSec, index_1.Animation.ANIMATIONTYPE_FLOAT, animationGroup, activeCamera);
+            }
+            if (position.beta !== undefined) {
+                CameraManager._addCameraAnimationToGroup('beta', activeCamera.beta, position.beta, framesPerSec, index_1.Animation.ANIMATIONTYPE_FLOAT, animationGroup, activeCamera);
+            }
+            if (position.radius !== undefined) {
+                CameraManager._addCameraAnimationToGroup('radius', activeCamera.radius, position.radius, framesPerSec, index_1.Animation.ANIMATIONTYPE_FLOAT, animationGroup, activeCamera);
+            }
+            if (position.target !== undefined) {
+                CameraManager._addCameraAnimationToGroup('target', activeCamera.target, position.target, framesPerSec, index_1.Animation.ANIMATIONTYPE_VECTOR3, animationGroup, activeCamera);
+            }
+            // animation is created for 1 second (100 frames), adjust speed ratio according to desired movement time
+            const speedRatio = 1000 / durationMs;
+            return new Promise(resolve => {
+                animationGroup.onAnimationGroupEndObservable.addOnce(() => {
+                    animationGroup.dispose();
+                    resolve();
+                });
+                animationGroup.start(false, speedRatio, 0, 100);
+            });
+        });
+    }
+    static _addCameraAnimationToGroup(targetProperty, from, to, framesPerSec, dataType, animationGroup, activeCamera) {
+        const alphaAnimation = new index_1.Animation(targetProperty, targetProperty, framesPerSec, dataType, index_1.Animation.ANIMATIONLOOPMODE_CONSTANT);
+        alphaAnimation.setKeys([
+            {
+                frame: 0,
+                value: from,
+            },
+            {
+                frame: 100,
+                value: to,
+            },
+        ]);
+        animationGroup.addTargetedAnimation(alphaAnimation, activeCamera);
+    }
+}
+exports.CameraManager = CameraManager;
+CameraManager.CAMERA_ANIMATION_NAME = '__cameraAnimation__';
+/** @internal */
+CameraManager.DEFAULT_CAMERA_POSITION = {
+    alpha: (45 * Math.PI) / 180,
+    beta: (75 * Math.PI) / 180,
+    radius: 1,
+    target: new index_1.Vector3(0, 0, 0),
+};
+CameraManager._AUTOFOCUS_CONSTANTS = {
+    minZ: 100,
+    wheelPrecision: 100,
+    panningSensibility: 2500,
+    pinchPrecision: 200,
+};
+CameraManager._DEFAULT_AUTOFOCUS_RADIUS_FACTOR = 1;
+CameraManager._DEFAULT_CAM_SPEED_MS = 250;
+//# sourceMappingURL=cameraManager.js.map

package/dist/lib-cjs/manager/cameraManager.js.map

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

package/dist/lib-cjs/manager/debugManager.d.ts

@@ -0,0 +1,60 @@
+import { AxesViewer, BoundingSphere, Color3, IInspectorOptions, Scene, TransformNode, Vector3, Viewer } from '../index';
+declare type DebugAxisKeys = 'X' | 'Y' | 'Z';
+declare type DebugAxisConfig = {
+    color: Color3;
+    position: Vector3;
+};
+/**
+ * Manager for debugging functionalities
+ */
+export declare class DebugManager {
+    protected viewer: Viewer;
+    protected static _DEBUG_AXIS_MAP: Record<DebugAxisKeys, DebugAxisConfig>;
+    protected static _WORLD_COORD_ROOT_KEY: string;
+    protected static _BOUNDING_SPHERE_KEY: string;
+    protected _axesViewer: AxesViewer | null;
+    protected _showBoundingSphereForAutofocus: boolean;
+    /** @internal */
+    constructor(viewer: Viewer);
+    /**
+     * Assign callback for drawing bounding sphere on autofocusing
+     * @internal
+     */
+    registerAutofocusStartListener(): void;
+    /**
+     * Enables the Babylon.js [Inspector](https://doc.babylonjs.com/toolsAndResources/tools/inspector).\
+     * Due to the additional size of the inspector, this function is only available in "development" builds!
+     *
+     * @returns Signalizes if inspector could be loaded
+     */
+    showInspector(options?: IInspectorOptions): Promise<boolean>;
+    hideInspector(): void;
+    /**
+     * Show world coordinate system with given dimension.\
+     * This is especially usefull when working on project with tricky positioning. (e.g. clones)
+     */
+    showWorldCoordinates(dimension: number): void;
+    hideWorldCoordinates(): void;
+    /**
+     * Draws a wireframe bounding sphere on the next call of {@link CameraManager.autofocusActiveCamera}.\
+     * This is usefull for checking which parts of the scene get centered.
+     */
+    showBoundingSphereForAutofocus(): void;
+    hideBoundingSphereForAutofocus(): void;
+    /**
+     * Adjust and enhance coordinate axes to fulfill our needs.
+     * - moves nodes into common root
+     * - adds text node
+     */
+    protected static _prepareWorldCoordinateAxis(text: 'X' | 'Y' | 'Z', axis: TransformNode, root: TransformNode, dimension: number, utilityLayerScene: Scene): void;
+    /**
+     * Calculate factor for creating world coordinate axes with exactly one unit in length
+     */
+    protected static _getWorldCoordinatesAxesUnifyFactor(): number;
+    /**
+     * Visualize bounding sphere which is used to zoom in via `autofocusActiveCamera` function
+     */
+    protected _drawBoundingSphereForAutofocus(boundingSphere: BoundingSphere): void;
+    protected _removeBoundingSphereForAutofocus(): void;
+}
+export {};