@combeenation/3d-viewer 5.2.0-alpha5 → 6.1.0-beta1

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

@@ -1,595 +1,595 @@
-"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 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 structureHelper_1 = require("../util/structureHelper");
-const event_1 = require("./event");
-const eventBroadcaster_1 = require("./eventBroadcaster");
-const parameter_1 = require("./parameter");
-const variant_1 = require("./variant");
-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._gltfExportManager = null;
-        this._variantInstances = null;
-        // default value is `true` ATM for compatibility reasons
-        // in the future material cloning should be the edge case
-        this._cloneMaterialsOnMutation = true;
-        this._isRenderLoopPaused = false;
-        this._inspectorLoaded = false;
-    }
-    /**
-     * Gets the BabylonJS 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 BabylonJS 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;
-    }
-    /**
-     * Gets the `cloneMaterialsOnMutation` flag, as defined in the spec
-     */
-    get cloneMaterialsOnMutation() {
-        return this._cloneMaterialsOnMutation;
-    }
-    /**
-     * 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() {
-        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);
-            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
-            const rootVariant = yield variant_1.Variant.create('_', indexJson, this);
-            this._variantInstances = yield variantInstanceManager_1.VariantInstanceManager.create(rootVariant);
-            // 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();
-            }
-            // 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 BabylonJS [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 BabylonJS 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 bbName = '__bounding_box__';
-            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 = bbName !== 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(bbName);
-            if (!boundingBox) {
-                boundingBox = new mesh_1.Mesh(bbName, 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;
-        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);
-            // focus the helper camera and set the calculated camera data to the real camera
-            const helperCamera = this.getFocusedHelperCamera(boundingBox, settings);
-            yield this.applyFocusedHelperCameraData(activeCamera, helperCamera, settings);
-            // remove the helper camera
-            helperCamera.dispose();
-        });
-    }
-    /**
-     * Resets everything by calling {@link destroy} to clear all references and {@link bootstrap} to setup a clean
-     * environment
-     */
-    reset() {
-        return __awaiter(this, void 0, void 0, function* () {
-            yield this.destroy();
-            return this.bootstrap();
-        });
-    }
-    /**
-     * 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;
-            }
-            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() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const setupJson = specStorage_1.SpecStorage.get('setup');
-            const instances = [];
-            for (const instanceDefinition of setupJson.instances) {
-                if (instanceDefinition.lazy) {
-                    this.variantInstances.register(instanceDefinition);
-                    continue;
-                }
-                instances.push(yield this.variantInstances.create(instanceDefinition.variant, instanceDefinition.name, instanceDefinition.parameters));
-            }
-            return instances;
-        });
-    }
-    /**
-     * Help function for focusing a helper camera exactly onto the given bounding box
-     */
-    getFocusedHelperCamera(boundingBox, settings) {
-        var _a, _b;
-        // use helper camera to get some default values and set the values of the real camera accordingly
-        const helperCamera = new arcRotateCamera_1.ArcRotateCamera('__helper_camera__', 0, // camera angles will be overwritten after the target has been set
-        0, 0, // radius will be calculated, so we can set to 0 here
-        math_vector_1.Vector3.Zero(), this.scene);
-        // this is required for automatically calculating the `lowerRadiusLimit`, so that we don't "dive" into meshes
-        // see https://doc.babylonjs.com/divingDeeper/behaviors/cameraBehaviors#framing-behavior
-        helperCamera.useFramingBehavior = true;
-        // `minZ` is the camera distance beyond which the mesh will be clipped
-        // this should be very low, but can't be zero
-        // a good value seems to be 1% of the bounding box size (= radius), whereas the value shouldn't go above 1, which is
-        // also the default value
-        const radius = boundingBox.getBoundingInfo().boundingSphere.radius;
-        helperCamera.minZ = Math.min(radius / 100, 1);
-        // set desired camera data, these won't be changed by the autofocus function!
-        // default values should focus the element exactly from the front (= XY Plane)
-        helperCamera.setTarget(boundingBox, true);
-        helperCamera.alpha = ((_a = settings === null || settings === void 0 ? void 0 : settings.alpha) !== null && _a !== void 0 ? _a : -90) * (Math.PI / 180);
-        helperCamera.beta = ((_b = settings === null || settings === void 0 ? void 0 : settings.beta) !== null && _b !== void 0 ? _b : 90) * (Math.PI / 180);
-        // finally zoom to the bounding box
-        // also apply a zoom factor, this adjusts the borders around the model in the viewport
-        helperCamera.zoomOnFactor = (settings === null || settings === void 0 ? void 0 : settings.radiusFactor) || 1;
-        helperCamera.zoomOn([boundingBox], true);
-        return helperCamera;
-    }
-    /**
-     * Help function for applying the relevant data of the focused helper camera to the real camera
-     */
-    applyFocusedHelperCameraData(activeCamera, helperCamera, settings) {
-        return __awaiter(this, void 0, void 0, function* () {
-            // limits
-            activeCamera.minZ = helperCamera.minZ;
-            activeCamera.maxZ = helperCamera.maxZ;
-            activeCamera.lowerRadiusLimit = helperCamera.lowerRadiusLimit;
-            activeCamera.upperRadiusLimit = helperCamera.upperRadiusLimit;
-            // additional settings
-            if ((settings === null || settings === void 0 ? void 0 : settings.adjustWheelPrecision) !== false) {
-                activeCamera.wheelPrecision = helperCamera.wheelPrecision;
-            }
-            if ((settings === null || settings === void 0 ? void 0 : settings.adjustPanningSensibility) !== false) {
-                activeCamera.panningSensibility = helperCamera.panningSensibility;
-            }
-            if ((settings === null || settings === void 0 ? void 0 : settings.adjustPinchPrecision) !== false) {
-                activeCamera.pinchPrecision = helperCamera.pinchPrecision;
-            }
-            // finally move the camera
-            // do this at last, so that all camera settings are already considered
-            const newCameraPosition = {
-                alpha: helperCamera.alpha,
-                beta: helperCamera.beta,
-                radius: helperCamera.radius,
-                target: helperCamera.target,
-            };
-            yield this.animationManager.animateToPlacement(activeCamera, newCameraPosition, settings === null || settings === void 0 ? void 0 : settings.animation);
-        });
-    }
-}
-exports.Viewer = Viewer;
-Viewer.version = buildinfo_json_1.default;
+"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 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 structureHelper_1 = require("../util/structureHelper");
+const event_1 = require("./event");
+const eventBroadcaster_1 = require("./eventBroadcaster");
+const parameter_1 = require("./parameter");
+const variant_1 = require("./variant");
+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._gltfExportManager = null;
+        this._variantInstances = null;
+        // default value is `true` ATM for compatibility reasons
+        // in the future material cloning should be the edge case
+        this._cloneMaterialsOnMutation = true;
+        this._isRenderLoopPaused = false;
+        this._inspectorLoaded = false;
+    }
+    /**
+     * Gets the BabylonJS 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 BabylonJS 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;
+    }
+    /**
+     * Gets the `cloneMaterialsOnMutation` flag, as defined in the spec
+     */
+    get cloneMaterialsOnMutation() {
+        return this._cloneMaterialsOnMutation;
+    }
+    /**
+     * 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() {
+        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);
+            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
+            const rootVariant = yield variant_1.Variant.create('_', indexJson, this);
+            this._variantInstances = yield variantInstanceManager_1.VariantInstanceManager.create(rootVariant);
+            // 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();
+            }
+            // 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 BabylonJS [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 BabylonJS 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 bbName = '__bounding_box__';
+            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 = bbName !== 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(bbName);
+            if (!boundingBox) {
+                boundingBox = new mesh_1.Mesh(bbName, 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;
+        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);
+            // focus the helper camera and set the calculated camera data to the real camera
+            const helperCamera = this.getFocusedHelperCamera(boundingBox, settings);
+            yield this.applyFocusedHelperCameraData(activeCamera, helperCamera, settings);
+            // remove the helper camera
+            helperCamera.dispose();
+        });
+    }
+    /**
+     * Resets everything by calling {@link destroy} to clear all references and {@link bootstrap} to setup a clean
+     * environment
+     */
+    reset() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.destroy();
+            return this.bootstrap();
+        });
+    }
+    /**
+     * 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;
+            }
+            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() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const setupJson = specStorage_1.SpecStorage.get('setup');
+            const instances = [];
+            for (const instanceDefinition of setupJson.instances) {
+                if (instanceDefinition.lazy) {
+                    this.variantInstances.register(instanceDefinition);
+                    continue;
+                }
+                instances.push(yield this.variantInstances.create(instanceDefinition.variant, instanceDefinition.name, instanceDefinition.parameters));
+            }
+            return instances;
+        });
+    }
+    /**
+     * Help function for focusing a helper camera exactly onto the given bounding box
+     */
+    getFocusedHelperCamera(boundingBox, settings) {
+        var _a, _b;
+        // use helper camera to get some default values and set the values of the real camera accordingly
+        const helperCamera = new arcRotateCamera_1.ArcRotateCamera('__helper_camera__', 0, // camera angles will be overwritten after the target has been set
+        0, 0, // radius will be calculated, so we can set to 0 here
+        math_vector_1.Vector3.Zero(), this.scene);
+        // this is required for automatically calculating the `lowerRadiusLimit`, so that we don't "dive" into meshes
+        // see https://doc.babylonjs.com/divingDeeper/behaviors/cameraBehaviors#framing-behavior
+        helperCamera.useFramingBehavior = true;
+        // `minZ` is the camera distance beyond which the mesh will be clipped
+        // this should be very low, but can't be zero
+        // a good value seems to be 1% of the bounding box size (= radius), whereas the value shouldn't go above 1, which is
+        // also the default value
+        const radius = boundingBox.getBoundingInfo().boundingSphere.radius;
+        helperCamera.minZ = Math.min(radius / 100, 1);
+        // set desired camera data, these won't be changed by the autofocus function!
+        // default values should focus the element exactly from the front (= XY Plane)
+        helperCamera.setTarget(boundingBox, true);
+        helperCamera.alpha = ((_a = settings === null || settings === void 0 ? void 0 : settings.alpha) !== null && _a !== void 0 ? _a : -90) * (Math.PI / 180);
+        helperCamera.beta = ((_b = settings === null || settings === void 0 ? void 0 : settings.beta) !== null && _b !== void 0 ? _b : 90) * (Math.PI / 180);
+        // finally zoom to the bounding box
+        // also apply a zoom factor, this adjusts the borders around the model in the viewport
+        helperCamera.zoomOnFactor = (settings === null || settings === void 0 ? void 0 : settings.radiusFactor) || 1;
+        helperCamera.zoomOn([boundingBox], true);
+        return helperCamera;
+    }
+    /**
+     * Help function for applying the relevant data of the focused helper camera to the real camera
+     */
+    applyFocusedHelperCameraData(activeCamera, helperCamera, settings) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // limits
+            activeCamera.minZ = helperCamera.minZ;
+            activeCamera.maxZ = helperCamera.maxZ;
+            activeCamera.lowerRadiusLimit = helperCamera.lowerRadiusLimit;
+            activeCamera.upperRadiusLimit = helperCamera.upperRadiusLimit;
+            // additional settings
+            if ((settings === null || settings === void 0 ? void 0 : settings.adjustWheelPrecision) !== false) {
+                activeCamera.wheelPrecision = helperCamera.wheelPrecision;
+            }
+            if ((settings === null || settings === void 0 ? void 0 : settings.adjustPanningSensibility) !== false) {
+                activeCamera.panningSensibility = helperCamera.panningSensibility;
+            }
+            if ((settings === null || settings === void 0 ? void 0 : settings.adjustPinchPrecision) !== false) {
+                activeCamera.pinchPrecision = helperCamera.pinchPrecision;
+            }
+            // finally move the camera
+            // do this at last, so that all camera settings are already considered
+            const newCameraPosition = {
+                alpha: helperCamera.alpha,
+                beta: helperCamera.beta,
+                radius: helperCamera.radius,
+                target: helperCamera.target,
+            };
+            yield this.animationManager.animateToPlacement(activeCamera, newCameraPosition, settings === null || settings === void 0 ? void 0 : settings.animation);
+        });
+    }
+}
+exports.Viewer = Viewer;
+Viewer.version = buildinfo_json_1.default.version;
 //# sourceMappingURL=viewer.js.map