@combeenation/3d-viewer 7.1.1 → 7.1.2

package/dist/lib-cjs/api/classes/viewer.js

@@ -1,671 +1,683 @@
-"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 __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Viewer = void 0;
-const buildinfo_json_1 = __importDefault(require("../../buildinfo.json"));
-const sceneSetup_1 = require("../internal/sceneSetup");
-const animationManager_1 = require("../manager/animationManager");
-const gltfExportManager_1 = require("../manager/gltfExportManager");
-const sceneManager_1 = require("../manager/sceneManager");
-const tagManager_1 = require("../manager/tagManager");
-const variantInstanceManager_1 = require("../manager/variantInstanceManager");
-const specStorage_1 = require("../store/specStorage");
-const babylonHelper_1 = require("../util/babylonHelper");
-const resourceHelper_1 = require("../util/resourceHelper");
-const sceneLoaderHelper_1 = require("../util/sceneLoaderHelper");
-const stringHelper_1 = require("../util/stringHelper");
-const structureHelper_1 = require("../util/structureHelper");
-const event_1 = require("./event");
-const eventBroadcaster_1 = require("./eventBroadcaster");
-const parameter_1 = require("./parameter");
-const arcRotateCamera_1 = require("@babylonjs/core/Cameras/arcRotateCamera");
-const boundingInfo_1 = require("@babylonjs/core/Culling/boundingInfo");
-const debugLayer_1 = require("@babylonjs/core/Debug/debugLayer");
-const engine_1 = require("@babylonjs/core/Engines/engine");
-const highlightLayer_1 = require("@babylonjs/core/Layers/highlightLayer");
-const sceneLoader_1 = require("@babylonjs/core/Loading/sceneLoader");
-const dynamicTexture_1 = require("@babylonjs/core/Materials/Textures/dynamicTexture");
-const standardMaterial_1 = require("@babylonjs/core/Materials/standardMaterial");
-const math_color_1 = require("@babylonjs/core/Maths/math.color");
-const math_vector_1 = require("@babylonjs/core/Maths/math.vector");
-const mesh_1 = require("@babylonjs/core/Meshes/mesh");
-const screenshotTools_1 = require("@babylonjs/core/Misc/screenshotTools");
-const webXRSessionManager_1 = require("@babylonjs/core/XR/webXRSessionManager");
-const lodash_es_1 = require("lodash-es");
-/**
- * The main exposed object. This is the entry point into the application
- *
- * ```js
- * const canvas = document.getElementById( 'babylon-canvas' );
- * const viewer = Viewer( canvas, '/path/to/index.json' );
- * ```
- * The class does nothing on its own and needs to {@link bootstrap}
- */
-class Viewer extends eventBroadcaster_1.EventBroadcaster {
-    /**
-     * Constructor
-     */
-    constructor(canvas, structureJson) {
-        super();
-        this.canvas = canvas;
-        this.structureJson = structureJson;
-        this._scene = null;
-        this._animationManager = null;
-        this._sceneManager = null;
-        this._tagManager = null;
-        this._gltfExportManager = null;
-        this._variantInstances = null;
-        // defaults to `false` as material cloning should be the edge case
-        this._cloneMaterialsOnMutation = false;
-        this._isRenderLoopPaused = false;
-        this._inspectorLoaded = false;
-        this._nodeNamingStrategyHandler = null;
-        this._tagManager = new tagManager_1.TagManager(this);
-        this._nodeNamingStrategyHandler = (node, payload) => {
-            var _a;
-            const suffix = [];
-            if (payload.variant.elements.length > 0) {
-                const nodeElements = payload.variant.elements.filter(e => e.nodesFlat.filter(n => { var _a, _b; return ((_b = (_a = n.metadata) === null || _a === void 0 ? void 0 : _a.cloneSource) === null || _b === void 0 ? void 0 : _b.id) === node.id; }).length > 0);
-                if (nodeElements.length > 0) {
-                    suffix.push(payload.variantParameterizable.name);
-                }
-            }
-            const variantInstances = this.variantInstances.allWithVariantName(payload.variant.name);
-            if (variantInstances.length > 0) {
-                suffix.push(payload.variantInstance.name);
-            }
-            const originalName = ((_a = node.metadata) === null || _a === void 0 ? void 0 : _a.originalName) || node.name;
-            return [originalName, ...suffix.filter(s => !!s)].join('.');
-        };
-    }
-    /**
-     * Help function for automatically creating a valid Spec from a list of variant names and dedicated GLB/babylon URLs.
-     * This data is most likely coming from babylon assets from the Combeenation system but other sources are also valid.
-     */
-    static generateSpec(genData) {
-        // dots in the variant name indicate inheritance, but this should not be the case for an auto-generated spec
-        // therefore dots are exchanged with slashes
-        const safeGenData = genData.map(data => (Object.assign(Object.assign({}, data), { name: (0, stringHelper_1.replaceDots)(data.name) })));
-        const spec = {
-            // common scene settings as suggested in the viewer docs
-            scene: {
-                engine: {
-                    antialiasing: true,
-                    options: {
-                        preserveDrawingBuffer: true,
-                        stencil: true,
-                        xrCompatible: false,
-                    },
-                },
-                scene: {
-                    globals: {},
-                },
-            },
-            setup: {
-                // create one instance for each input entry
-                // name and variant are named accordingly from the input, instance will be hidden by default and lazy loading
-                // is activated
-                instances: safeGenData.map(instanceData => ({
-                    name: instanceData.name,
-                    variant: instanceData.name,
-                    lazy: true,
-                    parameters: {
-                        [parameter_1.Parameter.VISIBLE]: false,
-                    },
-                })),
-            },
-            // variants definition is also mapped to the input array, using the name as key and url as glTF source
-            // no elements are created here, since this should be done automatically from the system
-            // => create one element which contains all root nodes of the imported 3d file (GLB or babylon)
-            variants: safeGenData.reduce((accVariants, curVariant) => {
-                accVariants[curVariant.name] = {
-                    glTF: curVariant.url,
-                };
-                return accVariants;
-            }, {}),
-        };
-        return spec;
-    }
-    /**
-     * Gets the Babylon.js Scene that is attached to the instance.
-     *
-     * @throws Error if the `scene` has not been initialized.
-     */
-    get scene() {
-        if (!this._scene) {
-            throw new Error(`Scene has not been initialized.`);
-        }
-        return this._scene;
-    }
-    /**
-     * Gets the {@link SceneManager} attached to the viewer.
-     *
-     * @throws Error if the {@link SceneManager} has not been initialized.
-     */
-    get sceneManager() {
-        if (!this._sceneManager) {
-            throw new Error(`SceneManager has not been initialized.`);
-        }
-        return this._sceneManager;
-    }
-    /**
-     * Gets the {@link GltfExportManager} attached to the viewer.
-     *
-     * @throws Error if the {@link GltfExportManager} has not been initialized.
-     */
-    get gltfExportManager() {
-        if (!this._gltfExportManager) {
-            throw new Error(`GltfExportManager has not been initialized.`);
-        }
-        return this._gltfExportManager;
-    }
-    /**
-     * Gets the Babylon.js Engine that is attached to the viewer.
-     */
-    get engine() {
-        return this.scene.getEngine();
-    }
-    /**
-     * Gets the {@link VariantInstanceManager} attached to the viewer.
-     *
-     * @throws Error if the {@link VariantInstanceManager} has not been initialized.
-     */
-    get variantInstances() {
-        if (!this._variantInstances) {
-            throw Error(`There is no variantInstanceManager.`);
-        }
-        return this._variantInstances;
-    }
-    /**
-     * Gets the {@link AnimationManager} attached to the viewer.
-     *
-     * @throws Error if the {@link AnimationManager} has not been initialized.
-     */
-    get animationManager() {
-        if (!this._animationManager) {
-            throw new Error(`There is no animationManager instance.`);
-        }
-        return this._animationManager;
-    }
-    get tagManager() {
-        if (!this._tagManager) {
-            throw new Error(`There is no tagManager instance.`);
-        }
-        return this._tagManager;
-    }
-    /**
-     * Gets the `cloneMaterialsOnMutation` flag, as defined in the spec
-     */
-    get cloneMaterialsOnMutation() {
-        return this._cloneMaterialsOnMutation;
-    }
-    /**
-     * Gets the strategy handler for naming cloned nodes.
-     */
-    get nodeNamingStrategyHandler() {
-        if (!this._nodeNamingStrategyHandler) {
-            throw new Error(`The NodeNamingStrategyHandler has not been registered yet.`);
-        }
-        return this._nodeNamingStrategyHandler;
-    }
-    /**
-     * Sets the strategy handler for naming cloned nodes.\
-     * Check the docs of the tag managers [renaming](https://3dviewer.docs.combeenation.com/pages/documentation/Tag-Manager.html#uniqueness-of-node-and-tag-names)
-     * chapter for further details.
-     */
-    set nodeNamingStrategyHandler(value) {
-        if (!value || typeof value !== 'function') {
-            throw new Error(`The NodeNamingStrategyHandler is not a callable function.`);
-        }
-        this._nodeNamingStrategyHandler = value;
-    }
-    /**
-     * Starts the application. This will
-     * * load the given "index" JSON file
-     * * setup the scene with the "scene" JSON file
-     * * create an (optional) default setup with different variant settings
-     * * sets up resizing by attaching a debounced version of {@link resize}
-     *
-     * @throws Error if any of the files is not found/valid
-     *
-     * @emits {@link Event.BOOTSTRAP_START}
-     * @emits {@link Event.BOOTSTRAP_END}
-     */
-    bootstrap(tagManagerParameterValues) {
-        return __awaiter(this, void 0, void 0, function* () {
-            this.broadcastEvent(event_1.Event.BOOTSTRAP_START, this);
-            let indexJson;
-            if ((0, lodash_es_1.isString)(this.structureJson)) {
-                indexJson = yield (0, resourceHelper_1.loadJson)(this.structureJson);
-            }
-            else {
-                indexJson = this.structureJson;
-            }
-            if (!indexJson.scene) {
-                throw new Error(`No "scene" property found for bootstrapping.`);
-            }
-            // fill spec store
-            specStorage_1.SpecStorage.createFromSpec(indexJson);
-            // init custom loader plugin
-            this.initCbnBabylonLoaderPlugin();
-            // load scene
-            if ((0, lodash_es_1.isString)(indexJson.scene)) {
-                const sceneJson = yield (0, resourceHelper_1.loadJson)(indexJson.scene);
-                indexJson.scene = sceneJson;
-            }
-            this._scene = yield this.initScene();
-            // create instance manager
-            this._variantInstances = yield variantInstanceManager_1.VariantInstanceManager.create(this);
-            // create optional default instances
-            if (indexJson.setup) {
-                if ((0, lodash_es_1.isString)(indexJson.setup)) {
-                    const setupJson = yield (0, resourceHelper_1.loadJson)(indexJson.setup);
-                    indexJson.setup = setupJson;
-                }
-                yield this.createVariantInstances(tagManagerParameterValues);
-            }
-            this.broadcastEvent(event_1.Event.VARIANT_INSTANCES_READY, this);
-            // create gltf export manager
-            this._gltfExportManager = yield gltfExportManager_1.GltfExportManager.create(this);
-            // resize handler
-            window.addEventListener('resize', (0, resourceHelper_1.debounce)(this.resize.bind(this), 100));
-            // wait until scene is completely ready
-            yield this.scene.whenReadyAsync();
-            // event broadcasting
-            this.broadcastEvent(event_1.Event.BOOTSTRAP_END, this);
-            // render loop
-            this.engine.runRenderLoop(() => {
-                if (!this._isRenderLoopPaused)
-                    this.scene.render();
-            });
-            return this;
-        });
-    }
-    /**
-     * Enables the Babylon.js [Inspector](https://doc.babylonjs.com/toolsAndResources/tools/inspector).\
-     * Due to the additional size of the inspector, the CDN version is used instead of shipping the required code with
-     * the viewer.\
-     * This means that the code will be downloaded only when needed and calling `enableDebugLayer` can take a little while
-     * depending on your internet connection etc.
-     */
-    enableDebugLayer(options) {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (!this._inspectorLoaded) {
-                // CDN version of inspector requires the Babylon.js core to be available as CDN module as well
-                yield (0, resourceHelper_1.loadJavascript)('https://cdn.jsdelivr.net/npm/babylonjs@5.6.0/babylon.min.js');
-                debugLayer_1.DebugLayer.InspectorURL =
-                    'https://cdn.jsdelivr.net/npm/babylonjs-inspector@5.6.0/babylon.inspector.bundle.max.min.js';
-                this._inspectorLoaded = true;
-            }
-            yield this.scene.debugLayer.show(options);
-        });
-    }
-    /**
-     * Destroys all registered {@link VariantInstance}s that are registered
-     */
-    destroyVariantInstances() {
-        this.variantInstances.all.forEach(variantInstance => {
-            this.variantInstances.destroy(variantInstance.name);
-        });
-        return this;
-    }
-    /**
-     * Trigger a resize event for the `Engine`
-     */
-    resize() {
-        this.engine.resize();
-        return this;
-    }
-    /**
-     * A convenience method for directly getting a Node from a {@link VariantInstance} and an {@link Element} by its
-     * {@link DottedPath}s.
-     */
-    getNode(variantInstanceName, elementDottedPath, nodeDottedPath) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const variantInstance = yield this.variantInstances.get(variantInstanceName);
-            return variantInstance.getNode(elementDottedPath, nodeDottedPath);
-        });
-    }
-    /**
-     * A convenience method for directly getting a Node from a {@link VariantInstance} and an {@link Element} by its
-     * {@link DottedPath}s.
-     */
-    getMesh(variantInstanceName, elementDottedPath, meshDottedPath) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const variantInstance = yield this.variantInstances.get(variantInstanceName);
-            return variantInstance.getMesh(elementDottedPath, meshDottedPath);
-        });
-    }
-    /**
-     * Switches the camera
-     *
-     * @emits {@link Event.CAMERA_SWITCHED}
-     */
-    switchCamera(newCamera, reset = true) {
-        const camera = this.scene.getCameraByName(newCamera);
-        if (camera) {
-            const activeCamera = this.scene.activeCamera;
-            if (activeCamera) {
-                activeCamera.detachControl(this.engine.getRenderingCanvas());
-            }
-            if (reset) {
-                camera.restoreState();
-            }
-            this.scene.setActiveCameraByName(newCamera);
-            camera.attachControl(this.engine.getRenderingCanvas());
-            this.broadcastEvent(event_1.Event.CAMERA_SWITCHED, camera);
-        }
-        else {
-            throw new Error(`Given camera "${newCamera}" not found.`);
-        }
-        // TODO: put traceable observers to new camera (@see element)
-        return this;
-    }
-    /**
-     * Moves or animates the active camera to given `placement`.
-     */
-    moveActiveCameraTo(placement, animation) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return this.animationManager.animateToPlacement(this.sceneManager.activeCamera, placement, animation);
-        });
-    }
-    /**
-     * Takes a sceenshot the the current scene. The result is a string containing a base64 encoded image
-     */
-    screenshot(settings) {
-        return new Promise((resolve, reject) => {
-            var _a, _b, _c, _d, _e, _f;
-            if (!this.engine) {
-                return reject('Engine is null');
-            }
-            if (!this.scene) {
-                return reject('Scene is null');
-            }
-            this.scene.render(); // in combination with a render target, we need to refresh the scene manually to get the latest view
-            screenshotTools_1.ScreenshotTools.CreateScreenshotUsingRenderTarget(this.engine, this.sceneManager.activeCamera, (_a = settings === null || settings === void 0 ? void 0 : settings.size) !== null && _a !== void 0 ? _a : { width: this.canvas.clientWidth, height: this.canvas.clientHeight }, resolve, (_b = settings === null || settings === void 0 ? void 0 : settings.mimeType) !== null && _b !== void 0 ? _b : 'image/png', (_c = settings === null || settings === void 0 ? void 0 : settings.samples) !== null && _c !== void 0 ? _c : 1, (_d = settings === null || settings === void 0 ? void 0 : settings.antialiasing) !== null && _d !== void 0 ? _d : false, (_e = settings === null || settings === void 0 ? void 0 : settings.fileName) !== null && _e !== void 0 ? _e : 'screenshot.png', (_f = settings === null || settings === void 0 ? void 0 : settings.renderSprites) !== null && _f !== void 0 ? _f : false);
-        });
-    }
-    /**
-     * Checks whether the browser is capable of handling XR.
-     */
-    isBrowserARCapable() {
-        return __awaiter(this, void 0, void 0, function* () {
-            return yield webXRSessionManager_1.WebXRSessionManager.IsSessionSupportedAsync('immersive-ar');
-        });
-    }
-    /**
-     * Calculates the bounding box from all visible meshes on the scene.
-     */
-    calculateBoundingBox(excludeGeometry) {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (this.scene.meshes.length === 0) {
-                throw new Error('There are currently no meshes on the scene.');
-            }
-            this.scene.render(); // CB-6062: workaround for BoundingBox not respecting render loop
-            const { max, min } = this.scene.meshes
-                .filter(mesh => {
-                const isEnabled = mesh.isEnabled();
-                // ignore the existing bounding box mesh for calculating the current one
-                const isNotBBoxMesh = Viewer.BOUNDING_BOX_NAME !== mesh.id;
-                // ignore meshes with invalid bounding infos
-                const hasValidBBoxInfo = mesh.getBoundingInfo().boundingSphere.radius > 0;
-                // ignore excluded meshes
-                const isExcluded = excludeGeometry ? (0, structureHelper_1.isMeshIncludedInExclusionList)(mesh, excludeGeometry) : false;
-                return isEnabled && isNotBBoxMesh && hasValidBBoxInfo && !isExcluded;
-            })
-                .reduce((accBBoxMinMax, curMesh, idx) => {
-                const bBox = curMesh.getBoundingInfo().boundingBox;
-                // use the first entry in the array as default value and get the resulting maximum/minimum values
-                const max = idx === 0 ? bBox.maximumWorld : math_vector_1.Vector3.Maximize(accBBoxMinMax.max, bBox.maximumWorld);
-                const min = idx === 0 ? bBox.minimumWorld : math_vector_1.Vector3.Minimize(accBBoxMinMax.min, bBox.minimumWorld);
-                return { max, min };
-            }, { max: new math_vector_1.Vector3(), min: new math_vector_1.Vector3() });
-            let boundingBox = this.scene.getMeshByName(Viewer.BOUNDING_BOX_NAME);
-            if (!boundingBox) {
-                boundingBox = new mesh_1.Mesh(Viewer.BOUNDING_BOX_NAME, this.scene);
-            }
-            boundingBox.setBoundingInfo(new boundingInfo_1.BoundingInfo(min, max));
-            return boundingBox;
-        });
-    }
-    /**
-     * Focuses the camera to see every visible mesh in scene and tries to optimize wheel precision and panning
-     */
-    autofocusActiveCamera(settings) {
-        var _a, _b, _c, _d;
-        return __awaiter(this, void 0, void 0, function* () {
-            // first check some preconditions
-            const activeCamera = this.scene.activeCamera;
-            if (!activeCamera) {
-                throw new Error('No active camera found when using autofocus feature.');
-            }
-            if (!(activeCamera instanceof arcRotateCamera_1.ArcRotateCamera)) {
-                const cameraClsName = activeCamera.getClassName();
-                throw new Error(`Camera of type "${cameraClsName}" is not implemented yet to use autofocus feature.`);
-            }
-            let exclude = (settings === null || settings === void 0 ? void 0 : settings.exclude) || [];
-            // Exclude shown photo dome or environment helper from bounding box calculation
-            const photoDome = this.scene.getNodeByName(babylonHelper_1.backgroundDomeName);
-            const photoDomeMeshes = photoDome === null || photoDome === void 0 ? void 0 : photoDome.getChildMeshes();
-            if (photoDomeMeshes === null || photoDomeMeshes === void 0 ? void 0 : photoDomeMeshes.length) {
-                exclude = [...exclude, ...photoDomeMeshes];
-            }
-            const envHelper = (_a = this.scene.metadata) === null || _a === void 0 ? void 0 : _a[babylonHelper_1.envHelperMetadataName];
-            if (envHelper === null || envHelper === void 0 ? void 0 : envHelper.rootMesh) {
-                exclude = [...exclude, envHelper.rootMesh];
-            }
-            // get bounding box of all visible meshes, this is the base for the autofocus algorithm
-            const boundingBox = yield this.calculateBoundingBox(exclude);
-            const radius = boundingBox.getBoundingInfo().boundingSphere.radius;
-            const center = boundingBox.getBoundingInfo().boundingSphere.center;
-            const diameter = radius * 2;
-            // 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 / Viewer._autofocusConstants.minZ, 1);
-            if ((settings === null || settings === void 0 ? void 0 : settings.adjustWheelPrecision) !== false) {
-                activeCamera.wheelPrecision = Viewer._autofocusConstants.wheelPrecision / radius;
-            }
-            if ((settings === null || settings === void 0 ? void 0 : settings.adjustPanningSensibility) !== false) {
-                activeCamera.panningSensibility = Viewer._autofocusConstants.panningSensibility / diameter;
-            }
-            if ((settings === null || settings === void 0 ? void 0 : settings.adjustPinchPrecision) !== false) {
-                activeCamera.pinchPrecision = Viewer._autofocusConstants.pinchPrecision / radius;
-            }
-            const radiusFactor = (_b = settings === null || settings === void 0 ? void 0 : settings.radiusFactor) !== null && _b !== void 0 ? _b : 1.5;
-            const alpha = ((_c = settings === null || settings === void 0 ? void 0 : settings.alpha) !== null && _c !== void 0 ? _c : -90) * (Math.PI / 180);
-            const beta = ((_d = settings === null || settings === void 0 ? void 0 : settings.beta) !== null && _d !== void 0 ? _d : 90) * (Math.PI / 180);
-            const newCameraPosition = {
-                alpha: alpha,
-                beta: beta,
-                // this calculation is a bit "simplified", as it doesn't consider the viewport ratio or the frustum angle
-                // but it's also done this way in the Babylon.js repository, so it should be fine for us
-                radius: diameter * radiusFactor,
-                target: center,
-            };
-            yield this.animationManager.animateToPlacement(activeCamera, newCameraPosition, settings === null || settings === void 0 ? void 0 : settings.animation);
-        });
-    }
-    /**
-     * Resets everything by calling {@link destroy} to clear all references and {@link bootstrap} to setup a clean
-     * environment
-     */
-    reset(tagManagerParameterValues) {
-        return __awaiter(this, void 0, void 0, function* () {
-            yield this.destroy();
-            return this.bootstrap(tagManagerParameterValues);
-        });
-    }
-    /**
-     * Destroys
-     *
-     * * all {@link VariantInstance}s using {@link destroyVariantInstances}
-     * * calling `dispose` on the `Engine` and `Scene`
-     */
-    destroy() {
-        this.destroyVariantInstances();
-        this.scene.dispose();
-        specStorage_1.SpecStorage.destroy();
-        return this;
-    }
-    /**
-     * Show coordinate system with given dimension (for debugging purpose).
-     */
-    showWorldCoordinates(dimension) {
-        const scene = this.scene;
-        const makeTextPlane = function (text, color, size) {
-            const dynamicTexture = new dynamicTexture_1.DynamicTexture('DynamicTexture', 50, scene, true);
-            dynamicTexture.hasAlpha = true;
-            dynamicTexture.drawText(text, 5, 40, 'bold 36px Arial', color, 'transparent', true);
-            const plane = mesh_1.Mesh.CreatePlane('TextPlane', size, scene, true);
-            plane.material = new standardMaterial_1.StandardMaterial('TextPlaneMaterial', scene);
-            plane.material.backFaceCulling = false;
-            plane.material.specularColor = new math_color_1.Color3(0, 0, 0);
-            plane.material.diffuseTexture = dynamicTexture;
-            return plane;
-        };
-        const axisX = mesh_1.Mesh.CreateLines('axisX', [
-            math_vector_1.Vector3.Zero(),
-            new math_vector_1.Vector3(dimension, 0, 0),
-            new math_vector_1.Vector3(dimension * 0.95, 0.05 * dimension, 0),
-            new math_vector_1.Vector3(dimension, 0, 0),
-            new math_vector_1.Vector3(dimension * 0.95, -0.05 * dimension, 0),
-        ], scene, false);
-        axisX.color = new math_color_1.Color3(1, 0, 0);
-        const xChar = makeTextPlane('X', 'red', dimension / 10);
-        xChar.position = new math_vector_1.Vector3(0.9 * dimension, -0.05 * dimension, 0);
-        const axisY = mesh_1.Mesh.CreateLines('axisY', [
-            math_vector_1.Vector3.Zero(),
-            new math_vector_1.Vector3(0, dimension, 0),
-            new math_vector_1.Vector3(-0.05 * dimension, dimension * 0.95, 0),
-            new math_vector_1.Vector3(0, dimension, 0),
-            new math_vector_1.Vector3(0.05 * dimension, dimension * 0.95, 0),
-        ], scene, false);
-        axisY.color = new math_color_1.Color3(0, 1, 0);
-        const yChar = makeTextPlane('Y', 'green', dimension / 10);
-        yChar.position = new math_vector_1.Vector3(0, 0.9 * dimension, -0.05 * dimension);
-        const axisZ = mesh_1.Mesh.CreateLines('axisZ', [
-            math_vector_1.Vector3.Zero(),
-            new math_vector_1.Vector3(0, 0, dimension),
-            new math_vector_1.Vector3(0, -0.05 * dimension, dimension * 0.95),
-            new math_vector_1.Vector3(0, 0, dimension),
-            new math_vector_1.Vector3(0, 0.05 * dimension, dimension * 0.95),
-        ], scene, false);
-        axisZ.color = new math_color_1.Color3(0, 0, 1);
-        const zChar = makeTextPlane('Z', 'blue', dimension / 10);
-        zChar.position = new math_vector_1.Vector3(0, 0.05 * dimension, 0.9 * dimension);
-    }
-    /**
-     * Pause render loop.
-     */
-    pauseRendering() {
-        this._isRenderLoopPaused = true;
-    }
-    /**
-     * Resume render loop when paused.
-     */
-    resumeRendering() {
-        this._isRenderLoopPaused = false;
-    }
-    /**
-     * @emits {@link Event.SCENE_PROCESSING_START}
-     * @emits {@link Event.SCENE_PROCESSING_END}
-     */
-    initScene() {
-        var _a, _b, _c;
-        return __awaiter(this, void 0, void 0, function* () {
-            const sceneJson = specStorage_1.SpecStorage.get('scene');
-            this.broadcastEvent(event_1.Event.SCENE_PROCESSING_START, sceneJson);
-            const engine = new engine_1.Engine(this.canvas, (_b = (_a = sceneJson.engine) === null || _a === void 0 ? void 0 : _a.antialiasing) !== null && _b !== void 0 ? _b : false, (_c = sceneJson.engine) === null || _c === void 0 ? void 0 : _c.options);
-            const scene = yield (0, sceneSetup_1.sceneSetup)(engine, sceneJson);
-            if (sceneJson.meshPicking) {
-                new highlightLayer_1.HighlightLayer('default', scene);
-                scene.onPointerPick = (pointerEvent, pickInfo) => {
-                    if (!pickInfo.hit) {
-                        return;
-                    }
-                    const mesh = pickInfo.pickedMesh;
-                    this.broadcastEvent(event_1.Event.MESH_PICKED, mesh, mesh === null || mesh === void 0 ? void 0 : mesh.metadata.element, mesh === null || mesh === void 0 ? void 0 : mesh.metadata.variant);
-                    if (mesh === null || mesh === void 0 ? void 0 : mesh.metadata.element) {
-                        this.broadcastEvent(event_1.Event.ELEMENT_PICKED, mesh.metadata.element);
-                    }
-                    if (mesh === null || mesh === void 0 ? void 0 : mesh.metadata.variant) {
-                        if (mesh.metadata.variant.inheritedParameters[parameter_1.Parameter.HIGHLIGHT_ENABLED]) {
-                            mesh.metadata.variant.toggleHighlight();
-                        }
-                        this.broadcastEvent(event_1.Event.VARIANT_PICKED, mesh.metadata.variant);
-                    }
-                };
-            }
-            this._sceneManager = yield sceneManager_1.SceneManager.create(scene);
-            this._animationManager = yield animationManager_1.AnimationManager.create(scene);
-            if (sceneJson.cloneMaterialsOnMutation !== undefined) {
-                this._cloneMaterialsOnMutation = sceneJson.cloneMaterialsOnMutation;
-            }
-            // register observers for tag manager
-            this.tagManager.registerNewTransformNodeObservers(scene);
-            this.broadcastEvent(event_1.Event.SCENE_PROCESSING_END, scene);
-            return scene;
-        });
-    }
-    /**
-     * Register custom file loader for babylon files which adds "missing-material" metadata to meshes which reference
-     * materials that are not present in the `materials` section of the given babylon file.
-     *
-     * Required for babylon files & materials loaded from "Combeenation configurator assets".
-     */
-    initCbnBabylonLoaderPlugin() {
-        const previousLoaderPlugin = sceneLoader_1.SceneLoader.GetPluginForExtension('babylon');
-        const customLoaderPlugin = (0, sceneLoaderHelper_1.getCustomCbnBabylonLoaderPlugin)(previousLoaderPlugin);
-        sceneLoader_1.SceneLoader.RegisterPlugin(customLoaderPlugin);
-    }
-    /**
-     * Batch creation of multiple {@link VariantInstance} objects with a {@link SetupJson} object passed
-     */
-    createVariantInstances(tagManagerParameterValues) {
-        var _a;
-        return __awaiter(this, void 0, void 0, function* () {
-            const setupJson = specStorage_1.SpecStorage.get('setup');
-            const instances = [];
-            for (const instanceDefinition of setupJson.instances) {
-                if ((0, lodash_es_1.isArray)(tagManagerParameterValues)) {
-                    instanceDefinition.tagManagerParameterValues = tagManagerParameterValues;
-                }
-                // don't create the instance right away if `lazy` is set, register it for later creation (on first usage) instead
-                // however if the variant should be `visible` by default, `lazy` loading doesn't make sense and should therefore
-                // be overruled by the `visible` flag
-                if (instanceDefinition.lazy && ((_a = instanceDefinition.parameters) === null || _a === void 0 ? void 0 : _a.visible) !== true) {
-                    this.variantInstances.register(instanceDefinition);
-                    continue;
-                }
-                const instance = yield this.variantInstances.create(instanceDefinition.variant, instanceDefinition.name, instanceDefinition.parameters, instanceDefinition.tagManagerParameterValues);
-                instances.push(instance);
-            }
-            return instances;
-        });
-    }
-}
-exports.Viewer = Viewer;
-Viewer.BOUNDING_BOX_NAME = '__bounding_box__';
-Viewer.version = buildinfo_json_1.default.version;
-// these are constants for calculating the camera settings, depending on the bounding box size of the meshes to zoom
-// the algorithms and constant values are directly taken from the Babylon.js repository
-Viewer._autofocusConstants = {
-    minZ: 100,
-    wheelPrecision: 100,
-    panningSensibility: 5000,
-    pinchPrecision: 200,
-};
+"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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Viewer = void 0;
+const buildinfo_json_1 = __importDefault(require("../../buildinfo.json"));
+const sceneSetup_1 = require("../internal/sceneSetup");
+const animationManager_1 = require("../manager/animationManager");
+const gltfExportManager_1 = require("../manager/gltfExportManager");
+const sceneManager_1 = require("../manager/sceneManager");
+const tagManager_1 = require("../manager/tagManager");
+const variantInstanceManager_1 = require("../manager/variantInstanceManager");
+const specStorage_1 = require("../store/specStorage");
+const babylonHelper_1 = require("../util/babylonHelper");
+const resourceHelper_1 = require("../util/resourceHelper");
+const sceneLoaderHelper_1 = require("../util/sceneLoaderHelper");
+const stringHelper_1 = require("../util/stringHelper");
+const structureHelper_1 = require("../util/structureHelper");
+const event_1 = require("./event");
+const eventBroadcaster_1 = require("./eventBroadcaster");
+const parameter_1 = require("./parameter");
+const arcRotateCamera_1 = require("@babylonjs/core/Cameras/arcRotateCamera");
+const boundingInfo_1 = require("@babylonjs/core/Culling/boundingInfo");
+const debugLayer_1 = require("@babylonjs/core/Debug/debugLayer");
+const engine_1 = require("@babylonjs/core/Engines/engine");
+const highlightLayer_1 = require("@babylonjs/core/Layers/highlightLayer");
+const sceneLoader_1 = require("@babylonjs/core/Loading/sceneLoader");
+const dynamicTexture_1 = require("@babylonjs/core/Materials/Textures/dynamicTexture");
+const standardMaterial_1 = require("@babylonjs/core/Materials/standardMaterial");
+const math_color_1 = require("@babylonjs/core/Maths/math.color");
+const math_vector_1 = require("@babylonjs/core/Maths/math.vector");
+const mesh_1 = require("@babylonjs/core/Meshes/mesh");
+const screenshotTools_1 = require("@babylonjs/core/Misc/screenshotTools");
+const webXRSessionManager_1 = require("@babylonjs/core/XR/webXRSessionManager");
+const lodash_es_1 = require("lodash-es");
+/**
+ * The main exposed object. This is the entry point into the application
+ *
+ * ```js
+ * const canvas = document.getElementById( 'babylon-canvas' );
+ * const viewer = Viewer( canvas, '/path/to/index.json' );
+ * ```
+ * The class does nothing on its own and needs to {@link bootstrap}
+ */
+class Viewer extends eventBroadcaster_1.EventBroadcaster {
+    /**
+     * Constructor
+     */
+    constructor(canvas, structureJson) {
+        super();
+        this.canvas = canvas;
+        this.structureJson = structureJson;
+        this._scene = null;
+        this._animationManager = null;
+        this._sceneManager = null;
+        this._tagManager = null;
+        this._gltfExportManager = null;
+        this._variantInstances = null;
+        // defaults to `false` as material cloning should be the edge case
+        this._cloneMaterialsOnMutation = false;
+        this._isRenderLoopPaused = false;
+        this._inspectorLoaded = false;
+        this._nodeNamingStrategyHandler = null;
+        this._tagManager = new tagManager_1.TagManager(this);
+        this._nodeNamingStrategyHandler = (node, payload) => {
+            var _a;
+            const suffix = [];
+            // (1) instance part
+            const variantInstances = this.variantInstances.allWithVariantName(payload.variant.name);
+            if (variantInstances.length > 0) {
+                suffix.push(payload.variantInstance.name);
+            }
+            // (2) element part
+            if (payload.variant.elements.length > 0) {
+                const nodeElements = payload.variant.elements.filter(e => e.nodesFlat.filter(n => { var _a, _b; return ((_b = (_a = n.metadata) === null || _a === void 0 ? void 0 : _a.cloneSource) === null || _b === void 0 ? void 0 : _b.id) === node.id; }).length > 0);
+                if (nodeElements.length > 0) {
+                    suffix.push(payload.variantParameterizable.name);
+                }
+            }
+            // (3) merge together
+            const originalName = ((_a = node.metadata) === null || _a === void 0 ? void 0 : _a.originalName) || node.name;
+            return [originalName, ...suffix.filter(s => !!s)].join('.');
+        };
+    }
+    /**
+     * Help function for automatically creating a valid Spec from a list of variant names and dedicated GLB/babylon URLs.
+     * This data is most likely coming from babylon assets from the Combeenation system but other sources are also valid.
+     */
+    static generateSpec(genData) {
+        // dots in the variant name indicate inheritance, but this should not be the case for an auto-generated spec
+        // therefore dots are exchanged with slashes
+        const safeGenData = genData.map(data => (Object.assign(Object.assign({}, data), { name: (0, stringHelper_1.replaceDots)(data.name) })));
+        const spec = {
+            // common scene settings as suggested in the viewer docs
+            scene: {
+                engine: {
+                    antialiasing: true,
+                    options: {
+                        preserveDrawingBuffer: true,
+                        stencil: true,
+                        xrCompatible: false,
+                    },
+                },
+                scene: {
+                    globals: {},
+                },
+            },
+            setup: {
+                // create one instance for each input entry
+                // name and variant are named accordingly from the input, instance will be hidden by default and lazy loading
+                // is activated
+                instances: safeGenData.map(instanceData => ({
+                    name: instanceData.name,
+                    variant: instanceData.name,
+                    lazy: true,
+                    parameters: {
+                        [parameter_1.Parameter.VISIBLE]: false,
+                    },
+                })),
+            },
+            // variants definition is also mapped to the input array, using the name as key and url as glTF source
+            // no elements are created here, since this should be done automatically from the system
+            // => create one element which contains all root nodes of the imported 3d file (GLB or babylon)
+            variants: safeGenData.reduce((accVariants, curVariant) => {
+                accVariants[curVariant.name] = {
+                    glTF: curVariant.url,
+                };
+                return accVariants;
+            }, {}),
+        };
+        return spec;
+    }
+    /**
+     * Gets the Babylon.js Scene that is attached to the instance.
+     *
+     * @throws Error if the `scene` has not been initialized.
+     */
+    get scene() {
+        if (!this._scene) {
+            throw new Error(`Scene has not been initialized.`);
+        }
+        return this._scene;
+    }
+    /**
+     * Gets the {@link SceneManager} attached to the viewer.
+     *
+     * @throws Error if the {@link SceneManager} has not been initialized.
+     */
+    get sceneManager() {
+        if (!this._sceneManager) {
+            throw new Error(`SceneManager has not been initialized.`);
+        }
+        return this._sceneManager;
+    }
+    /**
+     * Gets the {@link GltfExportManager} attached to the viewer.
+     *
+     * @throws Error if the {@link GltfExportManager} has not been initialized.
+     */
+    get gltfExportManager() {
+        if (!this._gltfExportManager) {
+            throw new Error(`GltfExportManager has not been initialized.`);
+        }
+        return this._gltfExportManager;
+    }
+    /**
+     * Gets the Babylon.js Engine that is attached to the viewer.
+     */
+    get engine() {
+        return this.scene.getEngine();
+    }
+    /**
+     * Gets the {@link VariantInstanceManager} attached to the viewer.
+     *
+     * @throws Error if the {@link VariantInstanceManager} has not been initialized.
+     */
+    get variantInstances() {
+        if (!this._variantInstances) {
+            throw Error(`There is no variantInstanceManager.`);
+        }
+        return this._variantInstances;
+    }
+    /**
+     * Gets the {@link AnimationManager} attached to the viewer.
+     *
+     * @throws Error if the {@link AnimationManager} has not been initialized.
+     */
+    get animationManager() {
+        if (!this._animationManager) {
+            throw new Error(`There is no animationManager instance.`);
+        }
+        return this._animationManager;
+    }
+    get tagManager() {
+        if (!this._tagManager) {
+            throw new Error(`There is no tagManager instance.`);
+        }
+        return this._tagManager;
+    }
+    /**
+     * Gets the `cloneMaterialsOnMutation` flag, as defined in the spec
+     */
+    get cloneMaterialsOnMutation() {
+        return this._cloneMaterialsOnMutation;
+    }
+    /**
+     * Gets the strategy handler for naming cloned nodes.
+     */
+    get nodeNamingStrategyHandler() {
+        if (!this._nodeNamingStrategyHandler) {
+            throw new Error(`The NodeNamingStrategyHandler has not been registered yet.`);
+        }
+        return this._nodeNamingStrategyHandler;
+    }
+    /**
+     * Sets the strategy handler for naming cloned nodes.\
+     * Check the docs of the tag managers [renaming](https://3dviewer.docs.combeenation.com/pages/documentation/Tag-Manager.html#uniqueness-of-node-and-tag-names)
+     * chapter for further details.
+     */
+    set nodeNamingStrategyHandler(value) {
+        if (!value || typeof value !== 'function') {
+            throw new Error(`The NodeNamingStrategyHandler is not a callable function.`);
+        }
+        this._nodeNamingStrategyHandler = value;
+    }
+    /**
+     * Starts the application. This will
+     * * load the given "index" JSON file
+     * * setup the scene with the "scene" JSON file
+     * * create an (optional) default setup with different variant settings
+     * * sets up resizing by attaching a debounced version of {@link resize}
+     *
+     * @throws Error if any of the files is not found/valid
+     *
+     * @emits {@link Event.BOOTSTRAP_START}
+     * @emits {@link Event.BOOTSTRAP_END}
+     */
+    bootstrap(tagManagerParameterValues) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.broadcastEvent(event_1.Event.BOOTSTRAP_START, this);
+            let indexJson;
+            if ((0, lodash_es_1.isString)(this.structureJson)) {
+                indexJson = yield (0, resourceHelper_1.loadJson)(this.structureJson);
+            }
+            else {
+                indexJson = this.structureJson;
+            }
+            if (!indexJson.scene) {
+                throw new Error(`No "scene" property found for bootstrapping.`);
+            }
+            // fill spec store
+            specStorage_1.SpecStorage.createFromSpec(indexJson);
+            // init custom loader plugin
+            this.initCbnBabylonLoaderPlugin();
+            // load scene
+            if ((0, lodash_es_1.isString)(indexJson.scene)) {
+                const sceneJson = yield (0, resourceHelper_1.loadJson)(indexJson.scene);
+                indexJson.scene = sceneJson;
+            }
+            this._scene = yield this.initScene();
+            // create instance manager
+            this._variantInstances = yield variantInstanceManager_1.VariantInstanceManager.create(this);
+            // create optional default instances
+            if (indexJson.setup) {
+                if ((0, lodash_es_1.isString)(indexJson.setup)) {
+                    const setupJson = yield (0, resourceHelper_1.loadJson)(indexJson.setup);
+                    indexJson.setup = setupJson;
+                }
+                this.printInstanceDefinitions(indexJson.setup);
+                yield this.createVariantInstances(tagManagerParameterValues);
+            }
+            this.broadcastEvent(event_1.Event.VARIANT_INSTANCES_READY, this);
+            // create gltf export manager
+            this._gltfExportManager = yield gltfExportManager_1.GltfExportManager.create(this);
+            // resize handler
+            window.addEventListener('resize', (0, resourceHelper_1.debounce)(this.resize.bind(this), 100));
+            // wait until scene is completely ready
+            yield this.scene.whenReadyAsync();
+            // event broadcasting
+            this.broadcastEvent(event_1.Event.BOOTSTRAP_END, this);
+            // render loop
+            this.engine.runRenderLoop(() => {
+                if (!this._isRenderLoopPaused)
+                    this.scene.render();
+            });
+            return this;
+        });
+    }
+    /**
+     * Enables the Babylon.js [Inspector](https://doc.babylonjs.com/toolsAndResources/tools/inspector).\
+     * Due to the additional size of the inspector, the CDN version is used instead of shipping the required code with
+     * the viewer.\
+     * This means that the code will be downloaded only when needed and calling `enableDebugLayer` can take a little while
+     * depending on your internet connection etc.
+     */
+    enableDebugLayer(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this._inspectorLoaded) {
+                // CDN version of inspector requires the Babylon.js core to be available as CDN module as well
+                yield (0, resourceHelper_1.loadJavascript)('https://cdn.jsdelivr.net/npm/babylonjs@5.6.0/babylon.min.js');
+                debugLayer_1.DebugLayer.InspectorURL =
+                    'https://cdn.jsdelivr.net/npm/babylonjs-inspector@5.6.0/babylon.inspector.bundle.max.min.js';
+                this._inspectorLoaded = true;
+            }
+            yield this.scene.debugLayer.show(options);
+        });
+    }
+    /**
+     * Destroys all registered {@link VariantInstance}s that are registered
+     */
+    destroyVariantInstances() {
+        this.variantInstances.all.forEach(variantInstance => {
+            this.variantInstances.destroy(variantInstance.name);
+        });
+        return this;
+    }
+    /**
+     * Trigger a resize event for the `Engine`
+     */
+    resize() {
+        this.engine.resize();
+        return this;
+    }
+    /**
+     * A convenience method for directly getting a Node from a {@link VariantInstance} and an {@link Element} by its
+     * {@link DottedPath}s.
+     */
+    getNode(variantInstanceName, elementDottedPath, nodeDottedPath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const variantInstance = yield this.variantInstances.get(variantInstanceName);
+            return variantInstance.getNode(elementDottedPath, nodeDottedPath);
+        });
+    }
+    /**
+     * A convenience method for directly getting a Node from a {@link VariantInstance} and an {@link Element} by its
+     * {@link DottedPath}s.
+     */
+    getMesh(variantInstanceName, elementDottedPath, meshDottedPath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const variantInstance = yield this.variantInstances.get(variantInstanceName);
+            return variantInstance.getMesh(elementDottedPath, meshDottedPath);
+        });
+    }
+    /**
+     * Switches the camera
+     *
+     * @emits {@link Event.CAMERA_SWITCHED}
+     */
+    switchCamera(newCamera, reset = true) {
+        const camera = this.scene.getCameraByName(newCamera);
+        if (camera) {
+            const activeCamera = this.scene.activeCamera;
+            if (activeCamera) {
+                activeCamera.detachControl(this.engine.getRenderingCanvas());
+            }
+            if (reset) {
+                camera.restoreState();
+            }
+            this.scene.setActiveCameraByName(newCamera);
+            camera.attachControl(this.engine.getRenderingCanvas());
+            this.broadcastEvent(event_1.Event.CAMERA_SWITCHED, camera);
+        }
+        else {
+            throw new Error(`Given camera "${newCamera}" not found.`);
+        }
+        // TODO: put traceable observers to new camera (@see element)
+        return this;
+    }
+    /**
+     * Moves or animates the active camera to given `placement`.
+     */
+    moveActiveCameraTo(placement, animation) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.animationManager.animateToPlacement(this.sceneManager.activeCamera, placement, animation);
+        });
+    }
+    /**
+     * Takes a sceenshot the the current scene. The result is a string containing a base64 encoded image
+     */
+    screenshot(settings) {
+        return new Promise((resolve, reject) => {
+            var _a, _b, _c, _d, _e, _f;
+            if (!this.engine) {
+                return reject('Engine is null');
+            }
+            if (!this.scene) {
+                return reject('Scene is null');
+            }
+            this.scene.render(); // in combination with a render target, we need to refresh the scene manually to get the latest view
+            screenshotTools_1.ScreenshotTools.CreateScreenshotUsingRenderTarget(this.engine, this.sceneManager.activeCamera, (_a = settings === null || settings === void 0 ? void 0 : settings.size) !== null && _a !== void 0 ? _a : { width: this.canvas.clientWidth, height: this.canvas.clientHeight }, resolve, (_b = settings === null || settings === void 0 ? void 0 : settings.mimeType) !== null && _b !== void 0 ? _b : 'image/png', (_c = settings === null || settings === void 0 ? void 0 : settings.samples) !== null && _c !== void 0 ? _c : 1, (_d = settings === null || settings === void 0 ? void 0 : settings.antialiasing) !== null && _d !== void 0 ? _d : false, (_e = settings === null || settings === void 0 ? void 0 : settings.fileName) !== null && _e !== void 0 ? _e : 'screenshot.png', (_f = settings === null || settings === void 0 ? void 0 : settings.renderSprites) !== null && _f !== void 0 ? _f : false);
+        });
+    }
+    /**
+     * Checks whether the browser is capable of handling XR.
+     */
+    isBrowserARCapable() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield webXRSessionManager_1.WebXRSessionManager.IsSessionSupportedAsync('immersive-ar');
+        });
+    }
+    /**
+     * Calculates the bounding box from all visible meshes on the scene.
+     */
+    calculateBoundingBox(excludeGeometry) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.scene.meshes.length === 0) {
+                throw new Error('There are currently no meshes on the scene.');
+            }
+            this.scene.render(); // CB-6062: workaround for BoundingBox not respecting render loop
+            const { max, min } = this.scene.meshes
+                .filter(mesh => {
+                const isEnabled = mesh.isEnabled();
+                // ignore the existing bounding box mesh for calculating the current one
+                const isNotBBoxMesh = Viewer.BOUNDING_BOX_NAME !== mesh.id;
+                // ignore meshes with invalid bounding infos
+                const hasValidBBoxInfo = mesh.getBoundingInfo().boundingSphere.radius > 0;
+                // ignore meshes with infinite distance, typically these are sky boxes
+                const hasInfiniteDistance = mesh.infiniteDistance;
+                // ignore excluded meshes
+                const isExcluded = excludeGeometry ? (0, structureHelper_1.isMeshIncludedInExclusionList)(mesh, excludeGeometry) : false;
+                return isEnabled && isNotBBoxMesh && hasValidBBoxInfo && !hasInfiniteDistance && !isExcluded;
+            })
+                .reduce((accBBoxMinMax, curMesh, idx) => {
+                const bBox = curMesh.getBoundingInfo().boundingBox;
+                // use the first entry in the array as default value and get the resulting maximum/minimum values
+                const max = idx === 0 ? bBox.maximumWorld : math_vector_1.Vector3.Maximize(accBBoxMinMax.max, bBox.maximumWorld);
+                const min = idx === 0 ? bBox.minimumWorld : math_vector_1.Vector3.Minimize(accBBoxMinMax.min, bBox.minimumWorld);
+                return { max, min };
+            }, { max: new math_vector_1.Vector3(), min: new math_vector_1.Vector3() });
+            let boundingBox = this.scene.getMeshByName(Viewer.BOUNDING_BOX_NAME);
+            if (!boundingBox) {
+                boundingBox = new mesh_1.Mesh(Viewer.BOUNDING_BOX_NAME, this.scene);
+            }
+            boundingBox.setBoundingInfo(new boundingInfo_1.BoundingInfo(min, max));
+            return boundingBox;
+        });
+    }
+    /**
+     * Focuses the camera to see every visible mesh in scene and tries to optimize wheel precision and panning
+     */
+    autofocusActiveCamera(settings) {
+        var _a, _b, _c, _d;
+        return __awaiter(this, void 0, void 0, function* () {
+            // first check some preconditions
+            const activeCamera = this.scene.activeCamera;
+            if (!activeCamera) {
+                throw new Error('No active camera found when using autofocus feature.');
+            }
+            if (!(activeCamera instanceof arcRotateCamera_1.ArcRotateCamera)) {
+                const cameraClsName = activeCamera.getClassName();
+                throw new Error(`Camera of type "${cameraClsName}" is not implemented yet to use autofocus feature.`);
+            }
+            let exclude = (settings === null || settings === void 0 ? void 0 : settings.exclude) || [];
+            // Exclude shown photo dome or environment helper from bounding box calculation
+            const photoDome = this.scene.getNodeByName(babylonHelper_1.backgroundDomeName);
+            const photoDomeMeshes = photoDome === null || photoDome === void 0 ? void 0 : photoDome.getChildMeshes();
+            if (photoDomeMeshes === null || photoDomeMeshes === void 0 ? void 0 : photoDomeMeshes.length) {
+                exclude = [...exclude, ...photoDomeMeshes];
+            }
+            const envHelper = (_a = this.scene.metadata) === null || _a === void 0 ? void 0 : _a[babylonHelper_1.envHelperMetadataName];
+            if (envHelper === null || envHelper === void 0 ? void 0 : envHelper.rootMesh) {
+                exclude = [...exclude, envHelper.rootMesh];
+            }
+            // get bounding box of all visible meshes, this is the base for the autofocus algorithm
+            const boundingBox = yield this.calculateBoundingBox(exclude);
+            const radius = boundingBox.getBoundingInfo().boundingSphere.radius;
+            const center = boundingBox.getBoundingInfo().boundingSphere.center;
+            const diameter = radius * 2;
+            // 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 / Viewer._autofocusConstants.minZ, 1);
+            if ((settings === null || settings === void 0 ? void 0 : settings.adjustWheelPrecision) !== false) {
+                activeCamera.wheelPrecision = Viewer._autofocusConstants.wheelPrecision / radius;
+            }
+            if ((settings === null || settings === void 0 ? void 0 : settings.adjustPanningSensibility) !== false) {
+                activeCamera.panningSensibility = Viewer._autofocusConstants.panningSensibility / diameter;
+            }
+            if ((settings === null || settings === void 0 ? void 0 : settings.adjustPinchPrecision) !== false) {
+                activeCamera.pinchPrecision = Viewer._autofocusConstants.pinchPrecision / radius;
+            }
+            const radiusFactor = (_b = settings === null || settings === void 0 ? void 0 : settings.radiusFactor) !== null && _b !== void 0 ? _b : 1.5;
+            const alpha = ((_c = settings === null || settings === void 0 ? void 0 : settings.alpha) !== null && _c !== void 0 ? _c : -90) * (Math.PI / 180);
+            const beta = ((_d = settings === null || settings === void 0 ? void 0 : settings.beta) !== null && _d !== void 0 ? _d : 90) * (Math.PI / 180);
+            const newCameraPosition = {
+                alpha: alpha,
+                beta: beta,
+                // this calculation is a bit "simplified", as it doesn't consider the viewport ratio or the frustum angle
+                // but it's also done this way in the Babylon.js repository, so it should be fine for us
+                radius: diameter * radiusFactor,
+                target: center,
+            };
+            yield this.animationManager.animateToPlacement(activeCamera, newCameraPosition, settings === null || settings === void 0 ? void 0 : settings.animation);
+        });
+    }
+    /**
+     * Resets everything by calling {@link destroy} to clear all references and {@link bootstrap} to setup a clean
+     * environment
+     */
+    reset(tagManagerParameterValues) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.destroy();
+            return this.bootstrap(tagManagerParameterValues);
+        });
+    }
+    /**
+     * Destroys
+     *
+     * * all {@link VariantInstance}s using {@link destroyVariantInstances}
+     * * calling `dispose` on the `Engine` and `Scene`
+     */
+    destroy() {
+        this.destroyVariantInstances();
+        this.scene.dispose();
+        specStorage_1.SpecStorage.destroy();
+        return this;
+    }
+    /**
+     * Show coordinate system with given dimension (for debugging purpose).
+     */
+    showWorldCoordinates(dimension) {
+        const scene = this.scene;
+        const makeTextPlane = function (text, color, size) {
+            const dynamicTexture = new dynamicTexture_1.DynamicTexture('DynamicTexture', 50, scene, true);
+            dynamicTexture.hasAlpha = true;
+            dynamicTexture.drawText(text, 5, 40, 'bold 36px Arial', color, 'transparent', true);
+            const plane = mesh_1.Mesh.CreatePlane('TextPlane', size, scene, true);
+            plane.material = new standardMaterial_1.StandardMaterial('TextPlaneMaterial', scene);
+            plane.material.backFaceCulling = false;
+            plane.material.specularColor = new math_color_1.Color3(0, 0, 0);
+            plane.material.diffuseTexture = dynamicTexture;
+            return plane;
+        };
+        const axisX = mesh_1.Mesh.CreateLines('axisX', [
+            math_vector_1.Vector3.Zero(),
+            new math_vector_1.Vector3(dimension, 0, 0),
+            new math_vector_1.Vector3(dimension * 0.95, 0.05 * dimension, 0),
+            new math_vector_1.Vector3(dimension, 0, 0),
+            new math_vector_1.Vector3(dimension * 0.95, -0.05 * dimension, 0),
+        ], scene, false);
+        axisX.color = new math_color_1.Color3(1, 0, 0);
+        const xChar = makeTextPlane('X', 'red', dimension / 10);
+        xChar.position = new math_vector_1.Vector3(0.9 * dimension, -0.05 * dimension, 0);
+        const axisY = mesh_1.Mesh.CreateLines('axisY', [
+            math_vector_1.Vector3.Zero(),
+            new math_vector_1.Vector3(0, dimension, 0),
+            new math_vector_1.Vector3(-0.05 * dimension, dimension * 0.95, 0),
+            new math_vector_1.Vector3(0, dimension, 0),
+            new math_vector_1.Vector3(0.05 * dimension, dimension * 0.95, 0),
+        ], scene, false);
+        axisY.color = new math_color_1.Color3(0, 1, 0);
+        const yChar = makeTextPlane('Y', 'green', dimension / 10);
+        yChar.position = new math_vector_1.Vector3(0, 0.9 * dimension, -0.05 * dimension);
+        const axisZ = mesh_1.Mesh.CreateLines('axisZ', [
+            math_vector_1.Vector3.Zero(),
+            new math_vector_1.Vector3(0, 0, dimension),
+            new math_vector_1.Vector3(0, -0.05 * dimension, dimension * 0.95),
+            new math_vector_1.Vector3(0, 0, dimension),
+            new math_vector_1.Vector3(0, 0.05 * dimension, dimension * 0.95),
+        ], scene, false);
+        axisZ.color = new math_color_1.Color3(0, 0, 1);
+        const zChar = makeTextPlane('Z', 'blue', dimension / 10);
+        zChar.position = new math_vector_1.Vector3(0, 0.05 * dimension, 0.9 * dimension);
+    }
+    /**
+     * Pause render loop.
+     */
+    pauseRendering() {
+        this._isRenderLoopPaused = true;
+    }
+    /**
+     * Resume render loop when paused.
+     */
+    resumeRendering() {
+        this._isRenderLoopPaused = false;
+    }
+    /**
+     * Prints defined instances from SetupJson to the console.
+     */
+    printInstanceDefinitions(setupJson) {
+        console.info('The following variant instances have been read from the given spec: ', setupJson.instances.map(o => o.name));
+    }
+    /**
+     * @emits {@link Event.SCENE_PROCESSING_START}
+     * @emits {@link Event.SCENE_PROCESSING_END}
+     */
+    initScene() {
+        var _a, _b, _c;
+        return __awaiter(this, void 0, void 0, function* () {
+            const sceneJson = specStorage_1.SpecStorage.get('scene');
+            this.broadcastEvent(event_1.Event.SCENE_PROCESSING_START, sceneJson);
+            const engine = new engine_1.Engine(this.canvas, (_b = (_a = sceneJson.engine) === null || _a === void 0 ? void 0 : _a.antialiasing) !== null && _b !== void 0 ? _b : false, (_c = sceneJson.engine) === null || _c === void 0 ? void 0 : _c.options);
+            const scene = yield (0, sceneSetup_1.sceneSetup)(engine, sceneJson);
+            if (sceneJson.meshPicking) {
+                new highlightLayer_1.HighlightLayer('default', scene);
+                scene.onPointerPick = (pointerEvent, pickInfo) => {
+                    if (!pickInfo.hit) {
+                        return;
+                    }
+                    const mesh = pickInfo.pickedMesh;
+                    this.broadcastEvent(event_1.Event.MESH_PICKED, mesh, mesh === null || mesh === void 0 ? void 0 : mesh.metadata.element, mesh === null || mesh === void 0 ? void 0 : mesh.metadata.variant);
+                    if (mesh === null || mesh === void 0 ? void 0 : mesh.metadata.element) {
+                        this.broadcastEvent(event_1.Event.ELEMENT_PICKED, mesh.metadata.element);
+                    }
+                    if (mesh === null || mesh === void 0 ? void 0 : mesh.metadata.variant) {
+                        if (mesh.metadata.variant.inheritedParameters[parameter_1.Parameter.HIGHLIGHT_ENABLED]) {
+                            mesh.metadata.variant.toggleHighlight();
+                        }
+                        this.broadcastEvent(event_1.Event.VARIANT_PICKED, mesh.metadata.variant);
+                    }
+                };
+            }
+            this._sceneManager = yield sceneManager_1.SceneManager.create(scene);
+            this._animationManager = yield animationManager_1.AnimationManager.create(scene);
+            if (sceneJson.cloneMaterialsOnMutation !== undefined) {
+                this._cloneMaterialsOnMutation = sceneJson.cloneMaterialsOnMutation;
+            }
+            // register observers for tag manager
+            this.tagManager.registerNewTransformNodeObservers(scene);
+            this.broadcastEvent(event_1.Event.SCENE_PROCESSING_END, scene);
+            return scene;
+        });
+    }
+    /**
+     * Register custom file loader for babylon files which adds "missing-material" metadata to meshes which reference
+     * materials that are not present in the `materials` section of the given babylon file.
+     *
+     * Required for babylon files & materials loaded from "Combeenation configurator assets".
+     */
+    initCbnBabylonLoaderPlugin() {
+        const previousLoaderPlugin = sceneLoader_1.SceneLoader.GetPluginForExtension('babylon');
+        const customLoaderPlugin = (0, sceneLoaderHelper_1.getCustomCbnBabylonLoaderPlugin)(previousLoaderPlugin);
+        sceneLoader_1.SceneLoader.RegisterPlugin(customLoaderPlugin);
+    }
+    /**
+     * Batch creation of multiple {@link VariantInstance} objects with a {@link SetupJson} object passed
+     */
+    createVariantInstances(tagManagerParameterValues) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const setupJson = specStorage_1.SpecStorage.get('setup');
+            const instances = [];
+            for (const instanceDefinition of setupJson.instances) {
+                if ((0, lodash_es_1.isArray)(tagManagerParameterValues)) {
+                    instanceDefinition.tagManagerParameterValues = tagManagerParameterValues;
+                }
+                // don't create the instance right away if `lazy` is set, register it for later creation (on first usage) instead
+                // however if the variant should be `visible` by default, `lazy` loading doesn't make sense and should therefore
+                // be overruled by the `visible` flag
+                if (instanceDefinition.lazy && ((_a = instanceDefinition.parameters) === null || _a === void 0 ? void 0 : _a.visible) !== true) {
+                    this.variantInstances.register(instanceDefinition);
+                    continue;
+                }
+                const instance = yield this.variantInstances.create(instanceDefinition.variant, instanceDefinition.name, instanceDefinition.parameters, instanceDefinition.tagManagerParameterValues);
+                instances.push(instance);
+            }
+            return instances;
+        });
+    }
+}
+exports.Viewer = Viewer;
+Viewer.BOUNDING_BOX_NAME = '__bounding_box__';
+Viewer.version = buildinfo_json_1.default.version;
+// these are constants for calculating the camera settings, depending on the bounding box size of the meshes to zoom
+// the algorithms and constant values are directly taken from the Babylon.js repository
+Viewer._autofocusConstants = {
+    minZ: 100,
+    wheelPrecision: 100,
+    panningSensibility: 5000,
+    pinchPrecision: 200,
+};
 //# sourceMappingURL=viewer.js.map