@luma.gl/webgl 8.6.0-alpha.1 → 8.6.0-alpha.5

package/dist/adapter/webgl-device.js

@@ -0,0 +1,207 @@
+import _defineProperty from "@babel/runtime/helpers/esm/defineProperty";
+import { Device, log } from '@luma.gl/api';
+import { polyfillContext } from '../context/polyfill/polyfill-context';
+import { trackContextState } from '../context/state-tracker/track-context-state';
+import { getDevicePixelRatio, setDevicePixelRatio } from '../context/context/device-pixels';
+import { createBrowserContext } from '../context/context/create-context';
+import { getCanvas } from '../context/context/get-canvas';
+import { isWebGL, isWebGL2 } from '../context/context/webgl-checks';
+import { getDeviceInfo } from './device-helpers/get-device-info';
+import { getDeviceFeatures } from './device-helpers/device-features';
+import { getDeviceLimits, getWebGLLimits } from './device-helpers/device-limits';
+import WEBGLBuffer from '../classes/webgl-buffer';
+import { WEBGLShader } from '../adapter/webgl-shader';
+import Texture2D from '../classes/texture-2d';
+const DEFAULT_DEVICE_PROPS = {
+  canvas: undefined,
+  gl: undefined,
+  webgl2: true,
+  webgl1: true,
+  manageState: true,
+  width: 800,
+  height: 600,
+  debug: false,
+  break: undefined,
+  onContextLost: () => console.error('WebGL context lost'),
+  onContextRestored: () => console.info('WebGL context restored'),
+  alpha: undefined,
+  depth: undefined,
+  stencil: undefined,
+  antialias: undefined,
+  premultipliedAlpha: undefined,
+  preserveDrawingBuffer: undefined,
+  failIfMajorPerformanceCaveat: undefined
+};
+const LOG_LEVEL = 1;
+const glToContextMap = new WeakMap();
+export function getWebGLDevice(gl) {
+  return glToContextMap.get(gl);
+}
+let counter = 0;
+export default class WebGLDevice extends Device {
+  static fromContext(gl) {
+    return gl.device;
+  }
+
+  static attach(gl, props) {
+    if (gl instanceof WebGLDevice) {
+      return gl;
+    }
+
+    if (!isWebGL(gl)) {
+      throw new Error('Invalid WebGLRenderingContext');
+    }
+
+    return new WebGLDevice({ ...props,
+      gl: gl
+    });
+  }
+
+  constructor(props) {
+    var _this$props$gl;
+
+    super();
+
+    _defineProperty(this, "features", void 0);
+
+    _defineProperty(this, "limits", void 0);
+
+    _defineProperty(this, "info", void 0);
+
+    _defineProperty(this, "lost", void 0);
+
+    _defineProperty(this, "props", void 0);
+
+    _defineProperty(this, "userData", void 0);
+
+    _defineProperty(this, "isWebGL2", void 0);
+
+    _defineProperty(this, "gl", void 0);
+
+    _defineProperty(this, "gl2", void 0);
+
+    _defineProperty(this, "offScreen", false);
+
+    _defineProperty(this, "webglLimits", void 0);
+
+    _defineProperty(this, "defaultFramebuffer", void 0);
+
+    _defineProperty(this, "defaultVertexArray", void 0);
+
+    _defineProperty(this, "_state", 'uninitialized');
+
+    _defineProperty(this, "_canvasSizeInfo", {
+      clientWidth: 0,
+      clientHeight: 0,
+      devicePixelRatio: 1
+    });
+
+    _defineProperty(this, "_extensions", {});
+
+    _defineProperty(this, "_polyfilled", false);
+
+    this.props = { ...DEFAULT_DEVICE_PROPS,
+      ...props
+    };
+    const device = (_this$props$gl = this.props.gl) === null || _this$props$gl === void 0 ? void 0 : _this$props$gl.device;
+
+    if (device) {
+      if (device._state !== 'initialized') {
+        log.error('recursive context');
+        throw new Error('recursive context');
+      }
+
+      return device;
+    }
+
+    this.offScreen = typeof OffscreenCanvas !== 'undefined' && props.canvas instanceof OffscreenCanvas;
+    this.gl = this.props.gl || this._createContext(props);
+    this.gl2 = this.gl;
+    this.isWebGL2 = isWebGL2(this.gl);
+    this._state = 'initializing';
+
+    if (this.gl.device) {
+      log.error('device already created');
+      throw new Error('device already created');
+    }
+
+    this.gl.device = this;
+    this.gl._version = typeof WebGL2RenderingContext !== 'undefined' && this.gl instanceof WebGL2RenderingContext ? 2 : 1;
+    glToContextMap.set(this.gl, this);
+    this.info = getDeviceInfo(this.gl);
+    const debug = this.gl.debug ? ' debug' : '';
+    const webGL = isWebGL2(this.gl) ? 'WebGL2' : 'WebGL1';
+    log.groupCollapsed(LOG_LEVEL, "".concat(webGL).concat(debug, " context: ").concat(this.info.vendor, ", ").concat(this.info.renderer))();
+    polyfillContext(this.gl);
+    log.probe(LOG_LEVEL, 'polyfilled context')();
+    trackContextState(this.gl, {
+      copyState: false,
+      log: (...args) => log.log(1, ...args)()
+    });
+    log.probe(LOG_LEVEL, 'instrumented context')();
+    this.features = getDeviceFeatures(this.gl);
+    log.probe(LOG_LEVEL, "queried device features ".concat(counter))();
+    this.limits = getDeviceLimits(this.gl);
+    log.probe(LOG_LEVEL, 'queried device limits')();
+    this.webglLimits = getWebGLLimits(this.gl);
+    log.probe(LOG_LEVEL, 'queried webgl limits')();
+    log.groupEnd(LOG_LEVEL)();
+    this._state = 'initialized';
+  }
+
+  destroy() {
+    let ext = this.gl.getExtension('STACKGL_destroy_context');
+
+    if (ext) {
+      ext.destroy();
+    }
+  }
+
+  resize(options) {
+    if (this.gl.canvas) {
+      const devicePixelRatio = getDevicePixelRatio(options === null || options === void 0 ? void 0 : options.useDevicePixels);
+      setDevicePixelRatio(this.gl, devicePixelRatio, options);
+      return;
+    }
+
+    const ext = this.gl.getExtension('STACKGL_resize_drawingbuffer');
+
+    if (ext && options && "width" in options && "height" in options) {
+      ext.resize(options.width, options.height);
+    }
+  }
+
+  _createBuffer(props) {
+    return new WEBGLBuffer(this.gl, props);
+  }
+
+  createTexture(props) {
+    return new Texture2D(this, props);
+  }
+
+  createShader(props) {
+    return new WEBGLShader(this, props);
+  }
+
+  commit() {
+    if (this.offScreen && this.gl.commit) {
+      this.gl.commit();
+    }
+  }
+
+  _createContext(options) {
+    const {
+      width,
+      height,
+      canvas
+    } = this.props;
+    const targetCanvas = getCanvas({
+      canvas,
+      width,
+      height
+    });
+    return createBrowserContext(targetCanvas, options);
+  }
+
+}
+//# sourceMappingURL=webgl-device.js.map

