@luma.gl/webgl 8.6.0-alpha.5 → 9.0.0-alpha.11

package/dist/esm/context/context/create-headless-context.js

@@ -0,0 +1,43 @@
+const ERR_HEADLESSGL_FAILED = 'Failed to create WebGL context in Node.js, headless gl returned null';
+const ERR_HEADLESSGL_LOAD = "  luma.gl: loaded under Node.js without headless gl installed, meaning that WebGL   contexts can not be created. This may not be an error. For example, this is a   typical configuration for isorender applications running on the server.";
+const CONTEXT_DEFAULTS = {
+  width: 1,
+  height: 1,
+  debug: true,
+  throwOnError: false
+};
+let headlessGL = null;
+export function registerHeadlessGL(headlessgl) {
+  headlessGL = headlessgl;
+}
+export function isHeadlessGLRegistered() {
+  return headlessGL !== null;
+}
+export function createHeadlessContext(options) {
+  options = { ...CONTEXT_DEFAULTS,
+    ...options
+  };
+  const {
+    width,
+    height,
+    webgl1,
+    webgl2
+  } = options;
+
+  if (webgl2 && !webgl1) {
+    throw new Error('headless-gl does not support WebGL2');
+  }
+
+  if (!headlessGL) {
+    throw new Error(ERR_HEADLESSGL_LOAD);
+  }
+
+  const gl = headlessGL(width, height, options);
+
+  if (!gl) {
+    throw new Error(ERR_HEADLESSGL_FAILED);
+  }
+
+  return gl;
+}
+//# sourceMappingURL=create-headless-context.js.map

package/dist/esm/context/context/create-headless-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/context/context/create-headless-context.ts"],"names":["ERR_HEADLESSGL_FAILED","ERR_HEADLESSGL_LOAD","CONTEXT_DEFAULTS","width","height","debug","throwOnError","headlessGL","registerHeadlessGL","headlessgl","isHeadlessGLRegistered","createHeadlessContext","options","webgl1","webgl2","Error","gl"],"mappings":"AAAA,MAAMA,qBAAqB,GACzB,sEADF;AAGA,MAAMC,mBAAmB,gPAAzB;AAKA,MAAMC,gBAAgB,GAAG;AACvBC,EAAAA,KAAK,EAAE,CADgB;AAEvBC,EAAAA,MAAM,EAAE,CAFe;AAGvBC,EAAAA,KAAK,EAAE,IAHgB;AAIvBC,EAAAA,YAAY,EAAE;AAJS,CAAzB;AAUA,IAAIC,UAA6B,GAAG,IAApC;AAGA,OAAO,SAASC,kBAAT,CAA4BC,UAA5B,EAAoD;AACzDF,EAAAA,UAAU,GAAGE,UAAb;AACD;AAGD,OAAO,SAASC,sBAAT,GAA2C;AAChD,SAAOH,UAAU,KAAK,IAAtB;AACD;AAGD,OAAO,SAASI,qBAAT,CAA+BC,OAA/B,EAAqF;AAC1FA,EAAAA,OAAO,GAAG,EAAC,GAAGV,gBAAJ;AAAsB,OAAGU;AAAzB,GAAV;AAEA,QAAM;AAACT,IAAAA,KAAD;AAAQC,IAAAA,MAAR;AAAgBS,IAAAA,MAAhB;AAAwBC,IAAAA;AAAxB,MAAkCF,OAAxC;;AAEA,MAAIE,MAAM,IAAI,CAACD,MAAf,EAAuB;AACrB,UAAM,IAAIE,KAAJ,CAAU,qCAAV,CAAN;AACD;;AACD,MAAI,CAACR,UAAL,EAAiB;AACf,UAAM,IAAIQ,KAAJ,CAAUd,mBAAV,CAAN;AACD;;AACD,QAAMe,EAAE,GAAGT,UAAU,CAACJ,KAAD,EAAQC,MAAR,EAAgBQ,OAAhB,CAArB;;AACA,MAAI,CAACI,EAAL,EAAS;AACP,UAAM,IAAID,KAAJ,CAAUf,qBAAV,CAAN;AACD;;AACD,SAAOgB,EAAP;AACD","sourcesContent":["const ERR_HEADLESSGL_FAILED =\n  'Failed to create WebGL context in Node.js, headless gl returned null';\n\nconst ERR_HEADLESSGL_LOAD = `\\\n  luma.gl: loaded under Node.js without headless gl installed, meaning that WebGL \\\n  contexts can not be created. This may not be an error. For example, this is a \\\n  typical configuration for isorender applications running on the server.`;\n\nconst CONTEXT_DEFAULTS = {\n  width: 1,\n  height: 1,\n  debug: true,\n  throwOnError: false\n};\n\n/** Duck typing for the main headless gl export, a function to create contexts */\nexport type HeadlessGL = (width: number, height: number, options: Record<string, unknown>) => WebGLRenderingContext;\n\nlet headlessGL: HeadlessGL | null = null; \n\n/** By importing `gl` and registering it with this function, contexts can be created under Node.js */\nexport function registerHeadlessGL(headlessgl: HeadlessGL) {\n  headlessGL = headlessgl;\n}\n\n/** @returns true if headless gl is registered */\nexport function isHeadlessGLRegistered(): boolean {\n  return headlessGL !== null;\n}\n\n/** Create headless gl context (for running under Node.js) */\nexport function createHeadlessContext(options?: Record<string, any>): WebGLRenderingContext {\n  options = {...CONTEXT_DEFAULTS, ...options};\n\n  const {width, height, webgl1, webgl2} = options;\n\n  if (webgl2 && !webgl1) {\n    throw new Error('headless-gl does not support WebGL2');\n  }\n  if (!headlessGL) {\n    throw new Error(ERR_HEADLESSGL_LOAD);\n  }\n  const gl = headlessGL(width, height, options);\n  if (!gl) {\n    throw new Error(ERR_HEADLESSGL_FAILED);\n  }\n  return gl;\n}\n"],"file":"create-headless-context.js"}

package/dist/esm/context/debug/spector.js

