@luma.gl/webgl 9.0.0-alpha.5 → 9.0.0-alpha.51

package/dist/context/debug/webgl-developer-tools.d.ts

@@ -1,4 +1,4 @@
-declare type DebugContextProps = {
+type DebugContextProps = {
     debug?: boolean;
     throwOnError?: boolean;
     break?: string[];
@@ -14,6 +14,6 @@ declare global {
  * @see https://github.com/vorg/webgl-debug
  */
 export declare function loadWebGLDeveloperTools(): Promise<void>;
-export declare function makeDebugContext(gl: WebGLRenderingContext, props?: DebugContextProps): WebGLRenderingContext;
+export declare function makeDebugContext(gl: WebGLRenderingContext, props?: DebugContextProps): WebGLRenderingContext | null;
 export {};
 //# sourceMappingURL=webgl-developer-tools.d.ts.map

package/dist/context/debug/webgl-developer-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webgl-developer-tools.d.ts","sourceRoot":"","sources":["../../../src/context/debug/webgl-developer-tools.ts"],"names":[],"mappings":"AAMA,aAAK,iBAAiB,GAAG;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAeF,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,eAAe,EAAE,GAAG,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ7D;AAID,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,qBAAqB,EAAE,KAAK,GAAE,iBAAsB,GAAG,qBAAqB,CAOhH"}
+{"version":3,"file":"webgl-developer-tools.d.ts","sourceRoot":"","sources":["../../../src/context/debug/webgl-developer-tools.ts"],"names":[],"mappings":"AASA,KAAK,iBAAiB,GAAG;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAoBF,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,eAAe,EAAE,GAAG,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAO7D;AAID,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,qBAAqB,EAAE,KAAK,GAAE,iBAAsB,GAAG,qBAAqB,GAAG,IAAI,CAOvH"}

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

@@ -1,63 +1,48 @@
-import { log, loadScript } from '@luma.gl/api/';
-import GL from '@luma.gl/constants';
+import { log, loadScript } from '@luma.gl/core';
+import { isBrowser } from '@probe.gl/env';
 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: undefined,
-  webgl2: false
-};
-
 function getContextData(gl) {
   gl.luma = gl.luma || {};
   return gl.luma;
 }
-
 export async function loadWebGLDeveloperTools() {
-  if (!globalThis.WebGLDebugUtils) {
+  if (isBrowser() && !globalThis.WebGLDebugUtils) {
     globalThis.global = globalThis.global || globalThis;
     globalThis.global.module = {};
     await loadScript(WEBGL_DEBUG_CDN_URL);
   }
 }
-export function makeDebugContext(gl, props = {}) {
+export function makeDebugContext(gl) {
+  let props = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
   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,
+  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);
@@ -66,53 +51,44 @@ function getDebugContext(gl, props) {
   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, ")");
+  args = `${args.slice(0, 100)}${args.length > 100 ? '...' : ''}`;
+  return `gl.${functionName}(${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, ")");
+  const message = `${errorMessage} in ${glName}.${functionName}(${functionArgs})`;
   log.error(message)();
   debugger;
-
   if (props.throwOnError) {
     throw new Error(message);
   }
 }
-
 function onValidateGLFunc(props, functionName, functionArgs) {
-  let functionString;
-
+  let functionString = '';
   if (log.level >= 1) {
     functionString = getFunctionString(functionName, functionArgs);
     log.log(1, functionString)();
   }
-
-  if (props.break) {
+  if (props.break && props.break.length > 0) {
     functionString = functionString || getFunctionString(functionName, functionArgs);
-    const isBreakpoint = props.break && props.break.every(breakOn => functionString.indexOf(breakOn) !== -1);
-
+    const isBreakpoint = 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));
+        throw new Error(`Undefined argument: ${functionString}`);
       } else {
-        log.error("Undefined argument: ".concat(functionString))();
+        log.error(`Undefined argument: ${functionString}`)();
         debugger;
       }
     }

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

@@ -1 +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","undefined","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","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: undefined,\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 {\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"}
+{"version":3,"file":"webgl-developer-tools.js","names":["log","loadScript","isBrowser","WEBGL_DEBUG_CDN_URL","getContextData","gl","luma","loadWebGLDeveloperTools","globalThis","WebGLDebugUtils","global","module","makeDebugContext","props","arguments","length","undefined","debug","getDebugContext","getRealContext","data","realContext","warn","debugContext","init","GL","glDebug","onGLError","bind","onValidateGLFunc","key","WebGLDebugContext","Object","setPrototypeOf","getPrototypeOf","create","getFunctionString","functionName","functionArgs","Array","from","map","arg","args","glFunctionArgsToString","slice","err","errorMessage","glEnumToString","glName","webgl2","message","error","throwOnError","Error","functionString","level","break","isBreakpoint","every","breakOn","indexOf"],"sources":["../../../src/context/debug/webgl-developer-tools.ts"],"sourcesContent":["// luma.gl, MIT license\n// Copyright (c) vis.gl contributors\n\nimport {log, loadScript} from '@luma.gl/core';\nimport {GL} from '@luma.gl/constants';\nimport {isBrowser} from '@probe.gl/env'\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\n// const DEFAULT_DEBUG_CONTEXT_PROPS: Required<DebugContextProps> = {\n//   debug: true,\n//   throwOnError: false,\n//   break: [],\n//   webgl2: false,\n// }\n\ntype ContextData = {\n  realContext?: WebGLRenderingContext;\n  debugContext?: WebGLRenderingContext;\n}\n\n// Helper to get shared context data\nfunction getContextData(gl: any): ContextData {\n  gl.luma = gl.luma || {};\n  return gl.luma;\n}\n\ndeclare global {\n  // eslint-disable-next-line no-var\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 (isBrowser() && !globalThis.WebGLDebugUtils) {\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 array of breakpoint strings supplied, check if any of them is contained in current GL function\n  if (props.break && props.break.length > 0) {\n    functionString = functionString || getFunctionString(functionName, functionArgs);\n    const isBreakpoint = 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"],"mappings":"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"}

package/dist/context/parameters/unified-parameter-api.d.ts

@@ -1,5 +1,5 @@
-import { Device } from '@luma.gl/api';
-import type { GLParameters } from '../../types/webgl';
+import { Device } from '@luma.gl/core';
+import type { GLParameters } from '@luma.gl/constants';
 export type { GLParameters };
 /**
  * Sets any GL parameter regardless of function (gl.blendMode, ...)
@@ -7,10 +7,13 @@ export type { GLParameters };
  * @note requires a `cache` object to be set on the context (gl.state.cache)
  * This object is used to fill in any missing values for composite setter functions
  */
-export declare function setParameters(device: Device | WebGLRenderingContext, parameters: GLParameters): void;
+export declare function setGLParameters(device: Device | WebGLRenderingContext, parameters: GLParameters): void;
 /**
  * Reads the entire WebGL state from a context
- * @returns - a newly created map, with values keyed by GL parameters
+
+  // default to querying all parameters
+
+  * @returns - a newly created map, with values keyed by GL parameters
  *
  * @note Copies the state from a context (gl.getParameter should not be overriden)
  * Reads the entire WebGL state from a context
@@ -19,14 +22,12 @@ export declare function setParameters(device: Device | WebGLRenderingContext, pa
  * considered a very slow operation, to be used only if/when a context already manipulated
  * by external code needs to be synchronized for the first time
  */
-export declare function getParameters(gl: WebGLRenderingContext, parameters?: Record<keyof GLParameters, any>): GLParameters;
-export declare function getParameters(gl: WebGLRenderingContext, parameters?: (keyof GLParameters)[]): GLParameters;
-export declare function getParameters(gl: WebGLRenderingContext, parameters: keyof GLParameters): GLParameters;
+export declare function getGLParameters(device: Device | WebGLRenderingContext, parameters?: keyof GLParameters | (keyof GLParameters)[] | GLParameters): GLParameters;
 /**
  * Reset all parameters to a (almost) pure context state
  * @note viewport and scissor will be set to the values in GL_PARAMETER_DEFAULTS,
  * NOT the canvas size dimensions, so they will have to be properly set after
  * calling this function.
  */
-export declare function resetParameters(gl: WebGLRenderingContext): void;
+export declare function resetGLParameters(device: Device | WebGLRenderingContext): void;
 //# sourceMappingURL=unified-parameter-api.d.ts.map

package/dist/context/parameters/unified-parameter-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unified-parameter-api.d.ts","sourceRoot":"","sources":["../../../src/context/parameters/unified-parameter-api.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,MAAM,EAAC,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAWpD,YAAY,EAAC,YAAY,EAAC,CAAC;AAE3B;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,EAAE,UAAU,EAAE,YAAY,GAAG,IAAI,CAiDpG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,qBAAqB,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,YAAY,EAAE,GAAG,CAAC,GAAG,YAAY,CAAC;AACrH,wBAAgB,aAAa,CAAC,EAAE,EAAE,qBAAqB,EAAE,UAAU,CAAC,EAAE,CAAC,MAAM,YAAY,CAAC,EAAE,GAAG,YAAY,CAAC;AAC5G,wBAAgB,aAAa,CAAC,EAAE,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,YAAY,GAAG,YAAY,CAAC;AAwBvG;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,qBAAqB,GAAG,IAAI,CAE/D"}
+{"version":3,"file":"unified-parameter-api.d.ts","sourceRoot":"","sources":["../../../src/context/parameters/unified-parameter-api.ts"],"names":[],"mappings":"AAMA,OAAO,EAAC,MAAM,EAAC,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAUrD,YAAY,EAAC,YAAY,EAAC,CAAC;AAE3B;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,GAAG,qBAAqB,EACtC,UAAU,EAAE,YAAY,GACvB,IAAI,CAiDN;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,GAAG,qBAAqB,EACtC,UAAU,GAAE,MAAM,YAAY,GAAG,CAAC,MAAM,YAAY,CAAC,EAAE,GAAG,YAAoC,GAC7F,YAAY,CAqBd;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAE9E"}

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

@@ -1,19 +1,15 @@
-import { GL_PARAMETER_DEFAULTS, GL_PARAMETER_SETTERS, GL_COMPOSITE_PARAMETER_SETTERS, GL_PARAMETER_GETTERS } from './webgl-parameter-tables';
-import WebGLDevice from '../../adapter/webgl-device';
-export function setParameters(device, parameters) {
+import { GL_PARAMETER_DEFAULTS, GL_PARAMETER_SETTERS, GL_COMPOSITE_PARAMETER_SETTERS, GL_PARAMETER_GETTERS } from "./webgl-parameter-tables.js";
+import { WebGLDevice } from "../../adapter/webgl-device.js";
+export function setGLParameters(device, parameters) {
   const webglDevice = WebGLDevice.attach(device);
   const gl = webglDevice.gl;
-
   if (isObjectEmpty(parameters)) {
     return;
   }
-
   const compositeSetters = {};
-
   for (const key in parameters) {
     const glConstant = Number(key);
     const setter = GL_PARAMETER_SETTERS[key];
-
     if (setter) {
       if (typeof setter === 'string') {
         compositeSetters[setter] = true;
@@ -22,9 +18,7 @@ export function setParameters(device, parameters) {
       }
     }
   }
-
   const cache = gl.state && gl.state.cache;
-
   if (cache) {
     for (const key in compositeSetters) {
       const compositeSetter = GL_COMPOSITE_PARAMETER_SETTERS[key];
@@ -32,34 +26,30 @@ export function setParameters(device, parameters) {
     }
   }
 }
-export function getParameters(gl, parameters) {
-  parameters = parameters || GL_PARAMETER_DEFAULTS;
-
+export function getGLParameters(device) {
+  let parameters = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : GL_PARAMETER_DEFAULTS;
+  const webglDevice = WebGLDevice.attach(device);
+  const gl = webglDevice.gl;
   if (typeof parameters === 'number') {
     const key = parameters;
     const getter = GL_PARAMETER_GETTERS[key];
     return getter ? getter(gl, key) : gl.getParameter(key);
   }
-
   const parameterKeys = Array.isArray(parameters) ? parameters : Object.keys(parameters);
   const state = {};
-
   for (const key of parameterKeys) {
     const getter = GL_PARAMETER_GETTERS[key];
     state[key] = getter ? getter(gl, Number(key)) : gl.getParameter(Number(key));
   }
-
   return state;
 }
-export function resetParameters(gl) {
-  setParameters(gl, GL_PARAMETER_DEFAULTS);
+export function resetGLParameters(device) {
+  setGLParameters(device, GL_PARAMETER_DEFAULTS);
 }
-
 function isObjectEmpty(object) {
   for (const key in object) {
     return false;
   }
-
   return true;
 }
 //# sourceMappingURL=unified-parameter-api.js.map

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

@@ -1 +1 @@
-{"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,CAAuBC,MAAvB,EAA+DC,UAA/D,EAA+F;AACpG,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;AAiBD,OAAO,SAASG,aAAT,CAAuBV,EAAvB,EAA2BH,UAA3B,EAAuC;AAE5CA,EAAAA,UAAU,GAAGA,UAAU,IAAIP,qBAA3B;;AAGA,MAAI,OAAOO,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,CAAyBlB,EAAzB,EAA0D;AAC/DL,EAAAA,aAAa,CAACK,EAAD,EAAKV,qBAAL,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(device: Device | WebGLRenderingContext, parameters: GLParameters): 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 * @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,"file":"unified-parameter-api.js","names":["GL_PARAMETER_DEFAULTS","GL_PARAMETER_SETTERS","GL_COMPOSITE_PARAMETER_SETTERS","GL_PARAMETER_GETTERS","WebGLDevice","setGLParameters","device","parameters","webglDevice","attach","gl","isObjectEmpty","compositeSetters","key","glConstant","Number","setter","cache","state","compositeSetter","getGLParameters","arguments","length","undefined","getter","getParameter","parameterKeys","Array","isArray","Object","keys","resetGLParameters","object"],"sources":["../../../src/context/parameters/unified-parameter-api.ts"],"sourcesContent":["// luma.gl, MIT license\n// Copyright (c) vis.gl contributors\n\n// 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/core';\nimport type {GLParameters} from '@luma.gl/constants';\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 {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 setGLParameters(\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 getGLParameters(\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 resetGLParameters(device: Device | WebGLRenderingContext): void {\n  setGLParameters(device, GL_PARAMETER_DEFAULTS);\n}\n\n// Helpers\n\n// Returns true if given object is empty, false otherwise.\nfunction isObjectEmpty(object) {\n  // @ts-ignore dummy key variable\n  for (const key in object) {\n    return false;\n  }\n  return true;\n}\n"],"mappings":"SASEA,qBAAqB,EACrBC,oBAAoB,EACpBC,8BAA8B,EAC9BC,oBAAoB;AAAA,SAGdC,WAAW;AAUnB,OAAO,SAASC,eAAeA,CAC7BC,MAAsC,EACtCC,UAAwB,EAClB;EACN,MAAMC,WAAW,GAAGJ,WAAW,CAACK,MAAM,CAACH,MAAM,CAAC;EAC9C,MAAMI,EAAE,GAAGF,WAAW,CAACE,EAAE;EAEzB,IAAIC,aAAa,CAACJ,UAAU,CAAC,EAAE;IAC7B;EACF;EAEA,MAAMK,gBAAgB,GAAG,CAAC,CAAC;EAI3B,KAAK,MAAMC,GAAG,IAAIN,UAAU,EAAE;IAC5B,MAAMO,UAAU,GAAGC,MAAM,CAACF,GAAG,CAAC;IAC9B,MAAMG,MAAM,GAAGf,oBAAoB,CAACY,GAAG,CAAC;IACxC,IAAIG,MAAM,EAAE;MAEV,IAAI,OAAOA,MAAM,KAAK,QAAQ,EAAE;QAC9BJ,gBAAgB,CAACI,MAAM,CAAC,GAAG,IAAI;MACjC,CAAC,MAAM;QAKLA,MAAM,CAACN,EAAE,EAAEH,UAAU,CAACM,GAAG,CAAC,EAAEC,UAAU,CAAC;MACzC;IACF;EACF;EAUA,MAAMG,KAAK,GAAGP,EAAE,CAACQ,KAAK,IAAIR,EAAE,CAACQ,KAAK,CAACD,KAAK;EACxC,IAAIA,KAAK,EAAE;IACT,KAAK,MAAMJ,GAAG,IAAID,gBAAgB,EAAE;MAElC,MAAMO,eAAe,GAAGjB,8BAA8B,CAACW,GAAG,CAAC;MAG3DM,eAAe,CAACT,EAAE,EAAEH,UAAU,EAAEU,KAAK,CAAC;IACxC;EACF;AAGF;AAgBA,OAAO,SAASG,eAAeA,CAC7Bd,MAAsC,EAExB;EAAA,IADdC,UAAsE,GAAAc,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAGrB,qBAAqB;EAE9F,MAAMQ,WAAW,GAAGJ,WAAW,CAACK,MAAM,CAACH,MAAM,CAAC;EAC9C,MAAMI,EAAE,GAAGF,WAAW,CAACE,EAAE;EAIzB,IAAI,OAAOH,UAAU,KAAK,QAAQ,EAAE;IAElC,MAAMM,GAAG,GAAGN,UAAU;IACtB,MAAMiB,MAAM,GAAGrB,oBAAoB,CAACU,GAAG,CAAC;IACxC,OAAOW,MAAM,GAAGA,MAAM,CAACd,EAAE,EAAEG,GAAG,CAAC,GAAGH,EAAE,CAACe,YAAY,CAACZ,GAAG,CAAC;EACxD;EAEA,MAAMa,aAAa,GAAGC,KAAK,CAACC,OAAO,CAACrB,UAAU,CAAC,GAAGA,UAAU,GAAGsB,MAAM,CAACC,IAAI,CAACvB,UAAU,CAAC;EAEtF,MAAMW,KAAK,GAAG,CAAC,CAAC;EAChB,KAAK,MAAML,GAAG,IAAIa,aAAa,EAAE;IAC/B,MAAMF,MAAM,GAAGrB,oBAAoB,CAACU,GAAG,CAAC;IACxCK,KAAK,CAACL,GAAG,CAAC,GAAGW,MAAM,GAAGA,MAAM,CAACd,EAAE,EAAEK,MAAM,CAACF,GAAG,CAAC,CAAC,GAAGH,EAAE,CAACe,YAAY,CAACV,MAAM,CAACF,GAAG,CAAC,CAAC;EAC9E;EACA,OAAOK,KAAK;AACd;AAQA,OAAO,SAASa,iBAAiBA,CAACzB,MAAsC,EAAQ;EAC9ED,eAAe,CAACC,MAAM,EAAEN,qBAAqB,CAAC;AAChD;AAKA,SAASW,aAAaA,CAACqB,MAAM,EAAE;EAE7B,KAAK,MAAMnB,GAAG,IAAImB,MAAM,EAAE;IACxB,OAAO,KAAK;EACd;EACA,OAAO,IAAI;AACb"}

package/dist/context/parameters/webgl-parameter-tables.d.ts

@@ -1,54 +1,53 @@
-import GL from '@luma.gl/constants';
-import type { GLParameters } from '../../types/webgl';
+import { GL, GLParameters } from '@luma.gl/constants';
 export declare const GL_PARAMETER_DEFAULTS: GLParameters;
 export declare const GL_PARAMETER_SETTERS: {
-    3042: (gl: any, value: any, key: any) => any;
-    32773: (gl: any, value: any) => any;
+    3042: (gl: WebGLRenderingContext, value: unknown, key: GL) => void;
+    32773: (gl: WebGLRenderingContext, value: [number, number, number, number]) => void;
     32777: string;
     34877: string;
     32969: string;
     32968: string;
     32971: string;
     32970: string;
-    3106: (gl: any, value: any) => any;
-    3107: (gl: any, value: any) => any;
-    2884: (gl: any, value: any, key: any) => any;
-    2885: (gl: any, value: any) => any;
-    2929: (gl: any, value: any, key: any) => any;
-    2931: (gl: any, value: any) => any;
-    2932: (gl: any, value: any) => any;
-    2928: (gl: any, value: any) => any;
-    2930: (gl: any, value: any) => any;
-    3024: (gl: any, value: any, key: any) => any;
-    35723: (gl: any, value: any, key: any) => any;
-    35725: (gl: any, value: any) => any;
-    36007: (gl: any, value: any) => any;
-    36389: (gl: any, value: any) => any;
-    34229: (gl: any, value: any) => any;
-    36006: (gl: any, value: any, key: any) => any;
-    36010: (gl: any, value: any, key: any) => any;
-    34964: (gl: any, value: any, key: any) => void;
-    36662: (gl: any, value: any, key: any) => void;
-    36663: (gl: any, value: any, key: any) => void;
-    35053: (gl: any, value: any, key: any) => void;
-    35055: (gl: any, value: any, key: any) => void;
-    2886: (gl: any, value: any) => any;
-    33170: (gl: any, value: any, key: any) => any;
-    2849: (gl: any, value: any) => any;
-    32823: (gl: any, value: any, key: any) => any;
+    3106: (gl: WebGLRenderingContext, value: [number, number, number, number]) => void;
+    3107: (gl: WebGLRenderingContext, value: [boolean, boolean, boolean, boolean]) => void;
+    2884: (gl: WebGLRenderingContext, value: unknown, key: GL) => void;
+    2885: (gl: WebGLRenderingContext, value: any) => void;
+    2929: (gl: WebGLRenderingContext, value: unknown, key: GL) => void;
+    2931: (gl: WebGLRenderingContext, value: any) => void;
+    2932: (gl: WebGLRenderingContext, value: any) => void;
+    2928: (gl: WebGLRenderingContext, value: [number, number]) => void;
+    2930: (gl: WebGLRenderingContext, value: any) => void;
+    3024: (gl: WebGLRenderingContext, value: unknown, key: GL) => void;
+    35723: (gl: WebGLRenderingContext, value: GL, key: GL) => void;
+    35725: (gl: WebGLRenderingContext, value: any) => void;
+    36007: (gl: WebGLRenderingContext, value: any) => void;
+    36389: (gl: WebGLRenderingContext, value: any) => void;
+    34229: (gl: WebGLRenderingContext, value: any) => void;
+    36006: (gl: WebGLRenderingContext, value: unknown, key: GL) => void;
+    36010: (gl: WebGLRenderingContext, value: unknown, key: GL) => void;
+    34964: (gl: WebGLRenderingContext, value: unknown, key: GL) => void;
+    36662: (gl: WebGLRenderingContext, value: unknown, key: GL) => void;
+    36663: (gl: WebGLRenderingContext, value: unknown, key: GL) => void;
+    35053: (gl: WebGLRenderingContext, value: unknown, key: GL) => void;
+    35055: (gl: WebGLRenderingContext, value: unknown, key: GL) => void;
+    2886: (gl: WebGLRenderingContext, value: any) => void;
+    33170: (gl: WebGLRenderingContext, value: GL, key: GL) => void;
+    2849: (gl: WebGLRenderingContext, value: any) => void;
+    32823: (gl: WebGLRenderingContext, value: unknown, key: GL) => void;
     32824: string;
     10752: string;
-    35977: (gl: any, value: any, key: any) => any;
-    32926: (gl: any, value: any, key: any) => any;
-    32928: (gl: any, value: any, key: any) => any;
+    35977: (gl: WebGLRenderingContext, value: unknown, key: GL) => void;
+    32926: (gl: WebGLRenderingContext, value: unknown, key: GL) => void;
+    32928: (gl: WebGLRenderingContext, value: unknown, key: GL) => void;
     32938: string;
     32939: string;
-    3089: (gl: any, value: any, key: any) => any;
-    3088: (gl: any, value: any) => any;
-    2960: (gl: any, value: any, key: any) => any;
-    2961: (gl: any, value: any) => any;
-    2968: (gl: any, value: any) => any;
-    36005: (gl: any, value: any) => any;
+    3089: (gl: WebGLRenderingContext, value: unknown, key: GL) => void;
+    3088: (gl: WebGLRenderingContext, value: [number, number, number, number]) => void;
+    2960: (gl: WebGLRenderingContext, value: unknown, key: GL) => void;
+    2961: (gl: WebGLRenderingContext, value: any) => void;
+    2968: (gl: WebGLRenderingContext, value: any) => void;
+    36005: (gl: WebGLRenderingContext, value: any) => void;
     2962: string;
     2967: string;
     2963: string;
@@ -61,67 +60,67 @@ export declare const GL_PARAMETER_SETTERS: {
     34817: string;
     34818: string;
     34819: string;
-    2978: (gl: any, value: any) => any;
-    3333: (gl: any, value: any, key: any) => any;
-    3317: (gl: any, value: any, key: any) => any;
-    37440: (gl: any, value: any, key: any) => any;
-    37441: (gl: any, value: any, key: any) => any;
-    37443: (gl: any, value: any, key: any) => any;
-    3330: (gl: any, value: any, key: any) => any;
-    3332: (gl: any, value: any, key: any) => any;
-    3331: (gl: any, value: any, key: any) => any;
-    3314: (gl: any, value: any, key: any) => any;
-    32878: (gl: any, value: any, key: any) => any;
-    3316: (gl: any, value: any, key: any) => any;
-    3315: (gl: any, value: any, key: any) => any;
-    32877: (gl: any, value: any, key: any) => any;
-    framebuffer: (gl: any, framebuffer: any) => any;
-    blend: (gl: any, value: any) => any;
-    blendColor: (gl: any, value: any) => any;
-    blendEquation: (gl: any, args: any) => void;
-    blendFunc: (gl: any, args: any) => void;
-    clearColor: (gl: any, value: any) => any;
-    clearDepth: (gl: any, value: any) => any;
-    clearStencil: (gl: any, value: any) => any;
-    colorMask: (gl: any, value: any) => any;
-    cull: (gl: any, value: any) => any;
-    cullFace: (gl: any, value: any) => any;
-    depthTest: (gl: any, value: any) => any;
-    depthFunc: (gl: any, value: any) => any;
-    depthMask: (gl: any, value: any) => any;
-    depthRange: (gl: any, value: any) => any;
-    dither: (gl: any, value: any) => any;
-    derivativeHint: (gl: any, value: any) => void;
-    frontFace: (gl: any, value: any) => any;
-    mipmapHint: (gl: any, value: any) => any;
-    lineWidth: (gl: any, value: any) => any;
-    polygonOffsetFill: (gl: any, value: any) => any;
-    polygonOffset: (gl: any, value: any) => any;
-    sampleCoverage: (gl: any, value: any) => any;
-    scissorTest: (gl: any, value: any) => any;
-    scissor: (gl: any, value: any) => any;
-    stencilTest: (gl: any, value: any) => any;
-    stencilMask: (gl: any, value: any) => void;
-    stencilFunc: (gl: any, args: any) => void;
-    stencilOp: (gl: any, args: any) => void;
-    viewport: (gl: any, value: any) => any;
+    2978: (gl: WebGLRenderingContext, value: [number, number, number, number]) => void;
+    3333: (gl: WebGLRenderingContext, value: number | boolean, key: GL) => void;
+    3317: (gl: WebGLRenderingContext, value: number | boolean, key: GL) => void;
+    37440: (gl: WebGLRenderingContext, value: number | boolean, key: GL) => void;
+    37441: (gl: WebGLRenderingContext, value: number | boolean, key: GL) => void;
+    37443: (gl: WebGLRenderingContext, value: number | boolean, key: GL) => void;
+    3330: (gl: WebGLRenderingContext, value: number | boolean, key: GL) => void;
+    3332: (gl: WebGLRenderingContext, value: number | boolean, key: GL) => void;
+    3331: (gl: WebGLRenderingContext, value: number | boolean, key: GL) => void;
+    3314: (gl: WebGLRenderingContext, value: number | boolean, key: GL) => void;
+    32878: (gl: WebGLRenderingContext, value: number | boolean, key: GL) => void;
+    3316: (gl: WebGLRenderingContext, value: number | boolean, key: GL) => void;
+    3315: (gl: WebGLRenderingContext, value: number | boolean, key: GL) => void;
+    32877: (gl: WebGLRenderingContext, value: number | boolean, key: GL) => void;
+    framebuffer: (gl: WebGLRenderingContext, framebuffer: any) => void;
+    blend: (gl: WebGLRenderingContext, value: any) => void;
+    blendColor: (gl: WebGLRenderingContext, value: [number, number, number, number]) => void;
+    blendEquation: (gl: WebGLRenderingContext, args: number | [number, number]) => void;
+    blendFunc: (gl: WebGLRenderingContext, args: [number, number] | [number, number, number, number]) => void;
+    clearColor: (gl: WebGLRenderingContext, value: [number, number, number, number]) => void;
+    clearDepth: (gl: WebGLRenderingContext, value: any) => void;
+    clearStencil: (gl: WebGLRenderingContext, value: any) => void;
+    colorMask: (gl: WebGLRenderingContext, value: [boolean, boolean, boolean, boolean]) => void;
+    cull: (gl: WebGLRenderingContext, value: any) => void;
+    cullFace: (gl: WebGLRenderingContext, value: any) => void;
+    depthTest: (gl: WebGLRenderingContext, value: any) => void;
+    depthFunc: (gl: WebGLRenderingContext, value: any) => void;
+    depthMask: (gl: WebGLRenderingContext, value: any) => void;
+    depthRange: (gl: WebGLRenderingContext, value: [number, number]) => void;
+    dither: (gl: WebGLRenderingContext, value: any) => void;
+    derivativeHint: (gl: WebGLRenderingContext, value: any) => void;
+    frontFace: (gl: WebGLRenderingContext, value: any) => void;
+    mipmapHint: (gl: WebGLRenderingContext, value: any) => void;
+    lineWidth: (gl: WebGLRenderingContext, value: any) => void;
+    polygonOffsetFill: (gl: WebGLRenderingContext, value: any) => void;
+    polygonOffset: (gl: WebGLRenderingContext, value: [number, number]) => void;
+    sampleCoverage: (gl: WebGLRenderingContext, value: [number, boolean?]) => void;
+    scissorTest: (gl: WebGLRenderingContext, value: any) => void;
+    scissor: (gl: WebGLRenderingContext, value: [number, number, number, number]) => void;
+    stencilTest: (gl: WebGLRenderingContext, value: any) => void;
+    stencilMask: (gl: WebGLRenderingContext, value: any) => void;
+    stencilFunc: (gl: WebGLRenderingContext, args: any) => void;
+    stencilOp: (gl: WebGLRenderingContext, args: any) => void;
+    viewport: (gl: WebGLRenderingContext, value: [number, number, number, number]) => void;
 };
 export declare const GL_COMPOSITE_PARAMETER_SETTERS: {
-    blendEquation: (gl: any, values: any, cache: any) => any;
-    blendFunc: (gl: any, values: any, cache: any) => any;
-    polygonOffset: (gl: any, values: any, cache: any) => any;
-    sampleCoverage: (gl: any, values: any, cache: any) => any;
-    stencilFuncFront: (gl: any, values: any, cache: any) => any;
-    stencilFuncBack: (gl: any, values: any, cache: any) => any;
-    stencilOpFront: (gl: any, values: any, cache: any) => any;
-    stencilOpBack: (gl: any, values: any, cache: any) => any;
+    blendEquation: (gl: WebGLRenderingContext, values: any, cache: any) => void;
+    blendFunc: (gl: WebGLRenderingContext, values: any, cache: any) => void;
+    polygonOffset: (gl: WebGLRenderingContext, values: any, cache: any) => void;
+    sampleCoverage: (gl: WebGLRenderingContext, values: any, cache: any) => void;
+    stencilFuncFront: (gl: WebGLRenderingContext, values: any, cache: any) => void;
+    stencilFuncBack: (gl: WebGLRenderingContext, values: any, cache: any) => void;
+    stencilOpFront: (gl: WebGLRenderingContext, values: any, cache: any) => void;
+    stencilOpBack: (gl: WebGLRenderingContext, values: any, cache: any) => void;
 };
-declare type UpdateFunc = (params: Record<string, any>) => void;
+type UpdateFunc = (params: Record<string, any>) => void;
 export declare const GL_HOOKED_SETTERS: {
-    enable: (update: UpdateFunc, capability: any) => void;
-    disable: (update: UpdateFunc, capability: any) => void;
-    pixelStorei: (update: UpdateFunc, pname: any, value: any) => void;
-    hint: (update: UpdateFunc, pname: any, hint: any) => void;
+    enable: (update: UpdateFunc, capability: GL) => void;
+    disable: (update: UpdateFunc, capability: GL) => void;
+    pixelStorei: (update: UpdateFunc, pname: GL, value: any) => void;
+    hint: (update: UpdateFunc, pname: GL, hint: GL) => void;
     useProgram: (update: UpdateFunc, value: any) => void;
     bindRenderbuffer: (update: UpdateFunc, target: any, value: any) => void;
     bindTransformFeedback: (update: UpdateFunc, target: any, value: any) => void;
@@ -157,16 +156,16 @@ export declare const GL_HOOKED_SETTERS: {
     viewport: (update: UpdateFunc, x: any, y: any, width: any, height: any) => void;
 };
 export declare const GL_PARAMETER_GETTERS: {
-    3042: (gl: any, key: any) => any;
-    2884: (gl: any, key: any) => any;
-    2929: (gl: any, key: any) => any;
-    3024: (gl: any, key: any) => any;
-    32823: (gl: any, key: any) => any;
-    32926: (gl: any, key: any) => any;
-    32928: (gl: any, key: any) => any;
-    3089: (gl: any, key: any) => any;
-    2960: (gl: any, key: any) => any;
-    35977: (gl: any, key: any) => any;
+    3042: (gl: WebGLRenderingContext, key: any) => boolean;
+    2884: (gl: WebGLRenderingContext, key: any) => boolean;
+    2929: (gl: WebGLRenderingContext, key: any) => boolean;
+    3024: (gl: WebGLRenderingContext, key: any) => boolean;
+    32823: (gl: WebGLRenderingContext, key: any) => boolean;
+    32926: (gl: WebGLRenderingContext, key: any) => boolean;
+    32928: (gl: WebGLRenderingContext, key: any) => boolean;
+    3089: (gl: WebGLRenderingContext, key: any) => boolean;
+    2960: (gl: WebGLRenderingContext, key: any) => boolean;
+    35977: (gl: WebGLRenderingContext, key: any) => boolean;
 };
 export declare const NON_CACHE_PARAMETERS: Set<GL>;
 export {};