@luma.gl/webgl 9.0.0-alpha.4 → 9.0.0-alpha.40

package/src/context/context/create-context.ts

@@ -1,110 +0,0 @@
-// luma.gl, MIT license
-
-/**
- * ContextProps
-* @param webgl2 Set to false to not create a WebGL2 context (force webgl1)
-* @param webgl1 set to false to not create a WebGL1 context (fail if webgl2 not available)
-* @param onContextLost
-* @param onContextRestored
-*
-* BROWSER CONTEXT PARAMETERS
-* @param debug Instrument context (at the expense of performance).
-* @param alpha Default render target has an alpha buffer.
-* @param depth Default render target has a depth buffer of at least 16 bits.
-* @param stencil Default render target has a stencil buffer of at least 8 bits.
-* @param antialias Boolean that indicates whether or not to perform anti-aliasing.
-* @param premultipliedAlpha Boolean that indicates that the page compositor will assume the drawing buffer contains colors with pre-multiplied alpha.
-* @param preserveDrawingBuffer Default render target buffers will not be automatically cleared and will preserve their values until cleared or overwritten
-* @param failIfMajorPerformanceCaveat Do not create if the system performance is low.
-*/
-type ContextProps = {
-  type?: 'webgl' | 'webgl1' | 'webgl2' | string;
-  webgl1?: boolean;
-  webgl2?: boolean;
-  onContextLost?: (event: Event) => void;
-  onContextRestored?: (event: Event) => void;
-  alpha?: boolean; // indicates if the canvas contains an alpha buffer.
-  desynchronized?: boolean; // hints the user agent to reduce the latency by desynchronizing the canvas paint cycle from the event loop
-  antialias?: boolean; // indicates whether or not to perform anti-aliasing.
-  depth?: boolean; // indicates that the drawing buffer has a depth buffer of at least 16 bits.
-  failIfMajorPerformanceCaveat?: boolean, // indicates if a context will be created if the system performance is low or if no hardware GPU is available.
-  powerPreference?: 'default' |  'high-performance' | 'low-power',
-  premultipliedAlpha?: boolean, // page compositor will assume the drawing buffer contains colors with pre-multiplied alpha.
-  preserveDrawingBuffer?: boolean // buffers will not be cleared and will preserve their values until cleared or overwritten by the author.
-};
-
-const DEFAULT_CONTEXT_PROPS: ContextProps = {
-  webgl2: true, // Attempt to create a WebGL2 context
-  webgl1: true, // Attempt to create a WebGL1 context (false to fail if webgl2 not available)
-  powerPreference: 'high-performance', // After all, most apps are using WebGL for performance reasons
-  onContextLost: () => console.error('WebGL context lost'),
-  onContextRestored: () => console.info('WebGL context restored'),
-};
-
-/**
- * Create a WebGL context for a canvas
- * Note calling this multiple time on the same canvas does return the same context
-* @param canvas A canvas element or offscreen canvas
- */
- export function createBrowserContext(canvas: HTMLCanvasElement | OffscreenCanvas, props: ContextProps): WebGLRenderingContext {
-   props = {...DEFAULT_CONTEXT_PROPS, ...props};
-
-  // Try to extract any extra information about why context creation failed
-  let errorMessage = null;
-  const onCreateError = (error) => (errorMessage = error.statusMessage || errorMessage);
-  canvas.addEventListener('webglcontextcreationerror', onCreateError, false);
-
-  // Create the desired context
-  let gl = null;
-
-  if (props.type === 'webgl2') {
-    props = {...props, webgl1: false};
-  }
-  if (props.type === 'webgl1') {
-    props = {...props, webgl2: false};
-  }
-
-  // Prefer webgl2 over webgl1 if both are acceptable
-  if (props.webgl2) {
-    gl = gl || canvas.getContext('webgl2', props);
-  }
-  if (props.webgl1) {
-    gl = gl || canvas.getContext('webgl', props);
-  }
-
-  // TODO are we removing this listener before giving it a chance to fire?
-  canvas.removeEventListener('webglcontextcreationerror', onCreateError, false);
-
-  if (!gl) {
-    throw new Error(
-      `Failed to create ${props.webgl2 && !props.webgl1 ? 'WebGL2' : 'WebGL'} context: ${
-        errorMessage || 'Unknown error'
-      }`
-    );
-  }
-
-  canvas.addEventListener('webglcontextlost', props.onContextLost, false);
-  canvas.addEventListener('webglcontextrestored', props.onContextRestored, false);
-
-  return gl;
-}
-
-/* TODO - can we call this asynchronously to catch the error events?
-export async function createBrowserContextAsync(canvas: HTMLCanvasElement | OffscreenCanvas, props: ContextProps): Promise<WebGLRenderingContext> {
-  props = {...DEFAULT_CONTEXT_PROPS, ...props};
-
- // Try to extract any extra information about why context creation failed
- let errorMessage = null;
- const onCreateError = (error) => (errorMessage = error.statusMessage || errorMessage);
- canvas.addEventListener('webglcontextcreationerror', onCreateError, false);
-
- const gl = createBrowserContext(canvas, props);
-
- // Give the listener a chance to fire
- await new Promise(resolve => setTimeout(resolve, 0));
-
- canvas.removeEventListener('webglcontextcreationerror', onCreateError, false);
-
- return gl;
-}
-*/

