babylonjs-gui 5.38.0 → 5.40.0

package/babylon.gui.d.ts

@@ -71,6 +71,7 @@ declare module BABYLON.GUI {
         private _pointerObserver;
         private _canvasPointerOutObserver;
         private _canvasBlurObserver;
+        private _controlAddedObserver;
         private _background;
         /** @internal */
         _rootContainer: Container;
@@ -1674,6 +1675,19 @@ declare module BABYLON.GUI {
          */
         _processObservables(type: number, x: number, y: number, pi: BABYLON.Nullable<BABYLON.PointerInfoBase>, pointerId: number, buttonIndex: number, deltaX?: number, deltaY?: number): boolean;
         private _prepareFont;
+        /**
+         * Clones a control and its descendants
+         * @param host the texture where the control will be instantiated. Can be empty, in which case the control will be created on the same texture
+         * @returns the cloned control
+         */
+        clone(host?: AdvancedDynamicTexture): Control;
+        /**
+         * Parses a serialized object into this control
+         * @param serializedObject the object with the serialized properties
+         * @param host the texture where the control will be instantiated. Can be empty, in which case the control will be created on the same texture
+         * @returns this control
+         */
+        parse(serializedObject: any, host?: AdvancedDynamicTexture): Control;
         /**
          * Serializes the current control
          * @param serializationObject defined the JSON serialized object
@@ -4062,6 +4076,25 @@ declare module BABYLON.GUI {
          */
         static ComposeToRef(tx: number, ty: number, angle: number, scaleX: number, scaleY: number, parentMatrix: BABYLON.Nullable<Matrix2D>, result: Matrix2D): void;
     }
+    /**
+     * Useful math functions
+     */
+    export class MathTools {
+        /**
+         * Default rounding precision for GUI elements. It should be
+         * set to a power of ten, where the exponent means the number
+         * of decimal digits to round to, i.e, 100 means 2 decimal digits,
+         * 1000 means 3 decimal digits, etc. Default is 100 (2 decimal digits).
+         */
+        static DefaultRoundingPrecision: number;
+        /**
+         * Rounds a number to the nearest multiple of a given precision
+         * @param value the value to be rounded
+         * @param precision the multiple to which the value will be rounded. Default is 100 (2 decimal digits)
+         * @returns
+         */
+        static Round(value: number, precision?: number): number;
+    }
 
 
     /**

package/babylon.gui.js

@@ -617,6 +617,11 @@ var AdvancedDynamicTexture = /** @class */ (function (_super) {
         _this.applyYInversionOnUpdate = invertY;
         _this._rootElement = scene.getEngine().getInputElement();
         _this._renderObserver = scene.onBeforeCameraRenderObservable.add(function (camera) { return _this._checkUpdate(camera); });
+        _this._controlAddedObserver = _this._rootContainer.onControlAddedObservable.add(function (control) {
+            if (control && _this._scene && _this._scene.activeCamera) {
+                _this._checkUpdate(_this._scene.activeCamera);
+            }
+        });
         _this._preKeyboardObserver = scene.onPreKeyboardObservable.add(function (info) {
             if (!_this._focusedControl) {
                 return;
@@ -1073,6 +1078,9 @@ var AdvancedDynamicTexture = /** @class */ (function (_super) {
         if (this._canvasBlurObserver) {
             scene.getEngine().onCanvasBlurObservable.remove(this._canvasBlurObserver);
         }
+        if (this._controlAddedObserver) {
+            this._rootContainer.onControlAddedObservable.remove(this._controlAddedObserver);
+        }
         if (this._layerToDispose) {
             this._layerToDispose.texture = null;
             this._layerToDispose.dispose();
@@ -6525,6 +6533,32 @@ var Control = /** @class */ (function () {
         //children need to be refreshed
         this.getDescendants().forEach(function (child) { return child._markAllAsDirty(); });
     };
+    /**
+     * Clones a control and its descendants
+     * @param host the texture where the control will be instantiated. Can be empty, in which case the control will be created on the same texture
+     * @returns the cloned control
+     */
+    Control.prototype.clone = function (host) {
+        var serialization = {};
+        this.serialize(serialization);
+        var controlType = core_Misc_observable__WEBPACK_IMPORTED_MODULE_1__.Tools.Instantiate("BABYLON.GUI." + serialization.className);
+        var cloned = new controlType();
+        cloned.parse(serialization, host);
+        return cloned;
+    };
+    /**
+     * Parses a serialized object into this control
+     * @param serializedObject the object with the serialized properties
+     * @param host the texture where the control will be instantiated. Can be empty, in which case the control will be created on the same texture
+     * @returns this control
+     */
+    Control.prototype.parse = function (serializedObject, host) {
+        var _this = this;
+        core_Misc_observable__WEBPACK_IMPORTED_MODULE_1__.SerializationHelper.Parse(function () { return _this; }, serializedObject, null);
+        this.name = serializedObject.name;
+        this._parseFromContent(serializedObject, host !== null && host !== void 0 ? host : this._host);
+        return this;
+    };
     /**
      * Serializes the current control
      * @param serializationObject defined the JSON serialized object
@@ -16850,6 +16884,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   "InputTextArea": () => (/* reexport safe */ _controls_index__WEBPACK_IMPORTED_MODULE_0__.InputTextArea),
 /* harmony export */   "KeyPropertySet": () => (/* reexport safe */ _controls_index__WEBPACK_IMPORTED_MODULE_0__.KeyPropertySet),
 /* harmony export */   "Line": () => (/* reexport safe */ _controls_index__WEBPACK_IMPORTED_MODULE_0__.Line),
+/* harmony export */   "MathTools": () => (/* reexport safe */ _math2D__WEBPACK_IMPORTED_MODULE_3__.MathTools),
 /* harmony export */   "Matrix2D": () => (/* reexport safe */ _math2D__WEBPACK_IMPORTED_MODULE_3__.Matrix2D),
 /* harmony export */   "Measure": () => (/* reexport safe */ _measure__WEBPACK_IMPORTED_MODULE_4__.Measure),
 /* harmony export */   "MultiLine": () => (/* reexport safe */ _controls_index__WEBPACK_IMPORTED_MODULE_0__.MultiLine),
@@ -16906,6 +16941,7 @@ __webpack_require__.r(__webpack_exports__);
 
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   "MathTools": () => (/* binding */ MathTools),
 /* harmony export */   "Matrix2D": () => (/* binding */ Matrix2D),
 /* harmony export */   "Vector2WithInfo": () => (/* binding */ Vector2WithInfo)
 /* harmony export */ });
@@ -17133,6 +17169,32 @@ var Matrix2D = /** @class */ (function () {
     return Matrix2D;
 }());
 
+/**
+ * Useful math functions
+ */
+var MathTools = /** @class */ (function () {
+    function MathTools() {
+    }
+    /**
+     * Rounds a number to the nearest multiple of a given precision
+     * @param value the value to be rounded
+     * @param precision the multiple to which the value will be rounded. Default is 100 (2 decimal digits)
+     * @returns
+     */
+    MathTools.Round = function (value, precision) {
+        if (precision === void 0) { precision = MathTools.DefaultRoundingPrecision; }
+        return Math.round(value * precision) / precision;
+    };
+    /**
+     * Default rounding precision for GUI elements. It should be
+     * set to a power of ten, where the exponent means the number
+     * of decimal digits to round to, i.e, 100 means 2 decimal digits,
+     * 1000 means 3 decimal digits, etc. Default is 100 (2 decimal digits).
+     */
+    MathTools.DefaultRoundingPrecision = 100;
+    return MathTools;
+}());
+
 
 
 /***/ }),
@@ -29865,6 +29927,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   "MRDLBackplateMaterial": () => (/* reexport safe */ _3D_index__WEBPACK_IMPORTED_MODULE_1__.MRDLBackplateMaterial),
 /* harmony export */   "MRDLSliderBarMaterial": () => (/* reexport safe */ _3D_index__WEBPACK_IMPORTED_MODULE_1__.MRDLSliderBarMaterial),
 /* harmony export */   "MRDLSliderThumbMaterial": () => (/* reexport safe */ _3D_index__WEBPACK_IMPORTED_MODULE_1__.MRDLSliderThumbMaterial),
+/* harmony export */   "MathTools": () => (/* reexport safe */ _2D_index__WEBPACK_IMPORTED_MODULE_0__.MathTools),
 /* harmony export */   "Matrix2D": () => (/* reexport safe */ _2D_index__WEBPACK_IMPORTED_MODULE_0__.Matrix2D),
 /* harmony export */   "Measure": () => (/* reexport safe */ _2D_index__WEBPACK_IMPORTED_MODULE_0__.Measure),
 /* harmony export */   "MeshButton3D": () => (/* reexport safe */ _3D_index__WEBPACK_IMPORTED_MODULE_1__.MeshButton3D),
@@ -29965,6 +30028,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   "MRDLBackplateMaterial": () => (/* reexport safe */ _index__WEBPACK_IMPORTED_MODULE_0__.MRDLBackplateMaterial),
 /* harmony export */   "MRDLSliderBarMaterial": () => (/* reexport safe */ _index__WEBPACK_IMPORTED_MODULE_0__.MRDLSliderBarMaterial),
 /* harmony export */   "MRDLSliderThumbMaterial": () => (/* reexport safe */ _index__WEBPACK_IMPORTED_MODULE_0__.MRDLSliderThumbMaterial),
+/* harmony export */   "MathTools": () => (/* reexport safe */ _index__WEBPACK_IMPORTED_MODULE_0__.MathTools),
 /* harmony export */   "Matrix2D": () => (/* reexport safe */ _index__WEBPACK_IMPORTED_MODULE_0__.Matrix2D),
 /* harmony export */   "Measure": () => (/* reexport safe */ _index__WEBPACK_IMPORTED_MODULE_0__.Measure),
 /* harmony export */   "MeshButton3D": () => (/* reexport safe */ _index__WEBPACK_IMPORTED_MODULE_0__.MeshButton3D),