@babylonjs/core 7.32.0 → 7.32.1

package/FrameGraph/frameGraphTextureManager.js

@@ -0,0 +1,277 @@
+import { getDimensionsFromTextureSize } from "../Materials/Textures/textureCreationOptions.js";
+import { Texture } from "../Materials/Textures/texture.js";
+import { backbufferColorTextureHandle, backbufferDepthStencilTextureHandle } from "./frameGraphTypes.js";
+
+var FrameGraphTextureNamespace;
+(function (FrameGraphTextureNamespace) {
+    FrameGraphTextureNamespace[FrameGraphTextureNamespace["Task"] = 0] = "Task";
+    FrameGraphTextureNamespace[FrameGraphTextureNamespace["Graph"] = 1] = "Graph";
+    FrameGraphTextureNamespace[FrameGraphTextureNamespace["External"] = 2] = "External";
+})(FrameGraphTextureNamespace || (FrameGraphTextureNamespace = {}));
+/**
+ * @experimental
+ * @internal
+ */
+export class FrameGraphTextureManager {
+    constructor(_engine, _debugTextures = false, _scene) {
+        this._engine = _engine;
+        this._debugTextures = _debugTextures;
+        this._scene = _scene;
+        this._textures = new Map();
+        this._addSystemTextures();
+    }
+    isBackbuffer(handle) {
+        if (handle === backbufferColorTextureHandle || handle === backbufferDepthStencilTextureHandle) {
+            return true;
+        }
+        const textureEntry = this._textures.get(handle);
+        if (!textureEntry) {
+            return false;
+        }
+        return textureEntry.refHandle === backbufferColorTextureHandle || textureEntry.refHandle === backbufferDepthStencilTextureHandle;
+    }
+    isBackbufferColor(handle) {
+        if (handle === backbufferColorTextureHandle) {
+            return true;
+        }
+        const textureEntry = this._textures.get(handle);
+        if (!textureEntry) {
+            return false;
+        }
+        return textureEntry.refHandle === backbufferColorTextureHandle;
+    }
+    isBackbufferDepthStencil(handle) {
+        if (handle === backbufferDepthStencilTextureHandle) {
+            return true;
+        }
+        const textureEntry = this._textures.get(handle);
+        if (!textureEntry) {
+            return false;
+        }
+        return textureEntry.refHandle === backbufferDepthStencilTextureHandle;
+    }
+    getTextureCreationOptions(handle) {
+        return this._textures.get(handle).creationOptions;
+    }
+    getTextureFromHandle(handle) {
+        return this._textures.get(handle).texture;
+    }
+    importTexture(name, texture, handle) {
+        const internalTexture = texture.texture;
+        if (!internalTexture) {
+            throw new Error("Texture must have an internal texture to be imported");
+        }
+        if (handle !== undefined) {
+            this._freeEntry(handle);
+        }
+        const creationOptions = {
+            size: { width: texture.width, height: texture.height },
+            options: {
+                generateMipMaps: internalTexture.generateMipMaps,
+                generateDepthBuffer: texture._generateDepthBuffer,
+                generateStencilBuffer: texture._generateStencilBuffer,
+                samples: internalTexture.samples,
+                label: internalTexture.label,
+                types: [internalTexture.type],
+                samplingModes: [internalTexture.samplingMode],
+                formats: [internalTexture.format],
+                targetTypes: [
+                    internalTexture.isCube
+                        ? 34067
+                        : internalTexture.is3D
+                            ? 32879
+                            : internalTexture.is2DArray
+                                ? 35866
+                                : 3553,
+                ],
+                useSRGBBuffers: [internalTexture._useSRGBBuffer],
+                labels: internalTexture.label ? [internalTexture.label] : undefined,
+            },
+            sizeIsPercentage: false,
+        };
+        return this._createHandleForTexture(name, texture, creationOptions, FrameGraphTextureNamespace.External, false, handle);
+    }
+    createRenderTargetTexture(name, taskNamespace, creationOptions, multiTargetMode = false, handle) {
+        return this._createHandleForTexture(name, null, creationOptions, taskNamespace ? FrameGraphTextureNamespace.Task : FrameGraphTextureNamespace.Graph, multiTargetMode, handle);
+    }
+    getAbsoluteDimensions(size, screenWidth = this._engine.getRenderWidth(true), screenHeight = this._engine.getRenderHeight(true)) {
+        const { width, height } = getDimensionsFromTextureSize(size);
+        return {
+            width: Math.floor((width * screenWidth) / 100),
+            height: Math.floor((height * screenHeight) / 100),
+        };
+    }
+    dispose() {
+        this.releaseTextures();
+    }
+    allocateTextures() {
+        this._textures.forEach((entry) => {
+            if (!entry.texture) {
+                if (entry.refHandle !== undefined) {
+                    const refEntry = this._textures.get(entry.refHandle);
+                    entry.texture = refEntry.texture;
+                    entry.texture?.texture?.incrementReferences();
+                    if (refEntry.refHandle === backbufferColorTextureHandle) {
+                        entry.refHandle = backbufferColorTextureHandle;
+                    }
+                    if (refEntry.refHandle === backbufferDepthStencilTextureHandle) {
+                        entry.refHandle = backbufferDepthStencilTextureHandle;
+                    }
+                }
+                else if (entry.namespace !== FrameGraphTextureNamespace.External) {
+                    if (entry.parentHandle !== undefined) {
+                        const creationOptions = entry.creationOptions;
+                        const size = creationOptions.sizeIsPercentage ? this.getAbsoluteDimensions(creationOptions.size) : creationOptions.size;
+                        const parentEntry = this._textures.get(entry.parentHandle);
+                        const parentInternalTexture = parentEntry.texture.textures[entry.parentTextureIndex];
+                        const creationOptionsForTexture = {
+                            createMipMaps: creationOptions.options.createMipMaps,
+                            generateMipMaps: creationOptions.options.generateMipMaps,
+                            generateDepthBuffer: creationOptions.options.generateDepthBuffer,
+                            generateStencilBuffer: creationOptions.options.generateStencilBuffer,
+                            samples: creationOptions.options.samples,
+                            type: creationOptions.options.types[0],
+                            format: creationOptions.options.formats[0],
+                            useSRGBBuffer: creationOptions.options.useSRGBBuffers[0],
+                            colorAttachment: parentInternalTexture,
+                            label: creationOptions.options.label,
+                        };
+                        entry.texture = this._engine.createRenderTargetTexture(size, creationOptionsForTexture);
+                        parentInternalTexture.incrementReferences();
+                    }
+                    else {
+                        const creationOptions = entry.creationOptions;
+                        const size = creationOptions.sizeIsPercentage ? this.getAbsoluteDimensions(creationOptions.size) : creationOptions.size;
+                        entry.texture = this._engine.createMultipleRenderTarget(size, creationOptions.options, false);
+                    }
+                }
+            }
+            if (entry.texture && entry.refHandle === undefined) {
+                entry.debug?.dispose();
+                entry.debug = this._createDebugTexture(entry.name, entry.texture);
+            }
+        });
+    }
+    createDanglingHandle() {
+        return FrameGraphTextureManager._Counter++;
+    }
+    resolveDanglingHandle(danglingHandle, handle) {
+        if (!this._textures.has(handle)) {
+            throw new Error(`resolveDanglingHandle: Handle ${handle} does not exist!`);
+        }
+        const textureEntry = this._textures.get(handle);
+        this._textures.set(danglingHandle, {
+            texture: textureEntry.texture,
+            refHandle: handle,
+            name: textureEntry.name,
+            creationOptions: {
+                size: { ...textureEntry.creationOptions.size },
+                options: { ...textureEntry.creationOptions.options, label: textureEntry.name },
+                sizeIsPercentage: textureEntry.creationOptions.sizeIsPercentage,
+            },
+            namespace: textureEntry.namespace,
+            parentHandle: textureEntry.parentHandle,
+            parentTextureIndex: textureEntry.parentTextureIndex,
+        });
+    }
+    releaseTextures(releaseAll = true) {
+        this._textures.forEach((entry, handle) => {
+            if (releaseAll || entry.namespace !== FrameGraphTextureNamespace.External) {
+                entry.debug?.dispose();
+                entry.debug = undefined;
+            }
+            if (entry.namespace === FrameGraphTextureNamespace.External) {
+                return;
+            }
+            entry.texture?.dispose();
+            entry.texture = null;
+            if (releaseAll || entry.namespace === FrameGraphTextureNamespace.Task) {
+                this._textures.delete(handle);
+            }
+        });
+        if (releaseAll) {
+            this._textures.clear();
+            this._addSystemTextures();
+        }
+    }
+    _addSystemTextures() {
+        const size = { width: this._engine.getRenderWidth(true), height: this._engine.getRenderHeight(true) };
+        this._textures.set(backbufferColorTextureHandle, {
+            name: "backbuffer color",
+            texture: null,
+            creationOptions: {
+                size,
+                options: {},
+                sizeIsPercentage: false,
+            },
+            namespace: FrameGraphTextureNamespace.External,
+        });
+        this._textures.set(backbufferDepthStencilTextureHandle, {
+            name: "backbuffer depth/stencil",
+            texture: null,
+            creationOptions: {
+                size,
+                options: {},
+                sizeIsPercentage: false,
+            },
+            namespace: FrameGraphTextureNamespace.External,
+        });
+    }
+    _createDebugTexture(name, texture) {
+        if (!this._debugTextures || !this._scene) {
+            return;
+        }
+        const textureDebug = new Texture(null, this._scene);
+        textureDebug.name = name;
+        textureDebug._texture = texture.texture || texture._depthStencilTexture;
+        textureDebug._texture.incrementReferences();
+        return textureDebug;
+    }
+    _freeEntry(handle) {
+        const entry = this._textures.get(handle);
+        if (entry) {
+            entry.debug?.dispose();
+            this._textures.delete(handle);
+        }
+    }
+    _createHandleForTexture(name, texture, creationOptions, namespace, multiTargetMode = false, handle, parentHandle, parentTextureIndex) {
+        handle = handle ?? FrameGraphTextureManager._Counter++;
+        this._textures.set(handle, {
+            texture,
+            name,
+            creationOptions: {
+                size: getDimensionsFromTextureSize(creationOptions.size),
+                options: { ...creationOptions.options, label: name },
+                sizeIsPercentage: creationOptions.sizeIsPercentage,
+            },
+            namespace,
+            parentHandle,
+            parentTextureIndex,
+        });
+        if (namespace === FrameGraphTextureNamespace.External) {
+            return handle;
+        }
+        if (multiTargetMode) {
+            const textureCount = creationOptions.options.textureCount ?? 1;
+            for (let i = 0; i < textureCount; i++) {
+                const label = creationOptions.options.labels?.[i] ?? `${i}`;
+                const textureName = `${name} - ${label}`;
+                const creationOptionsForTexture = {
+                    size: getDimensionsFromTextureSize(creationOptions.size),
+                    options: {
+                        ...creationOptions.options,
+                        formats: [creationOptions.options.formats[i]],
+                        types: [creationOptions.options.types[i]],
+                        textureCount: 1,
+                    },
+                    sizeIsPercentage: creationOptions.sizeIsPercentage,
+                };
+                this._createHandleForTexture(textureName, null, creationOptionsForTexture, namespace, false, handle + i + 1, handle, i);
+            }
+            FrameGraphTextureManager._Counter += textureCount;
+        }
+        return handle;
+    }
+}
+FrameGraphTextureManager._Counter = 2; // 0 and 1 are reserved for backbuffer textures
+//# sourceMappingURL=frameGraphTextureManager.js.map