package/src/context/context/device-pixels.ts

@@ -1,152 +0,0 @@
-import {log} from '@luma.gl/api';
-import {getContextState} from './context-state';
-
-/**
- * Returns multiplier need to convert CSS size to Device size
- */
-export function cssToDeviceRatio(gl: WebGLRenderingContext): number {
-  const state = getContextState(gl);
-
-  if (gl.canvas && state) {
-    // For headless gl we might have used custom width and height
-    // hence use cached clientWidth
-    const {clientWidth} = state._canvasSizeInfo;
-    return clientWidth ? gl.drawingBufferWidth / clientWidth : 1;
-  }
-  // use default device pixel ratio
-  return 1;
-}
-
-/**
- * Maps CSS pixel position to device pixel position
- */
- export function cssToDevicePixels(
-  gl: WebGLRenderingContext,
-  cssPixel: number[],
-  yInvert: boolean = true
-): {
-  x: number;
-  y: number;
-  width: number;
-  height: number;
-} {
-  const ratio = cssToDeviceRatio(gl);
-  const width = gl.drawingBufferWidth;
-  const height = gl.drawingBufferHeight;
-  return scalePixels(cssPixel, ratio, width, height, yInvert);
-}
-
-/**
- * Calulates device pixel ratio, used during context creation
- *
- * @param useDevicePixels - boolean or a number
- * @return - device pixel ratio
- */
- export function getDevicePixelRatio(useDevicePixels: boolean | number): number {
-  const windowRatio = typeof window === 'undefined' ? 1 : window.devicePixelRatio || 1;
-  if (Number.isFinite(useDevicePixels)) {
-    // @ts-expect-error Can no longer be boolean after previous line
-    return useDevicePixels <= 0 ? 1 : useDevicePixels;
-  }
-  return useDevicePixels ? windowRatio : 1;
-}
-
-// use devicePixelRatio to set canvas width and height
-export function setDevicePixelRatio(gl: WebGLRenderingContext, devicePixelRatio: number, options: {width?: number, height?: number} = {}) {
-  // NOTE: if options.width and options.height not used remove in v8
-  let clientWidth = 'width' in options ? options.width : gl.canvas.clientWidth;
-  let clientHeight = 'height' in options ? options.height : gl.canvas.clientHeight;
-
-  if (!clientWidth || !clientHeight) {
-    log.log(1, 'Canvas clientWidth/clientHeight is 0')();
-    // by forcing devicePixel ratio to 1, we do not scale gl.canvas.width and height in each frame.
-    devicePixelRatio = 1;
-    clientWidth = gl.canvas.width || 1;
-    clientHeight = gl.canvas.height || 1;
-  }
-
-  const contextState = getContextState(gl);
-  const cachedSize = contextState._canvasSizeInfo;
-  // Check if canvas needs to be resized
-  if (
-    cachedSize.clientWidth !== clientWidth ||
-    cachedSize.clientHeight !== clientHeight ||
-    cachedSize.devicePixelRatio !== devicePixelRatio
-  ) {
-    let clampedPixelRatio = devicePixelRatio;
-
-    const canvasWidth = Math.floor(clientWidth * clampedPixelRatio);
-    const canvasHeight = Math.floor(clientHeight * clampedPixelRatio);
-    gl.canvas.width = canvasWidth;
-    gl.canvas.height = canvasHeight;
-
-    // Note: when devicePixelRatio is too high, it is possible we might hit system limit for
-    // drawing buffer width and hight, in those cases they get clamped and resulting aspect ration may not be maintained
-    // for those cases, reduce devicePixelRatio.
-    if (gl.drawingBufferWidth !== canvasWidth || gl.drawingBufferHeight !== canvasHeight) {
-      log.warn(`Device pixel ratio clamped`)();
-      clampedPixelRatio = Math.min(
-        gl.drawingBufferWidth / clientWidth,
-        gl.drawingBufferHeight / clientHeight
-      );
-
-      gl.canvas.width = Math.floor(clientWidth * clampedPixelRatio);
-      gl.canvas.height = Math.floor(clientHeight * clampedPixelRatio);
-    }
-
-    Object.assign(contextState._canvasSizeInfo, {clientWidth, clientHeight, devicePixelRatio});
-  }
-}
-
-
-// PRIVATE
-
-function scalePixels(pixel: number[], ratio: number, width: number, height: number, yInvert: boolean): {
-  x: number;
-  y: number;
-  width: number;
-  height: number;
-} {
-  const x = scaleX(pixel[0], ratio, width);
-  let y = scaleY(pixel[1], ratio, height, yInvert);
-
-  // Find boundaries of next pixel to provide valid range of device pixel locaitons
-
-  let t = scaleX(pixel[0] + 1, ratio, width);
-  // If next pixel's position is clamped to boundary, use it as is, otherwise subtract 1 for current pixel boundary
-  const xHigh = t === width - 1 ? t : t - 1;
-
-  t = scaleY(pixel[1] + 1, ratio, height, yInvert);
-  let yHigh;
-  if (yInvert) {
-    // If next pixel's position is clamped to boundary, use it as is, otherwise clamp it to valid range
-    t = t === 0 ? t : t + 1;
-    // swap y and yHigh
-    yHigh = y;
-    y = t;
-  } else {
-    // If next pixel's position is clamped to boundary, use it as is, otherwise clamp it to valid range
-    yHigh = t === height - 1 ? t : t - 1;
-    // y remains same
-  }
-  return {
-    x,
-    y,
-    // when ratio < 1, current css pixel and next css pixel may point to same device pixel, set width/height to 1 in those cases.
-    width: Math.max(xHigh - x + 1, 1),
-    height: Math.max(yHigh - y + 1, 1)
-  };
-}
-
-function scaleX(x: number, ratio: number, width: number): number {
-  // since we are rounding to nearest, when ratio > 1, edge pixels may point to out of bounds value, clamp to the limit
-  const r = Math.min(Math.round(x * ratio), width - 1);
-  return r;
-}
-
-function scaleY(y: number, ratio: number, height: number, yInvert: boolean): number {
-  // since we are rounding to nearest, when ratio > 1, edge pixels may point to out of bounds value, clamp to the limit
-  return yInvert
-    ? Math.max(0, height - 1 - Math.round(y * ratio))
-    : Math.min(Math.round(y * ratio), height - 1);
-}

