redhotmagma-visualization 1.28.5 → 1.29.2

package/Three/ThreeBase.js

@@ -0,0 +1,724 @@
+"use strict";
+
+function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ThreeBase = exports.onProgress = void 0;
+
+var _three = require("three");
+
+var _tween = _interopRequireDefault(require("@tweenjs/tween.js"));
+
+var _pointerEvent = require("../CommonUtils/pointerEvent");
+
+var _VisualizationInterface = require("../VisualizationInterface");
+
+var _Constants = require("../Constants");
+
+var _removeObject = require("../Utils/removeObject");
+
+var _disposeMaterial = require("../Utils/disposeMaterial");
+
+var _createCanvas = require("../Utils/createCanvas");
+
+var _Deferred = _interopRequireDefault(require("../CommonUtils/Deferred"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+
+function _iterableToArrayLimit(arr, i) { var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"]; if (_i == null) return; var _arr = []; var _n = true; var _d = false; var _s, _e; try { for (_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
+
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e2) { throw _e2; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e3) { didErr = true; err = _e3; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
+
+function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
+
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
+
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+
+function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); if (superClass) _setPrototypeOf(subClass, superClass); }
+
+function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
+
+function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
+
+function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } return _assertThisInitialized(self); }
+
+function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
+
+function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
+
+function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
+
+function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+
+// default progress handler
+var onProgress = function onProgress(xhr) {
+  if (xhr.lengthComputable) {
+    var percentComplete = xhr.loaded / xhr.total * 100; // eslint-disable-next-line no-console
+
+    console.log(percentComplete.toFixed(2) + "% downloaded");
+  }
+};
+/**
+ * This object is an additional layer between the Three.js library and this app.
+ * Responsibilities:
+ *  - handles everything we need to load and render the 3D visualization
+ *  - customizes and simplifies the usage of Three.js in this app
+ *  - provides functionality for the common 3D tasks (like drawing on a texture)
+ */
+
+
+exports.onProgress = onProgress;
+
+var ThreeBase = /*#__PURE__*/function (_VisualizationInterfa) {
+  _inherits(ThreeBase, _VisualizationInterfa);
+
+  var _super = _createSuper(ThreeBase);
+
+  function ThreeBase() {
+    var _this2;
+
+    _classCallCheck(this, ThreeBase);
+
+    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+      args[_key] = arguments[_key];
+    }
+
+    _this2 = _super.call.apply(_super, [this].concat(args));
+
+    _defineProperty(_assertThisInitialized(_this2), "_container", null);
+
+    _defineProperty(_assertThisInitialized(_this2), "_customizableMaterialKeys", []);
+
+    _defineProperty(_assertThisInitialized(_this2), "_customizableMaterials", []);
+
+    _defineProperty(_assertThisInitialized(_this2), "_animationFrame", null);
+
+    _defineProperty(_assertThisInitialized(_this2), "_cameraMovementLocked", false);
+
+    _defineProperty(_assertThisInitialized(_this2), "_hitTestEnabled", true);
+
+    _defineProperty(_assertThisInitialized(_this2), "_isAnimating", false);
+
+    _defineProperty(_assertThisInitialized(_this2), "_animationGroups", []);
+
+    _defineProperty(_assertThisInitialized(_this2), "_loadingManager", Object.assign(new _three.LoadingManager(), {
+      onError: function onError(url) {
+        return _this2.onLoadError(url);
+      }
+    }));
+
+    _defineProperty(_assertThisInitialized(_this2), "camera", null);
+
+    _defineProperty(_assertThisInitialized(_this2), "scene", null);
+
+    _defineProperty(_assertThisInitialized(_this2), "cameraTweenGroup", new _tween["default"].Group());
+
+    _defineProperty(_assertThisInitialized(_this2), "cameraViews", {});
+
+    _defineProperty(_assertThisInitialized(_this2), "animate", function () {
+      var time = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 0;
+
+      if (!_this2._isAnimating) {
+        window.cancelAnimationFrame(_this2._animationFrame);
+        _this2._animationFrame = null;
+        return;
+      }
+
+      _this2._animationFrame = window.requestAnimationFrame(_this2.animate);
+
+      if (time) {
+        _this2.cameraTweenGroup.update(time);
+
+        if (_this2.controls) {
+          _this2.controls.update();
+        }
+
+        _this2.render();
+      }
+    });
+
+    _defineProperty(_assertThisInitialized(_this2), "startAnimation", function (name) {
+      if (_this2._animationGroups.indexOf(name) === -1) {
+        _this2._animationGroups.push(name);
+      }
+
+      if (!_this2._isAnimating) {
+        _this2._animationDeferred = new _Deferred["default"]("animation");
+        _this2._isAnimating = true;
+
+        _this2.animate();
+      }
+    });
+
+    _defineProperty(_assertThisInitialized(_this2), "stopAnimation", function (name) {
+      var animGroupIdx = _this2._animationGroups.indexOf(name);
+
+      if (!name) {
+        _this2._animationGroups.length = 0;
+      } else if (animGroupIdx !== -1) {
+        _this2._animationGroups.splice(animGroupIdx, 1);
+      }
+
+      if (_this2._animationGroups.length) {
+        // there are still running animations in the list
+        return;
+      }
+
+      window.cancelAnimationFrame(_this2._animationFrame);
+      _this2._isAnimating = false;
+
+      if (_this2._animationDeferred) {
+        _this2._animationDeferred.resolve();
+
+        delete _this2._animationDeferred;
+      }
+    });
+
+    _defineProperty(_assertThisInitialized(_this2), "animationRunning", /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee() {
+      return regeneratorRuntime.wrap(function _callee$(_context) {
+        while (1) {
+          switch (_context.prev = _context.next) {
+            case 0:
+              _context.t0 = _this2._animationDeferred;
+
+              if (!_context.t0) {
+                _context.next = 5;
+                break;
+              }
+
+              _context.next = 4;
+              return _this2._animationDeferred.promise;
+
+            case 4:
+              _context.t0 = _context.sent;
+
+            case 5:
+              return _context.abrupt("return", _context.t0);
+
+            case 6:
+            case "end":
+              return _context.stop();
+          }
+        }
+      }, _callee);
+    })));
+
+    _defineProperty(_assertThisInitialized(_this2), "endAnimation", function () {
+      return _this2.cameraTweenGroup.getAll().forEach(function (item) {
+        return item.end();
+      });
+    });
+
+    _defineProperty(_assertThisInitialized(_this2), "getIntersection", function (pointerEvent) {
+      var _this2$_intersectionR;
+
+      var raycaster = new _three.Raycaster();
+
+      var _this2$renderer$domEl = _this2.renderer.domElement.getBoundingClientRect(),
+          elementWidth = _this2$renderer$domEl.width,
+          elementHeight = _this2$renderer$domEl.height,
+          offsetX = _this2$renderer$domEl.left,
+          offsetY = _this2$renderer$domEl.top;
+
+      var point = (0, _pointerEvent.getPointFromPointerEvent)(pointerEvent);
+      var mouse = new _three.Vector2((point.x - offsetX) / elementWidth * 2 - 1, -((point.y - offsetY) / elementHeight) * 2 + 1);
+      raycaster.setFromCamera(mouse, _this2.camera);
+      var intersects = raycaster.intersectObjects(((_this2$_intersectionR = _this2._intersectionRoot) === null || _this2$_intersectionR === void 0 ? void 0 : _this2$_intersectionR.children) || _this2.scene.children, true);
+
+      if (intersects.length > 0) {
+        var intersect = intersects[0]; // closest object
+
+        return {
+          target: intersect,
+          getTextureHit: function getTextureHit() {
+            var material = intersect.object.material;
+
+            if (material && _this2._customizableMaterialKeys.indexOf(material.name) !== -1) {
+              // note: the texture Y is flipped by default in the webgl context
+              // see (https://github.com/mrdoob/three.js/issues/5644)
+              // so if it's flipped we need to flip it back to get the image coordinates
+              var texture = material.map;
+              var flipY = texture.flipY;
+              var _texture$image = texture.image,
+                  width = _texture$image.width,
+                  height = _texture$image.height;
+              var x = Math.round(intersect.uv.x * width);
+              var y = Math.round((flipY ? 1 - intersect.uv.y : intersect.uv.y) * height);
+              return _this2.textureHitFormatter(intersect, {
+                width: width,
+                height: height,
+                x: x,
+                y: y
+              });
+            }
+          }
+        };
+      }
+
+      return null;
+    });
+
+    return _this2;
+  }
+
+  _createClass(ThreeBase, [{
+    key: "init",
+    value:
+    /**
+     * Initializes the 3D renderer, camera and scene
+     * @param {HTMLElement} [container=<div>]
+     * @param {boolean} useDefaultSetup
+     */
+    function init() {
+      var container = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : document.createElement("div");
+      var useDefaultSetup = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
+      this._isInitialized = true;
+      var scene = this.createScene();
+      this.scene = scene;
+      this.camera = this.createCamera();
+      scene.add(this.camera);
+      this.renderer = this.createRenderer();
+      this.addToContainer(container);
+      this.setupContextLostHandling();
+
+      if (useDefaultSetup) {
+        this.setupDefaultLightning();
+        this.setupDefaultControls();
+        this.setupDefaultHitTest();
+      }
+
+      this.observable.dispatch(_Constants.EventTypes.Initialized);
+    }
+  }, {
+    key: "createScene",
+    value: function createScene() {
+      return new _three.Scene();
+    }
+    /**
+     * Create and return a customized three.js renderer object
+     * @return {WebGLRenderer}
+     */
+
+  }, {
+    key: "createRenderer",
+    value: function createRenderer() {}
+    /**
+     * Create and return a customized three.js camera object
+     * @return {Camera}
+     */
+
+  }, {
+    key: "createCamera",
+    value: function createCamera() {}
+    /**
+     * Updates the camera size (different setup for different camera types)
+     * @param {number} width
+     * @param {number} height
+     */
+    // eslint-disable-next-line no-unused-vars
+
+  }, {
+    key: "updateCamera",
+    value: function updateCamera(width, height) {}
+  }, {
+    key: "addToContainer",
+    value: function addToContainer(container) {
+      this._container = container;
+      container.appendChild(this.renderer.domElement);
+      var size = container.getBoundingClientRect();
+      this.setSize(size, false);
+    }
+    /**
+     * Creates the paths for loading a model (object + material)
+     * @returns {{objPath: string, mtlPath: string}}
+     */
+
+  }, {
+    key: "getModelPaths",
+    value: function getModelPaths() {
+      var _basePath = this._basePath,
+          _itemPath = this._itemPath,
+          _materialVariantPath = this._materialVariantPath;
+      var objPath = _itemPath ? [_basePath, _itemPath].join("/") : "";
+      var mtlPath = _materialVariantPath ? [objPath, "materials", _materialVariantPath].join("/") : "";
+      return {
+        objPath: objPath,
+        mtlPath: mtlPath
+      };
+    }
+    /**
+     * Sets the canvas size
+     * @param {number} width
+     * @param {number} height
+     * @param {boolean} rerender
+     */
+
+  }, {
+    key: "setSize",
+    value: function setSize(_ref2) {
+      var width = _ref2.width,
+          height = _ref2.height;
+      var rerender = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
+      this.renderer.setSize(width, height);
+      this.updateCamera(width, height); // if not animating render should be called directly
+
+      if (rerender && !this.isAnimating()) {
+        this.render();
+      }
+    }
+    /**
+     * Creates a simple cube for testing the scene setup
+     * @returns {Mesh}
+     */
+
+  }, {
+    key: "createSampleCube",
+    value: function createSampleCube() {
+      var geometry = new _three.BoxGeometry(1, 1, 1);
+      var material = new _three.MeshBasicMaterial({
+        color: 0x00ff00
+      });
+      var cube = new _three.Mesh(geometry, material);
+      return cube;
+    }
+    /**
+     * Implement this function to add default lights to the scene
+     */
+
+  }, {
+    key: "setupDefaultLightning",
+    value: function setupDefaultLightning() {}
+    /**
+     * @param {HTMLElement} targetElement
+     * @param {{}} options Custom options for the controls (see the OrbitControls.js file for details)
+     */
+    // eslint-disable-next-line no-unused-vars
+
+  }, {
+    key: "setupDefaultControls",
+    value: function setupDefaultControls(targetElement) {
+      var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+    }
+  }, {
+    key: "addAxesHelper",
+    value: function addAxesHelper() {
+      var axesHelper = new _three.AxesHelper(50);
+      this.scene.add(axesHelper);
+    }
+    /**
+     * Enable or disable the controls
+     * @param {boolean} [enabled=true]
+     */
+
+  }, {
+    key: "setControlsEnabled",
+    value: function setControlsEnabled() {
+      var enabled = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+
+      if (!this.controls) {
+        throw new Error("The controls should be available for the setControlsEnabled call!");
+      }
+
+      this.controls.enabled = enabled;
+    } // eslint-disable-next-line no-unused-vars
+
+  }, {
+    key: "updateMaterial",
+    value: function updateMaterial() {
+      var targetObject = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : this.scene;
+    }
+    /**
+     * Getter function for the customizable materials
+     * @returns {Array}
+     */
+
+  }, {
+    key: "getCustomizableMaterials",
+    value: function getCustomizableMaterials() {
+      return this._customizableMaterials;
+    }
+  }, {
+    key: "isCustomizableMaterialAvailable",
+    value: function isCustomizableMaterialAvailable() {
+      return this._customizableMaterials.length > 0;
+    }
+    /**
+     * Returns the material for the given name, or false if not found.
+     * @param {string} name
+     * @returns {boolean|Material}
+     */
+
+  }, {
+    key: "findMaterialByName",
+    value: function findMaterialByName(name) {
+      var _iterator = _createForOfIteratorHelper(this._customizableMaterials),
+          _step;
+
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var mat = _step.value;
+
+          if (mat.name === name) {
+            return mat;
+          }
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+
+      return false;
+    }
+    /**
+     * Calls the given drawing function for custom drawing implementations
+     * It provides the drawing context and the original texture image to the callback function.
+     * It also invalidates the texture to make it update in the next render.
+     * Calls the render function if it's not animating continuously.
+     * @param {function(ctx: CanvasRenderingContext2D, image: HTMLImageElement)} drawingFn
+     * @param {boolean} updateAlpha
+     * @param {boolean} clearTexture
+     * @param {string|undefined} materialName If not provided it uses the first customizable material
+     */
+
+  }, {
+    key: "getDrawingContext",
+    value: function getDrawingContext(drawingFn) {
+      var updateAlpha = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
+      var clearTexture = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
+      var materialName = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : undefined;
+    }
+    /**
+     * Starts the continuous animation in the animation frame
+     * It also updates the related tween group.
+     * @param {number} time The timestamp value from the requestAnimationFrame callback (DOMHighResTimeStamp)
+     */
+
+  }, {
+    key: "render",
+    value: function render() {
+      this.renderer && this.renderer.render(this.scene, this.camera);
+    }
+  }, {
+    key: "isAnimating",
+    value: function isAnimating() {
+      return this._isAnimating;
+    }
+  }, {
+    key: "cleanUpCameraAnimations",
+    value: function cleanUpCameraAnimations() {
+      this.stopAnimation("camera");
+      this.cameraTweenGroup.getAll().forEach(function (t) {
+        return t.stop();
+      });
+      this.cameraTweenGroup.removeAll();
+    }
+    /**
+     * Ads a click event listener to the targetElement
+     * The hit test will be performed only if the controls are enabled.
+     * On success it dispatches the EventTypes.Intersection event with the intersection data.
+     * @see getIntersection
+     * @see Observable
+     * @see createPointerHitListener
+     * @param targetElement
+     */
+
+  }, {
+    key: "setupDefaultHitTest",
+    value: function setupDefaultHitTest(targetElement) {
+      var _this3 = this;
+
+      var element = targetElement || this.renderer.domElement;
+      (0, _pointerEvent.createPointerHitListener)(element, function (evt) {
+        if (!_this3._hitTestEnabled) {
+          return;
+        }
+
+        if (!_this3.controls || _this3.controls.enabled || _this3._cameraMovementLocked) {
+          var is = _this3.getIntersection(evt);
+
+          _this3.observable.dispatch(is ? _Constants.EventTypes.Intersection : _Constants.EventTypes.ClickAway, is);
+        }
+      });
+    }
+    /**
+     * Checks if the pointer intersects with the model
+     * @param {MouseEvent|TouchEvent} pointerEvent
+     * @returns {{target: { distance, point, face, faceIndex, object }, getTextureHit: (function())}|null}
+     */
+
+  }, {
+    key: "textureHitFormatter",
+    value: function textureHitFormatter(intersect, position) {
+      return position;
+    }
+  }, {
+    key: "setupContextLostHandling",
+    value: function setupContextLostHandling() {
+      var _this = this;
+
+      this.renderer.getContext().canvas.addEventListener("webglcontextlost", function (event) {
+        event.preventDefault();
+        window.cancelAnimationFrame(_this._animationFrame); // eslint-disable-next-line no-console
+
+        console.warn("WEBGL CONTEXT LOST");
+      }, false);
+      this.renderer.getContext().canvas.addEventListener("webglcontextrestored", function () {
+        // if it was animating before start it again
+        if (_this._animationFrame) {
+          _this.animate();
+        } // eslint-disable-next-line no-console
+
+
+        console.warn("WEGL CONTEXT RESTORED");
+      }, false);
+    }
+  }, {
+    key: "toggleCameraLock",
+    value: function toggleCameraLock(locked) {
+      this._cameraMovementLocked = locked;
+
+      if (this.controls) {
+        this.controls.enabled = !locked;
+      }
+    }
+  }, {
+    key: "toggleHitTest",
+    value: function toggleHitTest(enabled) {
+      this._hitTestEnabled = enabled;
+    }
+  }, {
+    key: "clearScene",
+    value: function clearScene() {
+      // remove all Group objects
+      this.scene.children.filter(function (obj) {
+        return obj.type === "Group";
+      }).forEach(_removeObject.removeObject); // clear customizable materials and camera views
+
+      this._customizableMaterials = [];
+      this.cameraViews = {};
+    }
+  }, {
+    key: "dispose",
+    value: function dispose() {
+      this.stopAnimation();
+      this.cleanUpCameraAnimations();
+      this.observable.dispose();
+
+      if (this._container && this.renderer) {
+        this._container.removeChild(this.renderer.domElement);
+      }
+
+      if (this.scene) {
+        this.scene.traverse(function (obj) {
+          if (obj.geometry) {
+            obj.geometry.dispose();
+          }
+
+          if (obj.material) {
+            (0, _disposeMaterial.disposeMaterial)(obj.material);
+          }
+        });
+      }
+
+      this.scene = null;
+
+      if (this.renderer) {
+        this.renderer.dispose();
+      }
+
+      this.renderer = null;
+      this.camera = null;
+      this.cameraViews = null;
+      this.controls = null;
+      this._customizableMaterials = [];
+      this._isInitialized = false; // eslint-disable-next-line no-console
+
+      console.info("Three instance has been successfully disposed.");
+    }
+  }, {
+    key: "abortScreenshotting",
+    value: function abortScreenshotting() {
+      this._screenshottingInProgress && Object.defineProperty(this, "_abortScreenshotting", {
+        configurable: true,
+        get: function get() {
+          delete this._abortScreenshotting;
+          return true;
+        }
+      });
+    }
+  }, {
+    key: "createTempOverlay",
+    value: function () {
+      var _createTempOverlay = _asyncToGenerator( /*#__PURE__*/regeneratorRuntime.mark(function _callee2() {
+        var canvas, _createWorkingCanvas, _createWorkingCanvas2, tmpCanvas, scale, container;
+
+        return regeneratorRuntime.wrap(function _callee2$(_context2) {
+          while (1) {
+            switch (_context2.prev = _context2.next) {
+              case 0:
+                canvas = this.renderer.domElement;
+                this.render();
+                _createWorkingCanvas = (0, _createCanvas.createWorkingCanvas)(canvas, true), _createWorkingCanvas2 = _slicedToArray(_createWorkingCanvas, 1), tmpCanvas = _createWorkingCanvas2[0];
+                scale = 1 / this.renderer.getPixelRatio();
+                container = this._container;
+                Object.assign(tmpCanvas.style, {
+                  position: "absolute",
+                  top: "50%",
+                  left: "50%",
+                  transform: "translate(-50%, -50%) scale(".concat(scale, ", ").concat(scale, ")"),
+                  opacity: 0
+                });
+                container.insertBefore(tmpCanvas, canvas);
+                _context2.next = 9;
+                return new Promise(function (resolve) {
+                  window.requestAnimationFrame(function () {
+                    tmpCanvas.style.opacity = 1;
+                    canvas.style.visibility = "hidden";
+                    resolve();
+                  });
+                });
+
+              case 9:
+                return _context2.abrupt("return", function () {
+                  canvas.style.visibility = "visible";
+                  container.removeChild(tmpCanvas);
+                });
+
+              case 10:
+              case "end":
+                return _context2.stop();
+            }
+          }
+        }, _callee2, this);
+      }));
+
+      function createTempOverlay() {
+        return _createTempOverlay.apply(this, arguments);
+      }
+
+      return createTempOverlay;
+    }()
+  }]);
+
+  return ThreeBase;
+}(_VisualizationInterface.VisualizationInterface);
+
+exports.ThreeBase = ThreeBase;