@luma.gl/webgl 8.5.8 → 8.6.0-alpha.2

package/dist/classes/copy-and-blit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-and-blit.d.ts","sourceRoot":"","sources":["../../src/classes/copy-and-blit.ts"],"names":[],"mappings":"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"}

package/dist/classes/copy-and-blit.js

@@ -0,0 +1,338 @@
+import { log, assert } from '@luma.gl/api';
+import GL from '@luma.gl/constants';
+import Buffer from './webgl-buffer';
+import Framebuffer from './framebuffer';
+import Texture from './texture';
+import { assertWebGL2Context } from '../context/context/webgl-checks';
+import { withParameters } from '../context/state-tracker/with-parameters';
+import { flipRows, scalePixels } from '../webgl-utils/typed-array-utils';
+import { getTypedArrayFromGLType, getGLTypeFromTypedArray } from '../webgl-utils/typed-array-utils';
+import { glFormatToComponents, glTypeToBytes } from '../webgl-utils/format-utils';
+import { toFramebuffer } from '../webgl-utils/texture-utils';
+export function readPixelsToArray(source, options) {
+  const {
+    sourceX = 0,
+    sourceY = 0,
+    sourceFormat = GL.RGBA
+  } = options || {};
+  let {
+    sourceAttachment = GL.COLOR_ATTACHMENT0,
+    target = null,
+    sourceWidth,
+    sourceHeight,
+    sourceType
+  } = options || {};
+  const {
+    framebuffer,
+    deleteFramebuffer
+  } = getFramebuffer(source);
+  assert(framebuffer);
+  const {
+    gl,
+    handle,
+    attachments
+  } = framebuffer;
+  sourceWidth = sourceWidth || framebuffer.width;
+  sourceHeight = sourceHeight || framebuffer.height;
+
+  if (sourceAttachment === GL.COLOR_ATTACHMENT0 && handle === null) {
+    sourceAttachment = GL.FRONT;
+  }
+
+  assert(attachments[sourceAttachment]);
+  sourceType = sourceType || attachments[sourceAttachment].type;
+  target = getPixelArray(target, sourceType, sourceFormat, sourceWidth, sourceHeight);
+  sourceType = sourceType || getGLTypeFromTypedArray(target);
+  const prevHandle = gl.bindFramebuffer(GL.FRAMEBUFFER, handle);
+  gl.readPixels(sourceX, sourceY, sourceWidth, sourceHeight, sourceFormat, sourceType, target);
+  gl.bindFramebuffer(GL.FRAMEBUFFER, prevHandle || null);
+
+  if (deleteFramebuffer) {
+    framebuffer.delete();
+  }
+
+  return target;
+}
+export function readPixelsToBuffer(source, options) {
+  const {
+    sourceX = 0,
+    sourceY = 0,
+    sourceFormat = GL.RGBA,
+    targetByteOffset = 0
+  } = options || {};
+  let {
+    target,
+    sourceWidth,
+    sourceHeight,
+    sourceType
+  } = options || {};
+  const {
+    framebuffer,
+    deleteFramebuffer
+  } = getFramebuffer(source);
+  assert(framebuffer);
+  sourceWidth = sourceWidth || framebuffer.width;
+  sourceHeight = sourceHeight || framebuffer.height;
+  const gl2 = assertWebGL2Context(framebuffer.gl);
+  sourceType = sourceType || (target ? target.type : GL.UNSIGNED_BYTE);
+
+  if (!target) {
+    const components = glFormatToComponents(sourceFormat);
+    const byteCount = glTypeToBytes(sourceType);
+    const byteLength = targetByteOffset + sourceWidth * sourceHeight * components * byteCount;
+    target = new Buffer(gl2, {
+      byteLength,
+      accessor: {
+        type: sourceType,
+        size: components
+      }
+    });
+  }
+
+  target.bind({
+    target: GL.PIXEL_PACK_BUFFER
+  });
+  withParameters(gl2, {
+    framebuffer
+  }, () => {
+    gl2.readPixels(sourceX, sourceY, sourceWidth, sourceHeight, sourceFormat, sourceType, targetByteOffset);
+  });
+  target.unbind({
+    target: GL.PIXEL_PACK_BUFFER
+  });
+
+  if (deleteFramebuffer) {
+    framebuffer.delete();
+  }
+
+  return target;
+}
+export function copyToDataUrl(source, {
+  sourceAttachment = GL.COLOR_ATTACHMENT0,
+  targetMaxHeight = Number.MAX_SAFE_INTEGER
+} = {}) {
+  let data = readPixelsToArray(source, {
+    sourceAttachment
+  });
+  let {
+    width,
+    height
+  } = source;
+
+  while (height > targetMaxHeight) {
+    ({
+      data,
+      width,
+      height
+    } = scalePixels({
+      data,
+      width,
+      height
+    }));
+  }
+
+  flipRows({
+    data,
+    width,
+    height
+  });
+  const canvas = document.createElement('canvas');
+  canvas.width = width;
+  canvas.height = height;
+  const context = canvas.getContext('2d');
+  const imageData = context.createImageData(width, height);
+  imageData.data.set(data);
+  context.putImageData(imageData, 0, 0);
+  return canvas.toDataURL();
+}
+export function copyToImage(source, options) {
+  const dataUrl = copyToDataUrl(source, {
+    sourceAttachment: (options === null || options === void 0 ? void 0 : options.sourceAttachment) || GL.COLOR_ATTACHMENT0
+  });
+  const targetImage = (options === null || options === void 0 ? void 0 : options.targetImage) || new Image();
+  targetImage.src = dataUrl;
+  return targetImage;
+}
+export function copyToTexture(source, target, options) {
+  const {
+    sourceX = 0,
+    sourceY = 0,
+    targetMipmaplevel = 0,
+    targetInternalFormat = GL.RGBA
+  } = options || {};
+  let {
+    targetX,
+    targetY,
+    targetZ,
+    width,
+    height
+  } = options || {};
+  const {
+    framebuffer,
+    deleteFramebuffer
+  } = getFramebuffer(source);
+  assert(framebuffer);
+  const {
+    gl,
+    handle
+  } = framebuffer;
+  const isSubCopy = typeof targetX !== 'undefined' || typeof targetY !== 'undefined' || typeof targetZ !== 'undefined';
+  targetX = targetX || 0;
+  targetY = targetY || 0;
+  targetZ = targetZ || 0;
+  const prevHandle = gl.bindFramebuffer(GL.FRAMEBUFFER, handle);
+  assert(target);
+  let texture = null;
+  let textureTarget;
+
+  if (target instanceof Texture) {
+    texture = target;
+    width = Number.isFinite(width) ? width : texture.width;
+    height = Number.isFinite(height) ? height : texture.height;
+    texture.bind(0);
+    textureTarget = texture.target;
+  } else {
+    textureTarget = target;
+  }
+
+  if (!isSubCopy) {
+    gl.copyTexImage2D(textureTarget, targetMipmaplevel, targetInternalFormat, sourceX, sourceY, width, height, 0);
+  } else {
+    switch (textureTarget) {
+      case GL.TEXTURE_2D:
+      case GL.TEXTURE_CUBE_MAP:
+        gl.copyTexSubImage2D(textureTarget, targetMipmaplevel, targetX, targetY, sourceX, sourceY, width, height);
+        break;
+
+      case GL.TEXTURE_2D_ARRAY:
+      case GL.TEXTURE_3D:
+        const gl2 = assertWebGL2Context(gl);
+        gl2.copyTexSubImage3D(textureTarget, targetMipmaplevel, targetX, targetY, targetZ, sourceX, sourceY, width, height);
+        break;
+
+      default:
+    }
+  }
+
+  if (texture) {
+    texture.unbind();
+  }
+
+  gl.bindFramebuffer(GL.FRAMEBUFFER, prevHandle || null);
+
+  if (deleteFramebuffer) {
+    framebuffer.delete();
+  }
+
+  return texture;
+}
+export function blit(source, target, options) {
+  const {
+    sourceX0 = 0,
+    sourceY0 = 0,
+    targetX0 = 0,
+    targetY0 = 0,
+    color = true,
+    depth = false,
+    stencil = false,
+    filter = GL.NEAREST
+  } = options;
+  let {
+    sourceX1,
+    sourceY1,
+    targetX1,
+    targetY1,
+    sourceAttachment = GL.COLOR_ATTACHMENT0,
+    mask = 0
+  } = options;
+  const {
+    framebuffer: srcFramebuffer,
+    deleteFramebuffer: deleteSrcFramebuffer
+  } = getFramebuffer(source);
+  const {
+    framebuffer: dstFramebuffer,
+    deleteFramebuffer: deleteDstFramebuffer
+  } = getFramebuffer(target);
+  assert(srcFramebuffer);
+  assert(dstFramebuffer);
+  const {
+    gl,
+    handle,
+    width,
+    height,
+    readBuffer
+  } = dstFramebuffer;
+  const gl2 = assertWebGL2Context(gl);
+
+  if (!srcFramebuffer.handle && sourceAttachment === GL.COLOR_ATTACHMENT0) {
+    sourceAttachment = GL.FRONT;
+  }
+
+  if (color) {
+    mask |= GL.COLOR_BUFFER_BIT;
+  }
+
+  if (depth) {
+    mask |= GL.DEPTH_BUFFER_BIT;
+  }
+
+  if (stencil) {
+    mask |= GL.STENCIL_BUFFER_BIT;
+  }
+
+  if (deleteSrcFramebuffer || deleteDstFramebuffer) {
+    if (mask & (GL.DEPTH_BUFFER_BIT | GL.STENCIL_BUFFER_BIT)) {
+      mask = GL.COLOR_BUFFER_BIT;
+      log.warn('Blitting from or into a Texture object, forcing mask to GL.COLOR_BUFFER_BIT')();
+    }
+  }
+
+  assert(mask);
+  sourceX1 = sourceX1 === undefined ? srcFramebuffer.width : sourceX1;
+  sourceY1 = sourceY1 === undefined ? srcFramebuffer.height : sourceY1;
+  targetX1 = targetX1 === undefined ? width : targetX1;
+  targetY1 = targetY1 === undefined ? height : targetY1;
+  const prevDrawHandle = gl.bindFramebuffer(GL.DRAW_FRAMEBUFFER, handle);
+  const prevReadHandle = gl.bindFramebuffer(GL.READ_FRAMEBUFFER, srcFramebuffer.handle);
+  gl2.readBuffer(sourceAttachment);
+  gl2.blitFramebuffer(sourceX0, sourceY0, sourceX1, sourceY1, targetX0, targetY0, targetX1, targetY1, mask, filter);
+  gl2.readBuffer(readBuffer);
+  gl2.bindFramebuffer(GL.READ_FRAMEBUFFER, prevReadHandle || null);
+  gl2.bindFramebuffer(GL.DRAW_FRAMEBUFFER, prevDrawHandle || null);
+
+  if (deleteSrcFramebuffer) {
+    srcFramebuffer.delete();
+  }
+
+  if (deleteDstFramebuffer) {
+    dstFramebuffer.delete();
+  }
+}
+
+function getFramebuffer(source) {
+  if (!(source instanceof Framebuffer)) {
+    return {
+      framebuffer: toFramebuffer(source),
+      deleteFramebuffer: true
+    };
+  }
+
+  return {
+    framebuffer: source,
+    deleteFramebuffer: false
+  };
+}
+
+function getPixelArray(pixelArray, type, format, width, height) {
+  if (pixelArray) {
+    return pixelArray;
+  }
+
+  type = type || GL.UNSIGNED_BYTE;
+  const ArrayType = getTypedArrayFromGLType(type, {
+    clamped: false
+  });
+  const components = glFormatToComponents(format);
+  return new ArrayType(width * height * components);
+}
+//# sourceMappingURL=copy-and-blit.js.map