package/src/init.ts

@@ -1,4 +0,0 @@
-import {luma} from '@luma.gl/api';
-import WebGLDevice from './adapter/webgl-device';
-
-luma.registerDevices([WebGLDevice]);

package/src/types/webgl.ts

@@ -1,283 +0,0 @@
-import type {NumberArray} from '@luma.gl/api';
-import GL from '@luma.gl/constants';
-
-type Framebuffer = any;
-
-export type GLDrawMode =
-  | GL.POINTS
-  | GL.LINES
-  | GL.LINE_STRIP
-  | GL.LINE_LOOP
-  | GL.TRIANGLES
-  | GL.TRIANGLE_STRIP
-  | GL.TRIANGLE_FAN;
-
-export type GLPrimitive = GL.POINTS | GL.LINES | GL.TRIANGLES;
-
-export type GLType =
-  | GL.FLOAT
-  | GL.UNSIGNED_SHORT
-  | GL.UNSIGNED_INT
-  | GL.UNSIGNED_BYTE
-  | GL.BYTE
-  | GL.SHORT
-  | GL.INT;
-
-export type GLPackedType =
-  | GL.UNSIGNED_SHORT_5_6_5
-  | GL.UNSIGNED_SHORT_4_4_4_4
-  | GL.UNSIGNED_SHORT_5_5_5_1;
-
-export type GLUniformType = GLSamplerType | GLCompositeType;
-
-export type GLSamplerType =
-  | GL.SAMPLER_2D
-  | GL.SAMPLER_CUBE
-  | GL.SAMPLER_3D
-  | GL.SAMPLER_2D_SHADOW
-  | GL.SAMPLER_2D_ARRAY
-  | GL.SAMPLER_2D_ARRAY_SHADOW
-  | GL.SAMPLER_CUBE_SHADOW
-  | GL.INT_SAMPLER_2D
-  | GL.INT_SAMPLER_3D
-  | GL.INT_SAMPLER_CUBE
-  | GL.INT_SAMPLER_2D_ARRAY
-  | GL.UNSIGNED_INT_SAMPLER_2D
-  | GL.UNSIGNED_INT_SAMPLER_3D
-  | GL.UNSIGNED_INT_SAMPLER_CUBE
-  | GL.UNSIGNED_INT_SAMPLER_2D_ARRAY;
-
-// Composite types table
-export type GLCompositeType =
-  | GL.FLOAT
-  | GL.FLOAT_VEC2
-  | GL.FLOAT_VEC3
-  | GL.FLOAT_VEC4
-  | GL.INT
-  | GL.INT_VEC2
-  | GL.INT_VEC3
-  | GL.INT_VEC4
-  | GL.UNSIGNED_INT
-  | GL.UNSIGNED_INT_VEC2
-  | GL.UNSIGNED_INT_VEC3
-  | GL.UNSIGNED_INT_VEC4
-  | GL.BOOL
-  | GL.BOOL_VEC2
-  | GL.BOOL_VEC3
-  | GL.BOOL_VEC4
-  | GL.FLOAT_MAT2
-  | GL.FLOAT_MAT2x3
-  | GL.FLOAT_MAT2x4
-  | GL.FLOAT_MAT3x2
-  | GL.FLOAT_MAT3
-  | GL.FLOAT_MAT3x4
-  | GL.FLOAT_MAT4x2
-  | GL.FLOAT_MAT4x3
-  | GL.FLOAT_MAT4;
-
-export type GLFunction =
-  | GL.NEVER
-  | GL.LESS
-  | GL.EQUAL
-  | GL.LEQUAL
-  | GL.GREATER
-  | GL.NOTEQUAL
-  | GL.GEQUAL
-  | GL.ALWAYS;
-
-export type GLBlendEquation =
-  | GL.FUNC_ADD
-  | GL.FUNC_SUBTRACT
-  | GL.FUNC_REVERSE_SUBTRACT
-  | GL.MIN_EXT
-  | GL.MAX_EXT;
-
-export type GLBlendFunction =
-  | GL.ZERO
-  | GL.ONE
-  | GL.SRC_COLOR
-  | GL.ONE_MINUS_SRC_COLOR
-  | GL.DST_COLOR
-  | GL.ONE_MINUS_DST_COLOR
-  | GL.SRC_ALPHA
-  | GL.ONE_MINUS_SRC_ALPHA
-  | GL.DST_ALPHA
-  | GL.ONE_MINUS_DST_ALPHA
-  | GL.CONSTANT_COLOR
-  | GL.ONE_MINUS_CONSTANT_COLOR
-  | GL.CONSTANT_ALPHA
-  | GL.ONE_MINUS_CONSTANT_ALPHA
-  | GL.SRC_ALPHA_SATURATE;
-
-export type GLStencilOp =
-  | GL.KEEP
-  | GL.ZERO
-  | GL.REPLACE
-  | GL.INCR
-  | GL.INCR_WRAP
-  | GL.DECR
-  | GL.DECR_WRAP
-  | GL.INVERT;
-
-/** Parameters for textures and samplers */
-export type WebGLSamplerParameters = {
-  [GL.TEXTURE_WRAP_S]?: GL.CLAMP_TO_EDGE | GL.REPEAT | GL.MIRRORED_REPEAT;
-  [GL.TEXTURE_WRAP_T]?: GL.CLAMP_TO_EDGE | GL.REPEAT | GL.MIRRORED_REPEAT;
-  [GL.TEXTURE_WRAP_R]?: GL.CLAMP_TO_EDGE | GL.REPEAT | GL.MIRRORED_REPEAT;
-  [GL.TEXTURE_MAG_FILTER]?: GL.NEAREST | GL.LINEAR;
-  [GL.TEXTURE_MIN_FILTER]?:
-    | GL.NEAREST
-    | GL.LINEAR
-    | GL.NEAREST_MIPMAP_NEAREST
-    | GL.NEAREST_MIPMAP_LINEAR
-    | GL.LINEAR_MIPMAP_NEAREST
-    | GL.LINEAR_MIPMAP_LINEAR;
-  [GL.TEXTURE_MIN_LOD]?: number;
-  [GL.TEXTURE_MAX_LOD]?: number;
-  [GL.TEXTURE_COMPARE_FUNC]?: number; // COMPARE_FUNC);
-  [GL.TEXTURE_MAX_ANISOTROPY_EXT]?: number; //
-};
-
-/**
- * All global WebGL values set by a variety of setter gl.enable ...
- */
-export type GLValueParameters = {
-  [GL.BLEND]?: boolean;
-  [GL.BLEND_COLOR]?: [number, number, number, number] | NumberArray;
-  [GL.BLEND_EQUATION_RGB]?: GLBlendEquation;
-  [GL.BLEND_EQUATION_ALPHA]?: GLBlendEquation;
-  [GL.BLEND_SRC_RGB]?: GLBlendFunction;
-  [GL.BLEND_DST_RGB]?: GLBlendFunction;
-  [GL.BLEND_SRC_ALPHA]?: GLBlendFunction;
-  [GL.BLEND_DST_ALPHA]?: GLBlendFunction;
-  [GL.COLOR_CLEAR_VALUE]?: [number, number, number, number] | NumberArray;
-  [GL.COLOR_WRITEMASK]?: [boolean, boolean, boolean, boolean] | boolean[];
-  [GL.CULL_FACE]?: boolean;
-  [GL.CULL_FACE_MODE]?: GL.FRONT | GL.BACK | GL.FRONT_AND_BACK;
-  [GL.DEPTH_TEST]?: boolean;
-  [GL.DEPTH_CLEAR_VALUE]?: number;
-  [GL.DEPTH_FUNC]?: GLFunction;
-  [GL.DEPTH_RANGE]?: [number, number] | NumberArray;
-  [GL.DEPTH_WRITEMASK]?: boolean;
-  [GL.DITHER]?: boolean;
-  [GL.FRAGMENT_SHADER_DERIVATIVE_HINT]?: GL.FASTEST | GL.NICEST | GL.DONT_CARE;
-  [GL.CURRENT_PROGRAM]?: WebGLProgram | null;
-  [GL.FRAMEBUFFER_BINDING]?: WebGLFramebuffer | null;
-  [GL.RENDERBUFFER_BINDING]?: WebGLRenderbuffer | null;
-  [GL.TRANSFORM_FEEDBACK_BINDING]?: WebGLTransformFeedback | null;
-  [GL.VERTEX_ARRAY_BINDING]?: WebGLVertexArrayObject | null;
-  [GL.ARRAY_BUFFER_BINDING]?: WebGLBuffer | null;
-  [GL.COPY_READ_BUFFER_BINDING]?: WebGLBuffer | null;
-  [GL.COPY_WRITE_BUFFER_BINDING]?: WebGLBuffer | null;
-  [GL.PIXEL_PACK_BUFFER_BINDING]?: WebGLBuffer | null;
-  [GL.PIXEL_UNPACK_BUFFER_BINDING]?: WebGLBuffer | null;
-  [GL.TEXTURE_BINDING_2D]?: WebGLTexture | null;
-  [GL.TEXTURE_BINDING_2D_ARRAY]?: WebGLTexture | null;
-  [GL.TEXTURE_BINDING_3D]?: WebGLTexture | null;
-  [GL.TEXTURE_BINDING_CUBE_MAP]?: WebGLTexture | null;
-  [GL.FRONT_FACE]?: GL.CW | GL.CCW;
-  [GL.GENERATE_MIPMAP_HINT]?: GL.FASTEST | GL.NICEST | GL.DONT_CARE;
-  [GL.LINE_WIDTH]?: number;
-  [GL.POLYGON_OFFSET_FILL]?: boolean;
-  [GL.POLYGON_OFFSET_FACTOR]?: number;
-  [GL.POLYGON_OFFSET_UNITS]?: number;
-  [GL.SAMPLE_ALPHA_TO_COVERAGE]?: boolean;
-  [GL.SAMPLE_COVERAGE]?: boolean;
-  [GL.RASTERIZER_DISCARD]?: boolean;
-  [GL.SAMPLE_COVERAGE_VALUE]?: number;
-  [GL.SAMPLE_COVERAGE_INVERT]?: boolean;
-  [GL.SCISSOR_TEST]?: boolean;
-  [GL.SCISSOR_BOX]?: [number, number, number, number] | NumberArray;
-  [GL.STENCIL_TEST]?: boolean;
-  [GL.STENCIL_CLEAR_VALUE]?: number;
-  [GL.STENCIL_WRITEMASK]?: number;
-  [GL.STENCIL_BACK_WRITEMASK]?: number;
-  [GL.STENCIL_FUNC]?: GLFunction;
-  [GL.STENCIL_REF]?: GLFunction;
-  [GL.STENCIL_VALUE_MASK]?: GLFunction;
-  [GL.STENCIL_BACK_FUNC]?: GLFunction;
-  [GL.STENCIL_BACK_REF]?: GLFunction;
-  [GL.STENCIL_BACK_VALUE_MASK]?: GLFunction;
-  [GL.STENCIL_FAIL]?: GLStencilOp;
-  [GL.STENCIL_PASS_DEPTH_FAIL]?: GLStencilOp;
-  [GL.STENCIL_PASS_DEPTH_PASS]?: GLStencilOp;
-  [GL.STENCIL_BACK_FAIL]?: GLStencilOp;
-  [GL.STENCIL_BACK_PASS_DEPTH_FAIL]?: GLStencilOp;
-  [GL.STENCIL_BACK_PASS_DEPTH_PASS]?: GLStencilOp;
-  [GL.VIEWPORT]?: [number, number, number, number] | NumberArray;
-
-  // WEBGL1 PIXEL PACK/UNPACK MODES
-  [GL.PACK_ALIGNMENT]?: number;
-  [GL.UNPACK_ALIGNMENT]?: number;
-  [GL.UNPACK_FLIP_Y_WEBGL]?: boolean;
-  [GL.UNPACK_PREMULTIPLY_ALPHA_WEBGL]?: boolean;
-  [GL.UNPACK_COLORSPACE_CONVERSION_WEBGL]?: GL.NONE | GL.BROWSER_DEFAULT_WEBGL;
-
-  // WEBGL2 PIXEL PACK/UNPACK MODES
-  // RASTERIZER_DISCARD ...
-  [GL.PACK_ROW_LENGTH]?: number;
-  [GL.PACK_SKIP_PIXELS]?: number;
-  [GL.PACK_SKIP_ROWS]?: number;
-  [GL.READ_FRAMEBUFFER_BINDING]?: Framebuffer | null;
-  [GL.UNPACK_ROW_LENGTH]?: number;
-  [GL.UNPACK_IMAGE_HEIGHT]?: number;
-  [GL.UNPACK_SKIP_PIXELS]?: number;
-  [GL.UNPACK_SKIP_ROWS]?: number;
-  [GL.UNPACK_SKIP_IMAGES]?: number;
-};
-
-export type GLFunctionParameters = {
-  // Function-style setters
-  framebuffer?: Framebuffer | null;
-  blend?: boolean;
-  blendColor?: [number, number, number, number] | NumberArray;
-  blendEquation?: GLBlendEquation | [GLBlendEquation, GLBlendEquation];
-  blendFunc?:
-    | [GLBlendFunction, GLBlendFunction]
-    | [GLBlendFunction, GLBlendFunction, GLBlendFunction, GLBlendFunction];
-
-  clearColor?: [number, number, number, number] | NumberArray;
-  clearDepth?: number;
-  clearStencil?: number;
-
-  colorMask?: [boolean, boolean, boolean, boolean];
-
-  cull?: boolean;
-  cullFace?: GL.FRONT | GL.BACK | GL.FRONT_AND_BACK;
-
-  depthTest?: boolean;
-  depthFunc?: GLFunction;
-  depthMask?: boolean;
-  depthRange?: [number, number] | NumberArray;
-
-  dither?: boolean;
-
-  derivativeHint?: GL.FASTEST | GL.NICEST | GL.DONT_CARE;
-
-  frontFace?: GL.CW | GL.CCW;
-
-  mipmapHint?: GL.FASTEST | GL.NICEST | GL.DONT_CARE;
-
-  lineWidth?: number;
-
-  polygonOffsetFill?: boolean;
-  polygonOffset?: [number, number];
-
-  sampleCoverage?: [number, boolean];
-
-  scissorTest?: boolean;
-  scissor?: [number, number, number, number] | NumberArray;
-
-  stencilTest?: boolean;
-  stencilMask?: number | [number, number];
-  stencilFunc?:
-    | [GLFunction, number, number]
-    | [GLFunction, number, number, GLFunction, number, number];
-  stencilOp?:
-    | [GLStencilOp, GLStencilOp, GLStencilOp]
-    | [GLStencilOp, GLStencilOp, GLStencilOp, GLStencilOp, GLStencilOp, GLStencilOp];
-  viewport?: [number, number, number, number] | NumberArray;
-};
-
-/** WebGL style parameters object (with both GL constants and function style fields) */
-export type GLParameters = GLValueParameters | GLFunctionParameters;