@combeenation/3d-viewer 3.1.1-alpha7 → 3.1.2

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

@@ -1,487 +1,487 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Viewer = void 0;
-var tslib_1 = require("tslib");
-var arcRotateCamera_1 = require("@babylonjs/core/Cameras/arcRotateCamera");
-var boundingInfo_1 = require("@babylonjs/core/Culling/boundingInfo");
-var engine_1 = require("@babylonjs/core/Engines/engine");
-var highlightLayer_1 = require("@babylonjs/core/Layers/highlightLayer");
-var math_vector_1 = require("@babylonjs/core/Maths/math.vector");
-var mesh_1 = require("@babylonjs/core/Meshes/mesh");
-var screenshotTools_1 = require("@babylonjs/core/Misc/screenshotTools");
-var lodash_es_1 = require("lodash-es");
-var buildinfo_json_1 = require("../../buildinfo.json");
-var sceneSetup_1 = require("../internal/sceneSetup");
-var animationManager_1 = require("../manager/animationManager");
-var sceneManager_1 = require("../manager/sceneManager");
-var variantInstanceManager_1 = require("../manager/variantInstanceManager");
-var specStorage_1 = require("../store/specStorage");
-var resourceHelper_1 = require("../util/resourceHelper");
-var event_1 = require("./event");
-var eventBroadcaster_1 = require("./eventBroadcaster");
-var parameter_1 = require("./parameter");
-var variant_1 = require("./variant");
-/**
- * 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}
- */
-var Viewer = /** @class */ (function (_super) {
-    tslib_1.__extends(Viewer, _super);
-    /**
-     * Constructor
-     */
-    function Viewer(canvas, structureJson) {
-        var _this = _super.call(this) || this;
-        _this.canvas = canvas;
-        _this.structureJson = structureJson;
-        _this._scene = null;
-        _this._animationManager = null;
-        _this._sceneManager = null;
-        _this._variantInstances = null;
-        return _this;
-    }
-    Object.defineProperty(Viewer.prototype, "scene", {
-        /**
-         * Gets the BabylonJS Scene that is attached to the instance.
-         *
-         * @throws Error if the `scene` has not been initialized.
-         */
-        get: function () {
-            if (!this._scene) {
-                throw new Error("Scene has not been initialized.");
-            }
-            return this._scene;
-        },
-        enumerable: false,
-        configurable: true
-    });
-    Object.defineProperty(Viewer.prototype, "sceneManager", {
-        get: function () {
-            if (!this._sceneManager) {
-                throw new Error("Environment has not been initialized.");
-            }
-            return this._sceneManager;
-        },
-        enumerable: false,
-        configurable: true
-    });
-    Object.defineProperty(Viewer.prototype, "engine", {
-        /**
-         * Gets the BabylonJS Engine that is attached to the viewer.
-         */
-        get: function () {
-            return this.scene.getEngine();
-        },
-        enumerable: false,
-        configurable: true
-    });
-    Object.defineProperty(Viewer.prototype, "variantInstances", {
-        /**
-         * Gets the {@link VariantInstanceManager} attached to the viewer.
-         *
-         * @throws Error if the {@link VariantInstanceManager} has not been initialized.
-         */
-        get: function () {
-            if (!this._variantInstances) {
-                throw Error("There is no variantInstanceManager.");
-            }
-            return this._variantInstances;
-        },
-        enumerable: false,
-        configurable: true
-    });
-    Object.defineProperty(Viewer.prototype, "animationManager", {
-        /**
-         * Gets the {@link AnimationManager} attached to the viewer.
-         *
-         * @throws Error if the {@link AnimationManager} has not been initialized.
-         */
-        get: function () {
-            if (!this._animationManager) {
-                throw new Error("There is no animationManager instance.");
-            }
-            return this._animationManager;
-        },
-        enumerable: false,
-        configurable: true
-    });
-    /**
-     * 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}
-     */
-    Viewer.prototype.bootstrap = function () {
-        return tslib_1.__awaiter(this, void 0, void 0, function () {
-            var indexJson, sceneJson, _a, rootVariant, _b, setupJson;
-            return tslib_1.__generator(this, function (_c) {
-                switch (_c.label) {
-                    case 0:
-                        this.broadcastEvent(event_1.Event.BOOTSTRAP_START, this);
-                        if (!lodash_es_1.isString(this.structureJson)) return [3 /*break*/, 2];
-                        return [4 /*yield*/, resourceHelper_1.loadJson(this.structureJson)];
-                    case 1:
-                        indexJson = _c.sent();
-                        return [3 /*break*/, 3];
-                    case 2:
-                        indexJson = this.structureJson;
-                        _c.label = 3;
-                    case 3:
-                        if (!indexJson.scene) {
-                            throw new Error("No \"scene\" property found for bootstrapping.");
-                        }
-                        // fill spec store
-                        specStorage_1.SpecStorage.createFromSpec(indexJson);
-                        if (!lodash_es_1.isString(indexJson.scene)) return [3 /*break*/, 5];
-                        return [4 /*yield*/, resourceHelper_1.loadJson(indexJson.scene)];
-                    case 4:
-                        sceneJson = _c.sent();
-                        indexJson.scene = sceneJson;
-                        _c.label = 5;
-                    case 5:
-                        _a = this;
-                        return [4 /*yield*/, this.initScene()];
-                    case 6:
-                        _a._scene = _c.sent();
-                        return [4 /*yield*/, variant_1.Variant.create('_', indexJson, this)];
-                    case 7:
-                        rootVariant = _c.sent();
-                        _b = this;
-                        return [4 /*yield*/, variantInstanceManager_1.VariantInstanceManager.create(rootVariant)];
-                    case 8:
-                        _b._variantInstances = _c.sent();
-                        if (!indexJson.setup) return [3 /*break*/, 12];
-                        if (!lodash_es_1.isString(indexJson.setup)) return [3 /*break*/, 10];
-                        return [4 /*yield*/, resourceHelper_1.loadJson(indexJson.setup)];
-                    case 9:
-                        setupJson = _c.sent();
-                        indexJson.setup = setupJson;
-                        _c.label = 10;
-                    case 10: return [4 /*yield*/, this.createVariantInstances()];
-                    case 11:
-                        _c.sent();
-                        _c.label = 12;
-                    case 12:
-                        // resize handler
-                        window.addEventListener('resize', resourceHelper_1.debounce(this.resize.bind(this), 100));
-                        // event broadcasting
-                        this.broadcastEvent(event_1.Event.BOOTSTRAP_END, this);
-                        return [2 /*return*/, this];
-                }
-            });
-        });
-    };
-    // Disabled for now to decrease bundle size.
-    // See https://github.com/Combeenation/3d-viewer/issues/37
-    // /**
-    //  * Enables the BabylonJS DebugLayer. If you pass options, be sure to pass an Object of type `IInspectorOptions`.
-    //  */
-    // public async enableDebugLayer(options?: any) {
-    //  	// @ts-ignore
-    //  	await import(/* webpackChunkName: "debug-inspector" */'@babylonjs/inspector');
-    //  	await this.scene.debugLayer.show(options);
-    //  	return this;
-    // }
-    /**
-     * Destroys all registered {@link VariantInstance}s that are registered
-     */
-    Viewer.prototype.destroyVariantInstances = function () {
-        var _this = this;
-        this.variantInstances.all.forEach(function (variantInstance) {
-            _this.variantInstances.destroy(variantInstance.name);
-        });
-        return this;
-    };
-    /**
-     * Trigger a resize event for the `Engine`
-     */
-    Viewer.prototype.resize = function () {
-        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.
-     */
-    Viewer.prototype.getNode = function (variantInstanceName, elementDottedPath, nodeDottedPath) {
-        return tslib_1.__awaiter(this, void 0, void 0, function () {
-            var variantInstance;
-            return tslib_1.__generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0: return [4 /*yield*/, this.variantInstances.get(variantInstanceName)];
-                    case 1:
-                        variantInstance = _a.sent();
-                        return [2 /*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.
-     */
-    Viewer.prototype.getMesh = function (variantInstanceName, elementDottedPath, meshDottedPath) {
-        return tslib_1.__awaiter(this, void 0, void 0, function () {
-            var variantInstance;
-            return tslib_1.__generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0: return [4 /*yield*/, this.variantInstances.get(variantInstanceName)];
-                    case 1:
-                        variantInstance = _a.sent();
-                        return [2 /*return*/, variantInstance.getMesh(elementDottedPath, meshDottedPath)];
-                }
-            });
-        });
-    };
-    /**
-     * Switches the camera
-     *
-     * @emits {@link Event.CAMERA_SWITCHED}
-     */
-    Viewer.prototype.switchCamera = function (newCamera, reset) {
-        if (reset === void 0) { reset = true; }
-        var camera = this.scene.getCameraByName(newCamera);
-        if (camera) {
-            var 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`.
-     */
-    Viewer.prototype.moveActiveCameraTo = function (placement, animation) {
-        return tslib_1.__awaiter(this, void 0, void 0, function () {
-            return tslib_1.__generator(this, function (_a) {
-                return [2 /*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
-     */
-    Viewer.prototype.screenshot = function (settings) {
-        var _this = this;
-        return new Promise(function (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);
-        });
-    };
-    /**
-     * Calculates the bounding box from all visible meshes on the scene.
-     */
-    Viewer.prototype.calculateBoundingBox = function () {
-        if (this.scene.meshes.length === 0) {
-            throw new Error('There are currently no meshes on the scene.');
-        }
-        var max = new math_vector_1.Vector3(0, 0, 0);
-        var min = new math_vector_1.Vector3(0, 0, 0);
-        this.scene.meshes.filter(function (mesh) { return mesh.isVisible; }).forEach(function (mesh) {
-            max = math_vector_1.Vector3.Maximize(max, mesh.getBoundingInfo().boundingBox.maximumWorld);
-            min = math_vector_1.Vector3.Minimize(min, mesh.getBoundingInfo().boundingBox.minimumWorld);
-        });
-        var boundingBox = this.scene.getMeshByName('__bounding_box__');
-        if (!boundingBox) {
-            boundingBox = new mesh_1.Mesh('__bounding_box__', this.scene);
-        }
-        boundingBox.setBoundingInfo(new boundingInfo_1.BoundingInfo(min, max));
-        //boundingBox.showBoundingBox = true;
-        return boundingBox;
-    };
-    /**
-     * Focuses the camera to see every visible mesh in scene and tries to optimize wheel precision and panning.
-     */
-    Viewer.prototype.autofocusActiveCamera = function (settings) {
-        var _a;
-        var activeCamera = this.scene.activeCamera;
-        if (!activeCamera) {
-            throw new Error('No active camera found when using autofocus feature.');
-        }
-        if (activeCamera instanceof arcRotateCamera_1.ArcRotateCamera) {
-            // calculate some values
-            var boundingBox = this.calculateBoundingBox();
-            var size = boundingBox.getBoundingInfo().maximum.subtract(boundingBox.getBoundingInfo().minimum);
-            var radius = size.length() * ((_a = settings === null || settings === void 0 ? void 0 : settings.radiusFactor) !== null && _a !== void 0 ? _a : 1.5);
-            if (!isFinite(radius)) {
-                radius = 1;
-            }
-            // use helper camera to get some default values
-            var helperCamera = new arcRotateCamera_1.ArcRotateCamera('__helper_camera__', Math.PI / -2, Math.PI / 2, radius, math_vector_1.Vector3.Zero(), this.scene);
-            helperCamera.useFramingBehavior = true;
-            helperCamera.setTarget(boundingBox);
-            // translate values from helper to active camera
-            activeCamera.setTarget(mesh_1.Mesh.Center([boundingBox]));
-            activeCamera.alpha = helperCamera.alpha;
-            activeCamera.beta = helperCamera.beta;
-            activeCamera.minZ = helperCamera.minZ;
-            activeCamera.maxZ = helperCamera.maxZ;
-            activeCamera.radius = helperCamera.radius;
-            activeCamera.lowerRadiusLimit = helperCamera.lowerRadiusLimit;
-            activeCamera.upperRadiusLimit = helperCamera.upperRadiusLimit;
-            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;
-            }
-            // remove the helper camera
-            helperCamera.dispose();
-        }
-        else {
-            var cameraClsName = activeCamera.getClassName();
-            throw new Error("Camera of type \"" + cameraClsName + "\" is not implemented yet to use autofocus feature.");
-        }
-    };
-    /**
-     * Resets everything by calling {@link destroy} to clear all references and {@link bootstrap} to setup a clean
-     * environment
-     */
-    Viewer.prototype.reset = function () {
-        return tslib_1.__awaiter(this, void 0, void 0, function () {
-            return tslib_1.__generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0: return [4 /*yield*/, this.destroy()];
-                    case 1:
-                        _a.sent();
-                        return [2 /*return*/, this.bootstrap()];
-                }
-            });
-        });
-    };
-    /**
-     * Destroys
-     *
-     * * all {@link VariantInstance}s using {@link destroyVariantInstances}
-     * * calling `dispose` on the `Engine` and `Scene`
-     */
-    Viewer.prototype.destroy = function () {
-        this.destroyVariantInstances();
-        this.scene.dispose();
-        specStorage_1.SpecStorage.destroy();
-        return this;
-    };
-    /**
-     * @emits {@link Event.SCENE_PROCESSING_START}
-     * @emits {@link Event.SCENE_PROCESSING_END}
-     */
-    Viewer.prototype.initScene = function () {
-        var _a, _b, _c;
-        return tslib_1.__awaiter(this, void 0, void 0, function () {
-            var sceneJson, engine, scene, _d, _e;
-            var _this = this;
-            return tslib_1.__generator(this, function (_f) {
-                switch (_f.label) {
-                    case 0:
-                        sceneJson = specStorage_1.SpecStorage.get('scene');
-                        this.broadcastEvent(event_1.Event.SCENE_PROCESSING_START, sceneJson);
-                        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);
-                        return [4 /*yield*/, sceneSetup_1.sceneSetup(engine, sceneJson)];
-                    case 1:
-                        scene = _f.sent();
-                        if (sceneJson.meshPicking) {
-                            new highlightLayer_1.HighlightLayer('default', scene);
-                            scene.onPointerPick = function (pointerEvent, pickInfo) {
-                                if (!pickInfo.hit) {
-                                    return;
-                                }
-                                var 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);
-                                }
-                            };
-                        }
-                        _d = this;
-                        return [4 /*yield*/, sceneManager_1.SceneManager.create(scene)];
-                    case 2:
-                        _d._sceneManager = _f.sent();
-                        _e = this;
-                        return [4 /*yield*/, animationManager_1.AnimationManager.create(scene)];
-                    case 3:
-                        _e._animationManager = _f.sent();
-                        this.broadcastEvent(event_1.Event.SCENE_PROCESSING_END, scene);
-                        engine.runRenderLoop(function () {
-                            scene.render();
-                        });
-                        return [2 /*return*/, scene];
-                }
-            });
-        });
-    };
-    /**
-     * Batch creation of multiple {@link VariantInstance} objects with a {@link SetupJson} object passed
-     */
-    Viewer.prototype.createVariantInstances = function () {
-        return tslib_1.__awaiter(this, void 0, void 0, function () {
-            var setupJson, instances, _i, _a, instanceDefinition, _b, _c;
-            return tslib_1.__generator(this, function (_d) {
-                switch (_d.label) {
-                    case 0:
-                        setupJson = specStorage_1.SpecStorage.get('setup');
-                        instances = [];
-                        _i = 0, _a = setupJson.instances;
-                        _d.label = 1;
-                    case 1:
-                        if (!(_i < _a.length)) return [3 /*break*/, 4];
-                        instanceDefinition = _a[_i];
-                        if (instanceDefinition.lazy) {
-                            this.variantInstances.register(instanceDefinition);
-                            return [3 /*break*/, 3];
-                        }
-                        _c = (_b = instances).push;
-                        return [4 /*yield*/, this.variantInstances.create(instanceDefinition.variant, instanceDefinition.name, instanceDefinition.parameters)];
-                    case 2:
-                        _c.apply(_b, [_d.sent()]);
-                        _d.label = 3;
-                    case 3:
-                        _i++;
-                        return [3 /*break*/, 1];
-                    case 4: return [2 /*return*/, instances];
-                }
-            });
-        });
-    };
-    Viewer.version = buildinfo_json_1.version;
-    return Viewer;
-}(eventBroadcaster_1.EventBroadcaster));
-exports.Viewer = Viewer;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Viewer = void 0;
+var tslib_1 = require("tslib");
+var arcRotateCamera_1 = require("@babylonjs/core/Cameras/arcRotateCamera");
+var boundingInfo_1 = require("@babylonjs/core/Culling/boundingInfo");
+var engine_1 = require("@babylonjs/core/Engines/engine");
+var highlightLayer_1 = require("@babylonjs/core/Layers/highlightLayer");
+var math_vector_1 = require("@babylonjs/core/Maths/math.vector");
+var mesh_1 = require("@babylonjs/core/Meshes/mesh");
+var screenshotTools_1 = require("@babylonjs/core/Misc/screenshotTools");
+var lodash_es_1 = require("lodash-es");
+var buildinfo_json_1 = require("../../buildinfo.json");
+var sceneSetup_1 = require("../internal/sceneSetup");
+var animationManager_1 = require("../manager/animationManager");
+var sceneManager_1 = require("../manager/sceneManager");
+var variantInstanceManager_1 = require("../manager/variantInstanceManager");
+var specStorage_1 = require("../store/specStorage");
+var resourceHelper_1 = require("../util/resourceHelper");
+var event_1 = require("./event");
+var eventBroadcaster_1 = require("./eventBroadcaster");
+var parameter_1 = require("./parameter");
+var variant_1 = require("./variant");
+/**
+ * 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}
+ */
+var Viewer = /** @class */ (function (_super) {
+    tslib_1.__extends(Viewer, _super);
+    /**
+     * Constructor
+     */
+    function Viewer(canvas, structureJson) {
+        var _this = _super.call(this) || this;
+        _this.canvas = canvas;
+        _this.structureJson = structureJson;
+        _this._scene = null;
+        _this._animationManager = null;
+        _this._sceneManager = null;
+        _this._variantInstances = null;
+        return _this;
+    }
+    Object.defineProperty(Viewer.prototype, "scene", {
+        /**
+         * Gets the BabylonJS Scene that is attached to the instance.
+         *
+         * @throws Error if the `scene` has not been initialized.
+         */
+        get: function () {
+            if (!this._scene) {
+                throw new Error("Scene has not been initialized.");
+            }
+            return this._scene;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(Viewer.prototype, "sceneManager", {
+        get: function () {
+            if (!this._sceneManager) {
+                throw new Error("Environment has not been initialized.");
+            }
+            return this._sceneManager;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(Viewer.prototype, "engine", {
+        /**
+         * Gets the BabylonJS Engine that is attached to the viewer.
+         */
+        get: function () {
+            return this.scene.getEngine();
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(Viewer.prototype, "variantInstances", {
+        /**
+         * Gets the {@link VariantInstanceManager} attached to the viewer.
+         *
+         * @throws Error if the {@link VariantInstanceManager} has not been initialized.
+         */
+        get: function () {
+            if (!this._variantInstances) {
+                throw Error("There is no variantInstanceManager.");
+            }
+            return this._variantInstances;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(Viewer.prototype, "animationManager", {
+        /**
+         * Gets the {@link AnimationManager} attached to the viewer.
+         *
+         * @throws Error if the {@link AnimationManager} has not been initialized.
+         */
+        get: function () {
+            if (!this._animationManager) {
+                throw new Error("There is no animationManager instance.");
+            }
+            return this._animationManager;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * 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}
+     */
+    Viewer.prototype.bootstrap = function () {
+        return tslib_1.__awaiter(this, void 0, void 0, function () {
+            var indexJson, sceneJson, _a, rootVariant, _b, setupJson;
+            return tslib_1.__generator(this, function (_c) {
+                switch (_c.label) {
+                    case 0:
+                        this.broadcastEvent(event_1.Event.BOOTSTRAP_START, this);
+                        if (!lodash_es_1.isString(this.structureJson)) return [3 /*break*/, 2];
+                        return [4 /*yield*/, resourceHelper_1.loadJson(this.structureJson)];
+                    case 1:
+                        indexJson = _c.sent();
+                        return [3 /*break*/, 3];
+                    case 2:
+                        indexJson = this.structureJson;
+                        _c.label = 3;
+                    case 3:
+                        if (!indexJson.scene) {
+                            throw new Error("No \"scene\" property found for bootstrapping.");
+                        }
+                        // fill spec store
+                        specStorage_1.SpecStorage.createFromSpec(indexJson);
+                        if (!lodash_es_1.isString(indexJson.scene)) return [3 /*break*/, 5];
+                        return [4 /*yield*/, resourceHelper_1.loadJson(indexJson.scene)];
+                    case 4:
+                        sceneJson = _c.sent();
+                        indexJson.scene = sceneJson;
+                        _c.label = 5;
+                    case 5:
+                        _a = this;
+                        return [4 /*yield*/, this.initScene()];
+                    case 6:
+                        _a._scene = _c.sent();
+                        return [4 /*yield*/, variant_1.Variant.create('_', indexJson, this)];
+                    case 7:
+                        rootVariant = _c.sent();
+                        _b = this;
+                        return [4 /*yield*/, variantInstanceManager_1.VariantInstanceManager.create(rootVariant)];
+                    case 8:
+                        _b._variantInstances = _c.sent();
+                        if (!indexJson.setup) return [3 /*break*/, 12];
+                        if (!lodash_es_1.isString(indexJson.setup)) return [3 /*break*/, 10];
+                        return [4 /*yield*/, resourceHelper_1.loadJson(indexJson.setup)];
+                    case 9:
+                        setupJson = _c.sent();
+                        indexJson.setup = setupJson;
+                        _c.label = 10;
+                    case 10: return [4 /*yield*/, this.createVariantInstances()];
+                    case 11:
+                        _c.sent();
+                        _c.label = 12;
+                    case 12:
+                        // resize handler
+                        window.addEventListener('resize', resourceHelper_1.debounce(this.resize.bind(this), 100));
+                        // event broadcasting
+                        this.broadcastEvent(event_1.Event.BOOTSTRAP_END, this);
+                        return [2 /*return*/, this];
+                }
+            });
+        });
+    };
+    // Disabled for now to decrease bundle size.
+    // See https://github.com/Combeenation/3d-viewer/issues/37
+    // /**
+    //  * Enables the BabylonJS DebugLayer. If you pass options, be sure to pass an Object of type `IInspectorOptions`.
+    //  */
+    // public async enableDebugLayer(options?: any) {
+    //  	// @ts-ignore
+    //  	await import(/* webpackChunkName: "debug-inspector" */'@babylonjs/inspector');
+    //  	await this.scene.debugLayer.show(options);
+    //  	return this;
+    // }
+    /**
+     * Destroys all registered {@link VariantInstance}s that are registered
+     */
+    Viewer.prototype.destroyVariantInstances = function () {
+        var _this = this;
+        this.variantInstances.all.forEach(function (variantInstance) {
+            _this.variantInstances.destroy(variantInstance.name);
+        });
+        return this;
+    };
+    /**
+     * Trigger a resize event for the `Engine`
+     */
+    Viewer.prototype.resize = function () {
+        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.
+     */
+    Viewer.prototype.getNode = function (variantInstanceName, elementDottedPath, nodeDottedPath) {
+        return tslib_1.__awaiter(this, void 0, void 0, function () {
+            var variantInstance;
+            return tslib_1.__generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.variantInstances.get(variantInstanceName)];
+                    case 1:
+                        variantInstance = _a.sent();
+                        return [2 /*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.
+     */
+    Viewer.prototype.getMesh = function (variantInstanceName, elementDottedPath, meshDottedPath) {
+        return tslib_1.__awaiter(this, void 0, void 0, function () {
+            var variantInstance;
+            return tslib_1.__generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.variantInstances.get(variantInstanceName)];
+                    case 1:
+                        variantInstance = _a.sent();
+                        return [2 /*return*/, variantInstance.getMesh(elementDottedPath, meshDottedPath)];
+                }
+            });
+        });
+    };
+    /**
+     * Switches the camera
+     *
+     * @emits {@link Event.CAMERA_SWITCHED}
+     */
+    Viewer.prototype.switchCamera = function (newCamera, reset) {
+        if (reset === void 0) { reset = true; }
+        var camera = this.scene.getCameraByName(newCamera);
+        if (camera) {
+            var 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`.
+     */
+    Viewer.prototype.moveActiveCameraTo = function (placement, animation) {
+        return tslib_1.__awaiter(this, void 0, void 0, function () {
+            return tslib_1.__generator(this, function (_a) {
+                return [2 /*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
+     */
+    Viewer.prototype.screenshot = function (settings) {
+        var _this = this;
+        return new Promise(function (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);
+        });
+    };
+    /**
+     * Calculates the bounding box from all visible meshes on the scene.
+     */
+    Viewer.prototype.calculateBoundingBox = function () {
+        if (this.scene.meshes.length === 0) {
+            throw new Error('There are currently no meshes on the scene.');
+        }
+        var max = new math_vector_1.Vector3(0, 0, 0);
+        var min = new math_vector_1.Vector3(0, 0, 0);
+        this.scene.meshes.filter(function (mesh) { return mesh.isVisible; }).forEach(function (mesh) {
+            max = math_vector_1.Vector3.Maximize(max, mesh.getBoundingInfo().boundingBox.maximumWorld);
+            min = math_vector_1.Vector3.Minimize(min, mesh.getBoundingInfo().boundingBox.minimumWorld);
+        });
+        var boundingBox = this.scene.getMeshByName('__bounding_box__');
+        if (!boundingBox) {
+            boundingBox = new mesh_1.Mesh('__bounding_box__', this.scene);
+        }
+        boundingBox.setBoundingInfo(new boundingInfo_1.BoundingInfo(min, max));
+        //boundingBox.showBoundingBox = true;
+        return boundingBox;
+    };
+    /**
+     * Focuses the camera to see every visible mesh in scene and tries to optimize wheel precision and panning.
+     */
+    Viewer.prototype.autofocusActiveCamera = function (settings) {
+        var _a;
+        var activeCamera = this.scene.activeCamera;
+        if (!activeCamera) {
+            throw new Error('No active camera found when using autofocus feature.');
+        }
+        if (activeCamera instanceof arcRotateCamera_1.ArcRotateCamera) {
+            // calculate some values
+            var boundingBox = this.calculateBoundingBox();
+            var size = boundingBox.getBoundingInfo().maximum.subtract(boundingBox.getBoundingInfo().minimum);
+            var radius = size.length() * ((_a = settings === null || settings === void 0 ? void 0 : settings.radiusFactor) !== null && _a !== void 0 ? _a : 1.5);
+            if (!isFinite(radius)) {
+                radius = 1;
+            }
+            // use helper camera to get some default values
+            var helperCamera = new arcRotateCamera_1.ArcRotateCamera('__helper_camera__', Math.PI / -2, Math.PI / 2, radius, math_vector_1.Vector3.Zero(), this.scene);
+            helperCamera.useFramingBehavior = true;
+            helperCamera.setTarget(boundingBox);
+            // translate values from helper to active camera
+            activeCamera.setTarget(mesh_1.Mesh.Center([boundingBox]));
+            activeCamera.alpha = helperCamera.alpha;
+            activeCamera.beta = helperCamera.beta;
+            activeCamera.minZ = helperCamera.minZ;
+            activeCamera.maxZ = helperCamera.maxZ;
+            activeCamera.radius = helperCamera.radius;
+            activeCamera.lowerRadiusLimit = helperCamera.lowerRadiusLimit;
+            activeCamera.upperRadiusLimit = helperCamera.upperRadiusLimit;
+            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;
+            }
+            // remove the helper camera
+            helperCamera.dispose();
+        }
+        else {
+            var cameraClsName = activeCamera.getClassName();
+            throw new Error("Camera of type \"" + cameraClsName + "\" is not implemented yet to use autofocus feature.");
+        }
+    };
+    /**
+     * Resets everything by calling {@link destroy} to clear all references and {@link bootstrap} to setup a clean
+     * environment
+     */
+    Viewer.prototype.reset = function () {
+        return tslib_1.__awaiter(this, void 0, void 0, function () {
+            return tslib_1.__generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.destroy()];
+                    case 1:
+                        _a.sent();
+                        return [2 /*return*/, this.bootstrap()];
+                }
+            });
+        });
+    };
+    /**
+     * Destroys
+     *
+     * * all {@link VariantInstance}s using {@link destroyVariantInstances}
+     * * calling `dispose` on the `Engine` and `Scene`
+     */
+    Viewer.prototype.destroy = function () {
+        this.destroyVariantInstances();
+        this.scene.dispose();
+        specStorage_1.SpecStorage.destroy();
+        return this;
+    };
+    /**
+     * @emits {@link Event.SCENE_PROCESSING_START}
+     * @emits {@link Event.SCENE_PROCESSING_END}
+     */
+    Viewer.prototype.initScene = function () {
+        var _a, _b, _c;
+        return tslib_1.__awaiter(this, void 0, void 0, function () {
+            var sceneJson, engine, scene, _d, _e;
+            var _this = this;
+            return tslib_1.__generator(this, function (_f) {
+                switch (_f.label) {
+                    case 0:
+                        sceneJson = specStorage_1.SpecStorage.get('scene');
+                        this.broadcastEvent(event_1.Event.SCENE_PROCESSING_START, sceneJson);
+                        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);
+                        return [4 /*yield*/, sceneSetup_1.sceneSetup(engine, sceneJson)];
+                    case 1:
+                        scene = _f.sent();
+                        if (sceneJson.meshPicking) {
+                            new highlightLayer_1.HighlightLayer('default', scene);
+                            scene.onPointerPick = function (pointerEvent, pickInfo) {
+                                if (!pickInfo.hit) {
+                                    return;
+                                }
+                                var 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);
+                                }
+                            };
+                        }
+                        _d = this;
+                        return [4 /*yield*/, sceneManager_1.SceneManager.create(scene)];
+                    case 2:
+                        _d._sceneManager = _f.sent();
+                        _e = this;
+                        return [4 /*yield*/, animationManager_1.AnimationManager.create(scene)];
+                    case 3:
+                        _e._animationManager = _f.sent();
+                        this.broadcastEvent(event_1.Event.SCENE_PROCESSING_END, scene);
+                        engine.runRenderLoop(function () {
+                            scene.render();
+                        });
+                        return [2 /*return*/, scene];
+                }
+            });
+        });
+    };
+    /**
+     * Batch creation of multiple {@link VariantInstance} objects with a {@link SetupJson} object passed
+     */
+    Viewer.prototype.createVariantInstances = function () {
+        return tslib_1.__awaiter(this, void 0, void 0, function () {
+            var setupJson, instances, _i, _a, instanceDefinition, _b, _c;
+            return tslib_1.__generator(this, function (_d) {
+                switch (_d.label) {
+                    case 0:
+                        setupJson = specStorage_1.SpecStorage.get('setup');
+                        instances = [];
+                        _i = 0, _a = setupJson.instances;
+                        _d.label = 1;
+                    case 1:
+                        if (!(_i < _a.length)) return [3 /*break*/, 4];
+                        instanceDefinition = _a[_i];
+                        if (instanceDefinition.lazy) {
+                            this.variantInstances.register(instanceDefinition);
+                            return [3 /*break*/, 3];
+                        }
+                        _c = (_b = instances).push;
+                        return [4 /*yield*/, this.variantInstances.create(instanceDefinition.variant, instanceDefinition.name, instanceDefinition.parameters)];
+                    case 2:
+                        _c.apply(_b, [_d.sent()]);
+                        _d.label = 3;
+                    case 3:
+                        _i++;
+                        return [3 /*break*/, 1];
+                    case 4: return [2 /*return*/, instances];
+                }
+            });
+        });
+    };
+    Viewer.version = buildinfo_json_1.version;
+    return Viewer;
+}(eventBroadcaster_1.EventBroadcaster));
+exports.Viewer = Viewer;
 //# sourceMappingURL=viewer.js.map