package/dist/adapter/webgl-device.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapter/webgl-device.ts"],"names":["Device","log","polyfillContext","trackContextState","getDevicePixelRatio","setDevicePixelRatio","createBrowserContext","getCanvas","isWebGL","isWebGL2","getDeviceInfo","getDeviceFeatures","getDeviceLimits","getWebGLLimits","WEBGLBuffer","WEBGLShader","Texture2D","DEFAULT_DEVICE_PROPS","canvas","undefined","gl","webgl2","webgl1","manageState","width","height","debug","break","onContextLost","console","error","onContextRestored","info","alpha","depth","stencil","antialias","premultipliedAlpha","preserveDrawingBuffer","failIfMajorPerformanceCaveat","LOG_LEVEL","glToContextMap","WeakMap","getWebGLDevice","get","counter","WebGLDevice","fromContext","device","attach","props","Error","constructor","clientWidth","clientHeight","devicePixelRatio","_state","offScreen","OffscreenCanvas","_createContext","gl2","_version","WebGL2RenderingContext","set","webGL","groupCollapsed","vendor","renderer","probe","copyState","args","features","limits","webglLimits","groupEnd","destroy","ext","getExtension","resize","options","useDevicePixels","_createBuffer","createTexture","createShader","commit","targetCanvas"],"mappings":"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","sourcesContent":["// luma.gl, MIT license\nimport {Device, DeviceInfo, DeviceLimits, log} from '@luma.gl/api';\nimport {polyfillContext} from '../context/polyfill/polyfill-context';\nimport {trackContextState} from '../context/state-tracker/track-context-state';\nimport { ContextState } from '../context/context/context-state';\nimport {getDevicePixelRatio, setDevicePixelRatio} from '../context/context/device-pixels';\nimport {createBrowserContext} from '../context/context/create-context';\nimport {getCanvas} from '../context/context/get-canvas';\nimport {isWebGL, isWebGL2} from '../context/context/webgl-checks';\nimport {getDeviceInfo} from './device-helpers/get-device-info';\nimport {getDeviceFeatures, Feature} from './device-helpers/device-features';\nimport {getDeviceLimits, getWebGLLimits, WebGLLimits} from './device-helpers/device-limits';\n\n// WebGL classes\nimport type {BufferProps, ShaderProps} from '@luma.gl/api';\nimport WEBGLBuffer from '../classes/webgl-buffer';\nimport {WEBGLShader} from '../adapter/webgl-shader';\nimport Texture2D, {Texture2DProps} from '../classes/texture-2d';\nimport type {default as Framebuffer} from '../classes/framebuffer';\nimport type {default as VertexArrayObject} from '../classes/vertex-array-object';\n\n/** WebGLDevice options */\nexport type WebGLDeviceProps = {\n  canvas?: HTMLCanvasElement | OffscreenCanvas | string; // A canvas element or a canvas string id\n  width?: number /** width is only used when creating a new canvas */;\n  height?: number /** height is only used when creating a new canvas */;\n  // Attach to existing context\n  gl?: WebGLRenderingContext | WebGL2RenderingContext;\n  // COMMON CONTEXT PARAMETERS\n  webgl2?: boolean; // Set to false to not create a WebGL2 context (force webgl1)\n  webgl1?: boolean; // set to false to not create a WebGL1 context (fails if webgl2 not available)\n  manageState?: boolean; // Set to false to disable WebGL state management instrumentation\n  debug?: boolean; // Instrument context (at the expense of performance)\n  break?: Array<any>; // TODO: types\n  onContextLost?: (event: Event) => void;\n  onContextRestored?: (event: Event) => void;\n  // BROWSER CONTEXT PARAMETERS\n  alpha?: boolean; // Default render target has an alpha buffer.\n  depth?: boolean; // Default render target has a depth buffer of at least 16 bits.\n  stencil?: boolean; // Default render target has a stencil buffer of at least 8 bits.\n  antialias?: boolean; // Boolean that indicates whether or not to perform anti-aliasing.\n  premultipliedAlpha?: boolean; // Boolean that indicates that the page compositor will assume the drawing buffer contains colors with pre-multiplied alpha.\n  preserveDrawingBuffer?: boolean; // Default render target buffers will not be automatically cleared and will preserve their values until cleared or overwritten\n  failIfMajorPerformanceCaveat?: boolean; // Do not create if the system performance is low.\n};\n\nconst DEFAULT_DEVICE_PROPS: Required<WebGLDeviceProps> = {\n  canvas: undefined, // A canvas element or a canvas string id\n  gl: undefined,\n  webgl2: true, // Attempt to create a WebGL2 context\n  webgl1: true, // Attempt to create a WebGL1 context (false to fail if webgl2 not available)\n  manageState: true,\n  width: 800, // width are height are only used by headless gl\n  height: 600,\n  debug: false, // Instrument context (at the expense of performance)\n  break: undefined,\n  onContextLost: () => console.error('WebGL context lost'),\n  onContextRestored: () => console.info('WebGL context restored'),\n\n  alpha: undefined,\n  depth: undefined,\n  stencil: undefined,\n  antialias: undefined,\n  premultipliedAlpha: undefined,\n  preserveDrawingBuffer: undefined,\n  failIfMajorPerformanceCaveat: undefined\n};\n\nconst LOG_LEVEL = 1;\n\n// TODO use weakmap instead of modifying context\nconst glToContextMap = new WeakMap<WebGLRenderingContext | WebGL2RenderingContext, WebGLDevice>();\n\nexport function getWebGLDevice(gl: WebGLRenderingContext | WebGL2RenderingContext): WebGLDevice | undefined {\n  return glToContextMap.get(gl);\n}\n\nlet counter = 0;\n\n/** WebGPU style Device API for a WebGL context */\nexport default class WebGLDevice extends Device implements ContextState {\n  // WebGPU style API\n\n  /** A set like interface to test features */\n  readonly features: Set<Feature>;\n  readonly limits: DeviceLimits;\n  readonly info: DeviceInfo;\n\n  /** Promise that rejects when context is lost */\n  readonly lost: Promise<string>;\n\n  // Common API\n  props: Required<WebGLDeviceProps>;\n  userData: {[key: string]: any};\n\n  // WebGL specific API\n  readonly isWebGL2: boolean;\n  readonly gl: WebGLRenderingContext;\n  readonly gl2: WebGL2RenderingContext;\n  /** Is this device attached to an offscreen context */\n  readonly offScreen: boolean = false;\n\n  readonly webglLimits: WebGLLimits;\n\n  defaultFramebuffer?: Framebuffer;\n  defaultVertexArray?: VertexArrayObject;\n\n  // State used by luma.gl classes\n  _state: 'uninitialized' | 'initializing' | 'initialized' = 'uninitialized';\n  readonly _canvasSizeInfo = {clientWidth: 0, clientHeight: 0, devicePixelRatio: 1};\n  readonly _extensions: Record<string, any> = {};\n  _polyfilled: boolean = false;\n\n  /**\n   *\n   */\n  static fromContext(gl: WebGLRenderingContext): WebGLDevice {\n    // @ts-expect-error\n    return gl.device as WebGLDevice;\n  }\n\n  /**\n   * Get a device instance from a GL context\n   * Creates and instruments the device if not already created\n   * @param gl\n   * @returns\n   */\n  static attach(\n    gl: Device | WebGLRenderingContext | WebGL2RenderingContext,\n    props?: WebGLDeviceProps\n  ): WebGLDevice {\n    if (gl instanceof WebGLDevice) {\n      return gl;\n    }\n    if (!isWebGL(gl)) {\n      throw new Error('Invalid WebGLRenderingContext');\n    }\n    return new WebGLDevice({...props, gl: gl as WebGLRenderingContext});\n  }\n\n\n  constructor(props: WebGLDeviceProps) {\n    super();\n\n    this.props = {...DEFAULT_DEVICE_PROPS, ...props};\n\n    // If attaching to an already attached context, return the attached device\n    // @ts-expect-error device is attached to context\n    const device: WebGLDevice | undefined = this.props.gl?.device;\n    if (device) {\n      if (device._state !== 'initialized') {\n        log.error('recursive context');\n        throw new Error('recursive context');\n      }\n      return device;\n    }\n\n    this.offScreen =\n      typeof OffscreenCanvas !== 'undefined' &&\n      props.canvas instanceof OffscreenCanvas;\n\n    // Create an instrument context\n    this.gl = (this.props.gl || this._createContext(props)) as WebGLRenderingContext;\n    this.gl2 = this.gl as WebGL2RenderingContext;\n    this.isWebGL2 = isWebGL2(this.gl);\n    this._state = 'initializing';\n    // Avoid multiple instrumentations\n    // @ts-expect-error\n    if (this.gl.device) {\n      log.error('device already created');\n      throw new Error('device already created'); // ASSERT this device;\n    }\n    // @ts-expect-error\n    this.gl.device = this;\n    // @ts-ignore\n    this.gl._version = typeof WebGL2RenderingContext !== 'undefined' && this.gl instanceof WebGL2RenderingContext ? 2 : 1;\n    // TODO - move to weak map indexing\n    glToContextMap.set(this.gl, this);\n\n    // Luma Device fields\n    this.info = getDeviceInfo(this.gl);\n    // Log some debug info about the newly created context\n    // @ts-expect-error device is attached to context\n    const debug = this.gl.debug ? ' debug' : '';\n    const webGL = isWebGL2(this.gl) ? 'WebGL2' : 'WebGL1';\n    log.groupCollapsed(LOG_LEVEL, `${webGL}${debug} context: ${this.info.vendor}, ${this.info.renderer}`)();\n\n    polyfillContext(this.gl);\n    log.probe(LOG_LEVEL, 'polyfilled context')();\n\n    // Install context state tracking\n    trackContextState(this.gl, {\n      copyState: false,\n      log: (...args) => log.log(1, ...args)()\n    });\n    log.probe(LOG_LEVEL, 'instrumented context')();\n\n    // WebGPU Device fields\n    this.features = getDeviceFeatures(this.gl);\n    log.probe(LOG_LEVEL, `queried device features ${counter}`)();\n    this.limits = getDeviceLimits(this.gl);\n    log.probe(LOG_LEVEL, 'queried device limits')();\n\n    // Add seer integration - TODO - currently removed\n\n    // WEBGL specific fields\n    this.webglLimits = getWebGLLimits(this.gl);\n    log.probe(LOG_LEVEL, 'queried webgl limits')();\n\n    // Add debug instrumentation to the context\n    // if (isBrowser() && props.debug) {\n    //   // @ts-ignore\n    //   const {makeDebugContext} = global;\n    //   if (!makeDebugContext) {\n    //     log.warn('WebGL debug mode not activated. import \"@luma.gl/debug\" to enable.')();\n    //   } else {\n    //     // @ts-ignore\n    //     this.gl = global.makeDebugContext(this.gl, props);\n    //     this.gl2 = this.gl as WebGL2RenderingContext;\n    //     // Debug forces log level to at least 1\n    //     log.level = Math.max(log.level, 1);\n    //   }\n    // }\n\n    log.groupEnd(LOG_LEVEL)();\n    this._state = 'initialized';\n  }\n\n  /**\n   * Destroys the context\n   * @note Has no effect for browser contexts, there is no browser API for destroying contexts\n   */\n  destroy() {\n    let ext = this.gl.getExtension('STACKGL_destroy_context');\n    if (ext) {\n      ext.destroy();\n    }\n    // ext = this.gl.getExtension('WEBGL_lose_context');\n    // if (ext) {\n    //   // TODO - disconnect context lost callbacks?\n    //   ext.loseContext();\n    // }\n  }\n\n  // WEBGL SPECIFIC METHODS\n\n  /**\n   * Resize the canvas' drawing buffer.\n   *\n   * Can match the canvas CSS size, and optionally also consider devicePixelRatio\n   * Can be called every frame\n   *\n   * Regardless of size, the drawing buffer will always be scaled to the viewport, but\n   * for best visual results, usually set to either:\n   *  canvas CSS width x canvas CSS height\n   *  canvas CSS width * devicePixelRatio x canvas CSS height * devicePixelRatio\n   * See http://webgl2fundamentals.org/webgl/lessons/webgl-resizing-the-canvas.html\n   */\n  resize(options?: {width?: number; height?: number; useDevicePixels?: boolean | number}): void {\n    // Resize browser context .\n    if (this.gl.canvas) {\n      const devicePixelRatio = getDevicePixelRatio(options?.useDevicePixels);\n      setDevicePixelRatio(this.gl, devicePixelRatio, options);\n      return;\n    }\n\n    // Resize headless gl context\n    const ext = this.gl.getExtension('STACKGL_resize_drawingbuffer');\n    if (ext && options && `width` in options && `height` in options) {\n      ext.resize(options.width, options.height);\n    }\n  }\n\n  _createBuffer(props: BufferProps): WEBGLBuffer {\n    return new WEBGLBuffer(this.gl, props);\n  }\n\n  createTexture(props: Texture2DProps): Texture2D {\n    return new Texture2D(this, props);\n  }\n\n  createShader(props: ShaderProps): WEBGLShader {\n    return new WEBGLShader(this, props);\n  }\n\n  /**\n   * Offscreen Canvas Support: Commit the frame\n   * https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/commit\n   * Chrome's offscreen canvas does not require gl.commit\n   */\n  commit(): void {\n    // @ts-expect-error gl.commit is not officially part of WebGLRenderingContext\n    if (this.offScreen && this.gl.commit) {\n      // @ts-expect-error gl.commit is not officially part of WebGLRenderingContext\n      this.gl.commit();\n    }\n  }\n\n  // PRIVATE METHODS\n\n  /**\n   * Creates a context giving access to the WebGL API\n   */\n  _createContext(options?: WebGLDeviceProps): WebGLRenderingContext {\n    const {width, height, canvas} = this.props;\n    // Get or create a canvas\n    const targetCanvas = getCanvas({canvas, width, height});\n    // Create a WebGL context in the canvas\n    return createBrowserContext(targetCanvas, options);\n  }\n}\n\n/*\n// prettier-ignore\nimport {\n  Device, DeviceInfo, DeviceLimits,\n  Buffer, BufferProps\n} from '@luma.gl/api';\n\nimport {getWebGLDeviceInfo} from '../converters/webgl-device-info';\nimport {getWebGLLimits} from '../converters/webgl-limits';\nimport {getWebGLFeatures} from '../converters/webgl-features';\n\nexport default class WEBGLDevice implements Device {\n  readonly handle: WebGLRenderingContext;\n  readonly gl: WebGLRenderingContext;\n  readonly gl2: WebGL2RenderingContext | null;\n  readonly canvas: HTMLCanvasElement;\n\n  static isSupported(options: {canvas?: HTMLCanvasElement}): boolean {\n    const {canvas} = options;\n    let gl;\n    try {\n      gl = canvas && canvas.getContext(\"webgl\");\n      gl = gl && canvas && canvas.getContext(\"experimental-webgl\");\n    } catch (x) {\n      gl = null;\n    }\n    return Boolean(gl);\n  }\n\n  constructor(props = {}) {\n    const {canvas, swapChainFormat = \"bgra8unorm\"} = props;\n\n    const gl = createGLContext(props);\n    this.handle =\n    this.gl = gl;\n    this.gl2 = gl instanceof WebGL2RenderingContext ? gl : null;\n    this.canvas = canvas;\n  }\n\n  resize(width, height) {\n    resizeGLContext(this.gl);\n  }\n\n  getInfo(): DeviceInfo {\n    return getWebGLDeviceInfo(this.gl);\n  }\n\n  getLimits(): DeviceLimits {\n    return getWebGLLimits(this.gl, this.gl2);\n  }\n\n  getFeatures(): string[] {\n    return getWebGLFeatures(this.gl);\n  }\n\n  createBuffer(props: WebGPUBufferProps): WEBGLBuffer {\n    return new WEBGLBuffer(this.gl2 || this.gl, props);\n  }\n\n  createTexture(props: WebGPUTextureProps): WEBGLTexture {\n    return new WEBGLTexture(this, props);\n  }\n\n  createSampler(props: WebGPUSamplerProps): WEBGLSampler {\n    return new WEBGLSampler(this, props);\n  }\n\n  createShader(props: WebGPUShaderProps): WEBGLShader {\n    return new WEBGLShader(this, props);\n  }\n\n  createRenderPipeline(props: WebGPURenderPipelineProps): WEBGLPipeline {\n    return new WEBGLRenderPipeline(this, props);\n  }\n\n  createComputePipeline(props: WebGPUComputePipelineProps): WebGPUPipeline {\n    return new WebGPUComputePipeline(this, props);\n  }\n\n\n  // PRIVATE\n\n  _startFrame() {}\n\n  _endFrame() {}\n}\n*/\n"],"file":"webgl-device.js"}

