@luma.gl/webgl 8.6.0-alpha.4 → 9.0.0-alpha.3

package/README.md

@@ -1,70 +1,6 @@
 # @luma.gl/webgl
 
-This module contains a set of JavaScript class wrappers for the WebGL2 API.
+This module contains the WebGL Device adapter for luma.gl.
 
-# webgl-utils
-
-This luma.gl sub-module contains a number of completely generic WebGL helper functions that luma.gl relies on. They are independent of the luma.gl API and of each other, and could possibly be of generic interest for other webgl programs or frameworks that don't want to use luma.gl itself.
-
-Since all luma.gl code is MIT licensed you are of course welcome to copy these into your projects should you find them helpful.
-
-## Canvas Management
-
-The canvas manages the default drawing buffer including the size of the default drawing buffer, so the canvas typically needs to be updated when the window resizes
-
-## getPageLoadPromise
-
-Returns a promise that resolves when the page's HTML has loaded (meaning that any canvas specified in the HTML can now be queried by id).
-
-### createCanvas
-
-Programatically creates a canvas element with a certain size and id, and inserts it into the documents body once the page is loaded (see `getPageLoadPromise`).
-
-### createContext
-
-Gives a controlled interface to create a WebGL1 or WebGL2 context from a canvas.
-
-## GLSL Error Parser
-
-### formatGLSLError
-
-A formatter for parsing errors and warnings from the GLSL compiler. see `parseGLSLError`.
-
-- `errLog` (String) - error log (from `gl.getShaderInfoLog`)
-- `src` (String) - original shader source code
-- `shaderType` (Number) - shader type (GL constant)
-  Return (String) - Formatted string, has the error marked inline with src.
-
-### parseGLSLError
-
-A parse for GLSL compiler error logs. Note that the format of the error logs generated by the GLSL compiler is defined the WebGL spec, so it is possible to portably parse these logs.
-
-This function formats each GLSL shader compiler error or warning and generates text showing the source code around the error with marks pointing out where the issue was encountered.
-
-- `errLog` (String) - error log (from `gl.getShaderInfoLog`)
-- `src` (String) - original shader source code
-- `shaderType` (Number) - shader type (GL constant)
-  Return (object) - with `shaderName`, `errors` and `warnings` fields (all strings).
-
-## WebGL Constants
-
-### GL (namespace)
-
-All WebGL2 and extension constants exported as a single namespace `GL`. Allows constants to be referenced without tracking which version of WebGL or what extensions are available.
-
-### getKeyValue
-
-Resolves a WebGL enumeration `name` (returns itself if already a number)
-
-`getKeyValue(gl, name)`
-
-- `gl` (WebGLRenderingContext) - gl context
-- `name` (String)
-
-### getKeyValue
-
-Returns a key that matches the number.
-
-`getKey(gl, value)`
-
-- `gl` (WebGLRenderingContext) - gl context
+It also exports a set of JavaScript classes for the WebGL2 API.
+These represent the legacy luma.gl v8 API.

package/dist/adapter/converters/device-parameters.d.ts

@@ -0,0 +1,17 @@
+import { Device, Parameters, CompareFunction } from '@luma.gl/api';
+import GL from '@luma.gl/constants';
+import type { GLParameters } from '../../types/webgl';
+/**
+ * Execute a function with a set of temporary WebGL parameter overrides
+ * - Saves current "global" WebGL context settings
+ * - Sets the supplies WebGL context parameters,
+ * - Executes supplied function
+ * - Restores parameters
+ * - Returns the return value of the supplied function
+ */
+export declare function withDeviceParameters<T = unknown>(device: Device, parameters: Parameters & GLParameters, func: (device?: Device) => T): T;
+/** Set WebGPU Style Parameters */
+export declare function setDeviceParameters(device: Device, parameters: Parameters): void;
+export declare function convertCompareFunction(parameter: string, value: CompareFunction): GL;
+export declare function convertToCompareFunction(parameter: string, value: GL): CompareFunction;
+//# sourceMappingURL=device-parameters.d.ts.map

package/dist/adapter/converters/device-parameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-parameters.d.ts","sourceRoot":"","sources":["../../../src/adapter/converters/device-parameters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAE,UAAU,EAAE,eAAe,EAAuC,MAAM,cAAc,CAAC;AACvG,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKtD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,YAAY,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,CAAC,GAAG,CAAC,CAiBxI;AAGD,kCAAkC;AAClC,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,QAoGzE;AAyBD,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,EAAE,CAWpF;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,eAAe,CAWtF"}

package/dist/adapter/converters/{set-device-parameters.js → device-parameters.js}

@@ -1,6 +1,23 @@
-import { log } from '@luma.gl/api';
+import { log, isObjectEmpty } from '@luma.gl/api';
 import GL from '@luma.gl/constants';