@@ -0,0 +1,76 @@
+import { log, loadScript } from '@luma.gl/api';
+const DEFAULT_SPECTOR_PROPS = {
+  spector: log.get('spector') || log.get('inspect')
+};
+const SPECTOR_CDN_URL = 'https://spectorcdn.babylonjs.com/spector.bundle.js';
+const LOG_LEVEL = 1;
+let spector = null;
+let initialized = false;
+export async function loadSpectorJS(props) {
+  if (!globalThis.SPECTOR) {
+    try {
+      await loadScript(SPECTOR_CDN_URL);
+    } catch (error) {
+      log.warn(String(error));
+    }
+  }
+}
+export function initializeSpectorJS(props) {
+  var _props, _props2;
+
+  props = { ...DEFAULT_SPECTOR_PROPS,
+    ...props
+  };
+
+  if (!((_props = props) !== null && _props !== void 0 && _props.spector)) {
+    return null;
+  }
+
+  if (!spector && globalThis.SPECTOR) {
+    log.probe(LOG_LEVEL, "SPECTOR found and initialized")();
+    spector = new globalThis.SPECTOR.Spector();
+
+    if (globalThis.luma) {
+      globalThis.luma.spector = spector;
+    }
+  }
+
+  if (!spector) {
+    return null;
+  }
+
+  if (!initialized) {
+    var _spector, _spector2;
+
+    initialized = true;
+    spector.spyCanvases();
+    (_spector = spector) === null || _spector === void 0 ? void 0 : _spector.onCaptureStarted.add(capture => log.info("Spector capture started:", capture)());
+    (_spector2 = spector) === null || _spector2 === void 0 ? void 0 : _spector2.onCapture.add(capture => {
+      var _spector3, _spector4, _spector5;
+
+      log.info("Spector capture complete:", capture)();
+      (_spector3 = spector) === null || _spector3 === void 0 ? void 0 : _spector3.getResultUI();
+      (_spector4 = spector) === null || _spector4 === void 0 ? void 0 : _spector4.resultView.display();
+      (_spector5 = spector) === null || _spector5 === void 0 ? void 0 : _spector5.resultView.addCapture(capture);
+    });
+  }
+
+  if ((_props2 = props) !== null && _props2 !== void 0 && _props2.canvas) {
+    var _spector6, _props3;
+
+    if (typeof props.spector === 'string' && props.spector !== props.canvas.id) {
+      return spector;
+    }
+
+    (_spector6 = spector) === null || _spector6 === void 0 ? void 0 : _spector6.startCapture((_props3 = props) === null || _props3 === void 0 ? void 0 : _props3.canvas, 500);
+    new Promise(resolve => setTimeout(resolve, 2000)).then(_ => {
+      var _spector7;
+
+      log.info("Spector capture stopped after 2 seconds")();
+      (_spector7 = spector) === null || _spector7 === void 0 ? void 0 : _spector7.stopCapture();
+    });
+  }
+
+  return spector;
+}
+//# sourceMappingURL=spector.js.map

