@combeenation/3d-viewer 4.0.0-beta2 → 4.0.0-rc1

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

@@ -1,369 +1,521 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getClientRectFromMesh = exports.removeFromHighlightLayer = exports.addToHighlightLayer = exports.setMaterialRoughness = exports.setMaterialMetallness = exports.setMaterialTexture = exports.setMaterialColor = exports.setSourceNodeMaterial = exports.setMaterial = exports.deactivateTransformNode = exports.activateTransformNode = exports.assertTransformNode = exports.injectTransformNodeMetadata = exports.cloneTransformNodeMaterial = exports.cloneTransformNode = exports.getDottedPathForTransformNode = exports.mapToDottedNodes = void 0;
-var tslib_1 = require("tslib");
-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 lodash_es_1 = require("lodash-es");
-var dottedPath_1 = require("../classes/dottedPath");
-/**
- * @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 getDottedPathForTransformNode = 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.getDottedPathForTransformNode = getDottedPathForTransformNode;
-/**
- *
- * @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
- * @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 _prefix = dottedPath_1.DottedPath.create(prefix).addParts([
-            'node',
-            node.uniqueId.toString()
-        ]);
-        node.material = node.material.clone(_prefix.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 injectTransformNodeMetadata = function (node, metadata, deep) {
-    if (deep === void 0) { deep = true; }
-    node.metadata = lodash_es_1.merge({}, node.metadata, metadata);
-    if (deep) {
-        var children = node.getChildTransformNodes(true);
-        children.forEach(function (child) { return injectTransformNodeMetadata(child, metadata, deep); });
-    }
-};
-exports.injectTransformNodeMetadata = injectTransformNodeMetadata;
-/**
- * @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
- * @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;
-/**
- * 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.getClientRectFromMesh = exports.removeFromShadowGenerator = exports.addToShadowGenerator = exports.setReceiveShadows = exports.removeFromHighlightLayer = exports.addToHighlightLayer = exports.setMaterialRoughness = exports.setMaterialMetallness = exports.setMaterialTexture = exports.setMaterialColor = exports.setSourceNodeMaterial = exports.setMaterial = exports.moveTransformNode = exports.rotateTransformNode = 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 _prefix = dottedPath_1.DottedPath.create(prefix).addParts([
+            'node',
+            node.uniqueId.toString()
+        ]);
+        node.material = node.material.clone(_prefix.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;
+/**
+ * Attention: this function mutates the position of a node. Keep in mind that there are dependencies to other
+ * functions moving nodes around.
+ * @param node
+ * @param rotation
+ */
+var rotateTransformNode = function (node, rotation) {
+    // remember absolute rotation and reset it before translating
+    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);
+    }
+    if (!lodash_es_1.has(node.metadata, 'rotation.position') || lodash_es_1.get(node.metadata, 'position.dirty')) {
+        var rotationPosition = node.absolutePosition.clone();
+        if (lodash_es_1.has(node.metadata, 'rotation.offset')) {
+            rotationPosition = rotationPosition.subtract(lodash_es_1.get(node.metadata, 'rotation.offset'));
+        }
+        injectNodeMetadata(node, { 'rotation.position': rotationPosition }, false);
+        injectNodeMetadata(node, { 'position.dirty': false }, false);
+    }
+    node.setAbsolutePosition(lodash_es_1.get(node.metadata, 'rotation.position'));
+    node.rotationQuaternion = math_vector_1.Quaternion.FromArray(lodash_es_1.get(node.metadata, 'rotation.initial'));
+    node.rotateAround(math_vector_1.Vector3.Zero(), math_axis_1.Axis.X, rotation.x);
+    node.rotateAround(math_vector_1.Vector3.Zero(), math_axis_1.Axis.Y, rotation.y);
+    node.rotateAround(math_vector_1.Vector3.Zero(), math_axis_1.Axis.Z, rotation.z);
+    node.computeWorldMatrix(true);
+    var rotationOffset = node.absolutePosition.subtract(lodash_es_1.get(node.metadata, 'rotation.position'));
+    injectNodeMetadata(node, { 'rotation.offset': rotationOffset }, false);
+    return node;
+};
+exports.rotateTransformNode = rotateTransformNode;
+/**
+ * Attention: this function mutates the position of a node. Keep in mind that there are dependencies to other
+ * functions moving nodes around.
+ * @param node
+ * @param distance
+ */
+var moveTransformNode = function (node, distance) {
+    // remember absolute position and reset it before translating
+    if (!lodash_es_1.has(node.metadata, 'position.initial')) {
+        injectNodeMetadata(node, { 'position.initial': node.absolutePosition.clone() }, false);
+    }
+    var position = lodash_es_1.get(node.metadata, 'position.initial');
+    if (lodash_es_1.has(node.metadata, 'rotation.offset')) {
+        position = position.add(lodash_es_1.get(node.metadata, 'rotation.offset'));
+    }
+    node.setAbsolutePosition(position.add(distance));
+    injectNodeMetadata(node, { 'position.dirty': true }, false);
+    return node;
+};
+exports.moveTransformNode = moveTransformNode;
+/**
+ * @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