package/FrameGraph/frameGraphTextureManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameGraphTextureManager.js","sourceRoot":"","sources":["../../../../dev/core/src/FrameGraph/frameGraphTextureManager.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable import/no-internal-modules */\r\nimport type {\r\n    Scene,\r\n    AbstractEngine,\r\n    RenderTargetWrapper,\r\n    RenderTargetCreationOptions,\r\n    TextureSize,\r\n    Nullable,\r\n    FrameGraphTextureCreationOptions,\r\n    FrameGraphTextureHandle,\r\n} from \"core/index\";\r\nimport { getDimensionsFromTextureSize } from \"../Materials/Textures/textureCreationOptions\";\r\nimport { Texture } from \"../Materials/Textures/texture\";\r\nimport { backbufferColorTextureHandle, backbufferDepthStencilTextureHandle } from \"./frameGraphTypes\";\r\nimport { Constants } from \"../Engines/constants\";\r\n\r\ntype TextureEntry = {\r\n    texture: Nullable<RenderTargetWrapper>;\r\n    name: string;\r\n    creationOptions: FrameGraphTextureCreationOptions;\r\n    namespace: FrameGraphTextureNamespace;\r\n    debug?: Texture;\r\n    parentHandle?: FrameGraphTextureHandle;\r\n    parentTextureIndex?: number;\r\n    refHandle?: FrameGraphTextureHandle;\r\n};\r\n\r\nenum FrameGraphTextureNamespace {\r\n    Task,\r\n    Graph,\r\n    External,\r\n}\r\n\r\n/**\r\n * @experimental\r\n * @internal\r\n */\r\nexport class FrameGraphTextureManager {\r\n    private static _Counter = 2; // 0 and 1 are reserved for backbuffer textures\r\n\r\n    public _textures: Map<FrameGraphTextureHandle, TextureEntry> = new Map();\r\n\r\n    constructor(\r\n        private _engine: AbstractEngine,\r\n        private _debugTextures = false,\r\n        private _scene?: Scene\r\n    ) {\r\n        this._addSystemTextures();\r\n    }\r\n\r\n    public isBackbuffer(handle: FrameGraphTextureHandle): boolean {\r\n        if (handle === backbufferColorTextureHandle || handle === backbufferDepthStencilTextureHandle) {\r\n            return true;\r\n        }\r\n\r\n        const textureEntry = this._textures.get(handle);\r\n        if (!textureEntry) {\r\n            return false;\r\n        }\r\n\r\n        return textureEntry.refHandle === backbufferColorTextureHandle || textureEntry.refHandle === backbufferDepthStencilTextureHandle;\r\n    }\r\n\r\n    public isBackbufferColor(handle: FrameGraphTextureHandle): boolean {\r\n        if (handle === backbufferColorTextureHandle) {\r\n            return true;\r\n        }\r\n\r\n        const textureEntry = this._textures.get(handle);\r\n        if (!textureEntry) {\r\n            return false;\r\n        }\r\n\r\n        return textureEntry.refHandle === backbufferColorTextureHandle;\r\n    }\r\n\r\n    public isBackbufferDepthStencil(handle: FrameGraphTextureHandle): boolean {\r\n        if (handle === backbufferDepthStencilTextureHandle) {\r\n            return true;\r\n        }\r\n\r\n        const textureEntry = this._textures.get(handle);\r\n        if (!textureEntry) {\r\n            return false;\r\n        }\r\n\r\n        return textureEntry.refHandle === backbufferDepthStencilTextureHandle;\r\n    }\r\n\r\n    public getTextureCreationOptions(handle: FrameGraphTextureHandle): FrameGraphTextureCreationOptions {\r\n        return this._textures.get(handle)!.creationOptions;\r\n    }\r\n\r\n    public getTextureFromHandle(handle: FrameGraphTextureHandle): Nullable<RenderTargetWrapper> {\r\n        return this._textures.get(handle)!.texture;\r\n    }\r\n\r\n    public importTexture(name: string, texture: RenderTargetWrapper, handle?: FrameGraphTextureHandle): FrameGraphTextureHandle {\r\n        const internalTexture = texture.texture;\r\n\r\n        if (!internalTexture) {\r\n            throw new Error(\"Texture must have an internal texture to be imported\");\r\n        }\r\n\r\n        if (handle !== undefined) {\r\n            this._freeEntry(handle);\r\n        }\r\n\r\n        const creationOptions: FrameGraphTextureCreationOptions = {\r\n            size: { width: texture.width, height: texture.height },\r\n            options: {\r\n                generateMipMaps: internalTexture.generateMipMaps,\r\n                generateDepthBuffer: texture._generateDepthBuffer,\r\n                generateStencilBuffer: texture._generateStencilBuffer,\r\n                samples: internalTexture.samples,\r\n                label: internalTexture.label,\r\n                types: [internalTexture.type],\r\n                samplingModes: [internalTexture.samplingMode],\r\n                formats: [internalTexture.format],\r\n                targetTypes: [\r\n                    internalTexture.isCube\r\n                        ? Constants.TEXTURE_CUBE_MAP\r\n                        : internalTexture.is3D\r\n                          ? Constants.TEXTURE_3D\r\n                          : internalTexture.is2DArray\r\n                            ? Constants.TEXTURE_2D_ARRAY\r\n                            : Constants.TEXTURE_2D,\r\n                ],\r\n                useSRGBBuffers: [internalTexture._useSRGBBuffer],\r\n                labels: internalTexture.label ? [internalTexture.label] : undefined,\r\n            },\r\n            sizeIsPercentage: false,\r\n        };\r\n\r\n        return this._createHandleForTexture(name, texture, creationOptions, FrameGraphTextureNamespace.External, false, handle);\r\n    }\r\n\r\n    public createRenderTargetTexture(\r\n        name: string,\r\n        taskNamespace: boolean,\r\n        creationOptions: FrameGraphTextureCreationOptions,\r\n        multiTargetMode = false,\r\n        handle?: FrameGraphTextureHandle\r\n    ): FrameGraphTextureHandle {\r\n        return this._createHandleForTexture(\r\n            name,\r\n            null,\r\n            creationOptions,\r\n            taskNamespace ? FrameGraphTextureNamespace.Task : FrameGraphTextureNamespace.Graph,\r\n            multiTargetMode,\r\n            handle\r\n        );\r\n    }\r\n\r\n    public getAbsoluteDimensions(\r\n        size: TextureSize,\r\n        screenWidth = this._engine.getRenderWidth(true),\r\n        screenHeight = this._engine.getRenderHeight(true)\r\n    ): { width: number; height: number } {\r\n        const { width, height } = getDimensionsFromTextureSize(size);\r\n\r\n        return {\r\n            width: Math.floor((width * screenWidth) / 100),\r\n            height: Math.floor((height * screenHeight) / 100),\r\n        };\r\n    }\r\n\r\n    public dispose(): void {\r\n        this.releaseTextures();\r\n    }\r\n\r\n    public allocateTextures() {\r\n        this._textures.forEach((entry) => {\r\n            if (!entry.texture) {\r\n                if (entry.refHandle !== undefined) {\r\n                    const refEntry = this._textures.get(entry.refHandle)!;\r\n\r\n                    entry.texture = refEntry.texture;\r\n                    entry.texture?.texture?.incrementReferences();\r\n\r\n                    if (refEntry.refHandle === backbufferColorTextureHandle) {\r\n                        entry.refHandle = backbufferColorTextureHandle;\r\n                    }\r\n                    if (refEntry.refHandle === backbufferDepthStencilTextureHandle) {\r\n                        entry.refHandle = backbufferDepthStencilTextureHandle;\r\n                    }\r\n                } else if (entry.namespace !== FrameGraphTextureNamespace.External) {\r\n                    if (entry.parentHandle !== undefined) {\r\n                        const creationOptions = entry.creationOptions;\r\n                        const size = creationOptions.sizeIsPercentage ? this.getAbsoluteDimensions(creationOptions.size) : creationOptions.size;\r\n\r\n                        const parentEntry = this._textures.get(entry.parentHandle)!;\r\n                        const parentInternalTexture = parentEntry.texture!.textures![entry.parentTextureIndex!];\r\n\r\n                        const creationOptionsForTexture: RenderTargetCreationOptions = {\r\n                            createMipMaps: creationOptions.options.createMipMaps,\r\n                            generateMipMaps: creationOptions.options.generateMipMaps,\r\n                            generateDepthBuffer: creationOptions.options.generateDepthBuffer,\r\n                            generateStencilBuffer: creationOptions.options.generateStencilBuffer,\r\n                            samples: creationOptions.options.samples,\r\n                            type: creationOptions.options.types![0],\r\n                            format: creationOptions.options.formats![0],\r\n                            useSRGBBuffer: creationOptions.options.useSRGBBuffers![0],\r\n                            colorAttachment: parentInternalTexture,\r\n                            label: creationOptions.options.label,\r\n                        };\r\n\r\n                        entry.texture = this._engine.createRenderTargetTexture(size, creationOptionsForTexture);\r\n                        parentInternalTexture.incrementReferences();\r\n                    } else {\r\n                        const creationOptions = entry.creationOptions;\r\n                        const size = creationOptions.sizeIsPercentage ? this.getAbsoluteDimensions(creationOptions.size) : creationOptions.size;\r\n\r\n                        entry.texture = this._engine.createMultipleRenderTarget(size, creationOptions.options, false);\r\n                    }\r\n                }\r\n            }\r\n\r\n            if (entry.texture && entry.refHandle === undefined) {\r\n                entry.debug?.dispose();\r\n                entry.debug = this._createDebugTexture(entry.name, entry.texture);\r\n            }\r\n        });\r\n    }\r\n\r\n    public createDanglingHandle() {\r\n        return FrameGraphTextureManager._Counter++;\r\n    }\r\n\r\n    public resolveDanglingHandle(danglingHandle: FrameGraphTextureHandle, handle: FrameGraphTextureHandle) {\r\n        if (!this._textures.has(handle)) {\r\n            throw new Error(`resolveDanglingHandle: Handle ${handle} does not exist!`);\r\n        }\r\n\r\n        const textureEntry = this._textures.get(handle)!;\r\n\r\n        this._textures.set(danglingHandle, {\r\n            texture: textureEntry.texture,\r\n            refHandle: handle,\r\n            name: textureEntry.name,\r\n            creationOptions: {\r\n                size: { ...(textureEntry.creationOptions.size as { width: number; height: number; depth?: number; layers?: number }) },\r\n                options: { ...textureEntry.creationOptions.options, label: textureEntry.name },\r\n                sizeIsPercentage: textureEntry.creationOptions.sizeIsPercentage,\r\n            },\r\n            namespace: textureEntry.namespace,\r\n            parentHandle: textureEntry.parentHandle,\r\n            parentTextureIndex: textureEntry.parentTextureIndex,\r\n        });\r\n    }\r\n\r\n    public releaseTextures(releaseAll = true): void {\r\n        this._textures.forEach((entry, handle) => {\r\n            if (releaseAll || entry.namespace !== FrameGraphTextureNamespace.External) {\r\n                entry.debug?.dispose();\r\n                entry.debug = undefined;\r\n            }\r\n\r\n            if (entry.namespace === FrameGraphTextureNamespace.External) {\r\n                return;\r\n            }\r\n\r\n            entry.texture?.dispose();\r\n            entry.texture = null;\r\n\r\n            if (releaseAll || entry.namespace === FrameGraphTextureNamespace.Task) {\r\n                this._textures.delete(handle);\r\n            }\r\n        });\r\n\r\n        if (releaseAll) {\r\n            this._textures.clear();\r\n            this._addSystemTextures();\r\n        }\r\n    }\r\n\r\n    private _addSystemTextures() {\r\n        const size = { width: this._engine.getRenderWidth(true), height: this._engine.getRenderHeight(true) };\r\n\r\n        this._textures.set(backbufferColorTextureHandle, {\r\n            name: \"backbuffer color\",\r\n            texture: null,\r\n            creationOptions: {\r\n                size,\r\n                options: {},\r\n                sizeIsPercentage: false,\r\n            },\r\n            namespace: FrameGraphTextureNamespace.External,\r\n        });\r\n\r\n        this._textures.set(backbufferDepthStencilTextureHandle, {\r\n            name: \"backbuffer depth/stencil\",\r\n            texture: null,\r\n            creationOptions: {\r\n                size,\r\n                options: {},\r\n                sizeIsPercentage: false,\r\n            },\r\n            namespace: FrameGraphTextureNamespace.External,\r\n        });\r\n    }\r\n\r\n    private _createDebugTexture(name: string, texture: RenderTargetWrapper): Texture | undefined {\r\n        if (!this._debugTextures || !this._scene) {\r\n            return;\r\n        }\r\n\r\n        const textureDebug = new Texture(null, this._scene);\r\n\r\n        textureDebug.name = name;\r\n        textureDebug._texture = texture.texture || texture._depthStencilTexture!;\r\n        textureDebug._texture.incrementReferences();\r\n\r\n        return textureDebug;\r\n    }\r\n\r\n    private _freeEntry(handle: number): void {\r\n        const entry = this._textures.get(handle);\r\n\r\n        if (entry) {\r\n            entry.debug?.dispose();\r\n            this._textures.delete(handle);\r\n        }\r\n    }\r\n\r\n    private _createHandleForTexture(\r\n        name: string,\r\n        texture: Nullable<RenderTargetWrapper>,\r\n        creationOptions: FrameGraphTextureCreationOptions,\r\n        namespace: FrameGraphTextureNamespace,\r\n        multiTargetMode = false,\r\n        handle?: FrameGraphTextureHandle,\r\n        parentHandle?: FrameGraphTextureHandle,\r\n        parentTextureIndex?: number\r\n    ): FrameGraphTextureHandle {\r\n        handle = handle ?? FrameGraphTextureManager._Counter++;\r\n\r\n        this._textures.set(handle, {\r\n            texture,\r\n            name,\r\n            creationOptions: {\r\n                size: getDimensionsFromTextureSize(creationOptions.size),\r\n                options: { ...creationOptions.options, label: name },\r\n                sizeIsPercentage: creationOptions.sizeIsPercentage,\r\n            },\r\n            namespace,\r\n            parentHandle,\r\n            parentTextureIndex,\r\n        });\r\n\r\n        if (namespace === FrameGraphTextureNamespace.External) {\r\n            return handle;\r\n        }\r\n\r\n        if (multiTargetMode) {\r\n            const textureCount = creationOptions.options.textureCount ?? 1;\r\n            for (let i = 0; i < textureCount; i++) {\r\n                const label = creationOptions.options.labels?.[i] ?? `${i}`;\r\n                const textureName = `${name} - ${label}`;\r\n                const creationOptionsForTexture: FrameGraphTextureCreationOptions = {\r\n                    size: getDimensionsFromTextureSize(creationOptions.size),\r\n                    options: {\r\n                        ...creationOptions.options,\r\n                        formats: [creationOptions.options.formats![i]],\r\n                        types: [creationOptions.options.types![i]],\r\n                        textureCount: 1,\r\n                    },\r\n                    sizeIsPercentage: creationOptions.sizeIsPercentage,\r\n                };\r\n                this._createHandleForTexture(textureName, null, creationOptionsForTexture, namespace, false, handle + i + 1, handle, i);\r\n            }\r\n\r\n            FrameGraphTextureManager._Counter += textureCount;\r\n        }\r\n\r\n        return handle;\r\n    }\r\n}\r\n"]}