package/dist/esm/context/debug/spector.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/context/debug/spector.ts"],"names":["log","loadScript","DEFAULT_SPECTOR_PROPS","spector","get","SPECTOR_CDN_URL","LOG_LEVEL","initialized","loadSpectorJS","props","globalThis","SPECTOR","error","warn","String","initializeSpectorJS","probe","Spector","luma","spyCanvases","onCaptureStarted","add","capture","info","onCapture","getResultUI","resultView","display","addCapture","canvas","id","startCapture","Promise","resolve","setTimeout","then","_","stopCapture"],"mappings":"AACA,SAAQA,GAAR,EAAaC,UAAb,QAA8B,cAA9B;AAYA,MAAMC,qBAAmC,GAAG;AAC1CC,EAAAA,OAAO,EAAEH,GAAG,CAACI,GAAJ,CAAQ,SAAR,KAAsBJ,GAAG,CAACI,GAAJ,CAAQ,SAAR;AADW,CAA5C;AAKA,MAAMC,eAAe,GAAG,oDAAxB;AACA,MAAMC,SAAS,GAAG,CAAlB;AAEA,IAAIH,OAAY,GAAG,IAAnB;AACA,IAAII,WAAoB,GAAG,KAA3B;AAOA,OAAO,eAAeC,aAAf,CAA6BC,KAA7B,EAAmD;AACxD,MAAI,CAACC,UAAU,CAACC,OAAhB,EAAyB;AACvB,QAAI;AACF,YAAMV,UAAU,CAACI,eAAD,CAAhB;AACD,KAFD,CAEE,OAAMO,KAAN,EAAa;AACbZ,MAAAA,GAAG,CAACa,IAAJ,CAASC,MAAM,CAACF,KAAD,CAAf;AACD;AACF;AACF;AAED,OAAO,SAASG,mBAAT,CAA6BN,KAA7B,EAAmD;AAAA;;AACxDA,EAAAA,KAAK,GAAG,EAAC,GAAGP,qBAAJ;AAA2B,OAAGO;AAA9B,GAAR;;AACA,MAAI,YAACA,KAAD,mCAAC,OAAON,OAAR,CAAJ,EAAqB;AACnB,WAAO,IAAP;AACD;;AAED,MAAI,CAACA,OAAD,IAAYO,UAAU,CAACC,OAA3B,EAAoC;AAClCX,IAAAA,GAAG,CAACgB,KAAJ,CAAUV,SAAV,EAAqB,+BAArB;AACAH,IAAAA,OAAO,GAAG,IAAIO,UAAU,CAACC,OAAX,CAAmBM,OAAvB,EAAV;;AACA,QAAIP,UAAU,CAACQ,IAAf,EAAqB;AACnBR,MAAAA,UAAU,CAACQ,IAAX,CAAgBf,OAAhB,GAA0BA,OAA1B;AACD;AACF;;AAED,MAAI,CAACA,OAAL,EAAc;AACZ,WAAO,IAAP;AACD;;AAED,MAAI,CAACI,WAAL,EAAkB;AAAA;;AAChBA,IAAAA,WAAW,GAAG,IAAd;AAGAJ,IAAAA,OAAO,CAACgB,WAAR;AAEA,gBAAAhB,OAAO,UAAP,4CAASiB,gBAAT,CAA0BC,GAA1B,CAA+BC,OAAD,IAAsBtB,GAAG,CAACuB,IAAJ,6BAAqCD,OAArC,GAApD;AACA,iBAAAnB,OAAO,UAAP,8CAASqB,SAAT,CAAmBH,GAAnB,CAAwBC,OAAD,IAAsB;AAAA;;AAC3CtB,MAAAA,GAAG,CAACuB,IAAJ,8BAAsCD,OAAtC;AAGA,mBAAAnB,OAAO,UAAP,8CAASsB,WAAT;AACA,mBAAAtB,OAAO,UAAP,8CAASuB,UAAT,CAAoBC,OAApB;AACA,mBAAAxB,OAAO,UAAP,8CAASuB,UAAT,CAAoBE,UAApB,CAA+BN,OAA/B;AACD,KAPD;AAQD;;AAED,iBAAIb,KAAJ,oCAAI,QAAOoB,MAAX,EAAmB;AAAA;;AAEjB,QAAI,OAAOpB,KAAK,CAACN,OAAb,KAAyB,QAAzB,IAAqCM,KAAK,CAACN,OAAN,KAAkBM,KAAK,CAACoB,MAAN,CAAaC,EAAxE,EAA4E;AAC1E,aAAO3B,OAAP;AACD;;AAID,iBAAAA,OAAO,UAAP,8CAAS4B,YAAT,YAAsBtB,KAAtB,4CAAsB,QAAOoB,MAA7B,EAAqC,GAArC;AACA,QAAIG,OAAJ,CAAYC,OAAO,IAAIC,UAAU,CAACD,OAAD,EAAU,IAAV,CAAjC,EAAkDE,IAAlD,CAAuDC,CAAC,IAAI;AAAA;;AAC1DpC,MAAAA,GAAG,CAACuB,IAAJ;AACA,mBAAApB,OAAO,UAAP,8CAASkC,WAAT;AAED,KAJD;AAKD;;AAED,SAAOlC,OAAP;AACD","sourcesContent":["// luma.gl, MIT license\nimport {log, loadScript} from '@luma.gl/api';\n\n/** Spector debug initialization options */\ntype SpectorProps = {\n  /** Canvas to monitor */\n  canvas?: HTMLCanvasElement | OffscreenCanvas;\n  /** Whether debug is enabled. Auto-detected if ommitted */\n  debug?: boolean;\n  /** Whether spector is disabled */\n  spector?: boolean | string | object;\n};\n\nconst DEFAULT_SPECTOR_PROPS: SpectorProps = {\n  spector: log.get('spector') || log.get('inspect')\n};\n\n// https://github.com/BabylonJS/Spector.js#basic-usage\nconst SPECTOR_CDN_URL = 'https://spectorcdn.babylonjs.com/spector.bundle.js';\nconst LOG_LEVEL = 1;\n\nlet spector: any = null;\nlet initialized: boolean = false;\n\ndeclare global {\n  var SPECTOR: any;\n}\n\n/** Loads spector from CDN if not already installed */\nexport async function loadSpectorJS(props?: SpectorProps) {\n  if (!globalThis.SPECTOR) {\n    try {\n      await loadScript(SPECTOR_CDN_URL);\n    } catch(error) {\n      log.warn(String(error))\n    }\n  }\n}\n\nexport function initializeSpectorJS(props?: SpectorProps) {\n  props = {...DEFAULT_SPECTOR_PROPS, ...props};\n  if (!props?.spector) {\n    return null;\n  }\n\n  if (!spector && globalThis.SPECTOR) {\n    log.probe(LOG_LEVEL, \"SPECTOR found and initialized\")();\n    spector = new globalThis.SPECTOR.Spector();\n    if (globalThis.luma) {\n      globalThis.luma.spector = spector;\n    }\n  }\n\n  if (!spector) {\n    return null;\n  }\n\n  if (!initialized) {\n    initialized = true;\n\n    // enables recording some extra information merged in the capture like texture memory sizes and formats\n    spector.spyCanvases();\n    // A callback when results are ready\n    spector?.onCaptureStarted.add((capture: unknown) => log.info(`Spector capture started:`, capture)());\n    spector?.onCapture.add((capture: unknown) => {\n      log.info(`Spector capture complete:`, capture)();\n      // Use undocumented Spector API to open the UI with our capture\n      // See https://github.com/BabylonJS/Spector.js/blob/767ad1195a25b85a85c381f400eb50a979239eca/src/spector.ts#L124\n      spector?.getResultUI()\n      spector?.resultView.display();\n      spector?.resultView.addCapture(capture)\n    });\n  }\n\n  if (props?.canvas) {\n    // @ts-expect-error If spector is specified as a canvas id, only monitor that canvas\n    if (typeof props.spector === 'string' && props.spector !== props.canvas.id) {\n      return spector;\n    }\n\n    // capture startup\n    // spector?.captureCanvas(props?.canvas);\n    spector?.startCapture(props?.canvas, 500); // 500 commands\n    new Promise(resolve => setTimeout(resolve, 2000)).then(_ => {\n      log.info(`Spector capture stopped after 2 seconds`)();\n      spector?.stopCapture();\n      // spector?.displayUI();\n    });\n  }\n\n  return spector;\n}\n"],"file":"spector.js"}

package/dist/esm/context/debug/webgl-developer-tools.js