package/dist/adapter/webgl-shader.d.ts

@@ -0,0 +1,18 @@
+import { Shader, ShaderProps } from '@luma.gl/api';
+import { CompilerMessage } from '@luma.gl/shadertools';
+import WebGLDevice from '../adapter/webgl-device';
+/**
+ * An immutable compiled shader program that execute portions of the GPU Pipeline
+ */
+export declare class WEBGLShader extends Shader {
+    readonly device: WebGLDevice;
+    readonly gl: WebGLRenderingContext;
+    readonly handle: WebGLShader;
+    readonly stage: 'vertex' | 'fragment';
+    readonly source: string;
+    constructor(device: WebGLDevice, props: ShaderProps);
+    destroy(): void;
+    compilationInfo(): Promise<readonly CompilerMessage[]>;
+    _compile(source: any): void;
+}
+//# sourceMappingURL=webgl-shader.d.ts.map

package/dist/adapter/webgl-shader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgl-shader.d.ts","sourceRoot":"","sources":["../../src/adapter/webgl-shader.ts"],"names":[],"mappings":"AACA,OAAO,EAAW,MAAM,EAAE,WAAW,EAAC,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAgB,eAAe,EAAoB,MAAM,sBAAsB,CAAC;AAEvF,OAAO,WAAW,MAAM,yBAAyB,CAAC;AAElD;;GAEG;AACF,qBAAa,WAAY,SAAQ,MAAM;IACtC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,EAAE,EAAE,qBAAqB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,UAAU,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW;IAmBnD,OAAO,IAAI,IAAI;IAST,eAAe,IAAI,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC;IAO5D,QAAQ,CAAC,MAAM,KAAA;CAqBhB"}