package/FrameGraph/frameGraphTypes.d.ts

@@ -0,0 +1,59 @@
+import type { Nullable, TextureSize, FrameGraphContext, IMultiRenderTargetOptions } from "../index.js";
+/**
+ * Represents a texture handle in the frame graph.
+ */
+export type FrameGraphTextureHandle = number;
+/**
+ * Represents a texture handle for the backbuffer color texture.
+ */
+export declare const backbufferColorTextureHandle: FrameGraphTextureHandle;
+/**
+ * Represents a texture handle for the backbuffer depth/stencil texture.
+ */
+export declare const backbufferDepthStencilTextureHandle: FrameGraphTextureHandle;
+/**
+ * Options used to create a texture in the frame graph.
+ */
+export type FrameGraphTextureCreationOptions = {
+    /** Size of the texture. If sizeIsPercentage is true, these are percentages relative to the screen size */
+    size: TextureSize;
+    /** Options used to create the (multi) render target texture */
+    options: IMultiRenderTargetOptions;
+    /** If true, indicates that "size" is percentages relative to the screen size */
+    sizeIsPercentage: boolean;
+};
+/**
+ * Represents a texture description in the frame graph.
+ * This is basically the same thing than FrameGraphTextureCreationOptions, but the size is never in percentage and always in pixels.
+ */
+export type FrameGraphTextureDescription = {
+    /**
+     * Size of the texture.
+     */
+    size: {
+        width: number;
+        height: number;
+    };
+    /**
+     * Options used when the (multi) render target texture had been created.
+     */
+    options: IMultiRenderTargetOptions;
+};
+/**
+ * Defines a pass in the frame graph.
+ */
+export interface IFrameGraphPass {
+    /**
+     * The name of the pass.
+     */
+    name: string;
+    /**
+     * Sets the function to execute when the pass is executed
+     * @param func The function to execute when the pass is executed
+     */
+    setExecuteFunc(func: (context: FrameGraphContext) => void): void;
+    /** @internal */
+    _execute(): void;
+    /** @internal */
+    _isValid(): Nullable<string>;
+}

