@luma.gl/webgl 9.0.0-alpha.15 → 9.0.0-alpha.16

package/dist/adapter/webgl-canvas-context.js

@@ -1,55 +1,61 @@
-import _defineProperty from "@babel/runtime/helpers/esm/defineProperty";
 import { CanvasContext } from '@luma.gl/api';
-import WEBGLFramebuffer from './resources/webgl-framebuffer';
+import WEBGLFramebuffer from './resources/webgl-framebuffer.js';
+/**
+ * Holds a WebGL Canvas Context which will handle drawing buffer resizing etc
+ * @todo This class is WIP, intended to replace the old gltools-based context size tracking
+ */
 export default class WebGLCanvasContext extends CanvasContext {
-  constructor(device, props) {
-    super(props);
-
-    _defineProperty(this, "device", void 0);
-
-    _defineProperty(this, "presentationSize", void 0);
-
-    _defineProperty(this, "_framebuffer", null);
-
-    this.device = device;
-    this.presentationSize = [-1, -1];
-
-    this._setAutoCreatedCanvasId("".concat(this.device.id, "-canvas"));
-
-    this.update();
-  }
-
-  getCurrentFramebuffer() {
-    this.update();
-    this._framebuffer = this._framebuffer || new WEBGLFramebuffer(this.device, {
-      handle: null
-    });
-    return this._framebuffer;
-  }
-
-  update() {
-    const size = this.getPixelSize();
-    const sizeChanged = size[0] !== this.presentationSize[0] || size[1] !== this.presentationSize[1];
-
-    if (sizeChanged) {
-      this.presentationSize = size;
+    constructor(device, props) {
+        // Note: Base class creates / looks up the canvas (unless under Node.js)
+        super(props);
+        this._framebuffer = null;
+        this.device = device;
+        this.presentationSize = [-1, -1];
+        this._setAutoCreatedCanvasId(`${this.device.id}-canvas`);
+        this.update();
     }
-  }
-
-  resize(options) {
-    if (this.canvas) {
-      this.setDevicePixelRatio(devicePixelRatio, options);
-      return;
+    getCurrentFramebuffer() {
+        this.update();
+        this._framebuffer = this._framebuffer || new WEBGLFramebuffer(this.device, { handle: null });
+        return this._framebuffer;
     }
-
-    const ext = this.device.gl.getExtension('STACKGL_resize_drawingbuffer');
-
-    if (ext && options && "width" in options && "height" in options) {
-      ext.resize(options.width, options.height);
+    /** Resizes and updates render targets if necessary */
+    update() {
+        const size = this.getPixelSize();
+        const sizeChanged = size[0] !== this.presentationSize[0] || size[1] !== this.presentationSize[1];
+        if (sizeChanged) {
+            this.presentationSize = size;
+        }
+    }
+    /**
+     * Resize the canvas' drawing buffer.
+     *
+     * Can match the canvas CSS size, and optionally also consider devicePixelRatio
+     * Can be called every frame
+     *
+     * Regardless of size, the drawing buffer will always be scaled to the viewport, but
+     * for best visual results, usually set to either:
+     *  canvas CSS width x canvas CSS height
+     *  canvas CSS width * devicePixelRatio x canvas CSS height * devicePixelRatio
+     * See http://webgl2fundamentals.org/webgl/lessons/webgl-resizing-the-canvas.html
+     */
+    resize(options) {
+        // Resize browser context .
+        if (this.canvas) {
+            this.setDevicePixelRatio(devicePixelRatio, options);
+            return;
+        }
+        // Resize headless gl context
+        const ext = this.device.gl.getExtension('STACKGL_resize_drawingbuffer');
+        if (ext && options && `width` in options && `height` in options) {
+            ext.resize(options.width, options.height);
+        }
+    }
+    commit() {
+        // gl.commit was ultimately removed from standard??
+        // if (this.offScreen && this.gl.commit) {
+        //   // @ts-expect-error gl.commit is not officially part of WebGLRenderingContext
+        //   this.gl.commit();
+        // }
     }
-  }
-
-  commit() {}
-
 }
-//# sourceMappingURL=webgl-canvas-context.js.map