package/dist/adapter/webgl-shader.js

@@ -0,0 +1,82 @@
+import _defineProperty from "@babel/runtime/helpers/esm/defineProperty";
+import { log, uid, Shader } from '@luma.gl/api';
+import GL from '@luma.gl/constants';
+import { getShaderInfo, formatCompilerLog } from '@luma.gl/shadertools';
+import { parseShaderCompilerLog } from '../webgl-utils/parse-shader-compiler-log';
+export class WEBGLShader extends Shader {
+  constructor(device, props) {
+    super(device, {
+      id: getShaderIdFromProps(props),
+      ...props
+    });
+
+    _defineProperty(this, "device", void 0);
+
+    _defineProperty(this, "gl", void 0);
+
+    _defineProperty(this, "handle", void 0);
+
+    _defineProperty(this, "stage", void 0);
+
+    _defineProperty(this, "source", void 0);
+
+    this.device = device;
+    this.gl = device.gl;
+
+    switch (this.props.stage) {
+      case 'vertex':
+        this.handle = this.props.handle || this.gl.createShader(GL.VERTEX_SHADER);
+        break;
+
+      case 'fragment':
+        this.handle = this.props.handle || this.gl.createShader(GL.FRAGMENT_SHADER);
+        break;
+
+      default:
+        throw new Error(this.props.stage);
+    }
+
+    this.stage = this.props.stage;
+    this.source = this.props.source;
+
+    this._compile(this.source);
+  }
+
+  destroy() {
+    if (this.handle) {
+      this.removeStats();
+      this.gl.deleteShader(this.handle);
+      this.handle = null;
+    }
+  }
+
+  async compilationInfo() {
+    const log = this.gl.getShaderInfoLog(this.handle);
+    return parseShaderCompilerLog(log);
+  }
+
+  _compile(source) {
+    const addGLSLVersion = source => source.startsWith('#version ') ? source : "#version 100\n".concat(source);
+
+    source = addGLSLVersion(source);
+    this.gl.shaderSource(this.handle, source);
+    this.gl.compileShader(this.handle);
+    const compileStatus = this.gl.getShaderParameter(this.handle, GL.COMPILE_STATUS);
+
+    if (!compileStatus) {
+      const shaderLog = this.gl.getShaderInfoLog(this.handle);
+      const messages = parseShaderCompilerLog(shaderLog).filter(message => message.type === 'error');
+      const formattedLog = formatCompilerLog(messages, source);
+      const shaderName = getShaderInfo(source).name;
+      const shaderDescription = "".concat(this.stage, " shader ").concat(shaderName);
+      log.error("GLSL compilation errors in ".concat(shaderDescription, "\n").concat(formattedLog))();
+      throw new Error("GLSL compilation errors in ".concat(shaderName));
+    }
+  }
+
+}
+
+function getShaderIdFromProps(props) {
+  return getShaderInfo(props.source).name || props.id || uid("unnamed ".concat(props.stage, "-shader"));
+}
+//# sourceMappingURL=webgl-shader.js.map

