babylonjs-gui 7.4.0 → 7.6.0

package/babylon.gui.d.ts

@@ -432,8 +432,9 @@ declare module BABYLON.GUI {
          * Recreate the content of the ADT from a JSON object
          * @param serializedObject define the JSON serialized object to restore from
          * @param scaleToSize defines whether to scale to texture to the saved size
+         * @param urlRewriter defines an url rewriter to update urls before sending them to the controls
          */
-        parseSerializedObject(serializedObject: any, scaleToSize?: boolean): void;
+        parseSerializedObject(serializedObject: any, scaleToSize?: boolean, urlRewriter?: (url: string) => string): void;
         /**
          * Clones the ADT. If no mesh is defined, the GUI will be considered as a fullscreen GUI
          * @param newName defines the name of the new ADT
@@ -445,39 +446,44 @@ declare module BABYLON.GUI {
          * Recreate the content of the ADT from a JSON object
          * @param serializedObject define the JSON serialized object to restore from
          * @param scaleToSize defines whether to scale to texture to the saved size
+         * @param urlRewriter defines an url rewriter to update urls before sending them to the controls
          * @deprecated Please use parseSerializedObject instead
          */
-        parseContent: (serializedObject: any, scaleToSize?: boolean) => void;
+        parseContent: (serializedObject: any, scaleToSize?: boolean, urlRewriter?: ((url: string) => string) | undefined) => void;
         /**
          * Recreate the content of the ADT from a snippet saved by the GUI editor
          * @param snippetId defines the snippet to load
          * @param scaleToSize defines whether to scale to texture to the saved size
          * @param appendToAdt if provided the snippet will be appended to the adt. Otherwise a fullscreen ADT will be created.
+         * @param urlRewriter defines an url rewriter to update urls before sending them to the controls
          * @returns a promise that will resolve on success
          */
-        static ParseFromSnippetAsync(snippetId: string, scaleToSize?: boolean, appendToAdt?: AdvancedDynamicTexture): Promise<AdvancedDynamicTexture>;
+        static ParseFromSnippetAsync(snippetId: string, scaleToSize?: boolean, appendToAdt?: AdvancedDynamicTexture, urlRewriter?: (url: string) => string): Promise<AdvancedDynamicTexture>;
         /**
          * Recreate the content of the ADT from a snippet saved by the GUI editor
          * @param snippetId defines the snippet to load
          * @param scaleToSize defines whether to scale to texture to the saved size
+         * @param urlRewriter defines an url rewriter to update urls before sending them to the controls
          * @returns a promise that will resolve on success
          */
-        parseFromSnippetAsync(snippetId: string, scaleToSize?: boolean): Promise<AdvancedDynamicTexture>;
+        parseFromSnippetAsync(snippetId: string, scaleToSize?: boolean, urlRewriter?: (url: string) => string): Promise<AdvancedDynamicTexture>;
         /**
          * Recreate the content of the ADT from a url json
          * @param url defines the url to load
          * @param scaleToSize defines whether to scale to texture to the saved size
          * @param appendToAdt if provided the snippet will be appended to the adt. Otherwise a fullscreen ADT will be created.
+         * @param urlRewriter defines an url rewriter to update urls before sending them to the controls
          * @returns a promise that will resolve on success
          */
-        static ParseFromFileAsync(url: string, scaleToSize?: boolean, appendToAdt?: AdvancedDynamicTexture): Promise<AdvancedDynamicTexture>;
+        static ParseFromFileAsync(url: string, scaleToSize?: boolean, appendToAdt?: AdvancedDynamicTexture, urlRewriter?: (url: string) => string): Promise<AdvancedDynamicTexture>;
         /**
          * Recreate the content of the ADT from a url json
          * @param url defines the url to load
          * @param scaleToSize defines whether to scale to texture to the saved size
+         * @param urlRewriter defines an url rewriter to update urls before sending them to the controls
          * @returns a promise that will resolve on success
          */
-        parseFromURLAsync(url: string, scaleToSize?: boolean): Promise<AdvancedDynamicTexture>;
+        parseFromURLAsync(url: string, scaleToSize?: boolean, urlRewriter?: (url: string) => string): Promise<AdvancedDynamicTexture>;
         private static _LoadURLContentAsync;
         /**
          * Compares two rectangle based controls for pixel overlap
@@ -954,7 +960,7 @@ declare module BABYLON.GUI {
         /**
          * @internal
          */
-        _parseFromContent(serializedObject: any, host: AdvancedDynamicTexture): void;
+        _parseFromContent(serializedObject: any, host: AdvancedDynamicTexture, urlRewriter?: (url: string) => string): void;
         isReady(): boolean;
     }
 
@@ -1057,6 +1063,8 @@ declare module BABYLON.GUI {
         private _gradient;
         /** @internal */
         protected _rebuildLayout: boolean;
+        /** @internal */
+        protected _urlRewriter?: (url: string) => string;
         /**
          * BABYLON.Observable that fires when the control's enabled state changes
          */
@@ -1763,9 +1771,10 @@ declare module BABYLON.GUI {
          * 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
+         * @param urlRewriter defines an url rewriter to update urls before sending them to the controls
          * @returns this control
          */
-        parse(serializedObject: any, host?: AdvancedDynamicTexture): Control;
+        parse(serializedObject: any, host?: AdvancedDynamicTexture, urlRewriter?: (url: string) => string): Control;
         /**
          * Serializes the current control
          * @param serializationObject defined the JSON serialized object
@@ -1776,7 +1785,7 @@ declare module BABYLON.GUI {
         /**
          * @internal
          */
-        _parseFromContent(serializedObject: any, host: AdvancedDynamicTexture): void;
+        _parseFromContent(serializedObject: any, host: AdvancedDynamicTexture, urlRewriter?: (url: string) => string): void;
         /** Releases associated resources */
         dispose(): void;
         private static _HORIZONTAL_ALIGNMENT_LEFT;
@@ -1801,7 +1810,7 @@ declare module BABYLON.GUI {
         /**
          * @internal
          */
-        static _GetFontOffset(font: string): {
+        static _GetFontOffset(font: string, engineToUse?: BABYLON.AbstractEngine): {
             ascent: number;
             height: number;
             descent: number;
@@ -1810,9 +1819,10 @@ declare module BABYLON.GUI {
          * Creates a Control from parsed data
          * @param serializedObject defines parsed data
          * @param host defines the hosting AdvancedDynamicTexture
+         * @param urlRewriter defines an url rewriter to update urls before sending them to the controls
          * @returns a new Control
          */
-        static Parse(serializedObject: any, host: AdvancedDynamicTexture): Control;
+        static Parse(serializedObject: any, host: AdvancedDynamicTexture, urlRewriter?: (url: string) => string): Control;
         static AddHeader: (control: Control, text: string, size: string | number, options: {
             isHorizontal: boolean;
             controlFirst: boolean;