@@ -0,0 +1,121 @@
+import { log, loadScript } from '@luma.gl/api/';
+import GL from '@luma.gl/constants';
+const WEBGL_DEBUG_CDN_URL = 'https://unpkg.com/webgl-debug@2.0.1/index.js';
+const DEFAULT_DEBUG_CONTEXT_PROPS = {
+  debug: true,
+  throwOnError: false,
+  break: [],
+  webgl2: false
+};
+
+function getContextData(gl) {
+  gl.luma = gl.luma || {};
+  return gl.luma;
+}
+
+export async function loadWebGLDeveloperTools() {
+  if (!globalThis.WebGLDebugUtils) {
+    globalThis.global = globalThis.global || globalThis;
+    globalThis.global.module = {};
+    await loadScript(WEBGL_DEBUG_CDN_URL);
+  }
+}
+export function makeDebugContext(gl, props = {}) {
+  if (!gl) {
+    return null;
+  }
+
+  return props.debug ? getDebugContext(gl, props) : getRealContext(gl);
+}
+
+function getRealContext(gl) {
+  const data = getContextData(gl);
+  return data.realContext ? data.realContext : gl;
+}
+
+function getDebugContext(gl, props) {
+  if (!globalThis.WebGLDebugUtils) {
+    log.warn('webgl-debug not loaded')();
+    return gl;
+  }
+
+  const data = getContextData(gl);
+
+  if (data.debugContext) {
+    return data.debugContext;
+  }
+
+  globalThis.WebGLDebugUtils.init({ ...GL,
+    ...gl
+  });
+  const glDebug = globalThis.WebGLDebugUtils.makeDebugContext(gl, onGLError.bind(null, props), onValidateGLFunc.bind(null, props));
+
+  for (const key in GL) {
+    if (!(key in glDebug) && typeof GL[key] === 'number') {
+      glDebug[key] = GL[key];
+    }
+  }
+
+  class WebGLDebugContext {}
+
+  Object.setPrototypeOf(glDebug, Object.getPrototypeOf(gl));
+  Object.setPrototypeOf(WebGLDebugContext, glDebug);
+  const debugContext = Object.create(WebGLDebugContext);
+  data.realContext = gl;
+  data.debugContext = debugContext;
+  debugContext.debug = true;
+  return debugContext;
+}
+
+function getFunctionString(functionName, functionArgs) {
+  functionArgs = Array.from(functionArgs).map(arg => arg === undefined ? 'undefined' : arg);
+  let args = globalThis.WebGLDebugUtils.glFunctionArgsToString(functionName, functionArgs);
+  args = "".concat(args.slice(0, 100)).concat(args.length > 100 ? '...' : '');
+  return "gl.".concat(functionName, "(").concat(args, ")");
+}
+
+function onGLError(props, err, functionName, args) {
+  args = Array.from(args).map(arg => arg === undefined ? 'undefined' : arg);
+  const errorMessage = globalThis.WebGLDebugUtils.glEnumToString(err);
+  const functionArgs = globalThis.WebGLDebugUtils.glFunctionArgsToString(functionName, args);
+  const glName = props.webgl2 ? 'gl2' : 'gl1';
+  const message = "".concat(errorMessage, " in ").concat(glName, ".").concat(functionName, "(").concat(functionArgs, ")");
+  log.error(message)();
+  debugger;
+
+  if (props.throwOnError) {
+    throw new Error(message);
+  }
+}
+
+function onValidateGLFunc(props, functionName, functionArgs) {
+  let functionString = '';
+
+  if (log.level >= 1) {
+    functionString = getFunctionString(functionName, functionArgs);
+    log.log(1, functionString)();
+  }
+
+  if (props.break) {
+    functionString = functionString || getFunctionString(functionName, functionArgs);
+    const isBreakpoint = props.break && props.break.every(breakOn => functionString.indexOf(breakOn) !== -1);
+
+    if (isBreakpoint) {
+      debugger;
+    }
+  }
+
+  for (const arg of functionArgs) {
+    if (arg === undefined) {
+      functionString = functionString || getFunctionString(functionName, functionArgs);
+
+      if (props.throwOnError) {
+        throw new Error("Undefined argument: ".concat(functionString));
+      } else {
+        log.error("Undefined argument: ".concat(functionString))();
+        debugger;
+      }
+    }
+  }
+}
+//# sourceMappingURL=webgl-developer-tools.js.map