package/FrameGraph/frameGraphTypes.js

@@ -0,0 +1,9 @@
+/**
+ * Represents a texture handle for the backbuffer color texture.
+ */
+export const backbufferColorTextureHandle = 0;
+/**
+ * Represents a texture handle for the backbuffer depth/stencil texture.
+ */
+export const backbufferDepthStencilTextureHandle = 1;
+//# sourceMappingURL=frameGraphTypes.js.map

package/FrameGraph/frameGraphTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameGraphTypes.js","sourceRoot":"","sources":["../../../../dev/core/src/FrameGraph/frameGraphTypes.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAA4B,CAAC,CAAC;AAEvE;;GAEG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAA4B,CAAC,CAAC","sourcesContent":["// eslint-disable-next-line import/no-internal-modules\r\nimport type { Nullable, TextureSize, FrameGraphContext, IMultiRenderTargetOptions } from \"core/index\";\r\n\r\n/**\r\n * Represents a texture handle in the frame graph.\r\n */\r\nexport type FrameGraphTextureHandle = number;\r\n\r\n/**\r\n * Represents a texture handle for the backbuffer color texture.\r\n */\r\nexport const backbufferColorTextureHandle: FrameGraphTextureHandle = 0;\r\n\r\n/**\r\n * Represents a texture handle for the backbuffer depth/stencil texture.\r\n */\r\nexport const backbufferDepthStencilTextureHandle: FrameGraphTextureHandle = 1;\r\n\r\n/**\r\n * Options used to create a texture in the frame graph.\r\n */\r\nexport type FrameGraphTextureCreationOptions = {\r\n    /** Size of the texture. If sizeIsPercentage is true, these are percentages relative to the screen size */\r\n    size: TextureSize;\r\n\r\n    /** Options used to create the (multi) render target texture */\r\n    options: IMultiRenderTargetOptions;\r\n\r\n    /** If true, indicates that \"size\" is percentages relative to the screen size */\r\n    sizeIsPercentage: boolean;\r\n};\r\n\r\n/**\r\n * Represents a texture description in the frame graph.\r\n * This is basically the same thing than FrameGraphTextureCreationOptions, but the size is never in percentage and always in pixels.\r\n */\r\nexport type FrameGraphTextureDescription = {\r\n    /**\r\n     * Size of the texture.\r\n     */\r\n    size: { width: number; height: number };\r\n\r\n    /**\r\n     * Options used when the (multi) render target texture had been created.\r\n     */\r\n    options: IMultiRenderTargetOptions;\r\n};\r\n\r\n/**\r\n * Defines a pass in the frame graph.\r\n */\r\nexport interface IFrameGraphPass {\r\n    /**\r\n     * The name of the pass.\r\n     */\r\n    name: string;\r\n\r\n    /**\r\n     * Sets the function to execute when the pass is executed\r\n     * @param func The function to execute when the pass is executed\r\n     */\r\n    setExecuteFunc(func: (context: FrameGraphContext) => void): void;\r\n\r\n    /** @internal */\r\n    _execute(): void;\r\n\r\n    /** @internal */\r\n    _isValid(): Nullable<string>;\r\n}\r\n"]}

