@combeenation/3d-viewer 5.0.1 → 5.0.3-beta2

package/dist/lib-cjs/api/util/babylonHelper.js

@@ -1,498 +1,576 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getClientRectFromMesh = exports.removeFromShadowGenerator = exports.addToShadowGenerator = exports.setReceiveShadows = exports.removeFromHighlightLayer = exports.addToHighlightLayer = exports.setMaterialRoughness = exports.setMaterialMetallness = exports.setMaterialTexture = exports.setMaterialColor = exports.setSourceNodeMaterial = exports.setMaterial = exports.transformTransformNode = exports.disableNodeWithParents = exports.enableNodeWithParents = exports.deactivateTransformNode = exports.activateTransformNode = exports.assertTransformNode = exports.injectNodeMetadata = exports.cloneTransformNodeMaterial = exports.cloneNodeWithParents = exports.cloneTransformNode = exports.getDottedPathForNode = exports.mapToDottedNodes = exports.getRootNode = void 0;
-var tslib_1 = require("tslib");
-var light_1 = require("@babylonjs/core/Lights/light");
-var math_axis_1 = require("@babylonjs/core/Maths/math.axis");
-var math_vector_1 = require("@babylonjs/core/Maths/math.vector");
-var abstractMesh_1 = require("@babylonjs/core/Meshes/abstractMesh");
-var instancedMesh_1 = require("@babylonjs/core/Meshes/instancedMesh");
-var transformNode_1 = require("@babylonjs/core/Meshes/transformNode");
-var lodash_es_1 = require("lodash-es");
-var dottedPath_1 = require("../classes/dottedPath");
-/**
- * @param node
- * @return Node
- */
-var getRootNode = function (node) {
-    var _node = node;
-    while (_node.parent) {
-        _node = _node.parent;
-    }
-    return _node;
-};
-exports.getRootNode = getRootNode;
-/**
- * @param nodes
- * @param predicate
- * @return Map<DottedPath, T>
- */
-var mapToDottedNodes = function (nodes, predicate) {
-    var map = new Map();
-    var addNodes = function (_node) {
-        if (predicate && predicate(_node)) {
-            map.set(_node.metadata.dottedPath, _node);
-        }
-        _node.getChildren().forEach(function (child) {
-            addNodes(child);
-        });
-    };
-    nodes.forEach(function (node) {
-        addNodes(node);
-    });
-    return map;
-};
-exports.mapToDottedNodes = mapToDottedNodes;
-/**
- * @param node
- * @return DottedPath
- */
-var getDottedPathForNode = function (node) {
-    var dottedPath = dottedPath_1.DottedPath.create(node.name);
-    var _parent = node;
-    while (_parent.parent) {
-        _parent = _parent.parent;
-        dottedPath.unshiftPart(_parent.name);
-    }
-    return dottedPath;
-};
-exports.getDottedPathForNode = getDottedPathForNode;
-/**
- * @param node
- * @param predicate
- * @param deep
- * @return TransformNode | null
- */
-var cloneTransformNode = function (node, predicate, deep) {
-    if (deep === void 0) { deep = true; }
-    if (predicate && !predicate(node)) {
-        return null;
-    }
-    var clone = node.clone(node.name, node.parent, true);
-    if (clone) {
-        clone.metadata = lodash_es_1.cloneDeep(node.metadata);
-    }
-    if (deep) {
-        var children = node.getChildTransformNodes(true);
-        children.forEach(function (child) {
-            var clonedChild = cloneTransformNode(child, predicate, deep);
-            if (clonedChild) {
-                clonedChild.parent = clone;
-            }
-        });
-    }
-    return clone;
-};
-exports.cloneTransformNode = cloneTransformNode;
-/**
- * @param node
- */
-var cloneNodeWithParents = function (node) {
-    var clone = null;
-    if (node instanceof transformNode_1.TransformNode) {
-        clone = node.clone(node.name, cloneNodeWithParents(node.parent), true);
-    }
-    else if (node instanceof light_1.Light) {
-        clone = node.clone(node.name, cloneNodeWithParents(node.parent));
-    }
-    else if (node) {
-        throw new Error("Cloning of \"" + (node === null || node === void 0 ? void 0 : node.constructor.name) + "\" is not implemented (yet).");
-    }
-    return clone;
-};
-exports.cloneNodeWithParents = cloneNodeWithParents;
-/**
- * @param node
- * @param deep
- * @param prefix
- * @return TransformNode
- */
-var cloneTransformNodeMaterial = function (node, prefix, deep) {
-    if (prefix === void 0) { prefix = ''; }
-    if (deep === void 0) { deep = true; }
-    if (node instanceof abstractMesh_1.AbstractMesh && node.material) {
-        var newMatName = dottedPath_1.DottedPath.create(prefix).addParts([node.material.name, 'clone', node.uniqueId.toString()]);
-        node.material = node.material.clone(newMatName.path);
-    }
-    if (deep) {
-        var children = node.getChildTransformNodes(true);
-        children.forEach(function (child) { return cloneTransformNodeMaterial(child, prefix, deep); });
-    }
-    return node;
-};
-exports.cloneTransformNodeMaterial = cloneTransformNodeMaterial;
-/**
- * @param node
- * @param deep
- * @param metadata
- */
-var injectNodeMetadata = function (node, metadata, deep) {
-    if (deep === void 0) { deep = true; }
-    node.metadata = lodash_es_1.merge({}, node.metadata, metadata);
-    if (deep && node instanceof transformNode_1.TransformNode) {
-        var children = node.getChildTransformNodes(true);
-        children.forEach(function (child) { return injectNodeMetadata(child, metadata, deep); });
-    }
-};
-exports.injectNodeMetadata = injectNodeMetadata;
-/**
- * @param node
- * @param assertCallable
- * @param callableParameters
- * @param deep
- */
-var assertTransformNode = function (node, assertCallable, callableParameters, deep) {
-    if (callableParameters === void 0) { callableParameters = []; }
-    if (deep === void 0) { deep = true; }
-    assertCallable.apply(void 0, tslib_1.__spreadArrays([node], callableParameters));
-    if (deep) {
-        var children = node.getChildTransformNodes(true);
-        children.forEach(function (child) { return assertTransformNode(child, assertCallable, callableParameters, deep); });
-    }
-};
-exports.assertTransformNode = assertTransformNode;
-/**
- * @param node
- * @param deep
- */
-var activateTransformNode = function (node, deep) {
-    if (deep === void 0) { deep = true; }
-    node.setEnabled(true);
-    /*
-      if( node instanceof AbstractMesh ) {
-          node.visibility = 1;
-          node.isPickable = true;
-      }
-      */
-    if (deep) {
-        node.getChildTransformNodes(true).forEach(function (child) { return activateTransformNode(child, deep); });
-    }
-};
-exports.activateTransformNode = activateTransformNode;
-/**
- * @param node
- * @param deep
- */
-var deactivateTransformNode = function (node, deep) {
-    if (deep === void 0) { deep = true; }
-    node.setEnabled(false);
-    /*
-      if( node instanceof AbstractMesh ) {
-          node.visibility = 0;
-          node.isPickable = false;
-      }
-      */
-    if (deep) {
-        node.getChildTransformNodes(true).forEach(function (child) { return deactivateTransformNode(child, deep); });
-    }
-};
-exports.deactivateTransformNode = deactivateTransformNode;
-/**
- * @param node
- */
-var enableNodeWithParents = function (node) {
-    node.setEnabled(true);
-    if (node.parent) {
-        enableNodeWithParents(node.parent);
-    }
-};
-exports.enableNodeWithParents = enableNodeWithParents;
-/**
- * @param node
- */
-var disableNodeWithParents = function (node) {
-    node.setEnabled(false);
-    if (node.parent) {
-        disableNodeWithParents(node.parent);
-    }
-};
-exports.disableNodeWithParents = disableNodeWithParents;
-/**
- * Applies a {@link TransformationDefinition} consecutively to ensure dependencies in positioning etc.
- * @param node
- * @param transformation
- */
-var transformTransformNode = function (node, transformation) {
-    // scaling
-    if (!lodash_es_1.has(node.metadata, 'scaling.initial')) {
-        injectNodeMetadata(node, { 'scaling.initial': node.scaling }, false);
-    }
-    var initialScaling = lodash_es_1.get(node.metadata, 'scaling.initial');
-    node.scaling = initialScaling.multiply(transformation.scaling);
-    // position
-    if (!lodash_es_1.has(node.metadata, 'position.initial')) {
-        injectNodeMetadata(node, { 'position.initial': node.absolutePosition.clone() }, false);
-    }
-    var initialPosition = lodash_es_1.get(node.metadata, 'position.initial');
-    node.setAbsolutePosition(initialPosition.add(transformation.position).multiply(transformation.scaling));
-    // rotation
-    if (!lodash_es_1.has(node.metadata, 'rotation.initial')) {
-        var rotationQuaternion = node.rotationQuaternion;
-        if (!rotationQuaternion) {
-            rotationQuaternion = math_vector_1.Quaternion.RotationYawPitchRoll(node.rotation.x, node.rotation.y, node.rotation.z);
-        }
-        injectNodeMetadata(node, { 'rotation.initial': rotationQuaternion.asArray() }, false);
-    }
-    var initialRotationQuaternion = math_vector_1.Quaternion.FromArray(lodash_es_1.get(node.metadata, 'rotation.initial'));
-    node.rotationQuaternion = initialRotationQuaternion;
-    node.rotateAround(math_vector_1.Vector3.Zero(), math_axis_1.Axis.X, transformation.rotation.x);
-    node.rotateAround(math_vector_1.Vector3.Zero(), math_axis_1.Axis.Y, transformation.rotation.y);
-    node.rotateAround(math_vector_1.Vector3.Zero(), math_axis_1.Axis.Z, transformation.rotation.z);
-    node.computeWorldMatrix(true);
-};
-exports.transformTransformNode = transformTransformNode;
-/**
- * @param node
- * @param material
- * @param deep
- */
-var setMaterial = function (node, material, deep) {
-    if (deep === void 0) { deep = true; }
-    if (node instanceof abstractMesh_1.AbstractMesh) {
-        node.material = material;
-    }
-    if (deep) {
-        node.getChildTransformNodes(true).forEach(function (child) { return setMaterial(child, material, deep); });
-    }
-};
-exports.setMaterial = setMaterial;
-/**
- * !!! Warning !!!
- * This function is not public API. Whilst it can help solving certain problems, it only works reliably in well defined
- * situations and can cause unwanted side effects under some conditions. Use carefully at your own risk!
- *
- * See https://combeenation.myjetbrains.com/youtrack/issue/CB-5906 for further details regarding this warning.
- *
- * Set material of an instanced meshes source mesh.
- * Changes the material of all instanced meshes which have the same source mesh.
- *
- * @param node
- * @param material
- * @param deep
- *
- * @ignore
- */
-var setSourceNodeMaterial = function (node, material, deep) {
-    if (deep === void 0) { deep = true; }
-    var warn = "\tYou're using \"setSourceNodeMaterial\" which is not public API.\n\tWhilst it can help solving certain problems, it only works reliably in well defined situations and can cause unwanted side effects under some conditions.\n\tUse carefully at your own risk!";
-    console.warn("!!! Warning !!!\n" + warn);
-    if (node instanceof instancedMesh_1.InstancedMesh) {
-        node.sourceMesh.material = material;
-    }
-    if (deep) {
-        node.getChildTransformNodes(true).forEach(function (child) { return setSourceNodeMaterial(child, material, deep); });
-    }
-};
-exports.setSourceNodeMaterial = setSourceNodeMaterial;
-/**
- * @param node
- * @param color
- * @param deep
- */
-var setMaterialColor = function (node, color, deep) {
-    if (deep === void 0) { deep = true; }
-    if (node instanceof abstractMesh_1.AbstractMesh && node.material) {
-        var materialCls = node.material.getClassName();
-        switch (materialCls) {
-            case 'PBRMaterial':
-                node.material.albedoColor = color.toLinearSpace();
-                break;
-            case 'StandardMaterial':
-                node.material.diffuseColor = color;
-                break;
-            default:
-                throw new Error("Setting color for material of instance \"" + materialCls + "\" not implemented (yet).");
-        }
-    }
-    if (deep) {
-        node.getChildTransformNodes(true).forEach(function (child) { return setMaterialColor(child, color, deep); });
-    }
-};
-exports.setMaterialColor = setMaterialColor;
-/**
- * @param node
- * @param texture
- * @param deep
- */
-var setMaterialTexture = function (node, texture, deep) {
-    if (deep === void 0) { deep = true; }
-    if (node instanceof abstractMesh_1.AbstractMesh && node.material) {
-        var materialCls = node.material.getClassName();
-        switch (materialCls) {
-            case 'PBRMaterial':
-                node.material.albedoTexture = texture;
-                break;
-            case 'StandardMaterial':
-                node.material.diffuseTexture = texture;
-                break;
-            default:
-                throw new Error("Setting texture for material of instance \"" + materialCls + "\" not implemented (yet).");
-        }
-    }
-    if (deep) {
-        node.getChildTransformNodes(true).forEach(function (child) { return setMaterialTexture(child, texture, deep); });
-    }
-};
-exports.setMaterialTexture = setMaterialTexture;
-/**
- * @param node
- * @param metallness
- * @param deep
- */
-var setMaterialMetallness = function (node, metallness, deep) {
-    if (deep === void 0) { deep = true; }
-    if (node instanceof abstractMesh_1.AbstractMesh && node.material) {
-        var materialCls = node.material.getClassName();
-        switch (materialCls) {
-            case 'PBRMaterial':
-                node.material.metallic = metallness;
-                break;
-            default:
-                throw new Error("Setting metallness for material of instance \"" + materialCls + "\" not implemented (yet).");
-        }
-    }
-    if (deep) {
-        node.getChildTransformNodes(true).forEach(function (child) { return setMaterialMetallness(child, metallness, deep); });
-    }
-};
-exports.setMaterialMetallness = setMaterialMetallness;
-/**
- * @param node
- * @param roughness
- * @param deep
- */
-var setMaterialRoughness = function (node, roughness, deep) {
-    if (deep === void 0) { deep = true; }
-    if (node instanceof abstractMesh_1.AbstractMesh && node.material) {
-        var materialCls = node.material.getClassName();
-        switch (materialCls) {
-            case 'PBRMaterial':
-                node.material.roughness = roughness;
-                break;
-            case 'StandardMaterial':
-                node.material.roughness = roughness;
-                break;
-            default:
-                throw new Error("Setting roughness for material of instance \"" + materialCls + "\" not implemented (yet).");
-        }
-    }
-    if (deep) {
-        node.getChildTransformNodes(true).forEach(function (child) { return setMaterialRoughness(child, roughness, deep); });
-    }
-};
-exports.setMaterialRoughness = setMaterialRoughness;
-/**
- * @param node
- * @param layer
- * @param color
- * @param deep
- */
-var addToHighlightLayer = function (layer, color, node, deep) {
-    if (deep === void 0) { deep = true; }
-    if (node instanceof abstractMesh_1.AbstractMesh) {
-        layer.addMesh(node, color);
-    }
-    if (deep) {
-        node.getChildTransformNodes(true).forEach(function (child) { return addToHighlightLayer(layer, color, child, deep); });
-    }
-};
-exports.addToHighlightLayer = addToHighlightLayer;
-/**
- * @param node
- * @param layer
- * @param deep
- */
-var removeFromHighlightLayer = function (layer, node, deep) {
-    if (deep === void 0) { deep = true; }
-    if (node instanceof abstractMesh_1.AbstractMesh) {
-        layer.removeMesh(node);
-    }
-    if (deep) {
-        node.getChildTransformNodes(true).forEach(function (child) { return removeFromHighlightLayer(layer, child, deep); });
-    }
-};
-exports.removeFromHighlightLayer = removeFromHighlightLayer;
-/**
- * @param node
- * @param receiveShadows
- * @param deep
- */
-var setReceiveShadows = function (node, receiveShadows, deep) {
-    if (deep === void 0) { deep = true; }
-    if (node instanceof abstractMesh_1.AbstractMesh) {
-        node.receiveShadows = receiveShadows;
-    }
-    if (deep) {
-        node.getChildTransformNodes(true).forEach(function (child) { return setReceiveShadows(child, receiveShadows, deep); });
-    }
-};
-exports.setReceiveShadows = setReceiveShadows;
-/**
- * @param node
- * @param generator
- * @param deep
- */
-var addToShadowGenerator = function (generator, node, deep) {
-    if (deep === void 0) { deep = true; }
-    if (node instanceof abstractMesh_1.AbstractMesh) {
-        // We have to remove the node because there's no duplicate check in babylon
-        generator.removeShadowCaster(node, false);
-        generator.addShadowCaster(node, false);
-    }
-    if (deep) {
-        node.getChildTransformNodes(true).forEach(function (child) { return addToShadowGenerator(generator, child, deep); });
-    }
-};
-exports.addToShadowGenerator = addToShadowGenerator;
-/**
- * @param node
- * @param generator
- * @param deep
- */
-var removeFromShadowGenerator = function (generator, node, deep) {
-    if (deep === void 0) { deep = true; }
-    if (node instanceof abstractMesh_1.AbstractMesh) {
-        generator.removeShadowCaster(node, false);
-    }
-    if (deep) {
-        node.getChildTransformNodes(true).forEach(function (child) { return removeFromShadowGenerator(generator, child, deep); });
-    }
-};
-exports.removeFromShadowGenerator = removeFromShadowGenerator;
-/**
- * https://forum.babylonjs.com/t/get-mesh-bounding-box-position-and-size-in-2d-screen-coordinates/1058/3
- * @param mesh
- * @param scene
- * @param canvas
- */
-var getClientRectFromMesh = function (mesh, scene, canvas) {
-    // get bounding box of the mesh
-    var meshVectors = mesh.getBoundingInfo().boundingBox.vectors;
-    // get the matrix and viewport needed to project the vectors onto the screen
-    var worldMatrix = mesh.getWorldMatrix();
-    var transformMatrix = scene.getTransformMatrix();
-    var viewport = scene.activeCamera.viewport;
-    // loop though all the vectors and project them against the current camera viewport to get a set of coordinates
-    var coordinates = meshVectors.map(function (vector) {
-        var projection = math_vector_1.Vector3.Project(vector, worldMatrix, transformMatrix, viewport);
-        projection.x = projection.x * canvas.clientWidth;
-        projection.y = projection.y * canvas.clientHeight;
-        return projection;
-    });
-    // get the min and max for all the coordinates so we can calculate the largest possible screen size
-    var maxX = Math.max.apply(Math, coordinates.map(function (o) { return o.x; }));
-    var minX = Math.min.apply(Math, coordinates.map(function (o) { return o.x; }));
-    var maxY = Math.max.apply(Math, coordinates.map(function (o) { return o.y; }));
-    var minY = Math.min.apply(Math, coordinates.map(function (o) { return o.y; }));
-    // return a ClientRect from this
-    return {
-        width: maxX - minX,
-        height: maxY - minY,
-        left: minX,
-        top: minY,
-        right: maxX,
-        bottom: maxY,
-    };
-};
-exports.getClientRectFromMesh = getClientRectFromMesh;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.envHelperMetadataName = exports.backgroundDomeName = exports.changeEnvironment = exports.getClientRectFromMesh = exports.removeFromShadowGenerator = exports.addToShadowGenerator = exports.setReceiveShadows = exports.removeFromHighlightLayer = exports.addToHighlightLayer = exports.setMaterialRoughness = exports.setMaterialMetallness = exports.setMaterialTexture = exports.setMaterialColor = exports.setSourceNodeMaterial = exports.setMaterial = exports.transformTransformNode = exports.disableNodeWithParents = exports.enableNodeWithParents = exports.deactivateTransformNode = exports.activateTransformNode = exports.assertTransformNode = exports.injectNodeMetadata = exports.cloneTransformNodeMaterial = exports.cloneNodeWithParents = exports.cloneTransformNode = exports.getDottedPathForNode = exports.mapToDottedNodes = exports.getRootNode = void 0;
+var tslib_1 = require("tslib");
+var photoDome_1 = require("@babylonjs/core/Helpers/photoDome");
+var light_1 = require("@babylonjs/core/Lights/light");
+var cubeTexture_1 = require("@babylonjs/core/Materials/Textures/cubeTexture");
+var math_axis_1 = require("@babylonjs/core/Maths/math.axis");
+var math_color_1 = require("@babylonjs/core/Maths/math.color");
+var math_vector_1 = require("@babylonjs/core/Maths/math.vector");
+var abstractMesh_1 = require("@babylonjs/core/Meshes/abstractMesh");
+var instancedMesh_1 = require("@babylonjs/core/Meshes/instancedMesh");
+var transformNode_1 = require("@babylonjs/core/Meshes/transformNode");
+var tools_1 = require("@babylonjs/core/Misc/tools");
+var sceneSetup_1 = require("../internal/sceneSetup");
+var lodash_es_1 = require("lodash-es");
+var dottedPath_1 = require("../classes/dottedPath");
+var backgroundDomeName = 'BackgroundDome_ViewerGenerated';
+exports.backgroundDomeName = backgroundDomeName;
+var envHelperMetadataName = 'viewerEnvHelper';
+exports.envHelperMetadataName = envHelperMetadataName;
+/**
+ * @param node
+ * @return Node
+ */
+var getRootNode = function (node) {
+    var _node = node;
+    while (_node.parent) {
+        _node = _node.parent;
+    }
+    return _node;
+};
+exports.getRootNode = getRootNode;
+/**
+ * @param nodes
+ * @param predicate
+ * @return Map<DottedPath, T>
+ */
+var mapToDottedNodes = function (nodes, predicate) {
+    var map = new Map();
+    var addNodes = function (_node) {
+        if (predicate && predicate(_node)) {
+            map.set(_node.metadata.dottedPath, _node);
+        }
+        _node.getChildren().forEach(function (child) {
+            addNodes(child);
+        });
+    };
+    nodes.forEach(function (node) {
+        addNodes(node);
+    });
+    return map;
+};
+exports.mapToDottedNodes = mapToDottedNodes;
+/**
+ * @param node
+ * @return DottedPath
+ */
+var getDottedPathForNode = function (node) {
+    var dottedPath = dottedPath_1.DottedPath.create(node.name);
+    var _parent = node;
+    while (_parent.parent) {
+        _parent = _parent.parent;
+        dottedPath.unshiftPart(_parent.name);
+    }
+    return dottedPath;
+};
+exports.getDottedPathForNode = getDottedPathForNode;
+/**
+ * @param node
+ * @param predicate
+ * @param deep
+ * @return TransformNode | null
+ */
+var cloneTransformNode = function (node, predicate, deep) {
+    if (deep === void 0) { deep = true; }
+    if (predicate && !predicate(node)) {
+        return null;
+    }
+    var clone = node.clone(node.name, node.parent, true);
+    if (clone) {
+        clone.metadata = lodash_es_1.cloneDeep(node.metadata);
+    }
+    if (deep) {
+        var children = node.getChildTransformNodes(true);
+        children.forEach(function (child) {
+            var clonedChild = cloneTransformNode(child, predicate, deep);
+            if (clonedChild) {
+                clonedChild.parent = clone;
+            }
+        });
+    }
+    return clone;
+};
+exports.cloneTransformNode = cloneTransformNode;
+/**
+ * @param node
+ */
+var cloneNodeWithParents = function (node) {
+    var clone = null;
+    if (node instanceof transformNode_1.TransformNode) {
+        clone = node.clone(node.name, cloneNodeWithParents(node.parent), true);
+    }
+    else if (node instanceof light_1.Light) {
+        clone = node.clone(node.name, cloneNodeWithParents(node.parent));
+    }
+    else if (node) {
+        throw new Error("Cloning of \"" + (node === null || node === void 0 ? void 0 : node.constructor.name) + "\" is not implemented (yet).");
+    }
+    return clone;
+};
+exports.cloneNodeWithParents = cloneNodeWithParents;
+/**
+ * @param node
+ * @param deep
+ * @param prefix
+ * @return TransformNode
+ */
+var cloneTransformNodeMaterial = function (node, prefix, deep) {
+    if (prefix === void 0) { prefix = ''; }
+    if (deep === void 0) { deep = true; }
+    if (node instanceof abstractMesh_1.AbstractMesh && node.material) {
+        var newMatName = dottedPath_1.DottedPath.create(prefix).addParts([node.material.name, 'clone', node.uniqueId.toString()]);
+        node.material = node.material.clone(newMatName.path);
+    }
+    if (deep) {
+        var children = node.getChildTransformNodes(true);
+        children.forEach(function (child) { return cloneTransformNodeMaterial(child, prefix, deep); });
+    }
+    return node;
+};
+exports.cloneTransformNodeMaterial = cloneTransformNodeMaterial;
+/**
+ * @param node
+ * @param deep
+ * @param metadata
+ */
+var injectNodeMetadata = function (node, metadata, deep) {
+    if (deep === void 0) { deep = true; }
+    node.metadata = lodash_es_1.merge({}, node.metadata, metadata);
+    if (deep && node instanceof transformNode_1.TransformNode) {
+        var children = node.getChildTransformNodes(true);
+        children.forEach(function (child) { return injectNodeMetadata(child, metadata, deep); });
+    }
+};
+exports.injectNodeMetadata = injectNodeMetadata;
+/**
+ * @param node
+ * @param assertCallable
+ * @param callableParameters
+ * @param deep
+ */
+var assertTransformNode = function (node, assertCallable, callableParameters, deep) {
+    if (callableParameters === void 0) { callableParameters = []; }
+    if (deep === void 0) { deep = true; }
+    assertCallable.apply(void 0, tslib_1.__spreadArrays([node], callableParameters));
+    if (deep) {
+        var children = node.getChildTransformNodes(true);
+        children.forEach(function (child) { return assertTransformNode(child, assertCallable, callableParameters, deep); });
+    }
+};
+exports.assertTransformNode = assertTransformNode;
+/**
+ * @param node
+ * @param deep
+ */
+var activateTransformNode = function (node, deep) {
+    if (deep === void 0) { deep = true; }
+    node.setEnabled(true);
+    /*
+      if( node instanceof AbstractMesh ) {
+          node.visibility = 1;
+          node.isPickable = true;
+      }
+      */
+    if (deep) {
+        node.getChildTransformNodes(true).forEach(function (child) { return activateTransformNode(child, deep); });
+    }
+};
+exports.activateTransformNode = activateTransformNode;
+/**
+ * @param node
+ * @param deep
+ */
+var deactivateTransformNode = function (node, deep) {
+    if (deep === void 0) { deep = true; }
+    node.setEnabled(false);
+    /*
+      if( node instanceof AbstractMesh ) {
+          node.visibility = 0;
+          node.isPickable = false;
+      }
+      */
+    if (deep) {
+        node.getChildTransformNodes(true).forEach(function (child) { return deactivateTransformNode(child, deep); });
+    }
+};
+exports.deactivateTransformNode = deactivateTransformNode;
+/**
+ * @param node
+ */
+var enableNodeWithParents = function (node) {
+    node.setEnabled(true);
+    if (node.parent) {
+        enableNodeWithParents(node.parent);
+    }
+};
+exports.enableNodeWithParents = enableNodeWithParents;
+/**
+ * @param node
+ */
+var disableNodeWithParents = function (node) {
+    node.setEnabled(false);
+    if (node.parent) {
+        disableNodeWithParents(node.parent);
+    }
+};
+exports.disableNodeWithParents = disableNodeWithParents;
+/**
+ * Applies a {@link TransformationDefinition} consecutively to ensure dependencies in positioning etc.
+ * @param node
+ * @param transformation
+ */
+var transformTransformNode = function (node, transformation) {
+    // scaling
+    if (!lodash_es_1.has(node.metadata, 'scaling.initial')) {
+        injectNodeMetadata(node, { 'scaling.initial': node.scaling }, false);
+    }
+    var initialScaling = lodash_es_1.get(node.metadata, 'scaling.initial');
+    node.scaling = initialScaling.multiply(transformation.scaling);
+    // position
+    if (!lodash_es_1.has(node.metadata, 'position.initial')) {
+        injectNodeMetadata(node, { 'position.initial': node.absolutePosition.clone() }, false);
+    }
+    var initialPosition = lodash_es_1.get(node.metadata, 'position.initial');
+    node.setAbsolutePosition(initialPosition.add(transformation.position).multiply(transformation.scaling));
+    // rotation
+    if (!lodash_es_1.has(node.metadata, 'rotation.initial')) {
+        var rotationQuaternion = node.rotationQuaternion;
+        if (!rotationQuaternion) {
+            rotationQuaternion = math_vector_1.Quaternion.RotationYawPitchRoll(node.rotation.x, node.rotation.y, node.rotation.z);
+        }
+        injectNodeMetadata(node, { 'rotation.initial': rotationQuaternion.asArray() }, false);
+    }
+    var initialRotationQuaternion = math_vector_1.Quaternion.FromArray(lodash_es_1.get(node.metadata, 'rotation.initial'));
+    node.rotationQuaternion = initialRotationQuaternion;
+    node.rotateAround(math_vector_1.Vector3.Zero(), math_axis_1.Axis.X, transformation.rotation.x);
+    node.rotateAround(math_vector_1.Vector3.Zero(), math_axis_1.Axis.Y, transformation.rotation.y);
+    node.rotateAround(math_vector_1.Vector3.Zero(), math_axis_1.Axis.Z, transformation.rotation.z);
+    node.computeWorldMatrix(true);
+};
+exports.transformTransformNode = transformTransformNode;
+/**
+ * Apply changes of environment (background texture, etc.) consecutively in order to avoid dependency related issues.
+ * @param scene
+ * @param envDef
+ */
+var changeEnvironment = function (scene, envDef) {
+    var _a;
+    var _b;
+    // issue warning if both background texture and usedefault are set
+    if (envDef.environmentUseDefault && envDef.environmentBackground) {
+        console.warn("!!! Warning !!! Spec parameter 'environment.useDefaultEnvironment' is being overruled by 'environment.background'.");
+    }
+    var useDefaultEnv = envDef.environmentUseDefault && !envDef.environmentBackground;
+    // 1) set ENVIRONMENT_COLOR
+    scene.clearColor = envDef.environmentColor
+        ? math_color_1.Color4.FromColor3(envDef.environmentColor)
+        : useDefaultEnv
+            ? sceneSetup_1.defaultEnvHelperColor
+            : sceneSetup_1.defaultSceneClearColor;
+    // 2) dispose existing & set new ENVIRONMENT (==texture)
+    var curEnvTexture = scene.environmentTexture;
+    var envTextureChanged = envDef.environment !== (curEnvTexture === null || curEnvTexture === void 0 ? void 0 : curEnvTexture.url);
+    if (curEnvTexture && (!envDef.environment || envTextureChanged)) {
+        curEnvTexture.dispose();
+    }
+    var rotation = envDef.environmentRotation !== undefined ? tools_1.Tools.ToRadians(envDef.environmentRotation) : 0;
+    if (envDef.environment && envTextureChanged) {
+        var envTexture = cubeTexture_1.CubeTexture.CreateFromPrefilteredData(envDef.environment, scene);
+        envTexture.rotationY = rotation;
+        scene.environmentTexture = envTexture;
+    }
+    else if (curEnvTexture && curEnvTexture.rotationY !== rotation) {
+        curEnvTexture.rotationY = rotation;
+    }
+    // 3) dispose existing & set new ENVIRONMENT_BACKGROUND
+    var curDome = scene.getNodeByName(backgroundDomeName);
+    var backgroundUrlChanged = envDef.environmentBackground !== (curDome === null || curDome === void 0 ? void 0 : curDome.texture.url);
+    if (curDome && (!envDef.environmentBackground || backgroundUrlChanged)) {
+        curDome.dispose();
+    }
+    var rotationPhotoDome = -1 * rotation;
+    if (envDef.environmentBackground && backgroundUrlChanged) {
+        var textureUrl = envDef.environmentBackground;
+        var dome = new photoDome_1.PhotoDome(backgroundDomeName, textureUrl, { resolution: 32, size: 450 }, scene);
+        // Rotate submesh to get them in line with environment texture
+        dome.getChildMeshes(true)[0].rotation.y = tools_1.Tools.ToRadians(90);
+        dome.rotation.y = rotationPhotoDome;
+    }
+    else if (curDome && curDome.rotation.y !== rotationPhotoDome) {
+        curDome.rotation.y = rotationPhotoDome;
+    }
+    // 4) dispose existing & set new ENVIRONMENT_USEDEFAULT (only if no background is set)
+    var curEnvHelper = (_b = scene.metadata) === null || _b === void 0 ? void 0 : _b[envHelperMetadataName];
+    if (curEnvHelper && (!envDef.environmentUseDefault || envDef.environmentBackground)) {
+        curEnvHelper.dispose();
+    }
+    if (useDefaultEnv && !curEnvHelper) {
+        var envHelper = scene.createDefaultEnvironment({ sizeAuto: true });
+        envHelper === null || envHelper === void 0 ? void 0 : envHelper.setMainColor(math_color_1.Color3.FromArray(scene.clearColor.asArray()));
+        if (envHelper) {
+            scene.metadata = lodash_es_1.merge({}, scene.metadata, (_a = {}, _a[envHelperMetadataName] = envHelper, _a));
+        }
+    }
+    // 5) set ENVIRONMENT_INTENSITY
+    if (envDef.environmentIntensity !== undefined) {
+        scene.environmentIntensity = envDef.environmentIntensity;
+    }
+};
+exports.changeEnvironment = changeEnvironment;
+/**
+ * @param node
+ * @param material
+ * @param deep
+ */
+var setMaterial = function (node, material, deep) {
+    if (deep === void 0) { deep = true; }
+    if (node instanceof abstractMesh_1.AbstractMesh) {
+        node.material = material;
+    }
+    if (deep) {
+        node.getChildTransformNodes(true).forEach(function (child) { return setMaterial(child, material, deep); });
+    }
+};
+exports.setMaterial = setMaterial;
+/**
+ * !!! Warning !!!
+ * This function is not public API. Whilst it can help solving certain problems, it only works reliably in well defined
+ * situations and can cause unwanted side effects under some conditions. Use carefully at your own risk!
+ *
+ * See https://combeenation.myjetbrains.com/youtrack/issue/CB-5906 for further details regarding this warning.
+ *
+ * Set material of an instanced meshes source mesh.
+ * Changes the material of all instanced meshes which have the same source mesh.
+ *
+ * @param node
+ * @param material
+ * @param deep
+ *
+ * @ignore
+ */
+var setSourceNodeMaterial = function (node, material, deep) {
+    if (deep === void 0) { deep = true; }
+    var warn = "\tYou're using \"setSourceNodeMaterial\" which is not public API.\n\tWhilst it can help solving certain problems, it only works reliably in well defined situations and can cause unwanted side effects under some conditions.\n\tUse carefully at your own risk!";
+    console.warn("!!! Warning !!!\n" + warn);
+    if (node instanceof instancedMesh_1.InstancedMesh) {
+        node.sourceMesh.material = material;
+    }
+    if (deep) {
+        node.getChildTransformNodes(true).forEach(function (child) { return setSourceNodeMaterial(child, material, deep); });
+    }
+};
+exports.setSourceNodeMaterial = setSourceNodeMaterial;
+/**
+ * @param node
+ * @param color
+ * @param deep
+ */
+var setMaterialColor = function (node, color, deep) {
+    if (deep === void 0) { deep = true; }
+    if (node instanceof abstractMesh_1.AbstractMesh && node.material) {
+        var materialCls = node.material.getClassName();
+        switch (materialCls) {
+            case 'PBRMaterial':
+                node.material.albedoColor = color.toLinearSpace();
+                break;
+            case 'StandardMaterial':
+                node.material.diffuseColor = color;
+                break;
+            default:
+                throw new Error("Setting color for material of instance \"" + materialCls + "\" not implemented (yet).");
+        }
+    }
+    if (deep) {
+        node.getChildTransformNodes(true).forEach(function (child) { return setMaterialColor(child, color, deep); });
+    }
+};
+exports.setMaterialColor = setMaterialColor;
+/**
+ * @param node
+ * @param texture
+ * @param deep
+ */
+var setMaterialTexture = function (node, texture, deep) {
+    if (deep === void 0) { deep = true; }
+    if (node instanceof abstractMesh_1.AbstractMesh && node.material) {
+        var materialCls = node.material.getClassName();
+        switch (materialCls) {
+            case 'PBRMaterial':
+                node.material.albedoTexture = texture;
+                break;
+            case 'StandardMaterial':
+                node.material.diffuseTexture = texture;
+                break;
+            default:
+                throw new Error("Setting texture for material of instance \"" + materialCls + "\" not implemented (yet).");
+        }
+    }
+    if (deep) {
+        node.getChildTransformNodes(true).forEach(function (child) { return setMaterialTexture(child, texture, deep); });
+    }
+};
+exports.setMaterialTexture = setMaterialTexture;
+/**
+ * @param node
+ * @param metallness
+ * @param deep
+ */
+var setMaterialMetallness = function (node, metallness, deep) {
+    if (deep === void 0) { deep = true; }
+    if (node instanceof abstractMesh_1.AbstractMesh && node.material) {
+        var materialCls = node.material.getClassName();
+        switch (materialCls) {
+            case 'PBRMaterial':
+                node.material.metallic = metallness;
+                break;
+            default:
+                throw new Error("Setting metallness for material of instance \"" + materialCls + "\" not implemented (yet).");
+        }
+    }
+    if (deep) {
+        node.getChildTransformNodes(true).forEach(function (child) { return setMaterialMetallness(child, metallness, deep); });
+    }
+};
+exports.setMaterialMetallness = setMaterialMetallness;
+/**
+ * @param node
+ * @param roughness
+ * @param deep
+ */
+var setMaterialRoughness = function (node, roughness, deep) {
+    if (deep === void 0) { deep = true; }
+    if (node instanceof abstractMesh_1.AbstractMesh && node.material) {
+        var materialCls = node.material.getClassName();
+        switch (materialCls) {
+            case 'PBRMaterial':
+                node.material.roughness = roughness;
+                break;
+            case 'StandardMaterial':
+                node.material.roughness = roughness;
+                break;
+            default:
+                throw new Error("Setting roughness for material of instance \"" + materialCls + "\" not implemented (yet).");
+        }
+    }
+    if (deep) {
+        node.getChildTransformNodes(true).forEach(function (child) { return setMaterialRoughness(child, roughness, deep); });
+    }
+};
+exports.setMaterialRoughness = setMaterialRoughness;
+/**
+ * @param node
+ * @param layer
+ * @param color
+ * @param deep
+ */
+var addToHighlightLayer = function (layer, color, node, deep) {
+    if (deep === void 0) { deep = true; }
+    if (node instanceof abstractMesh_1.AbstractMesh) {
+        layer.addMesh(node, color);
+    }
+    if (deep) {
+        node.getChildTransformNodes(true).forEach(function (child) { return addToHighlightLayer(layer, color, child, deep); });
+    }
+};
+exports.addToHighlightLayer = addToHighlightLayer;
+/**
+ * @param node
+ * @param layer
+ * @param deep
+ */
+var removeFromHighlightLayer = function (layer, node, deep) {
+    if (deep === void 0) { deep = true; }
+    if (node instanceof abstractMesh_1.AbstractMesh) {
+        layer.removeMesh(node);
+    }
+    if (deep) {
+        node.getChildTransformNodes(true).forEach(function (child) { return removeFromHighlightLayer(layer, child, deep); });
+    }
+};
+exports.removeFromHighlightLayer = removeFromHighlightLayer;
+/**
+ * @param node
+ * @param receiveShadows
+ * @param deep
+ */
+var setReceiveShadows = function (node, receiveShadows, deep) {
+    if (deep === void 0) { deep = true; }
+    if (node instanceof abstractMesh_1.AbstractMesh) {
+        node.receiveShadows = receiveShadows;
+    }
+    if (deep) {
+        node.getChildTransformNodes(true).forEach(function (child) { return setReceiveShadows(child, receiveShadows, deep); });
+    }
+};
+exports.setReceiveShadows = setReceiveShadows;
+/**
+ * @param node
+ * @param generator
+ * @param deep
+ */
+var addToShadowGenerator = function (generator, node, deep) {
+    if (deep === void 0) { deep = true; }
+    if (node instanceof abstractMesh_1.AbstractMesh) {
+        // We have to remove the node because there's no duplicate check in babylon
+        generator.removeShadowCaster(node, false);
+        generator.addShadowCaster(node, false);
+    }
+    if (deep) {
+        node.getChildTransformNodes(true).forEach(function (child) { return addToShadowGenerator(generator, child, deep); });
+    }
+};
+exports.addToShadowGenerator = addToShadowGenerator;
+/**
+ * @param node
+ * @param generator
+ * @param deep
+ */
+var removeFromShadowGenerator = function (generator, node, deep) {
+    if (deep === void 0) { deep = true; }
+    if (node instanceof abstractMesh_1.AbstractMesh) {
+        generator.removeShadowCaster(node, false);
+    }
+    if (deep) {
+        node.getChildTransformNodes(true).forEach(function (child) { return removeFromShadowGenerator(generator, child, deep); });
+    }
+};
+exports.removeFromShadowGenerator = removeFromShadowGenerator;
+/**
+ * https://forum.babylonjs.com/t/get-mesh-bounding-box-position-and-size-in-2d-screen-coordinates/1058/3
+ * @param mesh
+ * @param scene
+ * @param canvas
+ */
+var getClientRectFromMesh = function (mesh, scene, canvas) {
+    // get bounding box of the mesh
+    var meshVectors = mesh.getBoundingInfo().boundingBox.vectors;
+    // get the matrix and viewport needed to project the vectors onto the screen
+    var worldMatrix = mesh.getWorldMatrix();
+    var transformMatrix = scene.getTransformMatrix();
+    var viewport = scene.activeCamera.viewport;
+    // loop though all the vectors and project them against the current camera viewport to get a set of coordinates
+    var coordinates = meshVectors.map(function (vector) {
+        var projection = math_vector_1.Vector3.Project(vector, worldMatrix, transformMatrix, viewport);
+        projection.x = projection.x * canvas.clientWidth;
+        projection.y = projection.y * canvas.clientHeight;
+        return projection;
+    });
+    // get the min and max for all the coordinates so we can calculate the largest possible screen size
+    var maxX = Math.max.apply(Math, coordinates.map(function (o) { return o.x; }));
+    var minX = Math.min.apply(Math, coordinates.map(function (o) { return o.x; }));
+    var maxY = Math.max.apply(Math, coordinates.map(function (o) { return o.y; }));
+    var minY = Math.min.apply(Math, coordinates.map(function (o) { return o.y; }));
+    // return a ClientRect from this
+    return {
+        width: maxX - minX,
+        height: maxY - minY,
+        left: minX,
+        top: minY,
+        right: maxX,
+        bottom: maxY,
+    };
+};
+exports.getClientRectFromMesh = getClientRectFromMesh;
 //# sourceMappingURL=babylonHelper.js.map