package/dist/esm/context/debug/webgl-developer-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/context/debug/webgl-developer-tools.ts"],"names":["log","loadScript","GL","WEBGL_DEBUG_CDN_URL","DEFAULT_DEBUG_CONTEXT_PROPS","debug","throwOnError","break","webgl2","getContextData","gl","luma","loadWebGLDeveloperTools","globalThis","WebGLDebugUtils","global","module","makeDebugContext","props","getDebugContext","getRealContext","data","realContext","warn","debugContext","init","glDebug","onGLError","bind","onValidateGLFunc","key","WebGLDebugContext","Object","setPrototypeOf","getPrototypeOf","create","getFunctionString","functionName","functionArgs","Array","from","map","arg","undefined","args","glFunctionArgsToString","slice","length","err","errorMessage","glEnumToString","glName","message","error","Error","functionString","level","isBreakpoint","every","breakOn","indexOf"],"mappings":"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","sourcesContent":["// luma.gl, MIT license\nimport {log, loadScript} from '@luma.gl/api/';\nimport GL from '@luma.gl/constants';\n\nconst WEBGL_DEBUG_CDN_URL = 'https://unpkg.com/webgl-debug@2.0.1/index.js';\n\ntype DebugContextProps = {\n  debug?: boolean;\n  throwOnError?: boolean;\n  break?: string[];\n  webgl2?: boolean;\n};\n\nconst DEFAULT_DEBUG_CONTEXT_PROPS: Required<DebugContextProps> = {\n  debug: true,\n  throwOnError: false,\n  break: [],\n  webgl2: false,\n}\n\n// Helper to get shared context data\nfunction getContextData(gl: any) {\n  gl.luma = gl.luma || {};\n  return gl.luma;\n}\n\ndeclare global {\n  var WebGLDebugUtils: any;\n}\n\n/**\n * Loads Khronos WebGLDeveloperTools from CDN if not already installed \n * const WebGLDebugUtils = require('webgl-debug');\n * @see https://github.com/KhronosGroup/WebGLDeveloperTools\n * @see https://github.com/vorg/webgl-debug\n */\nexport async function loadWebGLDeveloperTools(): Promise<void> {\n  if (!globalThis.WebGLDebugUtils) {\n    // @ts-expect-error Developer tools expects global to be set\n    globalThis.global = globalThis.global || globalThis;\n    // @ts-expect-error Developer tools expects global to be set\n    globalThis.global.module = {};\n    await loadScript(WEBGL_DEBUG_CDN_URL);\n  }\n}\n\n// Returns (a potentially new) context with debug instrumentation turned off or on.\n// Note that this actually returns a new context\nexport function makeDebugContext(gl: WebGLRenderingContext, props: DebugContextProps = {}): WebGLRenderingContext | null {\n  // Return null to ensure we don't try to create a context in this case (TODO what case is that?)\n  if (!gl) {\n    return null;\n  }\n\n  return props.debug ? getDebugContext(gl, props) : getRealContext(gl);\n}\n\n// Returns the real context from either of the real/debug contexts\nfunction getRealContext(gl: WebGLRenderingContext): WebGLRenderingContext {\n  const data = getContextData(gl);\n  // If the context has a realContext member, it is a debug context so return the realContext\n  return data.realContext ? data.realContext : gl;\n}\n\n// Returns the debug context from either of the real/debug contexts\nfunction getDebugContext(gl: WebGLRenderingContext, props: DebugContextProps): WebGLRenderingContext {\n  if (!globalThis.WebGLDebugUtils) {\n    log.warn('webgl-debug not loaded')();\n    return gl;\n  }\n\n  const data = getContextData(gl);\n\n  // If this already has a debug context, return it.\n  if (data.debugContext) {\n    return data.debugContext;\n  }\n\n  // Create a new debug context\n  globalThis.WebGLDebugUtils.init({...GL, ...gl});\n  const glDebug = globalThis.WebGLDebugUtils.makeDebugContext(\n    gl,\n    onGLError.bind(null, props),\n    onValidateGLFunc.bind(null, props)\n  );\n\n  // Make sure we have all WebGL2 and extension constants (todo dynamic import to circumvent minification?)\n  for (const key in GL) {\n    if (!(key in glDebug) && typeof GL[key] === 'number') {\n      glDebug[key] = GL[key];\n    }\n  }\n  \n  // Ensure we have a clean prototype on the instrumented object\n  // Note: setPrototypeOf does come with perf warnings, but we already take a bigger perf reduction\n  // by synchronizing the WebGL errors after each WebGL call.\n  class WebGLDebugContext {}\n  Object.setPrototypeOf(glDebug, Object.getPrototypeOf(gl));\n  Object.setPrototypeOf(WebGLDebugContext, glDebug);\n  const debugContext = Object.create(WebGLDebugContext);\n  // Store the debug context\n  data.realContext = gl;\n  data.debugContext = debugContext;\n  debugContext.debug = true;\n\n  // Return it\n  return debugContext;\n}\n\n// DEBUG TRACING\n\nfunction getFunctionString(functionName: string, functionArgs): string {\n  // Cover bug in webgl-debug-tools\n  functionArgs = Array.from(functionArgs).map(arg => arg === undefined ? 'undefined' : arg);\n  let args = globalThis.WebGLDebugUtils.glFunctionArgsToString(functionName, functionArgs);\n  args = `${args.slice(0, 100)}${args.length > 100 ? '...' : ''}`;\n  return `gl.${functionName}(${args})`;\n}\n\nfunction onGLError(props: DebugContextProps, err, functionName: string, args: any[]): void {\n  // Cover bug in webgl-debug-tools\n  args = Array.from(args).map(arg => arg === undefined ? 'undefined' : arg);\n  const errorMessage = globalThis.WebGLDebugUtils.glEnumToString(err);\n  const functionArgs = globalThis.WebGLDebugUtils.glFunctionArgsToString(functionName, args);\n  const glName = props.webgl2 ? 'gl2' : 'gl1';\n  const message = `${errorMessage} in ${glName}.${functionName}(${functionArgs})`;\n  log.error(message)();\n  debugger; // eslint-disable-line\n  if (props.throwOnError) {\n    throw new Error(message);\n  }\n}\n\n// Don't generate function string until it is needed\nfunction onValidateGLFunc(props: DebugContextProps, functionName: string, functionArgs: any[]): void {\n  let functionString: string = '';\n  if (log.level >= 1) {\n    functionString = getFunctionString(functionName, functionArgs);\n    log.log(1, functionString)();\n  }\n\n  if (props.break) {\n    functionString = functionString || getFunctionString(functionName, functionArgs);\n    const isBreakpoint =\n      props.break && props.break.every((breakOn: string) => functionString.indexOf(breakOn) !== -1);\n    if (isBreakpoint) {\n      debugger; // eslint-disable-line\n    }\n  }\n\n  for (const arg of functionArgs) {\n    if (arg === undefined) {\n      functionString = functionString || getFunctionString(functionName, functionArgs);\n      if (props.throwOnError) {\n        throw new Error(`Undefined argument: ${functionString}`);\n      } else {\n        log.error(`Undefined argument: ${functionString}`)();\n        debugger; // eslint-disable-line\n      }\n    }\n  }\n}\n"],"file":"webgl-developer-tools.js"}

package/dist/esm/context/parameters/unified-parameter-api.js

@@ -1,8 +1,8 @@
-import { assert } from '@luma.gl/api';
 import { GL_PARAMETER_DEFAULTS, GL_PARAMETER_SETTERS, GL_COMPOSITE_PARAMETER_SETTERS, GL_PARAMETER_GETTERS } from './webgl-parameter-tables';