package/FrameGraph/index.d.ts

@@ -0,0 +1,28 @@
+export * from "./Node/nodeRenderGraph";
+export * from "./Node/nodeRenderGraphBlock";
+export * from "./Node/nodeRenderGraphBlockConnectionPoint";
+export * from "./Node/nodeRenderGraphBuildState";
+export * from "./Node/Types/nodeRenderGraphTypes";
+export * from "./Node/Blocks/index";
+export * from "./Passes/pass";
+export * from "./Passes/renderPass";
+export * from "./Tasks/PostProcesses/blackAndWhiteTask";
+export * from "./Tasks/PostProcesses/bloomTask";
+export * from "./Tasks/PostProcesses/blurTask";
+export * from "./Tasks/PostProcesses/circleOfConfusionTask";
+export * from "./Tasks/PostProcesses/depthOfFieldTask";
+export * from "./Tasks/PostProcesses/extractHighlightsTask";
+export * from "./Tasks/PostProcesses/postProcessTask";
+export * from "./Tasks/Texture/clearTextureTask";
+export * from "./Tasks/Texture/copyToBackbufferColorTask";
+export * from "./Tasks/Texture/copyToTextureTask";
+export * from "./Tasks/Rendering/objectRendererTask";
+export * from "./Tasks/Rendering/geometryRendererTask";
+export * from "./Tasks/Rendering/cullObjectsTask";
+export * from "./frameGraph";
+export * from "./frameGraphContext";
+export * from "./frameGraphObjectList";
+export * from "./frameGraphRenderContext";
+export * from "./frameGraphTask";
+export * from "./frameGraphTextureManager";
+export * from "./frameGraphTypes";

package/FrameGraph/index.js

@@ -0,0 +1,30 @@
+/* eslint-disable import/no-internal-modules */
+export * from "./Node/nodeRenderGraph.js";
+export * from "./Node/nodeRenderGraphBlock.js";
+export * from "./Node/nodeRenderGraphBlockConnectionPoint.js";
+export * from "./Node/nodeRenderGraphBuildState.js";
+export * from "./Node/Types/nodeRenderGraphTypes.js";
+export * from "./Node/Blocks/index.js";
+export * from "./Passes/pass.js";
+export * from "./Passes/renderPass.js";
+export * from "./Tasks/PostProcesses/blackAndWhiteTask.js";
+export * from "./Tasks/PostProcesses/bloomTask.js";
+export * from "./Tasks/PostProcesses/blurTask.js";
+export * from "./Tasks/PostProcesses/circleOfConfusionTask.js";
+export * from "./Tasks/PostProcesses/depthOfFieldTask.js";
+export * from "./Tasks/PostProcesses/extractHighlightsTask.js";
+export * from "./Tasks/PostProcesses/postProcessTask.js";
+export * from "./Tasks/Texture/clearTextureTask.js";
+export * from "./Tasks/Texture/copyToBackbufferColorTask.js";
+export * from "./Tasks/Texture/copyToTextureTask.js";
+export * from "./Tasks/Rendering/objectRendererTask.js";
+export * from "./Tasks/Rendering/geometryRendererTask.js";
+export * from "./Tasks/Rendering/cullObjectsTask.js";
+export * from "./frameGraph.js";
+export * from "./frameGraphContext.js";
+export * from "./frameGraphObjectList.js";
+export * from "./frameGraphRenderContext.js";
+export * from "./frameGraphTask.js";
+export * from "./frameGraphTextureManager.js";
+export * from "./frameGraphTypes.js";
+//# sourceMappingURL=index.js.map

package/FrameGraph/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../dev/core/src/FrameGraph/index.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,qBAAqB,CAAC;AAEpC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AAEpC,cAAc,yCAAyC,CAAC;AACxD,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6CAA6C,CAAC;AAC5D,cAAc,wCAAwC,CAAC;AACvD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,uCAAuC,CAAC;AAEtD,cAAc,kCAAkC,CAAC;AACjD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,mCAAmC,CAAC;AAElD,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,mCAAmC,CAAC;AAElD,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC","sourcesContent":["/* eslint-disable import/no-internal-modules */\r\nexport * from \"./Node/nodeRenderGraph\";\r\nexport * from \"./Node/nodeRenderGraphBlock\";\r\nexport * from \"./Node/nodeRenderGraphBlockConnectionPoint\";\r\nexport * from \"./Node/nodeRenderGraphBuildState\";\r\nexport * from \"./Node/Types/nodeRenderGraphTypes\";\r\nexport * from \"./Node/Blocks/index\";\r\n\r\nexport * from \"./Passes/pass\";\r\nexport * from \"./Passes/renderPass\";\r\n\r\nexport * from \"./Tasks/PostProcesses/blackAndWhiteTask\";\r\nexport * from \"./Tasks/PostProcesses/bloomTask\";\r\nexport * from \"./Tasks/PostProcesses/blurTask\";\r\nexport * from \"./Tasks/PostProcesses/circleOfConfusionTask\";\r\nexport * from \"./Tasks/PostProcesses/depthOfFieldTask\";\r\nexport * from \"./Tasks/PostProcesses/extractHighlightsTask\";\r\nexport * from \"./Tasks/PostProcesses/postProcessTask\";\r\n\r\nexport * from \"./Tasks/Texture/clearTextureTask\";\r\nexport * from \"./Tasks/Texture/copyToBackbufferColorTask\";\r\nexport * from \"./Tasks/Texture/copyToTextureTask\";\r\n\r\nexport * from \"./Tasks/Rendering/objectRendererTask\";\r\nexport * from \"./Tasks/Rendering/geometryRendererTask\";\r\nexport * from \"./Tasks/Rendering/cullObjectsTask\";\r\n\r\nexport * from \"./frameGraph\";\r\nexport * from \"./frameGraphContext\";\r\nexport * from \"./frameGraphObjectList\";\r\nexport * from \"./frameGraphRenderContext\";\r\nexport * from \"./frameGraphTask\";\r\nexport * from \"./frameGraphTextureManager\";\r\nexport * from \"./frameGraphTypes\";\r\n"]}