package/dist/adapter/webgl-shader.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapter/webgl-shader.ts"],"names":["log","uid","Shader","GL","getShaderInfo","formatCompilerLog","parseShaderCompilerLog","WEBGLShader","constructor","device","props","id","getShaderIdFromProps","gl","stage","handle","createShader","VERTEX_SHADER","FRAGMENT_SHADER","Error","source","_compile","destroy","removeStats","deleteShader","compilationInfo","getShaderInfoLog","addGLSLVersion","startsWith","shaderSource","compileShader","compileStatus","getShaderParameter","COMPILE_STATUS","shaderLog","messages","filter","message","type","formattedLog","shaderName","name","shaderDescription","error"],"mappings":"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","sourcesContent":["// luma.gl, MIT license\nimport {log, uid, Shader, ShaderProps} from '@luma.gl/api';\nimport GL from '@luma.gl/constants';\nimport {getShaderInfo, CompilerMessage, formatCompilerLog} from '@luma.gl/shadertools';\nimport {parseShaderCompilerLog} from '../webgl-utils/parse-shader-compiler-log';\nimport WebGLDevice from '../adapter/webgl-device';\n\n/**\n * An immutable compiled shader program that execute portions of the GPU Pipeline\n */\n export class WEBGLShader extends Shader {\n  readonly device: WebGLDevice;\n  readonly gl: WebGLRenderingContext;\n  readonly handle: WebGLShader;\n\n  readonly stage: 'vertex' | 'fragment';\n  readonly source: string;\n\n  constructor(device: WebGLDevice, props: ShaderProps) {\n    super(device, {id: getShaderIdFromProps(props), ...props});\n    this.device = device;\n    this.gl = device.gl;\n    switch (this.props.stage) {\n      case 'vertex':\n        this.handle = this.props.handle || this.gl.createShader(GL.VERTEX_SHADER);\n        break;\n      case 'fragment':\n        this.handle = this.props.handle || this.gl.createShader(GL.FRAGMENT_SHADER);\n        break;\n      default:\n        throw new Error(this.props.stage);\n    }\n    this.stage = this.props.stage;\n    this.source = this.props.source;\n    this._compile(this.source);\n  }\n\n  destroy(): void {\n    if (this.handle) {\n      this.removeStats();\n      this.gl.deleteShader(this.handle);\n      // @ts-expect-error\n      this.handle = null;\n    }\n  }\n\n  async compilationInfo(): Promise<readonly CompilerMessage[]> {\n    const log = this.gl.getShaderInfoLog(this.handle);\n    return parseShaderCompilerLog(log);\n  }\n\n  // PRIVATE METHODS\n\n  _compile(source) {\n    const addGLSLVersion = source => source.startsWith('#version ') ? source : `#version 100\\n${source}`;\n    source = addGLSLVersion(source);\n\n    this.gl.shaderSource(this.handle, source);\n    this.gl.compileShader(this.handle);\n\n    // TODO - For performance reasons, avoid checking shader compilation errors on production?\n    // TODO - Load log even when no error reported, to catch warnings?\n    // https://gamedev.stackexchange.com/questions/30429/how-to-detect-glsl-warnings\n    const compileStatus = this.gl.getShaderParameter(this.handle, GL.COMPILE_STATUS);\n    if (!compileStatus) {\n      const shaderLog = this.gl.getShaderInfoLog(this.handle);\n      const messages = parseShaderCompilerLog(shaderLog).filter(message => message.type === 'error');\n      const formattedLog = formatCompilerLog(messages, source);\n      const shaderName: string = getShaderInfo(source).name;\n      const shaderDescription = `${this.stage} shader ${shaderName}`;\n      log.error(`GLSL compilation errors in ${shaderDescription}\\n${formattedLog}`)();\n      throw new Error(`GLSL compilation errors in ${shaderName}`);\n    }\n  }\n}\n\n// HELPERS\n\n/** Deduce an id, from shader source, or supplied id, or shader type */\nfunction getShaderIdFromProps(props: ShaderProps): string {\n  return getShaderInfo(props.source).name ||\n    props.id ||\n    uid(`unnamed ${props.stage}-shader`);\n}\n"],"file":"webgl-shader.js"}

package/dist/classes/accessor.js

@@ -1,6 +1,6 @@
+import { assert, checkProps } from '@luma.gl/api';
 import GL from '@luma.gl/constants';
