@luma.gl/webgl 9.1.0 → 9.1.2

package/dist/index.cjs

@@ -4654,6 +4654,7 @@ var WebGLDevice = class extends import_core22.Device {
   //
   /** type of this device */
   type = "webgl";
+  // Use the ! assertion to handle the case where _reuseDevices causes the constructor to return early
   /** The underlying WebGL context */
   handle;
   features;
@@ -4678,10 +4679,10 @@ var WebGLDevice = class extends import_core22.Device {
   constructor(props) {
     var _a, _b;
     super({ ...props, id: props.id || uid("webgl-device") });
-    if (!props.createCanvasContext) {
+    const canvasContextProps = import_core22.Device._getCanvasContextProps(props);
+    if (!canvasContextProps) {
       throw new Error("WebGLDevice requires props.createCanvasContext to be set");
     }
-    const canvasContextProps = props.createCanvasContext === true ? {} : props.createCanvasContext;
     let device = (_b = (_a = canvasContextProps.canvas) == null ? void 0 : _a.gl) == null ? void 0 : _b.device;
     if (device) {
       throw new Error(`WebGL context already attached to device ${device.id}`);
@@ -4714,6 +4715,11 @@ var WebGLDevice = class extends import_core22.Device {
     }
     device = gl.device;
     if (device) {
+      if (props._reuseDevices) {
+        import_core22.log.log(1, `Not creating a new Device, instead returning a reference to Device ${device.id} already attached to WebGL context`, device)();
+        device._reused = true;
+        return device;
+      }
       throw new Error(`WebGL context already attached to device ${device.id}`);
     }
     this.handle = gl;
@@ -4745,10 +4751,19 @@ var WebGLDevice = class extends import_core22.Device {
     }
   }
   /**
-   * Destroys the context
-   * @note Has no effect for WebGL browser contexts, there is no browser API for destroying contexts
+   * Destroys the device
+   *
+   * @note "Detaches" from the WebGL context unless _reuseDevices is true.
+   *
+   * @note The underlying WebGL context is not immediately destroyed,
+   * but may be destroyed later through normal JavaScript garbage collection.
+   * This is a fundamental limitation since WebGL does not offer any
+   * browser API for destroying WebGL contexts.
    */
   destroy() {
+    if (!this.props._reuseDevices && !this._reused) {
+      delete this.gl.device;
+    }
   }
   get isLost() {
     return this.gl.isContextLost();
@@ -5133,7 +5148,7 @@ var WebGLAdapter = class extends import_core23.Adapter {
       }
     }
     const device = new WebGLDevice(props);
-    const message2 = `Created ${device.type}${device.debug ? " debug" : ""} context: ${device.info.vendor}, ${device.info.renderer} for canvas: ${device.canvasContext.id}`;
+    const message2 = `${device._reused ? "Reusing" : "Created"} device with WebGL2 ${device.debug ? "debug " : ""}context: ${device.info.vendor}, ${device.info.renderer} for canvas: ${device.canvasContext.id}`;
     import_core23.log.probe(LOG_LEVEL2, message2)();
     import_core23.log.table(LOG_LEVEL2, device.info)();
     import_core23.log.groupEnd(LOG_LEVEL2)();