package/Gamepads/gamepadSceneComponent.d.ts

@@ -67,5 +67,4 @@ export declare class GamepadSystemSceneComponent implements ISceneComponent {
      * Disposes the component and the associated resources
      */
     dispose(): void;
-    private _beforeCameraUpdate;
 }

package/Gamepads/gamepadSceneComponent.js

@@ -55,7 +55,7 @@ export class GamepadSystemSceneComponent {
      * Registers the component in a given scene
      */
     register() {
-        this.scene._beforeCameraUpdateStage.registerStep(SceneComponentConstants.STEP_BEFORECAMERAUPDATE_GAMEPAD, this, this._beforeCameraUpdate);
+        // Nothing to do for gamepads
     }
     /**
      * Rebuilds the elements related to this component in case of
@@ -74,11 +74,5 @@ export class GamepadSystemSceneComponent {
             this.scene._gamepadManager = null;
         }
     }
-    _beforeCameraUpdate() {
-        const gamepadManager = this.scene._gamepadManager;
-        if (gamepadManager && gamepadManager._isMonitoring) {
-            gamepadManager._checkGamepadsStatus();
-        }
-    }
 }
 //# sourceMappingURL=gamepadSceneComponent.js.map

package/Gamepads/gamepadSceneComponent.js.map

@@ -1 +1 @@
-{"version":3,"file":"gamepadSceneComponent.js","sourceRoot":"","sources":["../../../../dev/core/src/Gamepads/gamepadSceneComponent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAClF,OAAO,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,EAAE,2BAA2B,EAAE,MAAM,+CAA+C,CAAC;AAe5F,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,SAAS,EAAE,gBAAgB,EAAE;IACrD,GAAG,EAAE;QACD,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE;YACvB,IAAI,CAAC,eAAe,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;YAChD,IAAI,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,uBAAuB,CAAC,YAAY,CAAgC,CAAC;YACxG,IAAI,CAAC,SAAS,EAAE;gBACZ,SAAS,GAAG,IAAI,2BAA2B,CAAC,IAAI,CAAC,CAAC;gBAClD,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;aACjC;SACJ;QAED,OAAO,IAAI,CAAC,eAAe,CAAC;IAChC,CAAC;IACD,UAAU,EAAE,IAAI;IAChB,YAAY,EAAE,IAAI;CACrB,CAAC,CAAC;AAeH;;;GAGG;AACH,uBAAuB,CAAC,SAAS,CAAC,UAAU,GAAG;IAC3C,IAAI,CAAC,GAAG,CAAC,IAAI,sBAAsB,EAAE,CAAC,CAAC;IACvC,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAeF;;;GAGG;AACH,4BAA4B,CAAC,SAAS,CAAC,UAAU,GAAG;IAChD,IAAI,CAAC,GAAG,CAAC,IAAI,2BAA2B,EAAE,CAAC,CAAC;IAC5C,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,2BAA2B;IAWpC;;;OAGG;IACH,YAAY,KAAY;QAdxB;;WAEG;QACa,SAAI,GAAG,uBAAuB,CAAC,YAAY,CAAC;QAYxD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAED;;OAEG;IACI,QAAQ;QACX,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,YAAY,CAAC,uBAAuB,CAAC,+BAA+B,EAAE,IAAI,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC9I,CAAC;IAED;;;OAGG;IACI,OAAO;QACV,6BAA6B;IACjC,CAAC;IAED;;OAEG;IACI,OAAO;QACV,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC;QAClD,IAAI,cAAc,EAAE;YAChB,cAAc,CAAC,OAAO,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC;SACrC;IACL,CAAC;IAEO,mBAAmB;QACvB,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC;QAElD,IAAI,cAAc,IAAI,cAAc,CAAC,aAAa,EAAE;YAChD,cAAc,CAAC,oBAAoB,EAAE,CAAC;SACzC;IACL,CAAC;CACJ","sourcesContent":["import type { Nullable } from \"../types\";\r\nimport { Scene } from \"../scene\";\r\nimport type { ISceneComponent } from \"../sceneComponent\";\r\nimport { SceneComponentConstants } from \"../sceneComponent\";\r\nimport { GamepadManager } from \"./gamepadManager\";\r\n\r\nimport { FreeCameraInputsManager } from \"../Cameras/freeCameraInputsManager\";\r\nimport { FreeCameraGamepadInput } from \"../Cameras/Inputs/freeCameraGamepadInput\";\r\nimport { ArcRotateCameraInputsManager } from \"../Cameras/arcRotateCameraInputsManager\";\r\nimport { ArcRotateCameraGamepadInput } from \"../Cameras/Inputs/arcRotateCameraGamepadInput\";\r\n\r\ndeclare module \"../scene\" {\r\n    export interface Scene {\r\n        /** @internal */\r\n        _gamepadManager: Nullable<GamepadManager>;\r\n\r\n        /**\r\n         * Gets the gamepad manager associated with the scene\r\n         * @see https://doc.babylonjs.com/features/featuresDeepDive/input/gamepads\r\n         */\r\n        gamepadManager: GamepadManager;\r\n    }\r\n}\r\n\r\nObject.defineProperty(Scene.prototype, \"gamepadManager\", {\r\n    get: function (this: Scene) {\r\n        if (!this._gamepadManager) {\r\n            this._gamepadManager = new GamepadManager(this);\r\n            let component = this._getComponent(SceneComponentConstants.NAME_GAMEPAD) as GamepadSystemSceneComponent;\r\n            if (!component) {\r\n                component = new GamepadSystemSceneComponent(this);\r\n                this._addComponent(component);\r\n            }\r\n        }\r\n\r\n        return this._gamepadManager;\r\n    },\r\n    enumerable: true,\r\n    configurable: true,\r\n});\r\n\r\ndeclare module \"../Cameras/freeCameraInputsManager\" {\r\n    /**\r\n     * Interface representing a free camera inputs manager\r\n     */\r\n    export interface FreeCameraInputsManager {\r\n        /**\r\n         * Adds gamepad input support to the FreeCameraInputsManager.\r\n         * @returns the FreeCameraInputsManager\r\n         */\r\n        addGamepad(): FreeCameraInputsManager;\r\n    }\r\n}\r\n\r\n/**\r\n * Adds a gamepad to the free camera inputs manager\r\n * @returns the FreeCameraInputsManager\r\n */\r\nFreeCameraInputsManager.prototype.addGamepad = function (): FreeCameraInputsManager {\r\n    this.add(new FreeCameraGamepadInput());\r\n    return this;\r\n};\r\n\r\ndeclare module \"../Cameras/arcRotateCameraInputsManager\" {\r\n    /**\r\n     * Interface representing an arc rotate camera inputs manager\r\n     */\r\n    export interface ArcRotateCameraInputsManager {\r\n        /**\r\n         * Adds gamepad input support to the ArcRotateCamera InputManager.\r\n         * @returns the camera inputs manager\r\n         */\r\n        addGamepad(): ArcRotateCameraInputsManager;\r\n    }\r\n}\r\n\r\n/**\r\n * Adds a gamepad to the arc rotate camera inputs manager\r\n * @returns the camera inputs manager\r\n */\r\nArcRotateCameraInputsManager.prototype.addGamepad = function (): ArcRotateCameraInputsManager {\r\n    this.add(new ArcRotateCameraGamepadInput());\r\n    return this;\r\n};\r\n\r\n/**\r\n * Defines the gamepad scene component responsible to manage gamepads in a given scene\r\n */\r\nexport class GamepadSystemSceneComponent implements ISceneComponent {\r\n    /**\r\n     * The component name helpfull to identify the component in the list of scene components.\r\n     */\r\n    public readonly name = SceneComponentConstants.NAME_GAMEPAD;\r\n\r\n    /**\r\n     * The scene the component belongs to.\r\n     */\r\n    public scene: Scene;\r\n\r\n    /**\r\n     * Creates a new instance of the component for the given scene\r\n     * @param scene Defines the scene to register the component in\r\n     */\r\n    constructor(scene: Scene) {\r\n        this.scene = scene;\r\n    }\r\n\r\n    /**\r\n     * Registers the component in a given scene\r\n     */\r\n    public register(): void {\r\n        this.scene._beforeCameraUpdateStage.registerStep(SceneComponentConstants.STEP_BEFORECAMERAUPDATE_GAMEPAD, this, this._beforeCameraUpdate);\r\n    }\r\n\r\n    /**\r\n     * Rebuilds the elements related to this component in case of\r\n     * context lost for instance.\r\n     */\r\n    public rebuild(): void {\r\n        // Nothing to do for gamepads\r\n    }\r\n\r\n    /**\r\n     * Disposes the component and the associated resources\r\n     */\r\n    public dispose(): void {\r\n        const gamepadManager = this.scene._gamepadManager;\r\n        if (gamepadManager) {\r\n            gamepadManager.dispose();\r\n            this.scene._gamepadManager = null;\r\n        }\r\n    }\r\n\r\n    private _beforeCameraUpdate(): void {\r\n        const gamepadManager = this.scene._gamepadManager;\r\n\r\n        if (gamepadManager && gamepadManager._isMonitoring) {\r\n            gamepadManager._checkGamepadsStatus();\r\n        }\r\n    }\r\n}\r\n"]}
+{"version":3,"file":"gamepadSceneComponent.js","sourceRoot":"","sources":["../../../../dev/core/src/Gamepads/gamepadSceneComponent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAClF,OAAO,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,EAAE,2BAA2B,EAAE,MAAM,+CAA+C,CAAC;AAe5F,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,SAAS,EAAE,gBAAgB,EAAE;IACrD,GAAG,EAAE;QACD,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE;YACvB,IAAI,CAAC,eAAe,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;YAChD,IAAI,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,uBAAuB,CAAC,YAAY,CAAgC,CAAC;YACxG,IAAI,CAAC,SAAS,EAAE;gBACZ,SAAS,GAAG,IAAI,2BAA2B,CAAC,IAAI,CAAC,CAAC;gBAClD,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;aACjC;SACJ;QAED,OAAO,IAAI,CAAC,eAAe,CAAC;IAChC,CAAC;IACD,UAAU,EAAE,IAAI;IAChB,YAAY,EAAE,IAAI;CACrB,CAAC,CAAC;AAeH;;;GAGG;AACH,uBAAuB,CAAC,SAAS,CAAC,UAAU,GAAG;IAC3C,IAAI,CAAC,GAAG,CAAC,IAAI,sBAAsB,EAAE,CAAC,CAAC;IACvC,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAeF;;;GAGG;AACH,4BAA4B,CAAC,SAAS,CAAC,UAAU,GAAG;IAChD,IAAI,CAAC,GAAG,CAAC,IAAI,2BAA2B,EAAE,CAAC,CAAC;IAC5C,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,2BAA2B;IAWpC;;;OAGG;IACH,YAAY,KAAY;QAdxB;;WAEG;QACa,SAAI,GAAG,uBAAuB,CAAC,YAAY,CAAC;QAYxD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAED;;OAEG;IACI,QAAQ;QACX,6BAA6B;IACjC,CAAC;IAED;;;OAGG;IACI,OAAO;QACV,6BAA6B;IACjC,CAAC;IAED;;OAEG;IACI,OAAO;QACV,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC;QAClD,IAAI,cAAc,EAAE;YAChB,cAAc,CAAC,OAAO,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC;SACrC;IACL,CAAC;CACJ","sourcesContent":["import type { Nullable } from \"../types\";\r\nimport { Scene } from \"../scene\";\r\nimport type { ISceneComponent } from \"../sceneComponent\";\r\nimport { SceneComponentConstants } from \"../sceneComponent\";\r\nimport { GamepadManager } from \"./gamepadManager\";\r\n\r\nimport { FreeCameraInputsManager } from \"../Cameras/freeCameraInputsManager\";\r\nimport { FreeCameraGamepadInput } from \"../Cameras/Inputs/freeCameraGamepadInput\";\r\nimport { ArcRotateCameraInputsManager } from \"../Cameras/arcRotateCameraInputsManager\";\r\nimport { ArcRotateCameraGamepadInput } from \"../Cameras/Inputs/arcRotateCameraGamepadInput\";\r\n\r\ndeclare module \"../scene\" {\r\n    export interface Scene {\r\n        /** @internal */\r\n        _gamepadManager: Nullable<GamepadManager>;\r\n\r\n        /**\r\n         * Gets the gamepad manager associated with the scene\r\n         * @see https://doc.babylonjs.com/features/featuresDeepDive/input/gamepads\r\n         */\r\n        gamepadManager: GamepadManager;\r\n    }\r\n}\r\n\r\nObject.defineProperty(Scene.prototype, \"gamepadManager\", {\r\n    get: function (this: Scene) {\r\n        if (!this._gamepadManager) {\r\n            this._gamepadManager = new GamepadManager(this);\r\n            let component = this._getComponent(SceneComponentConstants.NAME_GAMEPAD) as GamepadSystemSceneComponent;\r\n            if (!component) {\r\n                component = new GamepadSystemSceneComponent(this);\r\n                this._addComponent(component);\r\n            }\r\n        }\r\n\r\n        return this._gamepadManager;\r\n    },\r\n    enumerable: true,\r\n    configurable: true,\r\n});\r\n\r\ndeclare module \"../Cameras/freeCameraInputsManager\" {\r\n    /**\r\n     * Interface representing a free camera inputs manager\r\n     */\r\n    export interface FreeCameraInputsManager {\r\n        /**\r\n         * Adds gamepad input support to the FreeCameraInputsManager.\r\n         * @returns the FreeCameraInputsManager\r\n         */\r\n        addGamepad(): FreeCameraInputsManager;\r\n    }\r\n}\r\n\r\n/**\r\n * Adds a gamepad to the free camera inputs manager\r\n * @returns the FreeCameraInputsManager\r\n */\r\nFreeCameraInputsManager.prototype.addGamepad = function (): FreeCameraInputsManager {\r\n    this.add(new FreeCameraGamepadInput());\r\n    return this;\r\n};\r\n\r\ndeclare module \"../Cameras/arcRotateCameraInputsManager\" {\r\n    /**\r\n     * Interface representing an arc rotate camera inputs manager\r\n     */\r\n    export interface ArcRotateCameraInputsManager {\r\n        /**\r\n         * Adds gamepad input support to the ArcRotateCamera InputManager.\r\n         * @returns the camera inputs manager\r\n         */\r\n        addGamepad(): ArcRotateCameraInputsManager;\r\n    }\r\n}\r\n\r\n/**\r\n * Adds a gamepad to the arc rotate camera inputs manager\r\n * @returns the camera inputs manager\r\n */\r\nArcRotateCameraInputsManager.prototype.addGamepad = function (): ArcRotateCameraInputsManager {\r\n    this.add(new ArcRotateCameraGamepadInput());\r\n    return this;\r\n};\r\n\r\n/**\r\n * Defines the gamepad scene component responsible to manage gamepads in a given scene\r\n */\r\nexport class GamepadSystemSceneComponent implements ISceneComponent {\r\n    /**\r\n     * The component name helpfull to identify the component in the list of scene components.\r\n     */\r\n    public readonly name = SceneComponentConstants.NAME_GAMEPAD;\r\n\r\n    /**\r\n     * The scene the component belongs to.\r\n     */\r\n    public scene: Scene;\r\n\r\n    /**\r\n     * Creates a new instance of the component for the given scene\r\n     * @param scene Defines the scene to register the component in\r\n     */\r\n    constructor(scene: Scene) {\r\n        this.scene = scene;\r\n    }\r\n\r\n    /**\r\n     * Registers the component in a given scene\r\n     */\r\n    public register(): void {\r\n        // Nothing to do for gamepads\r\n    }\r\n\r\n    /**\r\n     * Rebuilds the elements related to this component in case of\r\n     * context lost for instance.\r\n     */\r\n    public rebuild(): void {\r\n        // Nothing to do for gamepads\r\n    }\r\n\r\n    /**\r\n     * Disposes the component and the associated resources\r\n     */\r\n    public dispose(): void {\r\n        const gamepadManager = this.scene._gamepadManager;\r\n        if (gamepadManager) {\r\n            gamepadManager.dispose();\r\n            this.scene._gamepadManager = null;\r\n        }\r\n    }\r\n}\r\n"]}

package/Gizmos/boundingBoxGizmo.d.ts

@@ -96,6 +96,13 @@ export interface IBoundingBoxGizmo extends IGizmo {
     /** Drag distance in babylon units that the gizmo will snap rotation to when dragged */
     rotationSnapDistance: number;
 }
+/**
+ * Dragging operation in observable
+ */
+export declare enum DragOperation {
+    Rotation = 0,
+    Scaling = 1
+}
 /**
  * Bounding box gizmo
  */

package/Gizmos/boundingBoxGizmo.js

@@ -12,6 +12,14 @@ import { PivotTools } from "../Misc/pivotTools.js";
 import { Color3 } from "../Maths/math.color.js";
 import { Epsilon } from "../Maths/math.constants.js";
 import { TransformNode } from "../Meshes/transformNode.js";
+/**
+ * Dragging operation in observable
+ */
+export var DragOperation;
+(function (DragOperation) {
+    DragOperation[DragOperation["Rotation"] = 0] = "Rotation";
+    DragOperation[DragOperation["Scaling"] = 1] = "Scaling";
+})(DragOperation || (DragOperation = {}));
 /**
  * Bounding box gizmo
  */
@@ -263,8 +271,13 @@ export class BoundingBoxGizmo extends Gizmo {
                 totalTurnAmountOfDrag = 0;
                 previousProjectDist = 0;
             });