package/dist/classes/copy-and-blit.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/classes/copy-and-blit.ts"],"names":["log","assert","GL","Buffer","Framebuffer","Texture","assertWebGL2Context","withParameters","flipRows","scalePixels","getTypedArrayFromGLType","getGLTypeFromTypedArray","glFormatToComponents","glTypeToBytes","toFramebuffer","readPixelsToArray","source","options","sourceX","sourceY","sourceFormat","RGBA","sourceAttachment","COLOR_ATTACHMENT0","target","sourceWidth","sourceHeight","sourceType","framebuffer","deleteFramebuffer","getFramebuffer","gl","handle","attachments","width","height","FRONT","type","getPixelArray","prevHandle","bindFramebuffer","FRAMEBUFFER","readPixels","delete","readPixelsToBuffer","targetByteOffset","gl2","UNSIGNED_BYTE","components","byteCount","byteLength","accessor","size","bind","PIXEL_PACK_BUFFER","unbind","copyToDataUrl","targetMaxHeight","Number","MAX_SAFE_INTEGER","data","canvas","document","createElement","context","getContext","imageData","createImageData","set","putImageData","toDataURL","copyToImage","dataUrl","targetImage","Image","src","copyToTexture","targetMipmaplevel","targetInternalFormat","targetX","targetY","targetZ","isSubCopy","texture","textureTarget","isFinite","copyTexImage2D","TEXTURE_2D","TEXTURE_CUBE_MAP","copyTexSubImage2D","TEXTURE_2D_ARRAY","TEXTURE_3D","copyTexSubImage3D","blit","sourceX0","sourceY0","targetX0","targetY0","color","depth","stencil","filter","NEAREST","sourceX1","sourceY1","targetX1","targetY1","mask","srcFramebuffer","deleteSrcFramebuffer","dstFramebuffer","deleteDstFramebuffer","readBuffer","COLOR_BUFFER_BIT","DEPTH_BUFFER_BIT","STENCIL_BUFFER_BIT","warn","undefined","prevDrawHandle","DRAW_FRAMEBUFFER","prevReadHandle","READ_FRAMEBUFFER","blitFramebuffer","pixelArray","format","ArrayType","clamped"],"mappings":"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","sourcesContent":["import {log, assert} from '@luma.gl/api';\nimport GL from '@luma.gl/constants';\nimport Buffer from './webgl-buffer';\nimport Framebuffer from './framebuffer';\nimport Texture from './texture';\nimport {assertWebGL2Context} from '../context/context/webgl-checks';\nimport {withParameters} from '../context/state-tracker/with-parameters';\nimport {flipRows, scalePixels} from '../webgl-utils/typed-array-utils';\nimport {getTypedArrayFromGLType, getGLTypeFromTypedArray} from '../webgl-utils/typed-array-utils';\nimport {glFormatToComponents, glTypeToBytes} from '../webgl-utils/format-utils';\nimport {toFramebuffer} from '../webgl-utils/texture-utils';\n\n/**\n * Copies data from a Framebuffer or a Texture object into ArrayBuffer object.\n * App can provide targetPixelArray or have it auto allocated by this method\n *  newly allocated by this method unless provided by app.\n * @note Slow requires roundtrip to GPU\n *\n * @param source\n * @param options\n// @returns {Uint8Array|Uint16Array|FloatArray} - pixel array,\n */\nexport function readPixelsToArray(\n  source: Framebuffer | Texture,\n  options?: {\n    sourceX?: number;\n    sourceY?: number;\n    sourceFormat?: number;\n    sourceAttachment?: number;\n    target?: Uint8Array | Uint16Array | Float32Array;\n    // following parameters are auto deduced if not provided\n    sourceWidth?: number;\n    sourceHeight?: number;\n    sourceType?: number;\n  }\n): Uint8Array | Uint16Array | Float32Array {\n  const {sourceX = 0, sourceY = 0, sourceFormat = GL.RGBA} = options || {};\n  let {\n    sourceAttachment = GL.COLOR_ATTACHMENT0, // TODO - support gl.readBuffer\n    target = null,\n    // following parameters are auto deduced if not provided\n    sourceWidth,\n    sourceHeight,\n    sourceType\n  } = options || {};\n\n  const {framebuffer, deleteFramebuffer} = getFramebuffer(source);\n  assert(framebuffer);\n  const {gl, handle, attachments} = framebuffer;\n  sourceWidth = sourceWidth || framebuffer.width;\n  sourceHeight = sourceHeight || framebuffer.height;\n\n  // TODO - Set and unset gl.readBuffer\n  if (sourceAttachment === GL.COLOR_ATTACHMENT0 && handle === null) {\n    sourceAttachment = GL.FRONT;\n  }\n\n  assert(attachments[sourceAttachment]);\n\n  // Deduce the type from color attachment if not provided.\n  sourceType = sourceType || attachments[sourceAttachment].type;\n\n  // Deduce type and allocated pixelArray if needed\n  target = getPixelArray(target, sourceType, sourceFormat, sourceWidth, sourceHeight);\n\n  // Pixel array available, if necessary, deduce type from it.\n  sourceType = sourceType || getGLTypeFromTypedArray(target);\n\n  const prevHandle = gl.bindFramebuffer(GL.FRAMEBUFFER, handle);\n  gl.readPixels(sourceX, sourceY, sourceWidth, sourceHeight, sourceFormat, sourceType, target);\n  // @ts-expect-error\n  gl.bindFramebuffer(GL.FRAMEBUFFER, prevHandle || null);\n  if (deleteFramebuffer) {\n    framebuffer.delete();\n  }\n  return target;\n}\n\n/**\n * Copies data from a Framebuffer or a Texture object into a Buffer object.\n * NOTE: doesn't wait for copy to be complete, it programs GPU to perform a DMA transffer.\n * @param source\n * @param options\n */\nexport function readPixelsToBuffer(\n  source: Framebuffer | Texture,\n  options?: {\n    sourceX?: number;\n    sourceY?: number;\n    sourceFormat?: number;\n    target?: Buffer; // A new Buffer object is created when not provided.\n    targetByteOffset?: number; // byte offset in buffer object\n    // following parameters are auto deduced if not provided\n    sourceWidth?: number;\n    sourceHeight?: number;\n    sourceType?: number;\n  }\n): Buffer {\n  const {sourceX = 0, sourceY = 0, sourceFormat = GL.RGBA,\n    targetByteOffset = 0\n  } = options || {};\n    // following parameters are auto deduced if not provided\n  let {\n    target,\n    sourceWidth,\n    sourceHeight,\n    sourceType,\n  } = options || {}\n  const {framebuffer, deleteFramebuffer} = getFramebuffer(source);\n  assert(framebuffer);\n  sourceWidth = sourceWidth || framebuffer.width;\n  sourceHeight = sourceHeight || framebuffer.height;\n\n  // Asynchronous read (PIXEL_PACK_BUFFER) is WebGL2 only feature\n  const gl2 = assertWebGL2Context(framebuffer.gl);\n\n  // deduce type if not available.\n  sourceType = sourceType || (target ? target.type : GL.UNSIGNED_BYTE);\n\n  if (!target) {\n    // Create new buffer with enough size\n    const components = glFormatToComponents(sourceFormat);\n    const byteCount = glTypeToBytes(sourceType);\n    const byteLength = targetByteOffset + sourceWidth * sourceHeight * components * byteCount;\n    target = new Buffer(gl2, {byteLength, accessor: {type: sourceType, size: components}});\n  }\n\n  // @ts-expect-error\n  target.bind({target: GL.PIXEL_PACK_BUFFER});\n  withParameters(gl2, {framebuffer}, () => {\n    gl2.readPixels(\n      sourceX,\n      sourceY,\n      sourceWidth,\n      sourceHeight,\n      sourceFormat,\n      sourceType,\n      targetByteOffset\n    );\n  });\n  target.unbind({target: GL.PIXEL_PACK_BUFFER});\n  if (deleteFramebuffer) {\n    framebuffer.delete();\n  }\n\n  return target;\n}\n\n// Reads pixels from a Framebuffer or Texture object to a dataUrl\nexport function copyToDataUrl(\n  source,\n  options?: {\n    sourceAttachment?: number; // TODO - support gl.readBuffer\n    targetMaxHeight?: number;\n  }\n): string;\n\n// Reads pixels from a Framebuffer or Texture object to a dataUrl\nexport function copyToDataUrl(\n  source,\n  {\n    sourceAttachment = GL.COLOR_ATTACHMENT0, // TODO - support gl.readBuffer\n    targetMaxHeight = Number.MAX_SAFE_INTEGER\n  } = {}\n) {\n  let data = readPixelsToArray(source, {sourceAttachment});\n\n  // Scale down\n  let {width, height} = source;\n  while (height > targetMaxHeight) {\n    ({data, width, height} = scalePixels({data, width, height}));\n  }\n\n  // Flip to top down coordinate system\n  flipRows({data, width, height});\n\n  const canvas = document.createElement('canvas');\n  canvas.width = width;\n  canvas.height = height;\n  const context = canvas.getContext('2d');\n\n  // Copy the pixels to a 2D canvas\n  const imageData = context.createImageData(width, height);\n  imageData.data.set(data);\n  context.putImageData(imageData, 0, 0);\n\n  return canvas.toDataURL();\n}\n\n// Reads pixels from a Framebuffer or Texture object into an HTML Image\n// Reads pixels from a Framebuffer or Texture object into an HTML Image\nexport function copyToImage(\n  source: Framebuffer | Texture,\n  options?: {\n    sourceAttachment?: number; // TODO - support gl.readBuffer\n    targetImage?: typeof Image;\n  }\n): typeof Image {\n  const dataUrl = copyToDataUrl(source, {sourceAttachment: options?.sourceAttachment || GL.COLOR_ATTACHMENT0});\n  const targetImage = options?.targetImage || new Image();\n  // @ts-expect-error\n  targetImage.src = dataUrl;\n  // @ts-expect-error\n  return targetImage;\n}\n\n/**\n * Copy a rectangle from a Framebuffer or Texture object into a texture (at an offset)\n */\n// eslint-disable-next-line complexity, max-statements\nexport function copyToTexture(\n  source: Framebuffer | Texture,\n  target: Texture | GL,\n  options?: {\n    sourceX?: number;\n    sourceY?: number;\n\n    targetX?: number;\n    targetY?: number;\n    targetZ?: number;\n    targetMipmaplevel?: number;\n    targetInternalFormat?: number;\n\n    width?: number; // defaults to target width\n    height?: number; // defaults to target height\n  }\n): Texture {\n  const {\n    sourceX = 0,\n    sourceY = 0,\n    // attachment = GL.COLOR_ATTACHMENT0, // TODO - support gl.readBuffer\n    targetMipmaplevel = 0,\n    targetInternalFormat = GL.RGBA\n  } = options || {};\n  let {\n    targetX,\n    targetY,\n    targetZ,\n    width, // defaults to target width\n    height // defaults to target height\n  } = options || {};\n\n  const {framebuffer, deleteFramebuffer} = getFramebuffer(source);\n  assert(framebuffer);\n  const {gl, handle} = framebuffer;\n  const isSubCopy =\n    typeof targetX !== 'undefined' ||\n    typeof targetY !== 'undefined' ||\n    typeof targetZ !== 'undefined';\n  targetX = targetX || 0;\n  targetY = targetY || 0;\n  targetZ = targetZ || 0;\n  const prevHandle = gl.bindFramebuffer(GL.FRAMEBUFFER, handle);\n  // TODO - support gl.readBuffer (WebGL2 only)\n  // const prevBuffer = gl.readBuffer(attachment);\n  assert(target);\n  let texture = null;\n  let textureTarget: GL;\n  if (target instanceof Texture) {\n    texture = target;\n    width = Number.isFinite(width) ? width : texture.width;\n    height = Number.isFinite(height) ? height : texture.height;\n    texture.bind(0);\n    textureTarget = texture.target;\n  } else {\n    textureTarget = target;\n  }\n\n  if (!isSubCopy) {\n    gl.copyTexImage2D(\n      textureTarget,\n      targetMipmaplevel,\n      targetInternalFormat,\n      sourceX,\n      sourceY,\n      width,\n      height,\n      0 /* border must be 0 */\n    );\n  } else {\n    switch (textureTarget) {\n      case GL.TEXTURE_2D:\n      case GL.TEXTURE_CUBE_MAP:\n        gl.copyTexSubImage2D(\n          textureTarget,\n          targetMipmaplevel,\n          targetX,\n          targetY,\n          sourceX,\n          sourceY,\n          width,\n          height\n        );\n        break;\n      case GL.TEXTURE_2D_ARRAY:\n      case GL.TEXTURE_3D:\n        const gl2 = assertWebGL2Context(gl);\n        gl2.copyTexSubImage3D(\n          textureTarget,\n          targetMipmaplevel,\n          targetX,\n          targetY,\n          targetZ,\n          sourceX,\n          sourceY,\n          width,\n          height\n        );\n        break;\n      default:\n    }\n  }\n  if (texture) {\n    texture.unbind();\n  }\n  // @ts-expect-error\n  gl.bindFramebuffer(GL.FRAMEBUFFER, prevHandle || null);\n  if (deleteFramebuffer) {\n    framebuffer.delete();\n  }\n  return texture;\n}\n\n/**\n * Copies a rectangle of pixels between Framebuffer or Texture objects\n * @note NOTE: WEBLG2 only\n * @param source\n * @param target\n * @param options\n */\n// eslint-disable-next-line max-statements, complexity\nexport function blit(\n  source,\n  target,\n  options: {\n    sourceAttachment?: number;\n    sourceX0?: number;\n    sourceY0?: number;\n    sourceX1?: number;\n    sourceY1?: number;\n    targetX0?: number;\n    targetY0?: number;\n    targetX1?: number;\n    targetY1?: number;\n    color?: boolean;\n    depth?: boolean;\n    stencil?: boolean;\n    mask?: number;\n    filter?: number;\n  }\n): void {\n  const {\n    sourceX0 = 0,\n    sourceY0 = 0,\n    targetX0 = 0,\n    targetY0 = 0,\n    color = true,\n    depth = false,\n    stencil = false,\n    filter = GL.NEAREST\n  } = options;\n\n  let {\n    sourceX1,\n    sourceY1,\n    targetX1,\n    targetY1,\n    sourceAttachment = GL.COLOR_ATTACHMENT0,\n    mask = 0\n  } = options;\n\n  const {framebuffer: srcFramebuffer, deleteFramebuffer: deleteSrcFramebuffer} =\n    getFramebuffer(source);\n  const {framebuffer: dstFramebuffer, deleteFramebuffer: deleteDstFramebuffer} =\n    getFramebuffer(target);\n\n  assert(srcFramebuffer);\n  assert(dstFramebuffer);\n  const {gl, handle, width, height, readBuffer} = dstFramebuffer;\n  const gl2 = assertWebGL2Context(gl);\n\n  if (!srcFramebuffer.handle && sourceAttachment === GL.COLOR_ATTACHMENT0) {\n    sourceAttachment = GL.FRONT;\n  }\n\n  if (color) {\n    mask |= GL.COLOR_BUFFER_BIT;\n  }\n  if (depth) {\n    mask |= GL.DEPTH_BUFFER_BIT;\n  }\n  if (stencil) {\n    mask |= GL.STENCIL_BUFFER_BIT;\n  }\n\n  if (deleteSrcFramebuffer || deleteDstFramebuffer) {\n    // Either source or destiantion was a texture object, which is wrapped in a Framebuffer objecgt as color attachment.\n    // Overwrite the mask to `COLOR_BUFFER_BIT`\n    if (mask & (GL.DEPTH_BUFFER_BIT | GL.STENCIL_BUFFER_BIT)) {\n      mask = GL.COLOR_BUFFER_BIT;\n      log.warn('Blitting from or into a Texture object, forcing mask to GL.COLOR_BUFFER_BIT')();\n    }\n  }\n  assert(mask);\n\n  sourceX1 = sourceX1 === undefined ? srcFramebuffer.width : sourceX1;\n  sourceY1 = sourceY1 === undefined ? srcFramebuffer.height : sourceY1;\n  targetX1 = targetX1 === undefined ? width : targetX1;\n  targetY1 = targetY1 === undefined ? height : targetY1;\n\n  const prevDrawHandle = gl.bindFramebuffer(GL.DRAW_FRAMEBUFFER, handle);\n  const prevReadHandle = gl.bindFramebuffer(GL.READ_FRAMEBUFFER, srcFramebuffer.handle);\n  gl2.readBuffer(sourceAttachment);\n  gl2.blitFramebuffer(\n    sourceX0,\n    sourceY0,\n    sourceX1,\n    sourceY1,\n    targetX0,\n    targetY0,\n    targetX1,\n    targetY1,\n    mask,\n    filter\n  );\n  gl2.readBuffer(readBuffer);\n  // @ts-expect-error\n  gl2.bindFramebuffer(GL.READ_FRAMEBUFFER, prevReadHandle || null);\n  // @ts-expect-error\n  gl2.bindFramebuffer(GL.DRAW_FRAMEBUFFER, prevDrawHandle || null);\n  if (deleteSrcFramebuffer) {\n    srcFramebuffer.delete();\n  }\n  if (deleteDstFramebuffer) {\n    dstFramebuffer.delete();\n  }\n\n  // return dstFramebuffer;\n}\n\n// Helper methods\n\nfunction getFramebuffer(source) {\n  if (!(source instanceof Framebuffer)) {\n    return {framebuffer: toFramebuffer(source), deleteFramebuffer: true};\n  }\n  return {framebuffer: source, deleteFramebuffer: false};\n}\n\nfunction getPixelArray(pixelArray, type, format, width, height) {\n  if (pixelArray) {\n    return pixelArray;\n  }\n  // Allocate pixel array if not already available, using supplied type\n  type = type || GL.UNSIGNED_BYTE;\n  const ArrayType = getTypedArrayFromGLType(type, {clamped: false});\n  const components = glFormatToComponents(format);\n  // TODO - check for composite type (components = 1).\n  return new ArrayType(width * height * components);\n}\n"],"file":"copy-and-blit.js"}

package/dist/classes/framebuffer.d.ts

@@ -0,0 +1,139 @@
+import GL from '@luma.gl/constants';
+import Resource, { ResourceProps } from './webgl-resource';
+import Texture2D from './texture-2d';
+import Renderbuffer from './renderbuffer';
+declare type TextureAttachment = {
+    texture: Texture2D;
+    layer?: number;
+    level?: number;
+};
+declare type Attachment = Renderbuffer | Texture2D | TextureAttachment;
+export declare type ImmutableFramebufferProps = ResourceProps & {
+    attachments?: Record<string, Attachment>;
+    readBuffer?: number;
+    drawBuffers?: number[];
+    check?: boolean;
+};
+export declare type FramebufferProps = ImmutableFramebufferProps & {
+    width?: number;
+    height?: number;
+    color?: boolean;
+    depth?: boolean;
+    stencil?: boolean;
+};
+declare type colorBufferFloatOptions = {
+    colorBufferFloat?: boolean;
+    colorBufferHalfFloat?: boolean;
+};
+export declare class ImmutableFramebuffer extends Resource<FramebufferProps> {
+    constructor(gl: WebGLRenderingContext, props?: FramebufferProps);
+    checkStatus(): this;
+    getStatus(): number;
+    show(): this;
+    log(logLevel?: number, message?: string): this;
+    bind({ target }?: {
+        target?: GL;
+    }): this;
+    unbind({ target }?: {
+        target?: GL;
+    }): this;
+    _initialize(options: {
+        attachments: Record<string, Attachment>;
+        readBuffer?: number;
+        drawBuffers?: number[];
+    }): this;
+    /** Attach from a map of attachments */
+    _attach(attachments: Record<string, Attachment>): void;
+    /** Attach one attachment */
+    _attachOne(attachmentPoint: GL, attachment: Attachment): Renderbuffer | Texture2D;
+    _attachRenderbuffer(attachment: GL, renderbuffer: Renderbuffer): void;
+    /**
+     * @param attachment
+     * @param texture
+     * @param layer = 0 - index into Texture2DArray and Texture3D or face for `TextureCubeMap`
+     * @param level  = 0 - mipmapLevel (must be 0 in WebGL1)
+     */
+    _attachTexture(attachment: GL, texture: Texture2D, layer: number, level: number): void;
+    /** @note Expects framebuffer to be bound */
+    _setReadBuffer(readBuffer: number): void;
+    /** @note Expects framebuffer to be bound */
+    _setDrawBuffers(drawBuffers: number[]): void;
+    _createHandle(): WebGLFramebuffer;
+    _deleteHandle(): void;
+    _bindHandle(handle: any): void;
+}
+export default class Framebuffer extends ImmutableFramebuffer {
+    width: any;
+    height: any;
+    attachments: {};
+    readBuffer: GL;
+    drawBuffers: GL[];
+    ownResources: any[];
+    static readonly FRAMEBUFFER_ATTACHMENT_PARAMETERS: GL[];
+    /**
+     * Check color buffer float support
+     * @param options.colorBufferFloat  Whether floating point textures can be rendered and read
+     * @param options.colorBufferHalfFloat Whether half float textures can be rendered and read
+     */
+    static isSupported(gl: WebGLRenderingContext, options: colorBufferFloatOptions): boolean;
+    /**
+     * returns the default Framebuffer
+     * Creates a Framebuffer object wrapper for the default WebGL framebuffer (target === null)
+     */
+    static getDefaultFramebuffer(gl: WebGLRenderingContext): Framebuffer;
+    get MAX_COLOR_ATTACHMENTS(): number;
+    get MAX_DRAW_BUFFERS(): number;
+    constructor(gl: WebGLRenderingContext, props?: FramebufferProps);
+    get color(): any;
+    get texture(): any;
+    get depth(): any;
+    get stencil(): any;
+    initialize(props: FramebufferProps): void;
+    delete(): this;
+    update(options: {
+        attachments: Record<string, Attachment>;
+        readBuffer?: number;
+        drawBuffers?: any;
+        clearAttachments?: boolean;
+        resizeAttachments?: boolean;
+    }): this;
+    /** Attachment resize is expected to be a noop if size is same */
+    resize(size?: {
+        width?: number;
+        height?: number;
+    }): this;
+    /** Attach from a map of attachments */
+    attach(attachments: any, { clearAttachments, resizeAttachments }?: {
+        clearAttachments?: boolean;
+        resizeAttachments?: boolean;
+    }): void;
+    clear(options?: {
+        color?: any;
+        depth?: any;
+        stencil?: any;
+        drawBuffers?: any[];
+    }): this;
+    blit(opts?: {}): any;
+    invalidate(options: {
+        attachments: [];
+        x?: number;
+        y?: number;
+        width: number;
+        height: number;
+    }): this;
+    getAttachmentParameter(attachment: any, pname: any, keys: any): number;
+    getAttachmentParameters(attachment: GL, keys: any, parameters?: any): {};
+    getParameters(keys?: boolean): {};
+    _createDefaultAttachments(color: any, depth: any, stencil: any, width: any, height: any): any;
+    _unattach(attachment: any): void;
+    /**
+     * Attempt to provide workable defaults for WebGL2 symbols under WebGL1
+     * null means OK to query
+     * TODO - move to webgl1 polyfills
+     * @param pname
+     * @returns
+     */
+    _getAttachmentParameterFallback(pname: any): GL.UNSIGNED_INT | GL.LINEAR | 0 | 8;
+}
+export {};
+//# sourceMappingURL=framebuffer.d.ts.map

package/dist/classes/framebuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framebuffer.d.ts","sourceRoot":"","sources":["../../src/classes/framebuffer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAIpC,OAAO,QAAQ,EAAE,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AACzD,OAAO,SAAS,MAAM,cAAc,CAAC;AACrC,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAM1C,aAAK,iBAAiB,GAAG;IACvB,OAAO,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,aAAK,UAAU,GAAG,YAAY,GAAG,SAAS,GAAG,iBAAiB,CAAC;AAE/D,oBAAY,yBAAyB,GAAG,aAAa,GAAG;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,oBAAY,gBAAgB,GAAG,yBAAyB,GAAG;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,aAAK,uBAAuB,GAAG;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAAC,CAAC;AAE5F,qBAAa,oBAAqB,SAAQ,QAAQ,CAAC,gBAAgB,CAAC;gBACtD,EAAE,EAAE,qBAAqB,EAAE,KAAK,CAAC,EAAE,gBAAgB;IAS/D,WAAW,IAAI,IAAI;IASnB,SAAS,IAAI,MAAM;IAYnB,IAAI;IAOJ,GAAG,CAAC,QAAQ,SAAI,EAAE,OAAO,SAAK;IAY9B,IAAI,CAAC,EAAC,MAAuB,EAAC;;KAAK;IAKnC,MAAM,CAAC,EAAC,MAAuB,EAAC;;KAAK;IAOrC,WAAW,CAAC,OAAO,EAAE;QAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;KAAC,GAAG,IAAI;IAmBlH,uCAAuC;IACvC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;IAgB/C,4BAA4B;IAC5B,UAAU,CAAC,eAAe,EAAE,EAAE,EAAE,UAAU,EAAE,UAAU,GAAG,YAAY,GAAG,SAAS;IAcjF,mBAAmB,CAAC,UAAU,EAAE,EAAE,EAAE,YAAY,EAAE,YAAY,GAAG,IAAI;IAIrE;;;;;OAKG;IACH,cAAc,CAAC,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IA4BtF,4CAA4C;IAC5C,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAaxC,4CAA4C;IAC5C,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE;IAuBrC,aAAa;IAIb,aAAa;IAIb,WAAW,CAAC,MAAM,KAAA;CAGnB;AAED,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,oBAAoB;IAC3D,KAAK,MAAQ;IACb,MAAM,MAAQ;IACd,WAAW,KAAM;IACjB,UAAU,KAAwB;IAClC,WAAW,OAA0B;IACrC,YAAY,QAAM;IAElB,MAAM,CAAC,QAAQ,CAAC,iCAAiC,OAiB/C;IAEF;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,qBAAqB,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO;IAIxF;;;OAGG;IACH,MAAM,CAAC,qBAAqB,CAAC,EAAE,EAAE,qBAAqB,GAAG,WAAW;IAapE,IAAI,qBAAqB,IAAI,MAAM,CAGlC;IAED,IAAI,gBAAgB,IAAI,MAAM,CAG7B;gBAEW,EAAE,EAAE,qBAAqB,EAAE,KAAK,CAAC,EAAE,gBAAgB;IAM/D,IAAI,KAAK,QAER;IAED,IAAI,OAAO,QAEV;IAED,IAAI,KAAK,QAIR;IAED,IAAI,OAAO,QAMV;IAGD,UAAU,CAAC,KAAK,EAAE,gBAAgB;IAuClC,MAAM,IAAI,IAAI;IAQd,MAAM,CAAC,OAAO,EAAE;QACd,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACxC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,MAAC;QACb,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAA;KAC5B,GAAG,IAAI;IA6BR,iEAAiE;IACjE,MAAM,CAAC,IAAI,CAAC,EAAE;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,IAAI;IA4BtD,uCAAuC;IACvC,MAAM,CAAC,WAAW,KAAA,EAAE,EAAC,gBAAwB,EAAE,iBAAwB,EAAC;;;KAAK;IAiD7E,KAAK,CAAC,OAAO,CAAC,EAAE;QAAC,KAAK,CAAC,EAAE,GAAG,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAC;QAAC,WAAW,CAAC,EAAE,GAAG,EAAE,CAAA;KAAC,GAAG,IAAI;IAwBrF,IAAI,CAAC,IAAI,KAAK;IAMd,UAAU,CAAC,OAAO,EAAE;QAAC,WAAW,EAAE,EAAE,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC;IAmB5F,sBAAsB,CAAC,UAAU,KAAA,EAAE,KAAK,KAAA,EAAE,IAAI,KAAA;IAc9C,uBAAuB,CACrB,UAAU,IAAuB,EACjC,IAAI,KAAA,EAEJ,UAAU,MAA+C;IAW3D,aAAa,CAAC,IAAI,UAAO;IAgBzB,yBAAyB,CAAC,KAAK,KAAA,EAAE,KAAK,KAAA,EAAE,OAAO,KAAA,EAAE,KAAK,KAAA,EAAE,MAAM,KAAA;IAuE9D,SAAS,CAAC,UAAU,KAAA;IAepB;;;;;;OAMG;IAEH,+BAA+B,CAAC,KAAK,KAAA;CAsBtC"}