@luma.gl/webgl 9.0.0-alpha.25 → 9.0.0-alpha.27

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

@@ -1,4 +1,4 @@
-import { assert, Framebuffer } from '@luma.gl/api';
+import { assert, Texture, Framebuffer } from '@luma.gl/api';
 import { GL } from '@luma.gl/constants';
 import { BufferWithAccessor as Buffer } from "./buffer-with-accessor.js";
 import { withParameters } from "../context/state-tracker/with-parameters.js";
@@ -94,6 +94,72 @@ export function readPixelsToBuffer(source, options) {
   }
   return target;
 }
+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 webglFramebuffer = framebuffer;
+  const {
+    device,
+    handle
+  } = webglFramebuffer;
+  const isSubCopy = typeof targetX !== 'undefined' || typeof targetY !== 'undefined' || typeof targetZ !== 'undefined';
+  targetX = targetX || 0;
+  targetY = targetY || 0;
+  targetZ = targetZ || 0;
+  const prevHandle = device.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) {
+    device.gl.copyTexImage2D(textureTarget, targetMipmaplevel, targetInternalFormat, sourceX, sourceY, width, height, 0);
+  } else {
+    switch (textureTarget) {
+      case GL.TEXTURE_2D:
+      case GL.TEXTURE_CUBE_MAP:
+        device.gl.copyTexSubImage2D(textureTarget, targetMipmaplevel, targetX, targetY, sourceX, sourceY, width, height);
+        break;
+      case GL.TEXTURE_2D_ARRAY:
+      case GL.TEXTURE_3D:
+        device.assertWebGL2();
+        device.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.destroy();
+  }
+  return texture;
+}
 function getFramebuffer(source) {
   if (!(source instanceof Framebuffer)) {
     return {

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

@@ -1 +1 @@
-{"version":3,"file":"copy-and-blit.js","names":["assert","Framebuffer","GL","BufferWithAccessor","Buffer","withParameters","getGLTypeFromTypedArray","getTypedArrayFromGLType","glFormatToComponents","glTypeToBytes","readPixelsToArray","source","options","sourceX","sourceY","sourceFormat","RGBA","sourceAttachment","COLOR_ATTACHMENT0","target","sourceWidth","sourceHeight","sourceType","framebuffer","deleteFramebuffer","getFramebuffer","gl","handle","width","height","FRONT","attachment","colorAttachments","type","getPixelArray","prevHandle","bindFramebuffer","FRAMEBUFFER","readPixels","destroy","readPixelsToBuffer","targetByteOffset","webglFramebuffer","gl2","device","assertWebGL2","UNSIGNED_BYTE","components","byteCount","byteLength","accessor","size","bind","PIXEL_PACK_BUFFER","unbind","toFramebuffer","texture","props","id","createFramebuffer","concat","pixelArray","format","ArrayType","clamped"],"sources":["../../src/classic/copy-and-blit.ts"],"sourcesContent":["// luma.gl, MIT license\nimport {assert, Texture, Framebuffer, FramebufferProps} from '@luma.gl/api';\nimport {GL} from '@luma.gl/constants';\n\nimport {BufferWithAccessor as Buffer} from './buffer-with-accessor';\nimport {WEBGLTexture}  from  '../adapter/resources/webgl-texture';\nimport {WEBGLFramebuffer} from '../adapter/resources/webgl-framebuffer';\nimport {withParameters} from '../context/state-tracker/with-parameters';\nimport {getGLTypeFromTypedArray, getTypedArrayFromGLType} from './typed-array-utils';\nimport {glFormatToComponents, glTypeToBytes} from './format-utils';\n\n/**\n * Copies data from a type  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 * @deprecated Use CommandEncoder.copyTextureToBuffer and Buffer.read\n * @note Slow requires roundtrip to GPU\n *\n * @param source\n * @param options\n * @returns 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} = framebuffer as WEBGLFramebuffer;\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  const attachment = sourceAttachment - GL.COLOR_ATTACHMENT0;\n  // assert(attachments[sourceAttachment]);\n\n  // Deduce the type from color attachment if not provided.\n  sourceType = sourceType || (framebuffer.colorAttachments[attachment] as WEBGLTexture).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.destroy();\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, targetByteOffset = 0} = options || {};\n  // following parameters are auto deduced if not provided\n  let {target, sourceWidth, sourceHeight, sourceType} = 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 webglFramebuffer = framebuffer as WEBGLFramebuffer;\n  const gl2 = webglFramebuffer.device.assertWebGL2();\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.destroy();\n  }\n\n  return target;\n}\n\nfunction getFramebuffer(source: Texture | Framebuffer): {\n  framebuffer: Framebuffer;\n  deleteFramebuffer: boolean;\n} {\n  if (!(source instanceof Framebuffer)) {\n    return {framebuffer: toFramebuffer(source), deleteFramebuffer: true};\n  }\n  return {framebuffer: source, deleteFramebuffer: false};\n}\n\n/**\n * Wraps a given texture into a framebuffer object, that can be further used\n * to read data from the texture object.\n */\nexport function toFramebuffer(texture: Texture, props?: FramebufferProps): Framebuffer {\n  const {device, width, height, id} = texture;\n  const framebuffer = device.createFramebuffer({\n    ...props,\n    id: `framebuffer-for-${id}`,\n    width,\n    height,\n    colorAttachments: [\n      texture\n    ]\n  }\n  );\n  return framebuffer;\n}\n\nfunction getPixelArray(\n  pixelArray,\n  type,\n  format,\n  width: number,\n  height: number\n): Uint8Array | Uint16Array | Float32Array {\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) as Uint8Array | Uint16Array | Float32Array;\n}\n"],"mappings":"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"}
+{"version":3,"file":"copy-and-blit.js","names":["assert","Texture","Framebuffer","GL","BufferWithAccessor","Buffer","withParameters","getGLTypeFromTypedArray","getTypedArrayFromGLType","glFormatToComponents","glTypeToBytes","readPixelsToArray","source","options","sourceX","sourceY","sourceFormat","RGBA","sourceAttachment","COLOR_ATTACHMENT0","target","sourceWidth","sourceHeight","sourceType","framebuffer","deleteFramebuffer","getFramebuffer","gl","handle","width","height","FRONT","attachment","colorAttachments","type","getPixelArray","prevHandle","bindFramebuffer","FRAMEBUFFER","readPixels","destroy","readPixelsToBuffer","targetByteOffset","webglFramebuffer","gl2","device","assertWebGL2","UNSIGNED_BYTE","components","byteCount","byteLength","accessor","size","bind","PIXEL_PACK_BUFFER","unbind","copyToTexture","targetMipmaplevel","targetInternalFormat","targetX","targetY","targetZ","isSubCopy","texture","textureTarget","Number","isFinite","copyTexImage2D","TEXTURE_2D","TEXTURE_CUBE_MAP","copyTexSubImage2D","TEXTURE_2D_ARRAY","TEXTURE_3D","copyTexSubImage3D","toFramebuffer","props","id","createFramebuffer","concat","pixelArray","format","ArrayType","clamped"],"sources":["../../src/classic/copy-and-blit.ts"],"sourcesContent":["// luma.gl, MIT license\nimport {assert, Texture, Framebuffer, FramebufferProps} from '@luma.gl/api';\nimport {GL} from '@luma.gl/constants';\n\nimport {BufferWithAccessor as Buffer} from './buffer-with-accessor';\nimport {WEBGLTexture}  from  '../adapter/resources/webgl-texture';\nimport {WEBGLFramebuffer} from '../adapter/resources/webgl-framebuffer';\nimport {withParameters} from '../context/state-tracker/with-parameters';\nimport {getGLTypeFromTypedArray, getTypedArrayFromGLType} from './typed-array-utils';\nimport {glFormatToComponents, glTypeToBytes} from './format-utils';\n\n/**\n * Copies data from a type  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 * @deprecated Use CommandEncoder.copyTextureToBuffer and Buffer.read\n * @note Slow requires roundtrip to GPU\n *\n * @param source\n * @param options\n * @returns 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} = framebuffer as WEBGLFramebuffer;\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  const attachment = sourceAttachment - GL.COLOR_ATTACHMENT0;\n  // assert(attachments[sourceAttachment]);\n\n  // Deduce the type from color attachment if not provided.\n  sourceType = sourceType || (framebuffer.colorAttachments[attachment] as WEBGLTexture).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.destroy();\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 * @deprecated Use CommandEncoder\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, targetByteOffset = 0} = options || {};\n  // following parameters are auto deduced if not provided\n  let {target, sourceWidth, sourceHeight, sourceType} = 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 webglFramebuffer = framebuffer as WEBGLFramebuffer;\n  const gl2 = webglFramebuffer.device.assertWebGL2();\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.destroy();\n  }\n\n  return target;\n}\n\n/**\n * Copy a rectangle from a Framebuffer or Texture object into a texture (at an offset)\n * @deprecated Use CommandEncoder\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 webglFramebuffer = framebuffer as WEBGLFramebuffer;\n  const {device, handle} = webglFramebuffer;\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 = device.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    device.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        device.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        device.assertWebGL2();\n        device.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.destroy();\n  }\n  return texture;\n}\n\nfunction getFramebuffer(source: Texture | Framebuffer): {\n  framebuffer: Framebuffer;\n  deleteFramebuffer: boolean;\n} {\n  if (!(source instanceof Framebuffer)) {\n    return {framebuffer: toFramebuffer(source), deleteFramebuffer: true};\n  }\n  return {framebuffer: source, deleteFramebuffer: false};\n}\n\n/**\n * Wraps a given texture into a framebuffer object, that can be further used\n * to read data from the texture object.\n */\nexport function toFramebuffer(texture: Texture, props?: FramebufferProps): Framebuffer {\n  const {device, width, height, id} = texture;\n  const framebuffer = device.createFramebuffer({\n    ...props,\n    id: `framebuffer-for-${id}`,\n    width,\n    height,\n    colorAttachments: [\n      texture\n    ]\n  }\n  );\n  return framebuffer;\n}\n\nfunction getPixelArray(\n  pixelArray,\n  type,\n  format,\n  width: number,\n  height: number\n): Uint8Array | Uint16Array | Float32Array {\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) as Uint8Array | Uint16Array | Float32Array;\n}\n"],"mappings":"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"}