-import { WebGLDevice } from '@luma.gl/webgl';
+import { pushContextState, popContextState } from '../../context/state-tracker/track-context-state';
+import { setParameters } from '../../context/parameters/unified-parameter-api';
+import WebGLDevice from '../webgl-device';
+export function withDeviceParameters(device, parameters, func) {
+  if (isObjectEmpty(parameters)) {
+    return func(device);
+  }
+
+  pushContextState(device.gl);
+
+  try {
+    setParameters(device, parameters);
+    setDeviceParameters(device, parameters);
+    return func(device);
+  } finally {
+    popContextState(device.gl);
+  }
+}
 export function setDeviceParameters(device, parameters) {
   const webglDevice = WebGLDevice.attach(device);
   const {
@@ -42,7 +59,8 @@ export function setDeviceParameters(device, parameters) {
   }
 
   if (parameters.depthCompare) {
-    parameters.depthCompare !== 'always' ? gl.enable(GL.DEPTH_TEST) : gl.disable(GL.DEPTH_TEST), gl.depthFunc(convertCompareFunction('depthCompare', parameters.depthCompare));
+    parameters.depthCompare !== 'always' ? gl.enable(GL.DEPTH_TEST) : gl.disable(GL.DEPTH_TEST);
+    gl.depthFunc(convertCompareFunction('depthCompare', parameters.depthCompare));
   }
 
   if (parameters.stencilWriteMask) {
@@ -58,7 +76,8 @@ export function setDeviceParameters(device, parameters) {
   if (parameters.stencilCompare) {
     const mask = parameters.stencilReadMask || 0xffffffff;
     const glValue = convertCompareFunction('depthCompare', parameters.stencilCompare);
-    parameters.stencilCompare !== 'always' ? gl.enable(GL.STENCIL_TEST) : gl.disable(GL.STENCIL_TEST), gl.stencilFuncSeparate(GL.FRONT, glValue, 0, mask);
+    parameters.stencilCompare !== 'always' ? gl.enable(GL.STENCIL_TEST) : gl.disable(GL.STENCIL_TEST);
+    gl.stencilFuncSeparate(GL.FRONT, glValue, 0, mask);
     gl.stencilFuncSeparate(GL.BACK, glValue, 0, mask);
   }
 
@@ -82,6 +101,18 @@ export function convertCompareFunction(parameter, value) {
     'always': GL.ALWAYS
   });
 }
+export function convertToCompareFunction(parameter, value) {
+  return map(parameter, value, {
+    [GL.NEVER]: 'never',
+    [GL.LESS]: 'less',
+    [GL.EQUAL]: 'equal',
+    [GL.LEQUAL]: 'less-equal',
+    [GL.GREATER]: 'greater',
+    [GL.NOTEQUAL]: 'not-equal',
+    [GL.GEQUAL]: 'greater-equal',
+    [GL.ALWAYS]: 'always'
+  });
+}
 
 function convertStencilOperation(parameter, value) {
   return map(parameter, value, {
@@ -121,4 +152,4 @@ function map(parameter, value, valueMap) {
 function mapBoolean(parameter, value) {
   return value;
 }
-//# sourceMappingURL=set-device-parameters.js.map
+//# sourceMappingURL=device-parameters.js.map

package/dist/adapter/converters/device-parameters.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/adapter/converters/device-parameters.ts"],"names":["log","isObjectEmpty","GL","pushContextState","popContextState","setParameters","WebGLDevice","withDeviceParameters","device","parameters","func","gl","setDeviceParameters","webglDevice","attach","gl2","cullMode","disable","CULL_FACE","enable","cullFace","FRONT","BACK","frontFace","map","ccw","CCW","cw","CW","depthBias","undefined","polygonOffset","depthBiasSlopeScale","depthWriteEnabled","depthMask","mapBoolean","depthCompare","DEPTH_TEST","depthFunc","convertCompareFunction","stencilWriteMask","mask","stencilMaskSeparate","stencilReadMask","warn","stencilCompare","glValue","STENCIL_TEST","stencilFuncSeparate","stencilPassOperation","dppass","convertStencilOperation","sfail","stencilFailOperation","dpfail","stencilDepthFailOperation","stencilOpSeparate","parameter","value","NEVER","LESS","EQUAL","LEQUAL","GREATER","NOTEQUAL","GEQUAL","ALWAYS","convertToCompareFunction","KEEP","ZERO","REPLACE","INVERT","INCR","DECR","INCR_WRAP","DECR_WRAP","convertBlendOperationToEquation","FUNC_ADD","FUNC_SUBTRACT","FUNC_REVERSE_SUBTRACT","MIN","MAX","message","valueMap","Error"],"mappings":"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","sourcesContent":["import {Device, Parameters, CompareFunction, StencilOperation, log, isObjectEmpty} from '@luma.gl/api';\nimport GL from '@luma.gl/constants';\nimport type { GLParameters } from '../../types/webgl';\nimport {pushContextState, popContextState} from '../../context/state-tracker/track-context-state';\nimport {setParameters} from '../../context/parameters/unified-parameter-api';\nimport WebGLDevice from '../webgl-device';\n\n/**\n * Execute a function with a set of temporary WebGL parameter overrides\n * - Saves current \"global\" WebGL context settings\n * - Sets the supplies WebGL context parameters,\n * - Executes supplied function\n * - Restores parameters\n * - Returns the return value of the supplied function\n */\nexport function withDeviceParameters<T = unknown>(device: Device, parameters: Parameters & GLParameters, func: (device?: Device) => T): T {\n  if (isObjectEmpty(parameters)) {\n    // Avoid setting state if no parameters provided. Just call and return\n    return func(device);\n  }\n\n  // Wrap in a try-catch to ensure that parameters are restored on exceptions\n  // @ts-expect-error\n  pushContextState(device.gl);\n  try {\n    setParameters(device, parameters);\n    setDeviceParameters(device, parameters);\n    return func(device);\n  } finally {\n    // @ts-expect-error\n    popContextState(device.gl);\n  }\n}\n\n\n/** Set WebGPU Style Parameters */\nexport function setDeviceParameters(device: Device, parameters: Parameters) {\n  const webglDevice = WebGLDevice.attach(device);\n  const {gl, gl2} = webglDevice;\n\n  // RASTERIZATION SETTINGS\n  if (parameters.cullMode) {\n    switch (parameters.cullMode) {\n      case 'none':\n        gl.disable(GL.CULL_FACE);\n        break;\n      case 'front':\n        gl.enable(GL.CULL_FACE);\n        gl.cullFace(GL.FRONT);\n        break;\n      case 'back':\n        gl.enable(GL.CULL_FACE);\n        gl.cullFace(GL.BACK);\n        break;\n    }\n  }\n\n  if (parameters.frontFace) {\n    gl.frontFace(map('frontFace', parameters.frontFace, {\n      ccw: GL.CCW,\n      cw: GL.CW\n    }));\n  }\n\n  if (parameters.depthBias !== undefined) {\n    gl.polygonOffset(parameters.depthBias, parameters.depthBiasSlopeScale || 0);\n  }\n\n  // depthBiasSlopeScale: {\n  //   // Handled by depthBias\n  // },\n\n  // DEPTH STENCIL\n\n  if (parameters.depthWriteEnabled !== undefined) {\n    gl.depthMask(mapBoolean('depthWriteEnabled', parameters.depthWriteEnabled));\n  }\n\n if (parameters.depthCompare) {\n    parameters.depthCompare !== 'always' ? gl.enable(GL.DEPTH_TEST) : gl.disable(GL.DEPTH_TEST);\n    gl.depthFunc(convertCompareFunction('depthCompare', parameters.depthCompare));\n  }\n\n  if (parameters.stencilWriteMask) {\n    const mask = parameters.stencilWriteMask;\n    gl.stencilMaskSeparate(GL.FRONT, mask);\n    gl.stencilMaskSeparate(GL.BACK, mask);\n  }\n\n  if (parameters.stencilReadMask) {\n    // stencilReadMask is handle inside stencil***Compare.\n    log.warn('stencilReadMask not supported under WebGL');\n  }\n\n  if (parameters.stencilCompare) {\n    const mask = parameters.stencilReadMask || 0xffffffff;\n    const glValue = convertCompareFunction('depthCompare', parameters.stencilCompare);\n    // TODO - ensure back doesn't overwrite\n    parameters.stencilCompare !== 'always' ? gl.enable(GL.STENCIL_TEST) : gl.disable(GL.STENCIL_TEST);\n    gl.stencilFuncSeparate(GL.FRONT, glValue, 0, mask);\n    gl.stencilFuncSeparate(GL.BACK, glValue, 0, mask);\n  }\n\n  if (parameters.stencilPassOperation) {\n    const dppass = convertStencilOperation('stencilPassOperation', parameters.stencilPassOperation);\n    const sfail = convertStencilOperation('stencilFailOperation', parameters.stencilFailOperation);\n    const dpfail = convertStencilOperation('stencilDepthFailOperation', parameters.stencilDepthFailOperation);\n    gl.stencilOpSeparate(GL.FRONT, sfail, dpfail, dppass);\n    gl.stencilOpSeparate(GL.BACK, sfail, dpfail, dppass);\n  }\n\n  // stencilDepthFailOperation() {\n  //   // handled by stencilPassOperation\n  // },\n\n  // stencilFailOperation() {\n  //   // handled by stencilPassOperation\n  // },\n\n  // COLOR STATE\n\n  // if (parameters.blend) {\n  //   gl.enable(GL.BLEND);\n\n  //   const blend = parameters.blend;\n\n  //   let colorEquation = (blend && blend.color && blend.color.operation) || 'add';\n  //   let alphaEquation = (blend && blend.alpha && blend.alpha.operation) || 'add';\n  //   gl.blendEquationSeparate(colorEquation, alphaEquation);\n\n  //   let colorSrcFactor = (blend && blend.color && blend.color.srcFactor) || 'one';\n  //   let colorDstFactor = (blend && blend.color && blend.color.dstFactor) || 'zero';\n  //   let alphaSrcFactor = (blend && blend.alpha && blend.alpha.srcFactor) || 'one';\n  //   let alphaDstFactor = (blend && blend.alpha && blend.alpha.dstFactor) || 'zero';\n  //   gl.blendFuncSeparate(colorSrcFactor, colorDstFactor, alphaSrcFactor, alphaDstFactor);\n  // }\n}\n\n/*\n      rasterizationState: {\n        cullMode: \"back\",\n      },\n\n      depthStencilState: {\n        depthWriteEnabled: true,\n        depthCompare: \"less\",\n        format: \"depth24plus-stencil8\",\n      },\n\n      colorStates: [\n        {\n          format: \"bgra8unorm\",\n          // colorBlend.srcFactor = wgpu::BlendFactor::SrcAlpha;\n          // colorBlend.dstFactor = wgpu::BlendFactor::OneMinusSrcAlpha;\n          // alphaBlend.srcFactor = wgpu::BlendFactor::SrcAlpha;\n          // alphaBlend.dstFactor = wgpu::BlendFactor::OneMinusSrcAlpha;\n        },\n      ],\n    });\n*/\n\nexport function convertCompareFunction(parameter: string, value: CompareFunction): GL {\n  return map(parameter, value, {\n    'never': GL.NEVER,\n    'less': GL.LESS,\n    'equal': GL.EQUAL,\n    'less-equal': GL.LEQUAL,\n    'greater': GL.GREATER,\n    'not-equal': GL.NOTEQUAL,\n    'greater-equal': GL.GEQUAL,\n    'always': GL.ALWAYS\n  });\n}\n\nexport function convertToCompareFunction(parameter: string, value: GL): CompareFunction {\n  return map(parameter, value, {\n    [GL.NEVER]: 'never',\n    [GL.LESS]: 'less',\n    [GL.EQUAL]: 'equal',\n    [GL.LEQUAL]: 'less-equal',\n    [GL.GREATER]: 'greater',\n    [GL.NOTEQUAL]: 'not-equal',\n    [GL.GEQUAL]: 'greater-equal',\n    [GL.ALWAYS]: 'always'\n  });\n}\n\nfunction convertStencilOperation(parameter: string, value: StencilOperation): GL {\n  return map(parameter, value, {\n    'keep': GL.KEEP,\n    'zero': GL.ZERO,\n    'replace': GL.REPLACE,\n    'invert': GL.INVERT,\n    'increment-clamp': GL.INCR,\n    'decrement-clamp': GL.DECR,\n    'increment-wrap': GL.INCR_WRAP,\n    'decrement-wrap': GL.DECR_WRAP\n  });\n}\n\nfunction convertBlendOperationToEquation(parameter, value): number {\n  return map(parameter, value, {\n    'add': GL.FUNC_ADD,\n    'sub': GL.FUNC_SUBTRACT,\n    'reverse-subtract': GL.FUNC_REVERSE_SUBTRACT,\n    // When using a WebGL 2 context, the following values are available additionally:\n    'min': GL.MIN,\n    'max': GL.MAX\n  });\n}\n\nfunction message(parameter: string, value: any): string {\n  return `Illegal parameter ${value} for ${parameter}`;\n}\n\nfunction map(parameter: string, value: any, valueMap: Record<string, any>): any {\n  if (!(value in valueMap)) {\n    throw new Error(message(parameter, value));\n  }\n  return valueMap[value];\n}\n\nfunction mapBoolean(parameter, value) {\n  return value;\n}\n"],"file":"device-parameters.js"}

package/dist/adapter/converters/renderbuffer-formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderbuffer-formats.d.ts","sourceRoot":"","sources":["../../../src/adapter/converters/renderbuffer-formats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGpC,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,CAa5F;AAED,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,EAAE,GAAG,MAAM,CAErE;AAKD;;;;GAIG;AACH,aAAK,kBAAkB,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,QAAA,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAqD5D,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/dist/{classes → adapter/converters}/renderbuffer-formats.js

@@ -1,5 +1,5 @@
 import GL from '@luma.gl/constants';
-import { isWebGL2 } from '../context/context/webgl-checks';
+import { isWebGL2 } from '../../context/context/webgl-checks';
 export function isRenderbufferFormatSupported(gl, format) {
   const info = RENDERBUFFER_FORMATS[format];
 

package/dist/adapter/converters/renderbuffer-formats.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/adapter/converters/renderbuffer-formats.ts"],"names":["GL","isWebGL2","isRenderbufferFormatSupported","gl","format","info","RENDERBUFFER_FORMATS","ext","Boolean","getExtension","gl2","getRenderbufferFormatBytesPerPixel","bpp","EXT_FLOAT_WEBGL2","DEPTH_COMPONENT16","DEPTH_COMPONENT24","DEPTH_COMPONENT32F","STENCIL_INDEX8","DEPTH_STENCIL","DEPTH24_STENCIL8","DEPTH32F_STENCIL8","RGBA4","RGB565","RGB5_A1","R8","R8UI","R8I","R16UI","R16I","R32UI","R32I","RG8","RG8UI","RG8I","RG16UI","RG16I","RG32UI","RG32I","RGB8","RGBA8","RGB10_A2","RGBA8UI","RGBA8I","RGB10_A2UI","RGBA16UI","RGBA16I","RGBA32I","RGBA32UI","R16F","RG16F","RGBA16F","R32F","RG32F","RGBA32F","R11F_G11F_B10F"],"mappings":"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","sourcesContent":["import GL from '@luma.gl/constants';\nimport {isWebGL2} from '../../context/context/webgl-checks';\n\nexport function isRenderbufferFormatSupported(gl: WebGLRenderingContext, format: GL): boolean {\n  const info = RENDERBUFFER_FORMATS[format];\n  // Unknown format\n  if (!info) {\n    return false;\n  }\n  if (info.ext) {\n    return Boolean(gl.getExtension(info.ext));\n  }\n  if (info.gl2) {\n    return isWebGL2(gl);\n  }\n  return true;\n}\n\nexport function getRenderbufferFormatBytesPerPixel(format: GL): number {\n  return RENDERBUFFER_FORMATS[format].bpp;\n}\n\n// Define local extension strings to optimize minification\nconst EXT_FLOAT_WEBGL2 = 'EXT_color_buffer_float';\n\n/**\n * @param bpp \"bytes per pixel\", used for memory usage calculations.\n * @param gl2 requires WebGL2\n * @param ext requires extension\n */\ntype RenderbufferFormat = {\n  bpp: number;\n  gl2?: boolean;\n  ext?: string;\n};\n\nconst RENDERBUFFER_FORMATS: Record<string, RenderbufferFormat> = {\n  [GL.DEPTH_COMPONENT16]: {bpp: 2}, // 16 depth bits.\n  [GL.DEPTH_COMPONENT24]: {gl2: true, bpp: 3},\n  [GL.DEPTH_COMPONENT32F]: {gl2: true, bpp: 4},\n\n  [GL.STENCIL_INDEX8]: {bpp: 1}, // 8 stencil bits.\n\n  [GL.DEPTH_STENCIL]: {bpp: 4},\n  [GL.DEPTH24_STENCIL8]: {gl2: true, bpp: 4},\n  [GL.DEPTH32F_STENCIL8]: {gl2: true, bpp: 5},\n\n  // When using a WebGL 1 context, color renderbuffer formats are limited\n  [GL.RGBA4]: {bpp: 2},\n  [GL.RGB565]: {bpp: 2},\n  [GL.RGB5_A1]: {bpp: 2},\n\n  // When using a WebGL 2 context, the following values are available additionally:\n  [GL.R8]: {gl2: true, bpp: 1},\n  [GL.R8UI]: {gl2: true, bpp: 1},\n  [GL.R8I]: {gl2: true, bpp: 1},\n  [GL.R16UI]: {gl2: true, bpp: 2},\n  [GL.R16I]: {gl2: true, bpp: 2},\n  [GL.R32UI]: {gl2: true, bpp: 4},\n  [GL.R32I]: {gl2: true, bpp: 4},\n  [GL.RG8]: {gl2: true, bpp: 2},\n  [GL.RG8UI]: {gl2: true, bpp: 2},\n  [GL.RG8I]: {gl2: true, bpp: 2},\n  [GL.RG16UI]: {gl2: true, bpp: 4},\n  [GL.RG16I]: {gl2: true, bpp: 4},\n  [GL.RG32UI]: {gl2: true, bpp: 8},\n  [GL.RG32I]: {gl2: true, bpp: 8},\n  [GL.RGB8]: {gl2: true, bpp: 3},\n  [GL.RGBA8]: {gl2: true, bpp: 4},\n  // [GL.SRGB8_ALPHA8]: {gl2: true, gl1: SRGB}, // When using the EXT_sRGB WebGL1 extension\n  [GL.RGB10_A2]: {gl2: true, bpp: 4},\n  [GL.RGBA8UI]: {gl2: true, bpp: 4},\n  [GL.RGBA8I]: {gl2: true, bpp: 4},\n  [GL.RGB10_A2UI]: {gl2: true, bpp: 4},\n  [GL.RGBA16UI]: {gl2: true, bpp: 8},\n  [GL.RGBA16I]: {gl2: true, bpp: 8},\n  [GL.RGBA32I]: {gl2: true, bpp: 16},\n  [GL.RGBA32UI]: {gl2: true, bpp: 16},\n\n  // When using a WebGL 2 context and the EXT_color_buffer_float WebGL2 extension\n  [GL.R16F]: {ext: EXT_FLOAT_WEBGL2, bpp: 2},\n  [GL.RG16F]: {ext: EXT_FLOAT_WEBGL2, bpp: 4},\n  [GL.RGBA16F]: {ext: EXT_FLOAT_WEBGL2, bpp: 8},\n  [GL.R32F]: {ext: EXT_FLOAT_WEBGL2, bpp: 4},\n  [GL.RG32F]: {ext: EXT_FLOAT_WEBGL2, bpp: 8},\n  // TODO - can't get WEBGL_color_buffer_float to work on renderbuffers\n  [GL.RGBA32F]: {ext: EXT_FLOAT_WEBGL2, bpp: 16},\n  // [GL.RGBA32F]: {ext: EXT_FLOAT_WEBGL2, gl1: EXT_FLOAT_WEBGL1},\n  [GL.R11F_G11F_B10F]: {ext: EXT_FLOAT_WEBGL2, bpp: 4}\n};\n\nexport default RENDERBUFFER_FORMATS;\n"],"file":"renderbuffer-formats.js"}

package/dist/adapter/converters/sampler-parameters.d.ts

@@ -0,0 +1,19 @@
+import { SamplerParameters } from '@luma.gl/api';
+import { WebGLSamplerParameters } from '../../types/webgl';
+/**
+ * Convert WebGPU-style sampler props to WebGL
+ * @param props
+ * @returns
+ */
+export declare function convertSamplerParametersToWebGL(props: SamplerParameters): WebGLSamplerParameters;
+/**
+ * Convert WebGL-style sampler props to WebGPU
+ * @param props
+ * @returns
+ */
+export declare function convertToSamplerParameters(params: WebGLSamplerParameters): SamplerParameters;
+/**
+ * Override sampler settings that are not supported by Non-Power-of-Two textures in WebGL1.
+*/
+export declare function updateSamplerParametersForNPOT(parameters: WebGLSamplerParameters): WebGLSamplerParameters;
+//# sourceMappingURL=sampler-parameters.d.ts.map

package/dist/adapter/converters/sampler-parameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampler-parameters.d.ts","sourceRoot":"","sources":["../../../src/adapter/converters/sampler-parameters.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,iBAAiB,EAAC,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAC,sBAAsB,EAAC,MAAM,mBAAmB,CAAC;AAGzD;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,iBAAiB,GAAG,sBAAsB,CAkChG;AAkCD;;;;GAIG;AACF,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,sBAAsB,GAAG,iBAAiB,CAkC7F;AA2CD;;EAEE;AACF,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,sBAAsB,GAAG,sBAAsB,CAUzG"}

package/dist/adapter/converters/sampler-parameters.js

@@ -0,0 +1,208 @@
+import GL from '@luma.gl/constants';
+import { convertCompareFunction, convertToCompareFunction } from './device-parameters';
+export function convertSamplerParametersToWebGL(props) {
+  const params = {};
+
+  if (props.addressModeU) {
+    params[GL.TEXTURE_WRAP_S] = convertAddressMode(props.addressModeU);
+  }
+
+  if (props.addressModeV) {
+    params[GL.TEXTURE_WRAP_T] = convertAddressMode(props.addressModeV);
+  }
+
+  if (props.addressModeW) {
+    params[GL.TEXTURE_WRAP_R] = convertAddressMode(props.addressModeW);
+  }
+
+  if (props.magFilter) {
+    params[GL.TEXTURE_MAG_FILTER] = convertMaxFilterMode(props.magFilter);
+  }
+
+  if (props.minFilter || props.mipmapFilter) {
+    params[GL.TEXTURE_MIN_FILTER] = convertMinFilterMode(props.minFilter || 'linear', props.mipmapFilter);
+  }
+
+  if (props.lodMinClamp !== undefined) {
+    params[GL.TEXTURE_MIN_LOD] = props.lodMinClamp;
+  }
+
+  if (props.lodMaxClamp !== undefined) {
+    params[GL.TEXTURE_MAX_LOD] = props.lodMaxClamp;
+  }
+
+  if (props.compare) {
+    params[GL.TEXTURE_COMPARE_MODE] = GL.COMPARE_REF_TO_TEXTURE;
+    params[GL.TEXTURE_COMPARE_FUNC] = convertCompareFunction('compare', props.compare);
+  }
+
+  if (props.maxAnisotropy) {
+    props[GL.TEXTURE_MAX_ANISOTROPY_EXT] = props.maxAnisotropy;
+  }
+
+  return params;
+}
+
+function convertAddressMode(addressMode) {
+  switch (addressMode) {
+    case 'clamp-to-edge':
+      return GL.CLAMP_TO_EDGE;
+
+    case 'repeat':
+      return GL.REPEAT;
+
+    case 'mirror-repeat':
+      return GL.MIRRORED_REPEAT;
+  }
+}
+
+function convertMaxFilterMode(maxFilter) {
+  switch (maxFilter) {
+    case 'nearest':
+      return GL.NEAREST;
+
+    case 'linear':
+      return GL.LINEAR;
+  }
+}
+
+function convertMinFilterMode(minFilter, mipmapFilter) {
+  if (!mipmapFilter) {
+    return convertMaxFilterMode(minFilter);
+  }
+
+  switch (minFilter) {
+    case 'nearest':
+      return mipmapFilter === 'nearest' ? GL.NEAREST_MIPMAP_NEAREST : GL.NEAREST_MIPMAP_LINEAR;
+
+    case 'linear':
+      return mipmapFilter === 'nearest' ? GL.LINEAR_MIPMAP_NEAREST : GL.LINEAR_MIPMAP_LINEAR;
+  }
+}
+
+export function convertToSamplerParameters(params) {
+  const props = {};
+
+  if (params[GL.TEXTURE_WRAP_S]) {
+    props.addressModeU = convertToAddressMode(params[GL.TEXTURE_WRAP_S]);
+  }
+
+  if (params[GL.TEXTURE_WRAP_T]) {
+    props.addressModeV = convertToAddressMode(params[GL.TEXTURE_WRAP_T]);
+  }
+
+  if (params[GL.TEXTURE_WRAP_R]) {
+    props.addressModeW = convertToAddressMode(params[GL.TEXTURE_WRAP_R]);
+  }
+
+  if (params[GL.TEXTURE_MAG_FILTER]) {
+    props.magFilter = convertToMaxFilterMode(params[GL.TEXTURE_MAG_FILTER]);
+  }
+
+  if (params[GL.TEXTURE_MIN_FILTER]) {
+    props.minFilter = convertToMinFilterMode(params[GL.TEXTURE_MIN_FILTER]);
+  }
+
+  if (params[GL.TEXTURE_MIN_FILTER]) {
+    props.mipmapFilter = convertToMipmapFilterMode(params[GL.TEXTURE_MIN_FILTER]);
+  }
+
+  if (params[GL.TEXTURE_MIN_LOD]) {
+    props.lodMinClamp = params[GL.TEXTURE_MIN_LOD];
+  }
+
+  if (params[GL.TEXTURE_MAX_LOD]) {
+    props.lodMaxClamp = params[GL.TEXTURE_MAX_LOD];
+  }
+
+  if (params[GL.TEXTURE_COMPARE_MODE] === GL.COMPARE_REF_TO_TEXTURE) {
+    props.compare = convertToCompareFunction('compare', params[GL.TEXTURE_COMPARE_FUNC]);
+  }
+
+  if (params[GL.TEXTURE_MAX_ANISOTROPY_EXT]) {
+    props.maxAnisotropy = params[GL.TEXTURE_MAX_ANISOTROPY_EXT];
+  }
+
+  return props;
+}
+
+function convertToAddressMode(addressMode) {
+  switch (addressMode) {
+    case GL.CLAMP_TO_EDGE:
+      return 'clamp-to-edge';
+
+    case GL.REPEAT:
+      return 'repeat';
+
+    case GL.MIRRORED_REPEAT:
+      return 'mirror-repeat';
+  }
+}
+
+function convertToMaxFilterMode(filterMode) {
+  switch (filterMode) {
+    case GL.NEAREST:
+      return 'nearest';
+
+    case GL.LINEAR:
+      return 'linear';
+  }
+}
+
+function convertToMinFilterMode(filterMode) {
+  switch (filterMode) {
+    case GL.NEAREST:
+      return 'nearest';
+
+    case GL.LINEAR:
+      return 'linear';
+
+    case GL.NEAREST_MIPMAP_NEAREST:
+      return 'nearest';
+
+    case GL.LINEAR_MIPMAP_NEAREST:
+      return 'linear';
+
+    case GL.NEAREST_MIPMAP_LINEAR:
+      return 'nearest';
+
+    case GL.LINEAR_MIPMAP_LINEAR:
+      return 'linear';
+  }
+}
+
+function convertToMipmapFilterMode(filterMode) {
+  switch (filterMode) {
+    case GL.NEAREST:
+      return 'nearest';
+
+    case GL.LINEAR:
+      return 'linear';
+
+    case GL.NEAREST_MIPMAP_NEAREST:
+      return 'nearest';
+
+    case GL.LINEAR_MIPMAP_NEAREST:
+      return 'nearest';
+
+    case GL.NEAREST_MIPMAP_LINEAR:
+      return 'linear';
+
+    case GL.LINEAR_MIPMAP_LINEAR:
+      return 'linear';
+  }
+}
+
+export function updateSamplerParametersForNPOT(parameters) {
+  const newParameters = { ...parameters
+  };
+
+  if (parameters[GL.TEXTURE_MIN_FILTER] !== GL.NEAREST) {
+    newParameters[GL.TEXTURE_MIN_FILTER] = GL.LINEAR;
+  }
+
+  newParameters[GL.TEXTURE_WRAP_S] = GL.CLAMP_TO_EDGE;
+  newParameters[GL.TEXTURE_WRAP_T] = GL.CLAMP_TO_EDGE;
+  return newParameters;
+}
+//# sourceMappingURL=sampler-parameters.js.map

package/dist/adapter/converters/sampler-parameters.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/adapter/converters/sampler-parameters.ts"],"names":["GL","convertCompareFunction","convertToCompareFunction","convertSamplerParametersToWebGL","props","params","addressModeU","TEXTURE_WRAP_S","convertAddressMode","addressModeV","TEXTURE_WRAP_T","addressModeW","TEXTURE_WRAP_R","magFilter","TEXTURE_MAG_FILTER","convertMaxFilterMode","minFilter","mipmapFilter","TEXTURE_MIN_FILTER","convertMinFilterMode","lodMinClamp","undefined","TEXTURE_MIN_LOD","lodMaxClamp","TEXTURE_MAX_LOD","compare","TEXTURE_COMPARE_MODE","COMPARE_REF_TO_TEXTURE","TEXTURE_COMPARE_FUNC","maxAnisotropy","TEXTURE_MAX_ANISOTROPY_EXT","addressMode","CLAMP_TO_EDGE","REPEAT","MIRRORED_REPEAT","maxFilter","NEAREST","LINEAR","NEAREST_MIPMAP_NEAREST","NEAREST_MIPMAP_LINEAR","LINEAR_MIPMAP_NEAREST","LINEAR_MIPMAP_LINEAR","convertToSamplerParameters","convertToAddressMode","convertToMaxFilterMode","convertToMinFilterMode","convertToMipmapFilterMode","filterMode","updateSamplerParametersForNPOT","parameters","newParameters"],"mappings":"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","sourcesContent":["// SAMPLER FILTERS\nimport {SamplerParameters} from '@luma.gl/api';\nimport GL from '@luma.gl/constants';\nimport {WebGLSamplerParameters} from '../../types/webgl';\nimport {convertCompareFunction, convertToCompareFunction} from './device-parameters';\n\n/**\n * Convert WebGPU-style sampler props to WebGL\n * @param props\n * @returns\n */\nexport function convertSamplerParametersToWebGL(props: SamplerParameters): WebGLSamplerParameters {\n  const params: Record<number, number> = {};\n  if (props.addressModeU) {\n    params[GL.TEXTURE_WRAP_S] = convertAddressMode(props.addressModeU);\n  }\n  if (props.addressModeV) {\n    params[GL.TEXTURE_WRAP_T] = convertAddressMode(props.addressModeV);\n  }\n  if (props.addressModeW) {\n    params[GL.TEXTURE_WRAP_R] = convertAddressMode(props.addressModeW);\n  }\n  if (props.magFilter) {\n    params[GL.TEXTURE_MAG_FILTER] = convertMaxFilterMode(props.magFilter);\n  }\n  if (props.minFilter || props.mipmapFilter) {\n    // TODO - arbitrary choice of linear?\n    params[GL.TEXTURE_MIN_FILTER] = convertMinFilterMode(props.minFilter || 'linear', props.mipmapFilter);\n  }\n  if (props.lodMinClamp !== undefined) {\n    params[GL.TEXTURE_MIN_LOD] = props.lodMinClamp;\n  }\n  if (props.lodMaxClamp !== undefined) {\n    params[GL.TEXTURE_MAX_LOD] = props.lodMaxClamp;\n  }\n  if (props.compare) {\n    // Setting prop.compare turns this into a comparison sampler\n    params[GL.TEXTURE_COMPARE_MODE] = GL.COMPARE_REF_TO_TEXTURE;\n    params[GL.TEXTURE_COMPARE_FUNC] = convertCompareFunction('compare', props.compare);\n  }\n  // Note depends on WebGL extension\n  if (props.maxAnisotropy) {\n    props[GL.TEXTURE_MAX_ANISOTROPY_EXT] = props.maxAnisotropy;\n  }\n  return params;\n}\n\n/** Convert address more */\nfunction convertAddressMode(addressMode: 'clamp-to-edge' | 'repeat' | 'mirror-repeat'): GL {\n  switch (addressMode) {\n    case 'clamp-to-edge': return GL.CLAMP_TO_EDGE;\n    case 'repeat': return GL.REPEAT;\n    case 'mirror-repeat': return GL.MIRRORED_REPEAT;\n  }\n}\n\nfunction convertMaxFilterMode(maxFilter: 'nearest' | 'linear'): GL {\n  switch (maxFilter) {\n    case 'nearest': return GL.NEAREST;\n    case 'linear': return GL.LINEAR;\n  }\n}\n\n/** \n * WebGPU has separate min filter and mipmap filter, \n * WebGL is combined and effectively offers 6 options\n */\nfunction convertMinFilterMode(minFilter: 'nearest' | 'linear', mipmapFilter?: 'nearest' | 'linear'): GL {\n  if (!mipmapFilter) {\n    return convertMaxFilterMode(minFilter);\n  }\n  switch (minFilter) {\n    case 'nearest': return mipmapFilter === 'nearest' ? GL.NEAREST_MIPMAP_NEAREST : GL.NEAREST_MIPMAP_LINEAR;\n    case 'linear': return mipmapFilter === 'nearest' ? GL.LINEAR_MIPMAP_NEAREST : GL.LINEAR_MIPMAP_LINEAR;\n  }\n}\n\n// Convert from WebGL to WebGPU\n\n/**\n * Convert WebGL-style sampler props to WebGPU\n * @param props\n * @returns\n */\n export function convertToSamplerParameters(params: WebGLSamplerParameters): SamplerParameters {\n  const props: SamplerParameters = {};\n  if (params[GL.TEXTURE_WRAP_S]) {\n    props.addressModeU = convertToAddressMode(params[GL.TEXTURE_WRAP_S]);\n  }\n  if (params[GL.TEXTURE_WRAP_T]) {\n    props.addressModeV = convertToAddressMode(params[GL.TEXTURE_WRAP_T]);\n  }\n  if (params[GL.TEXTURE_WRAP_R]) {\n    props.addressModeW = convertToAddressMode(params[GL.TEXTURE_WRAP_R]);\n  }\n  if (params[GL.TEXTURE_MAG_FILTER]) {\n    props.magFilter = convertToMaxFilterMode(params[GL.TEXTURE_MAG_FILTER]);\n  }\n  if (params[GL.TEXTURE_MIN_FILTER]) {\n    props.minFilter = convertToMinFilterMode(params[GL.TEXTURE_MIN_FILTER]);\n  }\n  if (params[GL.TEXTURE_MIN_FILTER]) {\n    props.mipmapFilter = convertToMipmapFilterMode(params[GL.TEXTURE_MIN_FILTER]);\n  }\n  if (params[GL.TEXTURE_MIN_LOD]) {\n    props.lodMinClamp = params[GL.TEXTURE_MIN_LOD];\n  }\n  if (params[GL.TEXTURE_MAX_LOD]) {\n    props.lodMaxClamp = params[GL.TEXTURE_MAX_LOD];\n  }\n  if (params[GL.TEXTURE_COMPARE_MODE] === GL.COMPARE_REF_TO_TEXTURE) {\n    props.compare = convertToCompareFunction('compare', params[GL.TEXTURE_COMPARE_FUNC]);\n  }\n  // NOTE depends on extension (very common)\n  if (params[GL.TEXTURE_MAX_ANISOTROPY_EXT]) {\n    props.maxAnisotropy = params[GL.TEXTURE_MAX_ANISOTROPY_EXT];\n  }\n  return props;\n}\n\n/** Convert address more */\nfunction convertToAddressMode(addressMode: number): 'clamp-to-edge' | 'repeat' | 'mirror-repeat' {\n  switch (addressMode) {\n    case GL.CLAMP_TO_EDGE: return 'clamp-to-edge';\n    case GL.REPEAT: return 'repeat';\n    case GL.MIRRORED_REPEAT: return 'mirror-repeat';\n  }\n}\n\nfunction convertToMaxFilterMode(filterMode: number): 'nearest' | 'linear' {\n  switch (filterMode) {\n    case GL.NEAREST: return 'nearest';\n    case GL.LINEAR: return 'linear';\n  }\n}\n\n/** WebGPU has separate min filter and mipmap filter, WebGL is combined */\nfunction convertToMinFilterMode(filterMode: number): 'nearest' | 'linear' {\n  switch (filterMode) {\n    // TODO is this correct?\n    case GL.NEAREST: return 'nearest';\n    case GL.LINEAR: return 'linear';\n    case GL.NEAREST_MIPMAP_NEAREST: return 'nearest';\n    case GL.LINEAR_MIPMAP_NEAREST: return 'linear';\n    case GL.NEAREST_MIPMAP_LINEAR: return 'nearest';\n    case GL.LINEAR_MIPMAP_LINEAR: return 'linear';\n  }\n}\n\nfunction convertToMipmapFilterMode(filterMode: number): 'nearest' | 'linear' {\n  switch (filterMode) {\n    // TODO is this correct?\n    case GL.NEAREST: return 'nearest';\n    case GL.LINEAR: return 'linear';\n    case GL.NEAREST_MIPMAP_NEAREST: return 'nearest';\n    case GL.LINEAR_MIPMAP_NEAREST: return 'nearest';\n    case GL.NEAREST_MIPMAP_LINEAR: return 'linear';\n    case GL.LINEAR_MIPMAP_LINEAR: return 'linear';\n  }\n}\n\n/**\n * Override sampler settings that are not supported by Non-Power-of-Two textures in WebGL1.\n*/\nexport function updateSamplerParametersForNPOT(parameters: WebGLSamplerParameters): WebGLSamplerParameters {\n  const newParameters = {...parameters};\n  if (parameters[GL.TEXTURE_MIN_FILTER] !== GL.NEAREST) {\n    // log.warn(`texture: ${this} is Non-Power-Of-Two, forcing TEXTURE_MIN_FILTER to LINEAR`)();\n    newParameters[GL.TEXTURE_MIN_FILTER] = GL.LINEAR;\n  }\n  // log.warn(`texture: ${this} is Non-Power-Of-Two, forcing TEXTURE_WRAP_S to CLAMP_TO_EDGE`)();\n  newParameters[GL.TEXTURE_WRAP_S] = GL.CLAMP_TO_EDGE;\n  newParameters[GL.TEXTURE_WRAP_T] = GL.CLAMP_TO_EDGE;\n  return newParameters;\n}\n"],"file":"sampler-parameters.js"}

package/dist/adapter/converters/texture-formats.d.ts

@@ -0,0 +1,93 @@
+import type { TextureFormat, DeviceFeature } from '@luma.gl/api';
+import GL from '@luma.gl/constants';
+export declare function checkTextureFeature(gl: WebGLRenderingContext, feature: DeviceFeature): boolean;
+/** Return a list of texture feature strings (for Device.features). Mainly compressed texture support */
+export declare function getTextureFeatures(gl: WebGLRenderingContext): DeviceFeature[];
+/** Map a format to webgl and constants */
+declare type Format = {
+    gl?: GL;
+    /** If a different unsized format is needed in WebGL1 */
+    gl1?: GL;
+    gl1ext?: string;
+    gl2ext?: string;
+    b?: number;
+    /** channels */
+    c?: number;
+    bpp?: number;
+    /** packed */
+    p?: number;
+    x?: string;
+    f?: DeviceFeature;
+    render?: DeviceFeature;
+    filter?: DeviceFeature;
+    wgpu?: false;
+    types?: number[];
+    dataFormat?: GL;
+    attachment?: GL.DEPTH_ATTACHMENT | GL.STENCIL_ATTACHMENT | GL.DEPTH_STENCIL_ATTACHMENT;
+};
+/** Legal combinations for internalFormat, format and type *
+// [GL.DEPTH_COMPONENT]: {types: [GL.UNSIGNED_SHORT, GL.UNSIGNED_INT, GL.UNSIGNED_INT_24_8], gl1ext: DEPTH},
+// [GL.DEPTH_STENCIL]: {gl1ext: DEPTH},
+// Sized texture format
+// R
+[GL.R8]: {dataFormat: GL.RED, types: [GL.UNSIGNED_BYTE], gl2: true},
+[GL.R16F]: {dataFormat: GL.RED, types: [GL.HALF_FLOAT, GL.FLOAT], gl2: true},
+[GL.R8UI]: {dataFormat: GL.RED_INTEGER, types: [GL.UNSIGNED_BYTE], gl2: true},
+// // RG
+[GL.RG8]: {dataFormat: GL.RG, types: [GL.UNSIGNED_BYTE], gl2: true},
+[GL.RG16F]: {dataFormat: GL.RG, types: [GL.HALF_FLOAT, GL.FLOAT], gl2: true},
+[GL.RG8UI]: {dataFormat: GL.RG_INTEGER, types: [GL.UNSIGNED_BYTE], gl2: true},
+// // RGB
+[GL.RGB8]: {dataFormat: GL.RGB, types: [GL.UNSIGNED_BYTE], gl2: true},
+[GL.SRGB8]: {dataFormat: GL.RGB, types: [GL.UNSIGNED_BYTE], gl2: true, gl1ext: EXT_SRGB},
+[GL.RGB16F]: {dataFormat: GL.RGB, types: [GL.HALF_FLOAT, GL.FLOAT], gl2: true, gl1ext: EXT_HALF_FLOAT_WEBGL1},
+[GL.RGB8UI]: {dataFormat: GL.RGB_INTEGER, types: [GL.UNSIGNED_BYTE], gl2: true},
+// // RGBA
+
+[GL.RGB565]: {dataFormat: GL.RGB, types: [GL.UNSIGNED_BYTE, GL.UNSIGNED_SHORT_5_6_5], gl2: true},
+[GL.R11F_G11F_B10F]: {dataFormat: GL.RGB, types: [GL.UNSIGNED_INT_10F_11F_11F_REV, GL.HALF_FLOAT, GL.FLOAT], gl2: true},
+[GL.RGB9_E5]: {dataFormat: GL.RGB, types: [GL.HALF_FLOAT, GL.FLOAT], gl2: true, gl1ext: EXT_HALF_FLOAT_WEBGL1},
+[GL.RGBA8]: {dataFormat: GL.RGBA, types: [GL.UNSIGNED_BYTE], gl2: true},
+[GL.SRGB8_ALPHA8]: {dataFormat: GL.RGBA, types: [GL.UNSIGNED_BYTE], gl2: true, gl1ext: EXT_SRGB},
+[GL.RGB5_A1]: {dataFormat: GL.RGBA, types: [GL.UNSIGNED_BYTE, GL.UNSIGNED_SHORT_5_5_5_1], gl2: true},
+[GL.RGBA4]: {dataFormat: GL.RGBA, types: [GL.UNSIGNED_BYTE, GL.UNSIGNED_SHORT_4_4_4_4], gl2: true},
+[GL.RGBA16F]: {dataFormat: GL.RGBA, types: [GL.HALF_FLOAT, GL.FLOAT], gl2: true, gl1ext: EXT_HALF_FLOAT_WEBGL1},
+[GL.RGBA8UI]: {dataFormat: GL.RGBA_INTEGER, types: [GL.UNSIGNED_BYTE], gl2: true}
+*/
+/** Texture format data */
+export declare const TEXTURE_FORMATS: Record<TextureFormat, Format>;
+/** Checks if a texture format is supported */
+export declare function isTextureFormatSupported(gl: WebGLRenderingContext, formatOrGL: TextureFormat | GL): boolean;
+/** Checks if a texture format is supported */
+export declare function getTextureFormatSupport(gl: WebGLRenderingContext, formatOrGL: TextureFormat | GL): {
+    supported: boolean;
+    filterable?: boolean;
+    renderable?: boolean;
+    blendable?: boolean;
+    storable?: boolean;
+};
+/** Checks whether linear filtering (interpolated sampling) is available for floating point textures */
+export declare function isTextureFormatFilterable(gl: WebGLRenderingContext, formatOrGL: TextureFormat | GL): boolean;
+export declare function isTextureFormatRenderable(gl: WebGLRenderingContext, formatOrGL: TextureFormat | GL): boolean;
+/**
+ * Converts WebGPU string style texture formats to GL constants
+ * Pass through GL constants
+ */
+export declare function getWebGLTextureFormat(gl: WebGLRenderingContext, formatOrGL: TextureFormat | GL): GL | undefined;
+export declare function getWebGLTextureParameters(gl: WebGLRenderingContext, formatOrGL: TextureFormat | GL): {
+    format: GL;
+    dataFormat: GL;
+    type: GL;
+    compressed: any;
+};
+export declare function getWebGLDepthStencilAttachment(formatOrGL: TextureFormat | GL): GL.DEPTH_ATTACHMENT | GL.STENCIL_ATTACHMENT | GL.DEPTH_STENCIL_ATTACHMENT;
+/**
+ * function to test if Float 32 bit format texture can be bound as color attachment
+ * @todo Generalize to check arbitrary formats?
+ */
+export declare function _checkFloat32ColorAttachment(gl: WebGLRenderingContext, internalFormat?: number, srcFormat?: GL, srcType?: GL): boolean;
+/** TODO - VERY roundabout legacy way of calculating bytes per pixel */
+export declare function getTextureFormatBytesPerPixel(gl: WebGLRenderingContext, formatOrGL: TextureFormat | GL): number;
+export declare function getWebGLDataType(dataType: string): GL;
+export {};
+//# sourceMappingURL=texture-formats.d.ts.map

package/dist/adapter/converters/texture-formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"texture-formats.d.ts","sourceRoot":"","sources":["../../../src/adapter/converters/texture-formats.ts"],"names":[],"mappings":"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"}