+            const computeAxis = function () {
+                const dragAxisIndex = Math.floor(i / 4);
+                TmpVectors.Vector3[0].set(dragAxisIndex == 0 ? 1 : 0, dragAxisIndex == 1 ? 1 : 0, dragAxisIndex == 2 ? 1 : 0);
+                return TmpVectors.Vector3[0];
+            };
             rotateAnchorsDragBehavior.onDragObservable.add((event) => {
-                this.onRotationSphereDragObservable.notifyObservers({});
+                this.onRotationSphereDragObservable.notifyObservers({ dragOperation: 0 /* DragOperation.Rotation */, dragAxis: computeAxis().clone() });
                 if (this.attachedMesh) {
                     const originalParent = this.attachedMesh.parent;
                     if (originalParent && originalParent.scaling && originalParent.scaling.isNonUniformWithinEpsilon(0.001)) {
@@ -327,12 +340,12 @@ export class BoundingBoxGizmo extends Gizmo {
             });
             // Selection/deselection
             rotateAnchorsDragBehavior.onDragStartObservable.add(() => {
-                this.onDragStartObservable.notifyObservers({});
+                this.onDragStartObservable.notifyObservers({ dragOperation: 0 /* DragOperation.Rotation */, dragAxis: computeAxis().clone() });
                 this._dragging = true;
                 this._selectNode(anchor);
             });
             rotateAnchorsDragBehavior.onDragEndObservable.add((event) => {
-                this.onRotationSphereDragEndObservable.notifyObservers({});
+                this.onRotationSphereDragEndObservable.notifyObservers({ dragOperation: 0 /* DragOperation.Rotation */, dragAxis: computeAxis().clone() });
                 this._dragging = false;
                 this._selectNode(null);
                 this._updateDummy();
@@ -374,7 +387,7 @@ export class BoundingBoxGizmo extends Gizmo {
                     let previousScale = 0;
                     box.addBehavior(scaleBoxesDragBehavior);
                     scaleBoxesDragBehavior.onDragObservable.add((event) => {
-                        this.onScaleBoxDragObservable.notifyObservers({});
+                        this.onScaleBoxDragObservable.notifyObservers({ dragOperation: 1 /* DragOperation.Scaling */, dragAxis: new Vector3(i - 1, j - 1, k - 1) });
                         if (this.attachedMesh) {
                             const originalParent = this.attachedMesh.parent;
                             if (originalParent && originalParent.scaling && originalParent.scaling.isNonUniformWithinEpsilon(0.001)) {
@@ -448,7 +461,7 @@ export class BoundingBoxGizmo extends Gizmo {
                     });
                     // Selection/deselection
                     scaleBoxesDragBehavior.onDragStartObservable.add(() => {
-                        this.onDragStartObservable.notifyObservers({});
+                        this.onDragStartObservable.notifyObservers({ dragOperation: 1 /* DragOperation.Scaling */, dragAxis: new Vector3(i - 1, j - 1, k - 1) });
                         this._dragging = true;
                         this._selectNode(box);
                         totalRelativeDragDistance = 0;
@@ -457,7 +470,7 @@ export class BoundingBoxGizmo extends Gizmo {
                         this._incrementalAnchorStartupValue.copyFrom(this._anchorMesh.scaling);
                     });
                     scaleBoxesDragBehavior.onDragEndObservable.add((event) => {
-                        this.onScaleBoxDragEndObservable.notifyObservers({});
+                        this.onScaleBoxDragEndObservable.notifyObservers({ dragOperation: 1 /* DragOperation.Scaling */, dragAxis: new Vector3(i - 1, j - 1, k - 1) });
                         this._dragging = false;
                         this._selectNode(null);
                         this._updateDummy();