-import { getTypedArrayFromGLType } from '../webgl-utils';
-import { checkProps, assert } from '../utils';
+import { getTypedArrayFromGLType } from '../webgl-utils/typed-array-utils';
 const DEFAULT_ACCESSOR_VALUES = {
   offset: 0,
   stride: 0,

package/dist/classes/accessor.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/classes/accessor.js"],"names":["GL","getTypedArrayFromGLType","checkProps","assert","DEFAULT_ACCESSOR_VALUES","offset","stride","type","FLOAT","size","divisor","normalized","integer","PROP_CHECKS","deprecatedProps","instanced","isInstanced","Accessor","getBytesPerElement","accessor","ArrayType","BYTES_PER_ELEMENT","getBytesPerVertex","resolve","accessors","constructor","forEach","_assign","Object","freeze","toString","JSON","stringify","BYTES_PER_VERTEX","props","undefined","INT","UNSIGNED_INT","buffer","index"],"mappings":"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","sourcesContent":["import GL from '@luma.gl/constants';\nimport {getTypedArrayFromGLType} from '../webgl-utils';\nimport {checkProps, assert} from '../utils';\n\nconst DEFAULT_ACCESSOR_VALUES = {\n  offset: 0,\n  stride: 0,\n  type: GL.FLOAT,\n  size: 1,\n  divisor: 0,\n  normalized: false,\n  integer: false\n};\n\nconst PROP_CHECKS = {\n  deprecatedProps: {\n    instanced: 'divisor',\n    isInstanced: 'divisor'\n  }\n};\n\nexport default class Accessor {\n  static getBytesPerElement(accessor) {\n    // TODO: using `FLOAT` when type is not specified,\n    // ensure this assumption is valid or force API to specify type.\n    const ArrayType = getTypedArrayFromGLType(accessor.type || GL.FLOAT);\n    return ArrayType.BYTES_PER_ELEMENT;\n  }\n\n  static getBytesPerVertex(accessor) {\n    assert(accessor.size);\n    // TODO: using `FLOAT` when type is not specified,\n    // ensure this assumption is valid or force API to specify type.\n    const ArrayType = getTypedArrayFromGLType(accessor.type || GL.FLOAT);\n    return ArrayType.BYTES_PER_ELEMENT * accessor.size;\n  }\n\n  // Combines (merges) a list of accessors. On top of default values\n  // Usually [programAccessor, bufferAccessor, appAccessor]\n  // All props will be set in the returned object.\n  // TODO check for conflicts between values in the supplied accessors\n  static resolve(...accessors) {\n    return new Accessor(...[DEFAULT_ACCESSOR_VALUES, ...accessors]); // Default values\n  }\n\n  constructor(...accessors) {\n    accessors.forEach((accessor) => this._assign(accessor)); // Merge in sequence\n    Object.freeze(this);\n  }\n\n  toString() {\n    return JSON.stringify(this);\n  }\n\n  // ACCESSORS\n\n  // TODO - remove>\n  get BYTES_PER_ELEMENT() {\n    return Accessor.getBytesPerElement(this);\n  }\n\n  get BYTES_PER_VERTEX() {\n    return Accessor.getBytesPerVertex(this);\n  }\n\n  // PRIVATE\n\n  // eslint-disable-next-line complexity, max-statements\n  _assign(props = {}) {\n    props = checkProps('Accessor', props, PROP_CHECKS);\n\n    if (props.type !== undefined) {\n      this.type = props.type;\n\n      // Auto-deduce integer type?\n      if (props.type === GL.INT || props.type === GL.UNSIGNED_INT) {\n        this.integer = true;\n      }\n    }\n    if (props.size !== undefined) {\n      this.size = props.size;\n    }\n    if (props.offset !== undefined) {\n      this.offset = props.offset;\n    }\n    if (props.stride !== undefined) {\n      this.stride = props.stride;\n    }\n    if (props.normalized !== undefined) {\n      this.normalized = props.normalized;\n    }\n    if (props.integer !== undefined) {\n      this.integer = props.integer;\n    }\n\n    // INSTANCE DIVISOR\n    if (props.divisor !== undefined) {\n      this.divisor = props.divisor;\n    }\n\n    // Buffer is optional\n    if (props.buffer !== undefined) {\n      this.buffer = props.buffer;\n    }\n\n    // The binding index (for binding e.g. Transform feedbacks and Uniform buffers)\n    // TODO - should this be part of accessor?\n    if (props.index !== undefined) {\n      if (typeof props.index === 'boolean') {\n        this.index = props.index ? 1 : 0;\n      } else {\n        this.index = props.index;\n      }\n    }\n\n    // DEPRECATED\n    if (props.instanced !== undefined) {\n      this.divisor = props.instanced ? 1 : 0;\n    }\n    if (props.isInstanced !== undefined) {\n      this.divisor = props.isInstanced ? 1 : 0;\n    }\n\n    return this;\n  }\n}\n\n// TEST EXPORTS\nexport {DEFAULT_ACCESSOR_VALUES};\n"],"file":"accessor.js"}
+{"version":3,"sources":["../../src/classes/accessor.js"],"names":["assert","checkProps","GL","getTypedArrayFromGLType","DEFAULT_ACCESSOR_VALUES","offset","stride","type","FLOAT","size","divisor","normalized","integer","PROP_CHECKS","deprecatedProps","instanced","isInstanced","Accessor","getBytesPerElement","accessor","ArrayType","BYTES_PER_ELEMENT","getBytesPerVertex","resolve","accessors","constructor","forEach","_assign","Object","freeze","toString","JSON","stringify","BYTES_PER_VERTEX","props","undefined","INT","UNSIGNED_INT","buffer","index"],"mappings":"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","sourcesContent":["import {assert, checkProps} from '@luma.gl/api';\nimport GL from '@luma.gl/constants';\nimport {getTypedArrayFromGLType} from '../webgl-utils/typed-array-utils';\n\nconst DEFAULT_ACCESSOR_VALUES = {\n  offset: 0,\n  stride: 0,\n  type: GL.FLOAT,\n  size: 1,\n  divisor: 0,\n  normalized: false,\n  integer: false\n};\n\nconst PROP_CHECKS = {\n  deprecatedProps: {\n    instanced: 'divisor',\n    isInstanced: 'divisor'\n  }\n};\n\nexport default class Accessor {\n  static getBytesPerElement(accessor) {\n    // TODO: using `FLOAT` when type is not specified,\n    // ensure this assumption is valid or force API to specify type.\n    const ArrayType = getTypedArrayFromGLType(accessor.type || GL.FLOAT);\n    return ArrayType.BYTES_PER_ELEMENT;\n  }\n\n  static getBytesPerVertex(accessor) {\n    assert(accessor.size);\n    // TODO: using `FLOAT` when type is not specified,\n    // ensure this assumption is valid or force API to specify type.\n    const ArrayType = getTypedArrayFromGLType(accessor.type || GL.FLOAT);\n    return ArrayType.BYTES_PER_ELEMENT * accessor.size;\n  }\n\n  // Combines (merges) a list of accessors. On top of default values\n  // Usually [programAccessor, bufferAccessor, appAccessor]\n  // All props will be set in the returned object.\n  // TODO check for conflicts between values in the supplied accessors\n  static resolve(...accessors) {\n    return new Accessor(...[DEFAULT_ACCESSOR_VALUES, ...accessors]); // Default values\n  }\n\n  constructor(...accessors) {\n    accessors.forEach((accessor) => this._assign(accessor)); // Merge in sequence\n    Object.freeze(this);\n  }\n\n  toString() {\n    return JSON.stringify(this);\n  }\n\n  // ACCESSORS\n\n  // TODO - remove>\n  get BYTES_PER_ELEMENT() {\n    return Accessor.getBytesPerElement(this);\n  }\n\n  get BYTES_PER_VERTEX() {\n    return Accessor.getBytesPerVertex(this);\n  }\n\n  // PRIVATE\n\n  // eslint-disable-next-line complexity, max-statements\n  _assign(props = {}) {\n    props = checkProps('Accessor', props, PROP_CHECKS);\n\n    if (props.type !== undefined) {\n      this.type = props.type;\n\n      // Auto-deduce integer type?\n      if (props.type === GL.INT || props.type === GL.UNSIGNED_INT) {\n        this.integer = true;\n      }\n    }\n    if (props.size !== undefined) {\n      this.size = props.size;\n    }\n    if (props.offset !== undefined) {\n      this.offset = props.offset;\n    }\n    if (props.stride !== undefined) {\n      this.stride = props.stride;\n    }\n    if (props.normalized !== undefined) {\n      this.normalized = props.normalized;\n    }\n    if (props.integer !== undefined) {\n      this.integer = props.integer;\n    }\n\n    // INSTANCE DIVISOR\n    if (props.divisor !== undefined) {\n      this.divisor = props.divisor;\n    }\n\n    // Buffer is optional\n    if (props.buffer !== undefined) {\n      this.buffer = props.buffer;\n    }\n\n    // The binding index (for binding e.g. Transform feedbacks and Uniform buffers)\n    // TODO - should this be part of accessor?\n    if (props.index !== undefined) {\n      if (typeof props.index === 'boolean') {\n        this.index = props.index ? 1 : 0;\n      } else {\n        this.index = props.index;\n      }\n    }\n\n    // DEPRECATED\n    if (props.instanced !== undefined) {\n      this.divisor = props.instanced ? 1 : 0;\n    }\n    if (props.isInstanced !== undefined) {\n      this.divisor = props.isInstanced ? 1 : 0;\n    }\n\n    return this;\n  }\n}\n\n// TEST EXPORTS\nexport {DEFAULT_ACCESSOR_VALUES};\n"],"file":"accessor.js"}

package/dist/classes/accessor.ts.disabled

@@ -1,6 +1,6 @@
 import GL from '@luma.gl/constants';
 import {getTypedArrayFromGLType} from '../webgl-utils';
-import {checkProps, assert} from '../utils';
+import {checkProps, assert} from '../utils/index';
 import {Buffer} from '@luma.gl/core/';
 
 export interface AccessorObject {

package/dist/classes/clear.d.ts

@@ -1,13 +1,14 @@
+import { Device } from '@luma.gl/api';
 import Framebuffer from './framebuffer';
 /** Optionally clears depth, color and stencil buffers */
-export declare function clear(gl: WebGLRenderingContext, options?: {
+export declare function clear(device: Device | WebGLRenderingContext, options?: {
     framebuffer?: Framebuffer;
     color?: any;
     depth?: any;
     stencil?: any;
 }): void;
 /** WebGL2 - clear a specific drawing buffer */
-export declare function clearBuffer(gl: any, options?: {
+export declare function clearBuffer(device: Device | WebGLRenderingContext, options?: {
     framebuffer?: Framebuffer;
     buffer?: any;
     drawBuffer?: any;

package/dist/classes/clear.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clear.d.ts","sourceRoot":"","sources":["../../src/classes/clear.ts"],"names":[],"mappings":"AAEA,OAAO,WAAW,MAAM,eAAe,CAAC;AAexC,yDAAyD;AACzD,wBAAgB,KAAK,CACnB,EAAE,EAAE,qBAAqB,EACzB,OAAO,CAAC,EAAE;IAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IAAC,KAAK,CAAC,EAAE,GAAG,CAAC;IAAC,KAAK,CAAC,EAAE,GAAG,CAAC;IAAC,OAAO,CAAC,EAAE,GAAG,CAAA;CAAC,GAC7E,IAAI,CAqCN;AAED,+CAA+C;AAC/C,wBAAgB,WAAW,CACzB,EAAE,EAAE,GAAG,EACP,OAAO,CAAC,EAAE;IAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IAAC,MAAM,CAAC,EAAE,GAAG,CAAC;IAAC,UAAU,CAAC,EAAE,GAAG,CAAC;IAAC,KAAK,CAAC,EAAE,GAAG,CAAA;CAAC,QAuCnF"}
+{"version":3,"file":"clear.d.ts","sourceRoot":"","sources":["../../src/classes/clear.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAS,MAAM,cAAc,CAAC;AAG5C,OAAO,WAAW,MAAM,eAAe,CAAC;AAexC,yDAAyD;AACzD,wBAAgB,KAAK,CACnB,MAAM,EAAE,MAAM,GAAG,qBAAqB,EACtC,OAAO,CAAC,EAAE;IAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IAAC,KAAK,CAAC,EAAE,GAAG,CAAC;IAAC,KAAK,CAAC,EAAE,GAAG,CAAC;IAAC,OAAO,CAAC,EAAE,GAAG,CAAA;CAAC,GAC7E,IAAI,CAuCN;AAED,+CAA+C;AAC/C,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,GAAG,qBAAqB,EACtC,OAAO,CAAC,EAAE;IAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IAAC,MAAM,CAAC,EAAE,GAAG,CAAC;IAAC,UAAU,CAAC,EAAE,GAAG,CAAC;IAAC,KAAK,CAAC,EAAE,GAAG,CAAA;CAAC,QAyCnF"}

package/dist/classes/clear.js

@@ -1,5 +1,6 @@
-import { assertWebGL2Context, withParameters } from '@luma.gl/gltools';
-import { assert } from '../utils';
+import { assert } from '@luma.gl/api';
+import { assertWebGL2Context } from '../context/context/webgl-checks';
+import { withParameters } from '../context/state-tracker/with-parameters';
 const GL_DEPTH_BUFFER_BIT = 0x00000100;
 const GL_STENCIL_BUFFER_BIT = 0x00000400;
 const GL_COLOR_BUFFER_BIT = 0x00004000;
@@ -8,7 +9,8 @@ const GL_DEPTH = 0x1801;
 const GL_STENCIL = 0x1802;
 const GL_DEPTH_STENCIL = 0x84f9;
 const ERR_ARGUMENTS = 'clear: bad arguments';
-export function clear(gl, options) {
+export function clear(device, options) {
+  const gl = device.gl || device;
   const {
     framebuffer = null,
     color = null,
@@ -52,7 +54,8 @@ export function clear(gl, options) {
     gl.clear(clearFlags);
   });
 }
-export function clearBuffer(gl, options) {
+export function clearBuffer(device, options) {
+  const gl = device.gl || device;
   assertWebGL2Context(gl);
   const {
     framebuffer = null,

package/dist/classes/clear.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/classes/clear.ts"],"names":["assertWebGL2Context","withParameters","assert","GL_DEPTH_BUFFER_BIT","GL_STENCIL_BUFFER_BIT","GL_COLOR_BUFFER_BIT","GL_COLOR","GL_DEPTH","GL_STENCIL","GL_DEPTH_STENCIL","ERR_ARGUMENTS","clear","gl","options","framebuffer","color","depth","stencil","parameters","clearFlags","clearColor","clearDepth","clearStencil","clearBuffer","buffer","drawBuffer","value","constructor","Int32Array","clearBufferiv","Uint32Array","clearBufferuiv","Float32Array","clearBufferfv","clearBufferfi"],"mappings":"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","sourcesContent":["import {assertWebGL2Context, withParameters} from '@luma.gl/gltools';\nimport {assert} from '../utils';\nimport Framebuffer from './framebuffer';\n\n// Should collapse during minification\nconst GL_DEPTH_BUFFER_BIT = 0x00000100;\nconst GL_STENCIL_BUFFER_BIT = 0x00000400;\nconst GL_COLOR_BUFFER_BIT = 0x00004000;\n\nconst GL_COLOR = 0x1800;\nconst GL_DEPTH = 0x1801;\nconst GL_STENCIL = 0x1802;\nconst GL_DEPTH_STENCIL = 0x84f9;\n\n// Should disappear if asserts are removed\nconst ERR_ARGUMENTS = 'clear: bad arguments';\n\n/** Optionally clears depth, color and stencil buffers */\nexport function clear(\n  gl: WebGLRenderingContext,\n  options?: {framebuffer?: Framebuffer; color?: any; depth?: any; stencil?: any}\n): void {\n  const {framebuffer = null, color = null, depth = null, stencil = null} = options || {};\n  const parameters: any = {};\n\n  if (framebuffer) {\n    parameters.framebuffer = framebuffer;\n  }\n\n  let clearFlags = 0;\n\n  if (color) {\n    clearFlags |= GL_COLOR_BUFFER_BIT;\n    if (color !== true) {\n      parameters.clearColor = color;\n    }\n  }\n\n  if (depth) {\n    clearFlags |= GL_DEPTH_BUFFER_BIT;\n    if (depth !== true) {\n      parameters.clearDepth = depth;\n    }\n  }\n\n  if (stencil) {\n    clearFlags |= GL_STENCIL_BUFFER_BIT;\n    if (depth !== true) {\n      parameters.clearStencil = depth;\n    }\n  }\n\n  assert(clearFlags !== 0, ERR_ARGUMENTS);\n\n  // Temporarily set any clear \"colors\" and call clear\n  withParameters(gl, parameters, () => {\n    gl.clear(clearFlags);\n  });\n}\n\n/** WebGL2 - clear a specific drawing buffer */\nexport function clearBuffer(\n  gl: any,\n  options?: {framebuffer?: Framebuffer; buffer?: any; drawBuffer?: any; value?: any}\n) {\n  assertWebGL2Context(gl);\n\n  const {framebuffer = null, buffer = GL_COLOR, drawBuffer = 0, value = [0, 0, 0, 0]} = options || {};\n  withParameters(gl, {framebuffer}, () => {\n    // Method selection per OpenGL ES 3 docs\n    switch (buffer) {\n      case GL_COLOR:\n        switch (value.constructor) {\n          case Int32Array:\n            gl.clearBufferiv(buffer, drawBuffer, value);\n            break;\n          case Uint32Array:\n            gl.clearBufferuiv(buffer, drawBuffer, value);\n            break;\n          case Float32Array:\n          default:\n            gl.clearBufferfv(buffer, drawBuffer, value);\n        }\n        break;\n\n      case GL_DEPTH:\n        gl.clearBufferfv(GL_DEPTH, 0, [value]);\n        break;\n\n      case GL_STENCIL:\n        gl.clearBufferiv(GL_STENCIL, 0, [value]);\n        break;\n\n      case GL_DEPTH_STENCIL:\n        const [depth, stencil] = value;\n        gl.clearBufferfi(GL_DEPTH_STENCIL, 0, depth, stencil);\n        break;\n\n      default:\n        assert(false, ERR_ARGUMENTS);\n    }\n  });\n}\n"],"file":"clear.js"}
+{"version":3,"sources":["../../src/classes/clear.ts"],"names":["assert","assertWebGL2Context","withParameters","GL_DEPTH_BUFFER_BIT","GL_STENCIL_BUFFER_BIT","GL_COLOR_BUFFER_BIT","GL_COLOR","GL_DEPTH","GL_STENCIL","GL_DEPTH_STENCIL","ERR_ARGUMENTS","clear","device","options","gl","framebuffer","color","depth","stencil","parameters","clearFlags","clearColor","clearDepth","clearStencil","clearBuffer","buffer","drawBuffer","value","constructor","Int32Array","clearBufferiv","Uint32Array","clearBufferuiv","Float32Array","clearBufferfv","clearBufferfi"],"mappings":"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","sourcesContent":["import {Device, assert} from '@luma.gl/api';\nimport {assertWebGL2Context} from '../context/context/webgl-checks';\nimport {withParameters} from '../context/state-tracker/with-parameters';\nimport Framebuffer from './framebuffer';\n\n// Should collapse during minification\nconst GL_DEPTH_BUFFER_BIT = 0x00000100;\nconst GL_STENCIL_BUFFER_BIT = 0x00000400;\nconst GL_COLOR_BUFFER_BIT = 0x00004000;\n\nconst GL_COLOR = 0x1800;\nconst GL_DEPTH = 0x1801;\nconst GL_STENCIL = 0x1802;\nconst GL_DEPTH_STENCIL = 0x84f9;\n\n// Should disappear if asserts are removed\nconst ERR_ARGUMENTS = 'clear: bad arguments';\n\n/** Optionally clears depth, color and stencil buffers */\nexport function clear(\n  device: Device | WebGLRenderingContext,\n  options?: {framebuffer?: Framebuffer; color?: any; depth?: any; stencil?: any}\n): void {\n  // @ts-expect-error Extract context\n  const gl = device.gl || device;\n  const {framebuffer = null, color = null, depth = null, stencil = null} = options || {};\n  const parameters: any = {};\n\n  if (framebuffer) {\n    parameters.framebuffer = framebuffer;\n  }\n\n  let clearFlags = 0;\n\n  if (color) {\n    clearFlags |= GL_COLOR_BUFFER_BIT;\n    if (color !== true) {\n      parameters.clearColor = color;\n    }\n  }\n\n  if (depth) {\n    clearFlags |= GL_DEPTH_BUFFER_BIT;\n    if (depth !== true) {\n      parameters.clearDepth = depth;\n    }\n  }\n\n  if (stencil) {\n    clearFlags |= GL_STENCIL_BUFFER_BIT;\n    if (depth !== true) {\n      parameters.clearStencil = depth;\n    }\n  }\n\n  assert(clearFlags !== 0, ERR_ARGUMENTS);\n\n  // Temporarily set any clear \"colors\" and call clear\n  withParameters(gl, parameters, () => {\n    gl.clear(clearFlags);\n  });\n}\n\n/** WebGL2 - clear a specific drawing buffer */\nexport function clearBuffer(\n  device: Device | WebGLRenderingContext,\n  options?: {framebuffer?: Framebuffer; buffer?: any; drawBuffer?: any; value?: any}\n) {\n  // @ts-expect-error Extract context\n  const gl = device.gl || device;\n  assertWebGL2Context(gl);\n\n  const {framebuffer = null, buffer = GL_COLOR, drawBuffer = 0, value = [0, 0, 0, 0]} = options || {};\n  withParameters(gl, {framebuffer}, () => {\n    // Method selection per OpenGL ES 3 docs\n    switch (buffer) {\n      case GL_COLOR:\n        switch (value.constructor) {\n          case Int32Array:\n            gl.clearBufferiv(buffer, drawBuffer, value);\n            break;\n          case Uint32Array:\n            gl.clearBufferuiv(buffer, drawBuffer, value);\n            break;\n          case Float32Array:\n          default:\n            gl.clearBufferfv(buffer, drawBuffer, value);\n        }\n        break;\n\n      case GL_DEPTH:\n        gl.clearBufferfv(GL_DEPTH, 0, [value]);\n        break;\n\n      case GL_STENCIL:\n        gl.clearBufferiv(GL_STENCIL, 0, [value]);\n        break;\n\n      case GL_DEPTH_STENCIL:\n        const [depth, stencil] = value;\n        gl.clearBufferfi(GL_DEPTH_STENCIL, 0, depth, stencil);\n        break;\n\n      default:\n        assert(false, ERR_ARGUMENTS);\n    }\n  });\n}\n"],"file":"clear.js"}

package/dist/classes/copy-and-blit.d.ts

@@ -1,6 +1,17 @@
+import GL from '@luma.gl/constants';
 import Buffer from './webgl-buffer';
 import Framebuffer from './framebuffer';
 import Texture from './texture';
+/**
+ * Copies data from a Framebuffer or a Texture object into ArrayBuffer object.
+ * App can provide targetPixelArray or have it auto allocated by this method
+ *  newly allocated by this method unless provided by app.
+ * @note Slow requires roundtrip to GPU
+ *
+ * @param source
+ * @param options
+// @returns {Uint8Array|Uint16Array|FloatArray} - pixel array,
+ */
 export declare function readPixelsToArray(source: Framebuffer | Texture, options?: {
     sourceX?: number;
     sourceY?: number;
@@ -11,6 +22,12 @@ export declare function readPixelsToArray(source: Framebuffer | Texture, options
     sourceHeight?: number;
     sourceType?: number;
 }): Uint8Array | Uint16Array | Float32Array;
+/**
+ * Copies data from a Framebuffer or a Texture object into a Buffer object.
+ * NOTE: doesn't wait for copy to be complete, it programs GPU to perform a DMA transffer.
+ * @param source
+ * @param options
+ */
 export declare function readPixelsToBuffer(source: Framebuffer | Texture, options?: {
     sourceX?: number;
     sourceY?: number;
@@ -32,7 +49,7 @@ export declare function copyToImage(source: Framebuffer | Texture, options?: {
 /**
  * Copy a rectangle from a Framebuffer or Texture object into a texture (at an offset)
  */
-export declare function copyToTexture(source: Framebuffer | Texture, target: Texture, options?: {
+export declare function copyToTexture(source: Framebuffer | Texture, target: Texture | GL, options?: {
     sourceX?: number;
     sourceY?: number;
     targetX?: number;

package/dist/classes/copy-and-blit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"copy-and-blit.d.ts","sourceRoot":"","sources":["../../src/classes/copy-and-blit.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"copy-and-blit.d.ts","sourceRoot":"","sources":["../../src/classes/copy-and-blit.ts"],"names":[],"mappings":"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"}