-import { isWebGL } from '../context/webgl-checks';
-export function setParameters(gl, parameters) {
-  assert(isWebGL(gl), 'setParameters requires a WebGL context');
+import WebGLDevice from '../../adapter/webgl-device';
+export function setParameters(device, parameters) {
+  const webglDevice = WebGLDevice.attach(device);
+  const gl = webglDevice.gl;
 
   if (isObjectEmpty(parameters)) {
     return;
@@ -32,8 +32,9 @@ export function setParameters(gl, parameters) {
     }
   }
 }
-export function getParameters(gl, parameters) {
-  parameters = parameters || GL_PARAMETER_DEFAULTS;
+export function getParameters(device, parameters = GL_PARAMETER_DEFAULTS) {
+  const webglDevice = WebGLDevice.attach(device);
+  const gl = webglDevice.gl;
 
   if (typeof parameters === 'number') {
     const key = parameters;
@@ -51,8 +52,8 @@ export function getParameters(gl, parameters) {
 
   return state;
 }
-export function resetParameters(gl) {
-  setParameters(gl, GL_PARAMETER_DEFAULTS);
+export function resetParameters(device) {
+  setParameters(device, GL_PARAMETER_DEFAULTS);
 }
 
 function isObjectEmpty(object) {

package/dist/esm/context/parameters/unified-parameter-api.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/context/parameters/unified-parameter-api.ts"],"names":["assert","GL_PARAMETER_DEFAULTS","GL_PARAMETER_SETTERS","GL_COMPOSITE_PARAMETER_SETTERS","GL_PARAMETER_GETTERS","isWebGL","setParameters","gl","parameters","isObjectEmpty","compositeSetters","key","glConstant","Number","setter","cache","state","compositeSetter","getParameters","getter","getParameter","parameterKeys","Array","isArray","Object","keys","resetParameters","object"],"mappings":"AAGA,SAAQA,MAAR,QAAqB,cAArB;AAEA,SACEC,qBADF,EAEEC,oBAFF,EAGEC,8BAHF,EAIEC,oBAJF,QAKO,0BALP;AAOA,SAAQC,OAAR,QAAsB,yBAAtB;AAUA,OAAO,SAASC,aAAT,CAAuBC,EAAvB,EAAkDC,UAAlD,EAAkF;AACvFR,EAAAA,MAAM,CAACK,OAAO,CAACE,EAAD,CAAR,EAAc,wCAAd,CAAN;;AAEA,MAAIE,aAAa,CAACD,UAAD,CAAjB,EAA+B;AAC7B;AACD;;AAED,QAAME,gBAAgB,GAAG,EAAzB;;AAIA,OAAK,MAAMC,GAAX,IAAkBH,UAAlB,EAA8B;AAC5B,UAAMI,UAAU,GAAGC,MAAM,CAACF,GAAD,CAAzB;AACA,UAAMG,MAAM,GAAGZ,oBAAoB,CAACS,GAAD,CAAnC;;AACA,QAAIG,MAAJ,EAAY;AAEV,UAAI,OAAOA,MAAP,KAAkB,QAAtB,EAAgC;AAC9BJ,QAAAA,gBAAgB,CAACI,MAAD,CAAhB,GAA2B,IAA3B;AACD,OAFD,MAEO;AAKLA,QAAAA,MAAM,CAACP,EAAD,EAAKC,UAAU,CAACG,GAAD,CAAf,EAAsBC,UAAtB,CAAN;AACD;AACF;AACF;;AAUD,QAAMG,KAAK,GAAGR,EAAE,CAACS,KAAH,IAAYT,EAAE,CAACS,KAAH,CAASD,KAAnC;;AACA,MAAIA,KAAJ,EAAW;AACT,SAAK,MAAMJ,GAAX,IAAkBD,gBAAlB,EAAoC;AAElC,YAAMO,eAAe,GAAGd,8BAA8B,CAACQ,GAAD,CAAtD;AAGAM,MAAAA,eAAe,CAACV,EAAD,EAAKC,UAAL,EAAiBO,KAAjB,CAAf;AACD;AACF;AAGF;AAiBD,OAAO,SAASG,aAAT,CAAuBX,EAAvB,EAA2BC,UAA3B,EAAuC;AAE5CA,EAAAA,UAAU,GAAGA,UAAU,IAAIP,qBAA3B;;AAGA,MAAI,OAAOO,UAAP,KAAsB,QAA1B,EAAoC;AAElC,UAAMG,GAAG,GAAGH,UAAZ;AACA,UAAMW,MAAM,GAAGf,oBAAoB,CAACO,GAAD,CAAnC;AACA,WAAOQ,MAAM,GAAGA,MAAM,CAACZ,EAAD,EAAKI,GAAL,CAAT,GAAqBJ,EAAE,CAACa,YAAH,CAAgBT,GAAhB,CAAlC;AACD;;AAED,QAAMU,aAAa,GAAGC,KAAK,CAACC,OAAN,CAAcf,UAAd,IAA4BA,UAA5B,GAAyCgB,MAAM,CAACC,IAAP,CAAYjB,UAAZ,CAA/D;AAEA,QAAMQ,KAAK,GAAG,EAAd;;AACA,OAAK,MAAML,GAAX,IAAkBU,aAAlB,EAAiC;AAC/B,UAAMF,MAAM,GAAGf,oBAAoB,CAACO,GAAD,CAAnC;AACAK,IAAAA,KAAK,CAACL,GAAD,CAAL,GAAaQ,MAAM,GAAGA,MAAM,CAACZ,EAAD,EAAKM,MAAM,CAACF,GAAD,CAAX,CAAT,GAA6BJ,EAAE,CAACa,YAAH,CAAgBP,MAAM,CAACF,GAAD,CAAtB,CAAhD;AACD;;AACD,SAAOK,KAAP;AACD;AAQD,OAAO,SAASU,eAAT,CAAyBnB,EAAzB,EAA0D;AAC/DD,EAAAA,aAAa,CAACC,EAAD,EAAKN,qBAAL,CAAb;AACD;;AAKD,SAASQ,aAAT,CAAuBkB,MAAvB,EAA+B;AAC7B,OAAK,MAAMhB,GAAX,IAAkBgB,MAAlB,EAA0B;AACxB,WAAO,KAAP;AACD;;AACD,SAAO,IAAP;AACD","sourcesContent":["// Provides a unified API for getting and setting any WebGL parameter\n// Also knows default values of all parameters, enabling fast cache initialization\n// Provides base functionality for the state caching.\nimport {assert} from '@luma.gl/api';\nimport type {GLParameters} from './webgl-parameters';\nimport {\n  GL_PARAMETER_DEFAULTS,\n  GL_PARAMETER_SETTERS,\n  GL_COMPOSITE_PARAMETER_SETTERS,\n  GL_PARAMETER_GETTERS\n} from './webgl-parameter-tables';\n\nimport {isWebGL} from '../context/webgl-checks';\n\nexport type {GLParameters};\n\n/**\n * Sets any GL parameter regardless of function (gl.blendMode, ...)\n *\n * @note requires a `cache` object to be set on the context (gl.state.cache)\n * This object is used to fill in any missing values for composite setter functions\n */\nexport function setParameters(gl: WebGLRenderingContext, parameters: GLParameters): void {\n  assert(isWebGL(gl), 'setParameters requires a WebGL context');\n\n  if (isObjectEmpty(parameters)) {\n    return;\n  }\n\n  const compositeSetters = {};\n\n  // HANDLE PRIMITIVE SETTERS (and make note of any composite setters)\n\n  for (const key in parameters) {\n    const glConstant = Number(key);\n    const setter = GL_PARAMETER_SETTERS[key];\n    if (setter) {\n      // Composite setters should only be called once, so save them\n      if (typeof setter === 'string') {\n        compositeSetters[setter] = true;\n      } else {\n        // if (gl[glConstant] !== undefined) {\n        // TODO - added above check since this is being called on WebGL2 parameters in WebGL1...\n        // TODO - deep equal on values? only call setter if value has changed?\n        // NOTE - the setter will automatically update this.state\n        setter(gl, parameters[key], glConstant);\n      }\n    }\n  }\n\n  // HANDLE COMPOSITE SETTERS\n\n  // NOTE: any non-provided values needed by composite setters are filled in from state cache\n  // The cache parameter is automatically retrieved from the context\n  // This depends on `trackContextState`, which is technically a \"circular\" dependency.\n  // But it is too inconvenient to always require a cache parameter here.\n  // This is the ONLY external dependency in this module/\n  // @ts-expect-error\n  const cache = gl.state && gl.state.cache;\n  if (cache) {\n    for (const key in compositeSetters) {\n      // TODO - avoid calling composite setters if values have not changed.\n      const compositeSetter = GL_COMPOSITE_PARAMETER_SETTERS[key];\n      // Note - if `trackContextState` has been called,\n      // the setter will automatically update this.state.cache\n      compositeSetter(gl, parameters, cache);\n    }\n  }\n\n  // Add a log for the else case?\n}\n\n/**\n * Reads the entire WebGL state from a context\n * @returns - a newly created map, with values keyed by GL parameters\n *\n * @note Copies the state from a context (gl.getParameter should not be overriden)\n * Reads the entire WebGL state from a context\n *\n * @note This can generates a huge amount of synchronous driver roundtrips and should be\n * considered a very slow operation, to be used only if/when a context already manipulated\n * by external code needs to be synchronized for the first time\n */\nexport function getParameters(gl: WebGLRenderingContext, parameters?: Record<keyof GLParameters, any>): GLParameters;\nexport function getParameters(gl: WebGLRenderingContext, parameters?: (keyof GLParameters)[]): GLParameters;\nexport function getParameters(gl: WebGLRenderingContext, parameters: keyof GLParameters): GLParameters;\n\nexport function getParameters(gl, parameters) {\n  // default to querying all parameters\n  parameters = parameters || GL_PARAMETER_DEFAULTS;\n  // support both arrays of parameters and objects (keys represent parameters)\n\n  if (typeof parameters === 'number') {\n    // single GL enum\n    const key = parameters;\n    const getter = GL_PARAMETER_GETTERS[key];\n    return getter ? getter(gl, key) : gl.getParameter(key);\n  }\n\n  const parameterKeys = Array.isArray(parameters) ? parameters : Object.keys(parameters);\n\n  const state = {};\n  for (const key of parameterKeys) {\n    const getter = GL_PARAMETER_GETTERS[key];\n    state[key] = getter ? getter(gl, Number(key)) : gl.getParameter(Number(key));\n  }\n  return state;\n}\n\n/**\n * Reset all parameters to a (almost) pure context state\n * @note viewport and scissor will be set to the values in GL_PARAMETER_DEFAULTS,\n * NOT the canvas size dimensions, so they will have to be properly set after\n * calling this function.\n */\nexport function resetParameters(gl: WebGLRenderingContext): void {\n  setParameters(gl, GL_PARAMETER_DEFAULTS);\n}\n\n// Helpers\n\n// Returns true if given object is empty, false otherwise.\nfunction isObjectEmpty(object) {\n  for (const key in object) {\n    return false;\n  }\n  return true;\n}\n"],"file":"unified-parameter-api.js"}
+{"version":3,"sources":["../../../../src/context/parameters/unified-parameter-api.ts"],"names":["GL_PARAMETER_DEFAULTS","GL_PARAMETER_SETTERS","GL_COMPOSITE_PARAMETER_SETTERS","GL_PARAMETER_GETTERS","WebGLDevice","setParameters","device","parameters","webglDevice","attach","gl","isObjectEmpty","compositeSetters","key","glConstant","Number","setter","cache","state","compositeSetter","getParameters","getter","getParameter","parameterKeys","Array","isArray","Object","keys","resetParameters","object"],"mappings":"AAKA,SACEA,qBADF,EAEEC,oBAFF,EAGEC,8BAHF,EAIEC,oBAJF,QAKO,0BALP;AAQA,OAAOC,WAAP,MAAwB,4BAAxB;AAUA,OAAO,SAASC,aAAT,CACLC,MADK,EAELC,UAFK,EAGC;AACN,QAAMC,WAAW,GAAGJ,WAAW,CAACK,MAAZ,CAAmBH,MAAnB,CAApB;AACA,QAAMI,EAAE,GAAGF,WAAW,CAACE,EAAvB;;AAEA,MAAIC,aAAa,CAACJ,UAAD,CAAjB,EAA+B;AAC7B;AACD;;AAED,QAAMK,gBAAgB,GAAG,EAAzB;;AAIA,OAAK,MAAMC,GAAX,IAAkBN,UAAlB,EAA8B;AAC5B,UAAMO,UAAU,GAAGC,MAAM,CAACF,GAAD,CAAzB;AACA,UAAMG,MAAM,GAAGf,oBAAoB,CAACY,GAAD,CAAnC;;AACA,QAAIG,MAAJ,EAAY;AAEV,UAAI,OAAOA,MAAP,KAAkB,QAAtB,EAAgC;AAC9BJ,QAAAA,gBAAgB,CAACI,MAAD,CAAhB,GAA2B,IAA3B;AACD,OAFD,MAEO;AAKLA,QAAAA,MAAM,CAACN,EAAD,EAAKH,UAAU,CAACM,GAAD,CAAf,EAAsBC,UAAtB,CAAN;AACD;AACF;AACF;;AAUD,QAAMG,KAAK,GAAGP,EAAE,CAACQ,KAAH,IAAYR,EAAE,CAACQ,KAAH,CAASD,KAAnC;;AACA,MAAIA,KAAJ,EAAW;AACT,SAAK,MAAMJ,GAAX,IAAkBD,gBAAlB,EAAoC;AAElC,YAAMO,eAAe,GAAGjB,8BAA8B,CAACW,GAAD,CAAtD;AAGAM,MAAAA,eAAe,CAACT,EAAD,EAAKH,UAAL,EAAiBU,KAAjB,CAAf;AACD;AACF;AAGF;AAgBD,OAAO,SAASG,aAAT,CACLd,MADK,EAELC,UAAsE,GAAGP,qBAFpE,EAGS;AACd,QAAMQ,WAAW,GAAGJ,WAAW,CAACK,MAAZ,CAAmBH,MAAnB,CAApB;AACA,QAAMI,EAAE,GAAGF,WAAW,CAACE,EAAvB;;AAIA,MAAI,OAAOH,UAAP,KAAsB,QAA1B,EAAoC;AAElC,UAAMM,GAAG,GAAGN,UAAZ;AACA,UAAMc,MAAM,GAAGlB,oBAAoB,CAACU,GAAD,CAAnC;AACA,WAAOQ,MAAM,GAAGA,MAAM,CAACX,EAAD,EAAKG,GAAL,CAAT,GAAqBH,EAAE,CAACY,YAAH,CAAgBT,GAAhB,CAAlC;AACD;;AAED,QAAMU,aAAa,GAAGC,KAAK,CAACC,OAAN,CAAclB,UAAd,IAA4BA,UAA5B,GAAyCmB,MAAM,CAACC,IAAP,CAAYpB,UAAZ,CAA/D;AAEA,QAAMW,KAAK,GAAG,EAAd;;AACA,OAAK,MAAML,GAAX,IAAkBU,aAAlB,EAAiC;AAC/B,UAAMF,MAAM,GAAGlB,oBAAoB,CAACU,GAAD,CAAnC;AACAK,IAAAA,KAAK,CAACL,GAAD,CAAL,GAAaQ,MAAM,GAAGA,MAAM,CAACX,EAAD,EAAKK,MAAM,CAACF,GAAD,CAAX,CAAT,GAA6BH,EAAE,CAACY,YAAH,CAAgBP,MAAM,CAACF,GAAD,CAAtB,CAAhD;AACD;;AACD,SAAOK,KAAP;AACD;AAQD,OAAO,SAASU,eAAT,CAAyBtB,MAAzB,EAAuE;AAC5ED,EAAAA,aAAa,CAACC,MAAD,EAASN,qBAAT,CAAb;AACD;;AAKD,SAASW,aAAT,CAAuBkB,MAAvB,EAA+B;AAC7B,OAAK,MAAMhB,GAAX,IAAkBgB,MAAlB,EAA0B;AACxB,WAAO,KAAP;AACD;;AACD,SAAO,IAAP;AACD","sourcesContent":["// Provides a unified API for getting and setting any WebGL parameter\n// Also knows default values of all parameters, enabling fast cache initialization\n// Provides base functionality for the state caching.\nimport {Device} from '@luma.gl/api';\nimport type {GLParameters} from '../../types/webgl';\nimport {\n  GL_PARAMETER_DEFAULTS,\n  GL_PARAMETER_SETTERS,\n  GL_COMPOSITE_PARAMETER_SETTERS,\n  GL_PARAMETER_GETTERS\n} from './webgl-parameter-tables';\n\nimport {isWebGL} from '../context/webgl-checks';\nimport WebGLDevice from '../../adapter/webgl-device';\n\nexport type {GLParameters};\n\n/**\n * Sets any GL parameter regardless of function (gl.blendMode, ...)\n *\n * @note requires a `cache` object to be set on the context (gl.state.cache)\n * This object is used to fill in any missing values for composite setter functions\n */\nexport function setParameters(\n  device: Device | WebGLRenderingContext,\n  parameters: GLParameters\n): void {\n  const webglDevice = WebGLDevice.attach(device);\n  const gl = webglDevice.gl;\n\n  if (isObjectEmpty(parameters)) {\n    return;\n  }\n\n  const compositeSetters = {};\n\n  // HANDLE PRIMITIVE SETTERS (and make note of any composite setters)\n\n  for (const key in parameters) {\n    const glConstant = Number(key);\n    const setter = GL_PARAMETER_SETTERS[key];\n    if (setter) {\n      // Composite setters should only be called once, so save them\n      if (typeof setter === 'string') {\n        compositeSetters[setter] = true;\n      } else {\n        // if (gl[glConstant] !== undefined) {\n        // TODO - added above check since this is being called on WebGL2 parameters in WebGL1...\n        // TODO - deep equal on values? only call setter if value has changed?\n        // NOTE - the setter will automatically update this.state\n        setter(gl, parameters[key], glConstant);\n      }\n    }\n  }\n\n  // HANDLE COMPOSITE SETTERS\n\n  // NOTE: any non-provided values needed by composite setters are filled in from state cache\n  // The cache parameter is automatically retrieved from the context\n  // This depends on `trackContextState`, which is technically a \"circular\" dependency.\n  // But it is too inconvenient to always require a cache parameter here.\n  // This is the ONLY external dependency in this module/\n  // @ts-expect-error\n  const cache = gl.state && gl.state.cache;\n  if (cache) {\n    for (const key in compositeSetters) {\n      // TODO - avoid calling composite setters if values have not changed.\n      const compositeSetter = GL_COMPOSITE_PARAMETER_SETTERS[key];\n      // Note - if `trackContextState` has been called,\n      // the setter will automatically update this.state.cache\n      compositeSetter(gl, parameters, cache);\n    }\n  }\n\n  // Add a log for the else case?\n}\n\n/**\n * Reads the entire WebGL state from a context\n\n  // default to querying all parameters\n\n  * @returns - a newly created map, with values keyed by GL parameters\n *\n * @note Copies the state from a context (gl.getParameter should not be overriden)\n * Reads the entire WebGL state from a context\n *\n * @note This can generates a huge amount of synchronous driver roundtrips and should be\n * considered a very slow operation, to be used only if/when a context already manipulated\n * by external code needs to be synchronized for the first time\n */\nexport function getParameters(\n  device: Device | WebGLRenderingContext,\n  parameters: keyof GLParameters | (keyof GLParameters)[] | GLParameters = GL_PARAMETER_DEFAULTS\n): GLParameters {\n  const webglDevice = WebGLDevice.attach(device);\n  const gl = webglDevice.gl;\n\n  // support both arrays of parameters and objects (keys represent parameters)\n\n  if (typeof parameters === 'number') {\n    // single GL enum\n    const key = parameters;\n    const getter = GL_PARAMETER_GETTERS[key];\n    return getter ? getter(gl, key) : gl.getParameter(key);\n  }\n\n  const parameterKeys = Array.isArray(parameters) ? parameters : Object.keys(parameters);\n\n  const state = {};\n  for (const key of parameterKeys) {\n    const getter = GL_PARAMETER_GETTERS[key];\n    state[key] = getter ? getter(gl, Number(key)) : gl.getParameter(Number(key));\n  }\n  return state;\n}\n\n/**\n * Reset all parameters to a (almost) pure context state\n * @note viewport and scissor will be set to the values in GL_PARAMETER_DEFAULTS,\n * NOT the canvas size dimensions, so they will have to be properly set after\n * calling this function.\n */\nexport function resetParameters(device: Device | WebGLRenderingContext): void {\n  setParameters(device, GL_PARAMETER_DEFAULTS);\n}\n\n// Helpers\n\n// Returns true if given object is empty, false otherwise.\nfunction isObjectEmpty(object) {\n  for (const key in object) {\n    return false;\n  }\n  return true;\n}\n"],"file":"unified-parameter-api.js"}