@luma.gl/webgl 9.0.0-alpha.34 → 9.0.0-alpha.36

package/src/context/state-tracker/track-context-state.ts

@@ -2,7 +2,7 @@
 // NOTE: this system does not handle buffer bindings
 import {assert} from '@luma.gl/core';
 import {GL_PARAMETER_DEFAULTS, GL_HOOKED_SETTERS, NON_CACHE_PARAMETERS} from '../parameters/webgl-parameter-tables';
-import {setParameters, getParameters} from '../parameters/unified-parameter-api';
+import {setGLParameters, getGLParameters} from '../parameters/unified-parameter-api';
 import {deepArrayEqual} from './deep-array-equal';
 
 // HELPER CLASS - GLState
@@ -24,7 +24,7 @@ class GLState {
     } = {}
   ) {
     this.gl = gl;
-    this.cache = copyState ? getParameters(gl) : Object.assign({}, GL_PARAMETER_DEFAULTS);
+    this.cache = copyState ? getGLParameters(gl) : Object.assign({}, GL_PARAMETER_DEFAULTS);
     this.log = log;
 
     this._updateCache = this._updateCache.bind(this);
@@ -39,7 +39,7 @@ class GLState {
     assert(this.stateStack.length > 0);
     // Use the saved values in the state stack to restore parameters
     const oldValues = this.stateStack[this.stateStack.length - 1];
-    setParameters(this.gl, oldValues);
+    setGLParameters(this.gl, oldValues);
     // Don't pop until we have reset parameters (to make sure other "stack frames" are not affected)
     this.stateStack.pop();
   }

package/src/context/state-tracker/with-parameters.ts

@@ -1,6 +1,6 @@
 import type {Device} from '@luma.gl/core';
 import {WebGLDevice} from '../../adapter/webgl-device';
-import {GLParameters, setParameters} from '../parameters/unified-parameter-api';
+import {GLParameters, setGLParameters} from '../parameters/unified-parameter-api';
 import {pushContextState, popContextState} from './track-context-state';
 
 /**
@@ -11,7 +11,7 @@ import {pushContextState, popContextState} from './track-context-state';
  * - Restores parameters
  * - Returns the return value of the supplied function
  */
-export function withParameters(device: Device | WebGLRenderingContext, parameters: GLParameters & {nocatch?: boolean}, func: any): any {
+export function withGLParameters(device: Device | WebGLRenderingContext, parameters: GLParameters & {nocatch?: boolean}, func: any): any {
   const webglDevice = WebGLDevice.attach(device);
   const gl = webglDevice.gl;
 
@@ -23,7 +23,7 @@ export function withParameters(device: Device | WebGLRenderingContext, parameter
   const {nocatch = true} = parameters;
 
   pushContextState(gl);
-  setParameters(gl, parameters);
+  setGLParameters(gl, parameters);
 
   // Setup is done, call the function
   let value;

package/src/index.ts

@@ -27,11 +27,11 @@ export {WEBGLRenderPipeline} from './adapter/resources/webgl-render-pipeline';
 export {WEBGLCommandEncoder} from './adapter/resources/webgl-command-encoder';
 export {WEBGLRenderPass} from './adapter/resources/webgl-render-pass';
 // export {WEBGLComputePass} from './adapter/resources/webgl-compute-pass';
+export {WEBGLVertexArray} from './adapter/resources/webgl-vertex-array';
 
 // non-api resources
 export type {RenderbufferProps} from './adapter/objects/webgl-renderbuffer';
 export {WEBGLRenderbuffer} from './adapter/objects/webgl-renderbuffer';
-export {WEBGLVertexArrayObject} from './adapter/objects/webgl-vertex-array-object';
 
 // WebGL adapter classes (Legacy will likely be removed)
 export {Accessor} from './classic/accessor';
@@ -53,32 +53,54 @@ export {setDeviceParameters, withDeviceParameters} from './adapter/converters/de
 
 export type {GLParameters} from '@luma.gl/constants';
 export {
-  getParameters,
-  setParameters,
-  resetParameters
+  getGLParameters,
+  setGLParameters,
+  resetGLParameters
 } from './context/parameters/unified-parameter-api';
 
+export {withGLParameters} from './context/state-tracker/with-parameters';
+
+// HELPERS - EXPERIMENTAL
+export {getShaderLayout} from './adapter/helpers/get-shader-layout';
 export {
-  withParameters
-} from './context/state-tracker/with-parameters';
+  convertGLToTextureFormat,
+  _checkFloat32ColorAttachment
+} from './adapter/converters/texture-formats';
 
+// TEST EXPORTS
+export {TEXTURE_FORMATS as _TEXTURE_FORMATS} from './adapter/converters/texture-formats';
+
+// DEPRECATED EXPORTS
+export {clear} from './classic/clear';
+export {readPixelsToBuffer, readPixelsToArray, copyToTexture} from './classic/copy-and-blit';
 // State tracking
 export {
   trackContextState,
   pushContextState,
   popContextState
 } from './context/state-tracker/track-context-state';
-
 // Polyfills (supports a subset of WebGL2 APIs on WebGL1 contexts)
 export {polyfillContext} from './context/polyfill/polyfill-context';
 
 // HELPERS - EXPERIMENTAL
-export {getShaderLayout} from './adapter/helpers/get-shader-layout';
-export {convertGLToTextureFormat, _checkFloat32ColorAttachment} from './adapter/converters/texture-formats';
-
-// TEST EXPORTS
-export {TEXTURE_FORMATS as _TEXTURE_FORMATS} from './adapter/converters/texture-formats';
-
-// DEPRECATED EXPORTS
-export {clear} from './classic/clear';
-export {readPixelsToBuffer, readPixelsToArray, copyToTexture} from './classic/copy-and-blit';
+// export {getShaderLayout, getProgramBindings} from './adapter/helpers/get-shader-layout';
+// export {convertGLToTextureFormat, _checkFloat32ColorAttachment} from './adapter/converters/texture-formats';
+// export {TEXTURE_FORMATS as _TEXTURE_FORMATS} from './adapter/converters/texture-formats';
+
+// // WebGL Types - Experimental exports
+// export type {
+//   GLDrawMode,
+//   GLPrimitive,
+//   GLDataType,
+//   GLPixelType,
+//   GLUniformType,
+//   GLSamplerType,
+//   GLCompositeType,
+//   GLFunction,
+//   GLBlendEquation,
+//   GLBlendFunction,
+//   GLStencilOp,
+//   GLSamplerParameters,
+//   GLValueParameters,
+//   GLFunctionParameters
+// } from '@luma.gl/constants';

package/dist/adapter/objects/webgl-vertex-array-object.d.ts

@@ -1,55 +0,0 @@
-import type { Device, Buffer, ResourceProps, TypedArray } from '@luma.gl/core';
-import { WebGLResource } from './webgl-resource';
-import { WEBGLBuffer } from '../resources/webgl-buffer';
-import { AccessorObject } from '../..';
-/**
- * VertexArrayObject properties
- * @param constantAttributeZero Attribute 0 can not be disable on most desktop OpenGL based browsers
- * and on iOS Safari browser.
- */
-export type VertexArrayObjectProps = ResourceProps & {
-    constantAttributeZero?: boolean;
-};
-/** VertexArrayObject wrapper */
-export declare class WEBGLVertexArrayObject extends WebGLResource<VertexArrayObjectProps> {
-    get [Symbol.toStringTag](): string;
-    /** Buffer constant */
-    private buffer;
-    private bufferValue;
-    static isConstantAttributeZeroSupported(device: Device): boolean;
-    constructor(device: Device, props?: VertexArrayObjectProps);
-    destroy(): void;
-    _createHandle(): WebGLVertexArrayObject;
-    _deleteHandle(): void;
-    _bindHandle(handle: WEBGLVertexArrayObject): void;
-    /**
-     * Enabling an attribute location makes it reference the currently bound buffer
-     *  Disabling an attribute location makes it reference the global constant value
-     * TODO - handle single values for size 1 attributes?
-     * TODO - convert classic arrays based on known type?
-     */
-    enable(location: number, enable?: boolean): void;
-    setElementBuffer(elementBuffer?: WEBGLBuffer | null, opts?: {}): void;
-    /** Set a location in vertex attributes array to a buffer, enables the location, sets divisor */
-    setBuffer(location: number, buffer: WEBGLBuffer, accessor: AccessorObject): void;
-    /**
-     * Set an attribute to a constant value
-     * @param device
-     * @param location
-     * @param array
-     *
-     * @note Constants are stored globally on the WebGL context, not the VAO
-     * so they need to be updated before every render
-     * @todo - use known type (in configuration or passed in) to allow non-typed arrays?
-     * @todo - remember/cache values to avoid setting them unnecessarily?
-     */
-    setConstant(location: any, array: TypedArray): void;
-    /**
-     * Provide a means to create a buffer that is equivalent to a constant.
-     * NOTE: Desktop OpenGL cannot disable attribute 0.
-     * https://stackoverflow.com/questions/20305231/webgl-warning-attribute-0-is-disabled-
-     * this-has-significant-performance-penalty
-     */
-    getConstantBuffer(elementCount: number, value: any): Buffer;
-}
-//# sourceMappingURL=webgl-vertex-array-object.d.ts.map

package/dist/adapter/objects/webgl-vertex-array-object.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"webgl-vertex-array-object.d.ts","sourceRoot":"","sources":["../../../src/adapter/objects/webgl-vertex-array-object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,UAAU,EAAe,MAAM,eAAe,CAAC;AAM3F,OAAO,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAC,WAAW,EAAC,MAAM,2BAA2B,CAAC;AAGtD,OAAO,EAAC,cAAc,EAAC,MAAM,OAAO,CAAC;AAIrC;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,aAAa,GAAG;IACnD,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF,gCAAgC;AAChC,qBAAa,sBAAuB,SAAQ,aAAa,CAAC,sBAAsB,CAAC;IAC/E,IAAa,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAE1C;IAED,sBAAsB;IACtB,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,WAAW,CAAQ;IAE3B,MAAM,CAAC,gCAAgC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;gBAKpD,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,sBAAsB;IAKjD,OAAO,IAAI,IAAI;IAMf,aAAa;IAIb,aAAa,IAAI,IAAI;IAOrB,WAAW,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI;IAI1D;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,UAAO,GAAG,IAAI;IAgB7C,gBAAgB,CAAC,aAAa,GAAE,WAAW,GAAG,IAAW,EAAE,IAAI,KAAK;IASpE,gGAAgG;IAChG,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI;IA+BhF;;;;;;;;;;OAUG;IACH,WAAW,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAgBnD;;;;;OAKG;IACH,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,KAAA,GAAG,MAAM;CA2BvD"}

package/dist/adapter/objects/webgl-vertex-array-object.js

@@ -1,173 +0,0 @@
-let _Symbol$toStringTag;
-import { Resource, assert, getScratchArray, fillArray } from '@luma.gl/core';
-import { GL } from '@luma.gl/constants';
-import { getBrowser } from '@probe.gl/env';
-import { WebGLResource } from "./webgl-resource.js";
-const ERR_ELEMENTS = 'elements must be GL.ELEMENT_ARRAY_BUFFER';
-_Symbol$toStringTag = Symbol.toStringTag;
-export class WEBGLVertexArrayObject extends WebGLResource {
-  get [_Symbol$toStringTag]() {
-    return 'BaseVertexArrayObject';
-  }
-  static isConstantAttributeZeroSupported(device) {
-    return device.info.type === 'webgl2' || getBrowser() === 'Chrome';
-  }
-  constructor(device, props) {
-    super(device, props, {
-      ...Resource.defaultProps,
-      constantAttributeZero: false
-    });
-    this.buffer = null;
-    this.bufferValue = null;
-    Object.seal(this);
-  }
-  destroy() {
-    super.destroy();
-    if (this.buffer) {
-      var _this$buffer;
-      (_this$buffer = this.buffer) === null || _this$buffer === void 0 ? void 0 : _this$buffer.destroy();
-    }
-  }
-  _createHandle() {
-    return this.gl2.createVertexArray();
-  }
-  _deleteHandle() {
-    this.gl2.deleteVertexArray(this.handle);
-    return [this.elements];
-  }
-  _bindHandle(handle) {
-    this.gl2.bindVertexArray(handle);
-  }
-  enable(location) {
-    let enable = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
-    const canDisableAttributeZero = this.device.isWebGL2 || getBrowser() === 'Chrome';
-    const canDisableAttribute = canDisableAttributeZero || location !== 0;
-    if (enable || canDisableAttribute) {
-      location = Number(location);
-      this.bind(() => enable ? this.gl.enableVertexAttribArray(location) : this.gl.disableVertexAttribArray(location));
-    }
-  }
-  setElementBuffer() {
-    let elementBuffer = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : null;
-    let opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
-    assert(!elementBuffer || elementBuffer.glTarget === GL.ELEMENT_ARRAY_BUFFER, ERR_ELEMENTS);
-    this.bind(() => {
-      this.gl.bindBuffer(GL.ELEMENT_ARRAY_BUFFER, elementBuffer ? elementBuffer.handle : null);
-    });
-  }
-  setBuffer(location, buffer, accessor) {
-    if (buffer.glTarget === GL.ELEMENT_ARRAY_BUFFER) {
-      this.setElementBuffer(buffer, accessor);
-      return;
-    }
-    const {
-      size,
-      type,
-      stride,
-      offset,
-      normalized,
-      integer,
-      divisor
-    } = accessor;
-    const {
-      gl,
-      gl2
-    } = this;
-    location = Number(location);
-    this.bind(() => {
-      gl.bindBuffer(gl.ARRAY_BUFFER, buffer.handle);
-      if (integer) {
-        this.device.assertWebGL2();
-        gl2.vertexAttribIPointer(location, size, type, stride, offset);
-      } else {
-        gl.vertexAttribPointer(location, size, type, normalized, stride, offset);
-      }
-      gl.enableVertexAttribArray(location);
-      gl2.vertexAttribDivisor(location, divisor || 0);
-    });
-  }
-  setConstant(location, array) {
-    switch (array.constructor) {
-      case Float32Array:
-        setConstantFloatArray(this.device, location, array);
-        break;
-      case Int32Array:
-        setConstantIntArray(this.device, location, array);
-        break;
-      case Uint32Array:
-        setConstantUintArray(this.device, location, array);
-        break;
-      default:
-        assert(false);
-    }
-  }
-  getConstantBuffer(elementCount, value) {
-    const constantValue = normalizeConstantArrayValue(value);
-    const byteLength = constantValue.byteLength * elementCount;
-    const length = constantValue.length * elementCount;
-    let updateNeeded = !this.buffer;
-    this.buffer = this.buffer || this.device.createBuffer({
-      byteLength
-    });
-    updateNeeded = updateNeeded || this.buffer.reallocate(byteLength);
-    updateNeeded = updateNeeded || !compareConstantArrayValues(constantValue, this.bufferValue);
-    if (updateNeeded) {
-      const typedArray = getScratchArray(value.constructor, length);
-      fillArray({
-        target: typedArray,
-        source: constantValue,
-        start: 0,
-        count: length
-      });
-      this.buffer.subData(typedArray);
-      this.bufferValue = value;
-    }
-    return this.buffer;
-  }
-}
-function setConstantFloatArray(device, location, array) {
-  switch (array.length) {
-    case 1:
-      device.gl.vertexAttrib1fv(location, array);
-      break;
-    case 2:
-      device.gl.vertexAttrib2fv(location, array);
-      break;
-    case 3:
-      device.gl.vertexAttrib3fv(location, array);
-      break;
-    case 4:
-      device.gl.vertexAttrib4fv(location, array);
-      break;
-    default:
-      assert(false);
-  }
-}
-function setConstantIntArray(device, location, array) {
-  var _device$gl;
-  device.assertWebGL2();
-  (_device$gl = device.gl2) === null || _device$gl === void 0 ? void 0 : _device$gl.vertexAttribI4iv(location, array);
-}
-function setConstantUintArray(device, location, array) {
-  var _device$gl2;
-  device.assertWebGL2();
-  (_device$gl2 = device.gl2) === null || _device$gl2 === void 0 ? void 0 : _device$gl2.vertexAttribI4uiv(location, array);
-}
-function normalizeConstantArrayValue(arrayValue) {
-  if (Array.isArray(arrayValue)) {
-    return new Float32Array(arrayValue);
-  }
-  return arrayValue;
-}
-function compareConstantArrayValues(v1, v2) {
-  if (!v1 || !v2 || v1.length !== v2.length || v1.constructor !== v2.constructor) {
-    return false;
-  }
-  for (let i = 0; i < v1.length; ++i) {
-    if (v1[i] !== v2[i]) {
-      return false;
-    }
-  }
-  return true;
-}
-//# sourceMappingURL=webgl-vertex-array-object.js.map

package/dist/adapter/objects/webgl-vertex-array-object.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"webgl-vertex-array-object.js","names":["Resource","assert","getScratchArray","fillArray","GL","getBrowser","WebGLResource","ERR_ELEMENTS","_Symbol$toStringTag","Symbol","toStringTag","WEBGLVertexArrayObject","isConstantAttributeZeroSupported","device","info","type","constructor","props","defaultProps","constantAttributeZero","buffer","bufferValue","Object","seal","destroy","_this$buffer","_createHandle","gl2","createVertexArray","_deleteHandle","deleteVertexArray","handle","elements","_bindHandle","bindVertexArray","enable","location","arguments","length","undefined","canDisableAttributeZero","isWebGL2","canDisableAttribute","Number","bind","gl","enableVertexAttribArray","disableVertexAttribArray","setElementBuffer","elementBuffer","opts","glTarget","ELEMENT_ARRAY_BUFFER","bindBuffer","setBuffer","accessor","size","stride","offset","normalized","integer","divisor","ARRAY_BUFFER","assertWebGL2","vertexAttribIPointer","vertexAttribPointer","vertexAttribDivisor","setConstant","array","Float32Array","setConstantFloatArray","Int32Array","setConstantIntArray","Uint32Array","setConstantUintArray","getConstantBuffer","elementCount","value","constantValue","normalizeConstantArrayValue","byteLength","updateNeeded","createBuffer","reallocate","compareConstantArrayValues","typedArray","target","source","start","count","subData","vertexAttrib1fv","vertexAttrib2fv","vertexAttrib3fv","vertexAttrib4fv","_device$gl","vertexAttribI4iv","_device$gl2","vertexAttribI4uiv","arrayValue","Array","isArray","v1","v2","i"],"sources":["../../../src/adapter/objects/webgl-vertex-array-object.ts"],"sourcesContent":["import type {Device, Buffer, ResourceProps, TypedArray, NumericArray} from '@luma.gl/core';\nimport {Resource, assert, getScratchArray, fillArray} from '@luma.gl/core';\nimport {GL} from '@luma.gl/constants';\nimport {getBrowser} from '@probe.gl/env';\n\nimport {WebGLDevice} from '../webgl-device';\nimport {WebGLResource} from './webgl-resource';\nimport {WEBGLBuffer} from '../resources/webgl-buffer';\n\nimport {BufferWithAccessor} from '../../classic/buffer-with-accessor';\nimport {AccessorObject} from '../..';\n\nconst ERR_ELEMENTS = 'elements must be GL.ELEMENT_ARRAY_BUFFER';\n\n/**\n * VertexArrayObject properties\n * @param constantAttributeZero Attribute 0 can not be disable on most desktop OpenGL based browsers\n * and on iOS Safari browser.\n */\nexport type VertexArrayObjectProps = ResourceProps & {\n  constantAttributeZero?: boolean;\n};\n\n/** VertexArrayObject wrapper */\nexport class WEBGLVertexArrayObject extends WebGLResource<VertexArrayObjectProps> {\n  override get [Symbol.toStringTag](): string {\n    return 'BaseVertexArrayObject';\n  }\n\n  /** Buffer constant */\n  private buffer: BufferWithAccessor | null = null;\n  private bufferValue = null;\n\n  static isConstantAttributeZeroSupported(device: Device): boolean {\n    return device.info.type === 'webgl2' || getBrowser() === 'Chrome';\n  }\n\n  // Create a VertexArray\n  constructor(device: Device, props?: VertexArrayObjectProps) {\n    super(device, props, {...Resource.defaultProps, constantAttributeZero: false});\n    Object.seal(this);\n  }\n\n  override destroy(): void {\n    super.destroy();\n    if (this.buffer) {\n      this.buffer?.destroy();\n    }  }\n\n  override _createHandle() {\n    return this.gl2.createVertexArray();\n  }\n\n  override _deleteHandle(): void {\n    this.gl2.deleteVertexArray(this.handle);\n    // @ts-expect-error\n    return [this.elements];\n    // return [this.elements, ...this.buffers];\n  }\n\n  override _bindHandle(handle: WEBGLVertexArrayObject): void {\n    this.gl2.bindVertexArray(handle);\n  }\n\n  /**\n   * Enabling an attribute location makes it reference the currently bound buffer\n   *  Disabling an attribute location makes it reference the global constant value\n   * TODO - handle single values for size 1 attributes?\n   * TODO - convert classic arrays based on known type?\n   */\n  enable(location: number, enable = true): void {\n    // Attribute 0 cannot be disabled in most desktop OpenGL based browsers...\n    const canDisableAttributeZero = this.device.isWebGL2 || getBrowser() === 'Chrome';\n    const canDisableAttribute = canDisableAttributeZero || location !== 0;\n\n    if (enable || canDisableAttribute) {\n      location = Number(location);\n      this.bind(() =>\n        enable\n          ? this.gl.enableVertexAttribArray(location)\n          : this.gl.disableVertexAttribArray(location)\n      );\n    }  }\n\n  // Set (bind) an elements buffer, for indexed rendering.\n  // Must be a Buffer bound to GL.ELEMENT_ARRAY_BUFFER. Constants not supported\n  setElementBuffer(elementBuffer: WEBGLBuffer | null = null, opts = {}) {\n    assert(!elementBuffer || elementBuffer.glTarget === GL.ELEMENT_ARRAY_BUFFER, ERR_ELEMENTS);\n\n    // The GL.ELEMENT_ARRAY_BUFFER_BINDING is stored on the VertexArrayObject...\n    this.bind(() => {\n      this.gl.bindBuffer(GL.ELEMENT_ARRAY_BUFFER, elementBuffer ? elementBuffer.handle : null);\n    });\n  }\n\n  /** Set a location in vertex attributes array to a buffer, enables the location, sets divisor */\n  setBuffer(location: number, buffer: WEBGLBuffer, accessor: AccessorObject): void {\n    // Check target\n    if (buffer.glTarget === GL.ELEMENT_ARRAY_BUFFER) {\n      this.setElementBuffer(buffer, accessor);\n      return;\n    }\n\n    const {size, type, stride, offset, normalized, integer, divisor} = accessor;\n\n    const {gl, gl2} = this;\n    location = Number(location);\n\n    this.bind(() => {\n      // A non-zero buffer object must be bound to the GL_ARRAY_BUFFER target\n      gl.bindBuffer(gl.ARRAY_BUFFER, buffer.handle);\n\n      // WebGL2 supports *integer* data formats, i.e. GPU will see integer values\n      if (integer) {\n        this.device.assertWebGL2();\n        gl2.vertexAttribIPointer(location, size, type, stride, offset);\n      } else {\n        // Attaches ARRAY_BUFFER with specified buffer format to location\n        gl.vertexAttribPointer(location, size, type, normalized, stride, offset);\n      }\n      gl.enableVertexAttribArray(location);\n      gl2.vertexAttribDivisor(location, divisor || 0);\n\n      // NOTE We don't unbind buffer here, typically another buffer will be bound just after\n    });\n  }\n\n  /**\n   * Set an attribute to a constant value\n   * @param device\n   * @param location\n   * @param array\n   * \n   * @note Constants are stored globally on the WebGL context, not the VAO\n   * so they need to be updated before every render\n   * @todo - use known type (in configuration or passed in) to allow non-typed arrays?\n   * @todo - remember/cache values to avoid setting them unnecessarily?\n   */\n  setConstant(location: any, array: TypedArray): void {\n    switch (array.constructor) {\n      case Float32Array:\n        setConstantFloatArray(this.device, location, array as Float32Array);\n        break;\n      case Int32Array:\n        setConstantIntArray(this.device, location, array as Int32Array);\n        break;\n      case Uint32Array:\n        setConstantUintArray(this.device, location, array as Uint32Array);\n        break;\n      default:\n        assert(false);\n    }\n  }\n\n  /**\n   * Provide a means to create a buffer that is equivalent to a constant.\n   * NOTE: Desktop OpenGL cannot disable attribute 0.\n   * https://stackoverflow.com/questions/20305231/webgl-warning-attribute-0-is-disabled-\n   * this-has-significant-performance-penalty\n   */\n  getConstantBuffer(elementCount: number, value): Buffer {\n    // Create buffer only when needed, and reuse it (avoids inflating buffer creation statistics)\n\n    const constantValue = normalizeConstantArrayValue(value);\n\n    const byteLength = constantValue.byteLength * elementCount;\n    const length = constantValue.length * elementCount;\n\n    let updateNeeded = !this.buffer;\n\n    this.buffer = this.buffer || this.device.createBuffer({byteLength}) as BufferWithAccessor;\n    updateNeeded = updateNeeded || this.buffer.reallocate(byteLength);\n\n    // Reallocate and update contents if needed\n    updateNeeded =\n      updateNeeded || !compareConstantArrayValues(constantValue, this.bufferValue);\n\n    if (updateNeeded) {\n      // Create a typed array that is big enough, and fill it with the required data\n      const typedArray = getScratchArray(value.constructor, length);\n      fillArray({target: typedArray, source: constantValue, start: 0, count: length});\n      this.buffer.subData(typedArray);\n      this.bufferValue = value;\n    }\n\n    return this.buffer;\n  }\n}\n\nfunction setConstantFloatArray(device: WebGLDevice, location: number, array: Float32Array): void {\n  switch (array.length) {\n    case 1:\n      device.gl.vertexAttrib1fv(location, array);\n      break;\n    case 2:\n      device.gl.vertexAttrib2fv(location, array);\n      break;\n    case 3:\n      device.gl.vertexAttrib3fv(location, array);\n      break;\n    case 4:\n      device.gl.vertexAttrib4fv(location, array);\n      break;\n    default:\n      assert(false);\n  }\n}\n\nfunction setConstantIntArray(device: WebGLDevice, location: number, array: Int32Array): void {\n  device.assertWebGL2();\n  device.gl2?.vertexAttribI4iv(location, array);\n  // switch (array.length) {\n  //   case 1:\n  //     gl.vertexAttribI1iv(location, array);\n  //     break;\n  //   case 2:\n  //     gl.vertexAttribI2iv(location, array);\n  //     break;\n  //   case 3:\n  //     gl.vertexAttribI3iv(location, array);\n  //     break;\n  //   case 4:\n  //     break;\n  //   default:\n  //     assert(false);\n  // }\n}\n\nfunction setConstantUintArray(device: WebGLDevice, location: number, array: Uint32Array) {\n  device.assertWebGL2();\n  device.gl2?.vertexAttribI4uiv(location, array);\n  // switch (array.length) {\n  //   case 1:\n  //     gl.vertexAttribI1uiv(location, array);\n  //     break;\n  //   case 2:\n  //     gl.vertexAttribI2uiv(location, array);\n  //     break;\n  //   case 3:\n  //     gl.vertexAttribI3uiv(location, array);\n  //     break;\n  //   case 4:\n  //     gl.vertexAttribI4uiv(location, array);\n  //     break;\n  //   default:\n  //     assert(false);\n  // }\n}\n\n// HELPERS\n\n/**\n * TODO - convert Arrays based on known type? (read type from accessor, don't assume Float32Array)\n * TODO - handle single values for size 1 attributes?\n */\nfunction normalizeConstantArrayValue(arrayValue: NumericArray) {\n  if (Array.isArray(arrayValue)) {\n    return new Float32Array(arrayValue);\n  }\n  return arrayValue;\n}\n\n/**\n * \n */\nfunction compareConstantArrayValues(v1: NumericArray, v2: NumericArray): boolean {\n  if (!v1 || !v2 || v1.length !== v2.length || v1.constructor !== v2.constructor) {\n    return false;\n  }\n  for (let i = 0; i < v1.length; ++i) {\n    if (v1[i] !== v2[i]) {\n      return false;\n    }\n  }\n  return true;\n}\n"],"mappings":"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"}