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

package/src/classes/buffer.d.ts

@@ -1,84 +0,0 @@
-import {AccessorObject} from '../types';
-import Resource, {ResourceProps} from './resource';
-
-export type BufferProps = ResourceProps & {
-  data?: any; // ArrayBufferView;
-  byteLength?: number;
-  target?: number;
-  usage?: number;
-  accessor?: AccessorObject;
-
-  /** @deprecated */
-  index?: number;
-  /** @deprecated */
-  offset?: number;
-  /** @deprecated */
-  size?: number;
-  /** @deprecated */
-  type?: number
-}
-
-/**
- * Holds a block of unformatted memory allocated on the GPU via an underlying 
- * WebGLBuffer. These can be used to store vertex data, pixel data retrieved
- * from images or the framebuffer, and a variety of other things. 
- */
-export default class Buffer extends Resource {
-
-  readonly handle: WebGLBuffer;
-  readonly byteLength: number;
-  readonly bytesUsed: number;
-  readonly usage: number;
-  readonly accessor: object;
-
-  readonly type: any;
-  readonly bytes: any;
-
-  constructor(gl: WebGLRenderingContext, props?: BufferProps);
-  constructor(gl: WebGLRenderingContext, data: ArrayBufferView | number[]);
-  constructor(gl: WebGLRenderingContext, byteLength: number);
-
-  initialize(props?: BufferProps): this;
-  setProps(props: BufferProps): this;
-
-  getElementCount(accessor?: any): number;
-  getVertexCount(accessor?: any): number;
-
-  setAccessor(accessor: any): this;
-  reallocate(byteLength: any): boolean;
-
-  setData(props: any): this;
-  subData(props: any): this;
-
-  copyData(options: {
-    sourceBuffer: any;
-    readOffset?: number;
-    writeOffset?: number;
-    size: any;
-  }): this;
-
-  getData(options?: {
-    dstData?: any;
-    srcByteOffset?: number;
-    dstOffset?: number;
-    length?: number;
-  }): any;
-
-  /**
-   * Binds a buffer to a given binding point (target).
-   *   GL.TRANSFORM_FEEDBACK_BUFFER and GL.UNIFORM_BUFFER take an index, and optionally a range.
-   *   - GL.TRANSFORM_FEEDBACK_BUFFER and GL.UNIFORM_BUFFER need an index to affect state
-   *   - GL.UNIFORM_BUFFER: `offset` must be aligned to GL.UNIFORM_BUFFER_OFFSET_ALIGNMENT.
-   *   - GL.UNIFORM_BUFFER: `size` must be a minimum of GL.UNIFORM_BLOCK_SIZE_DATA.
-   */
-  bind(options?: {target?: any; index?: any; offset?: number; size: any}): this;
-  unbind(options?: {target?: any; index?: any}): this;
-
-  getDebugData(): {
-    data: any;
-    changed: boolean;
-  };
-  invalidateDebugData(): void;
-  setByteLength(byteLength: any): boolean;
-  updateAccessor(opts: any): this;
-}

package/src/classes/clear.d.ts

@@ -1,11 +0,0 @@
-import Framebuffer from './framebuffer';
-
-export function clear(
-  gl: WebGLRenderingContext,
-  options?: {framebuffer?: Framebuffer; color?: any; depth?: any; stencil?: any}
-): void;
-
-export function clearBuffer(
-  gl: any,
-  options?: {framebuffer?: Framebuffer; buffer?: any; drawBuffer?: any; value?: any}
-);

package/src/classes/copy-and-blit.d.ts

@@ -1,101 +0,0 @@
-import Buffer from './buffer';
-import Framebuffer from './framebuffer';
-import Texture from './texture';
-
-// NOTE: Slow requires roundtrip to GPU
-// Copies data from a Framebuffer or a Texture object into ArrayBuffer object.
-// App can provide targetPixelArray or have it auto allocated by this method
-// @returns {Uint8Array|Uint16Array|FloatArray} - pixel array,
-//  newly allocated by this method unless provided by app.
-export function readPixelsToArray(
-  source: Framebuffer | Texture,
-  options?: {
-    sourceX?: number;
-    sourceY?: number;
-    sourceFormat?: number;
-    sourceAttachment?: number;
-    target?: Uint8Array | Uint16Array | Float32Array;
-    // following parameters are auto deduced if not provided
-    sourceWidth?: number;
-    sourceHeight?: number;
-    sourceType?: number;
-  }
-): Uint8Array | Uint16Array | Float32Array;
-
-// NOTE: doesn't wait for copy to be complete, it programs GPU to perform a DMA transffer.
-// Copies data from a Framebuffer or a Texture object into a Buffer object.
-export function readPixelsToBuffer(
-  source: Framebuffer | Texture,
-  options?: {
-    sourceX?: number;
-    sourceY?: number;
-    sourceFormat?: number;
-    target?: Buffer; // A new Buffer object is created when not provided.
-    targetByteOffset?: number; // byte offset in buffer object
-    // following parameters are auto deduced if not provided
-    sourceWidth?: number;
-    sourceHeight?: number;
-    sourceType?: number;
-  }
-): Buffer;
-
-// Reads pixels from a Framebuffer or Texture object to a dataUrl
-export function copyToDataUrl(
-  source,
-  options?: {
-    sourceAttachment?: number; // TODO - support gl.readBuffer
-    targetMaxHeight?: number;
-  }
-): string;
-
-// Reads pixels from a Framebuffer or Texture object into an HTML Image
-export function copyToImage(
-  source: Framebuffer | Texture,
-  options?: {
-    sourceAttachment?: number; // TODO - support gl.readBuffer
-    targetImage?: typeof Image;
-  }
-): typeof Image;
-
-// Copy a rectangle from a Framebuffer or Texture object into a texture (at an offset)
-export function copyToTexture(
-  source: Framebuffer | Texture,
-  target: Texture,
-  options?: {
-    sourceX?: number;
-    sourceY?: number;
-
-    targetX?: number;
-    targetY?: number;
-    targetZ?: number;
-    targetMipmaplevel?: number;
-    targetInternalFormat?: number;
-
-    width?: number; // defaults to target width
-    height?: number; // defaults to target height
-  }
-): Texture;
-
-// NOTE: WEBLG2 only
-// Copies a rectangle of pixels between Framebuffer or Texture objects
-// eslint-disable-next-line max-statements, complexity
-export function blit(
-  source,
-  target,
-  options: {
-    sourceAttachment?: number;
-    sourceX0?: number;
-    sourceY0?: number;
-    sourceX1?: number;
-    sourceY1?: number;
-    targetX0?: number;
-    targetY0?: number;
-    targetX1?: number;
-    targetY1?: number;
-    color?: boolean;
-    depth?: boolean;
-    stencil?: boolean;
-    mask?: number;
-    filter?: number;
-  }
-): void;

package/src/classes/framebuffer.d.ts

@@ -1,96 +0,0 @@
-import Resource, {ResourceProps} from './resource';
-
-export type FramebufferProps = ResourceProps & {
-  width?: number;
-  height?: number;
-  attachments?: any;
-  color?: boolean;
-  depth?: boolean;
-  stencil?: boolean;
-  check?: boolean;
-  readBuffer?: any;
-  drawBuffers?: any;
-}
-
-/**
- * Framebuffers hold a collection of Texture and Renderbuffer attachments.
- * Framebuffers allow rendering to non-Default Framebuffer locations
- * without disturbing the main screen.
-*/
-export default class Framebuffer extends Resource {
-  static readonly STATUS: number[];
-
-  readonly handle: WebGLFramebuffer;
-  readonly width: number;
-  readonly height: number;
-  readonly attachments: any[];
-
-  /**
-   * Support
-   * @param gl
-   * @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?: {
-      colorBufferFloat: any;
-      colorBufferHalfFloat: any;
-    }
-  ): boolean;
-
-  /** returns the default Framebuffer */
-  static getDefaultFramebuffer(gl: WebGLRenderingContext): Framebuffer;
-
-  get MAX_COLOR_ATTACHMENTS(): any;
-  get MAX_DRAW_BUFFERS(): any;
-  get color(): any;
-  get texture(): any;
-  get depth(): any;
-  get stencil(): any;
-
-  constructor(gl: WebGLRenderingContext, props?: FramebufferProps);
-
-  initialize(options?: FramebufferProps): this;
-
-  // @ts-ignore
-  delete(): void;
-
-  resize(size?: {width: any; height: any}): this;
-
-  update(options?: {
-    attachments?: {};
-    readBuffer: any;
-    drawBuffers: any;
-    clearAttachments?: boolean;
-    resizeAttachments?: boolean;
-  }): this;
-
-  attach(
-    attachments: any,
-    options?: {
-      clearAttachments?: boolean;
-      resizeAttachments?: boolean;
-    }
-  ): this;
-
-  checkStatus(): this;
-  getStatus(): any;
-  clear(options?: {color?: any; depth?: any; stencil?: any; drawBuffers?: any[]}): this;
-  readPixels(opts?: {}): any;
-  readPixelsToBuffer(opts?: {}): any;
-  copyToDataUrl(opts?: {}): any;
-  copyToImage(opts?: {}): any;
-  copyToTexture(opts?: {}): any;
-  blit(opts?: {}): any;
-  invalidate(options: {attachments?: any[]; x?: number; y?: number; width: any; height: any}): this;
-  getAttachmentParameter(attachment: any, pname: any, keys: any): any;
-  getAttachmentParameters(attachment: any, keys: any, parameters?: any): {};
-  getParameters(keys?: boolean): {};
-  show(): this;
-  log(logLevel?: number, message?: string): this;
-  bind({target}?: {target?: any}): this;
-  unbind({target}?: {target?: any}): this;
-}
-
-export const FRAMEBUFFER_ATTACHMENT_PARAMETERS: any[];

package/src/classes/program-configuration.d.ts

@@ -1,15 +0,0 @@
-/**
- * is a mechanism for taking a program object and querying information 
- * about it, so as to be able to interface and interact with it. 
- * For example, if there is a uniform, you may need to query its 
- * location so that you can set its value.
- */
-export default class ProgramConfiguration {
-  constructor(program: any);
-  getAttributeInfo(locationOrName: any): any;
-  getAttributeLocation(locationOrName: any): any;
-  getAttributeAccessor(locationOrName: any): any;
-  getVaryingInfo(locationOrName: any): any;
-  getVaryingIndex(locationOrName: any): any;
-  getVaryingAccessor(locationOrName: any): any;
-}

package/src/classes/program.d.ts

@@ -1,44 +0,0 @@
-import Resource, {ResourceProps} from './resource';
-import ProgramConfiguration from './program-configuration';
-
-export type ProgramProps = ResourceProps & {
-
-}
-
-/**
- * A Program holds fully processed executable code,
- * for one or more Shader stages. 
- */
-export default class Program extends Resource {
-
-  readonly handle: WebGLProgram;  
-  readonly configuration: ProgramConfiguration;
-
-  constructor(gl: WebGLRenderingContext, props?: {});
-  initialize(props?: {}): this;
-  delete(options?: {}): this;
-  setProps(props: any): this;
-  draw(options: {
-    logPriority?: any;
-    drawMode?: any;
-    vertexCount: any;
-    offset?: number;
-    start?: any;
-    end?: any;
-    isIndexed?: boolean;
-    indexType?: any;
-    instanceCount?: number;
-    isInstanced?: boolean;
-    vertexArray?: any;
-    transformFeedback?: any;
-    framebuffer?: any;
-    parameters?: {};
-    uniforms?: any;
-    samplers?: any;
-  }): boolean;
-  setUniforms(uniforms?: {}): this;
-  getActiveUniforms(uniformIndices: any, pname: any): any;
-  getUniformBlockIndex(blockName: any): any;
-  getActiveUniformBlockParameter(blockIndex: any, pname: any): any;
-  uniformBlockBinding(blockIndex: any, blockBinding: any): void;
-}

package/src/classes/query.d.ts

@@ -1,21 +0,0 @@
-import Resource from './resource';
-
-/**
- * Asynchronous queries for different kinds of information
- */
-export default class Query extends Resource {
-  readonly handle: WebGLQuery;
-
-  static isSupported(gl: WebGLRenderingContext, opts?: any[]): boolean;
-  constructor(gl: WebGLRenderingContext, opts?: {});
-  beginTimeElapsedQuery(): this;
-  beginOcclusionQuery({conservative}?: {conservative?: boolean}): this;
-  beginTransformFeedbackQuery(): this;
-  begin(target: any): this;
-  end(): this;
-  isResultAvailable(): any;
-  isTimerDisjoint(): any;
-  getResult(): any;
-  getTimerMilliseconds(): number;
-  createPoll(limit?: number): any;
-}

package/src/classes/renderbuffer.d.ts

@@ -1,34 +0,0 @@
-import Resource, {ResourceProps} from './resource';
-
-export type RenderbufferProps = ResourceProps & {
-  format: number;
-  width?: number;
-  height?: number;
-  samples?: number;
-};
-
-/**
- * Renderbuffers are GPU objects that contain images. 
- * In contrast to Textures they are optimized for use as render targets, with Framebuffers.
- * while Textures may not be, and are the logical choice when
- * you do not need to sample (i.e. in a post-pass shader) 
- * from the produced image. If you need to resample 
- * (such as when reading depth back in a second shader pass), 
- * use Textures instead. 
- * Renderbuffer objects also natively accommodate Multisampling (MSAA).
- */
-export default class Renderbuffer extends Resource {
-  static isSupported(gl: WebGLRenderingContext, options?: {format?: number}): boolean;
-  static getSamplesForFormat(gl: WebGLRenderingContext, options: {format: number}): number;
-
-  readonly width: number;
-  readonly height: number;
-  readonly format: number;
-
-  constructor(gl: WebGLRenderingContext, props: RenderbufferProps);
-
-  /** Creates and initializes a renderbuffer object's data store */
-  initialize(props: Renderbuffer): this;
-
-  resize(size: {width: number, height: number}): this;
-}

package/src/classes/renderbuffer.js

@@ -1,105 +0,0 @@
-/* eslint-disable no-inline-comments */
-import GL from '@luma.gl/constants';
-import Resource from './resource';
-import RENDERBUFFER_FORMATS from './renderbuffer-formats';
-import {isWebGL2} from '@luma.gl/gltools';
-import {assert} from '../utils/assert';
-
-function isFormatSupported(gl, format, formats) {
-  const info = formats[format];
-  if (!info) {
-    return false;
-  }
-  const value = isWebGL2(gl) ? info.gl2 || info.gl1 : info.gl1;
-  if (typeof value === 'string') {
-    return gl.getExtension(value);
-  }
-  return value;
-}
-
-export default class Renderbuffer extends Resource {
-  static isSupported(gl, {format} = {format: null}) {
-    return !format || isFormatSupported(gl, format, RENDERBUFFER_FORMATS);
-  }
-
-  static getSamplesForFormat(gl, {format}) {
-    // Polyfilled to return [0] under WebGL1
-    return gl.getInternalformatParameter(GL.RENDERBUFFER, format, GL.SAMPLES);
-  }
-
-  constructor(gl, opts = {}) {
-    super(gl, opts);
-
-    // @ts-ignore
-    this.initialize(opts);
-
-    Object.seal(this);
-  }
-
-  // Creates and initializes a renderbuffer object's data store
-  initialize({format, width = 1, height = 1, samples = 0}) {
-    assert(format, 'Needs format');
-
-    this._trackDeallocatedMemory();
-
-    this.gl.bindRenderbuffer(GL.RENDERBUFFER, this.handle);
-
-    if (samples !== 0 && isWebGL2(this.gl)) {
-      // @ts-ignore
-      this.gl.renderbufferStorageMultisample(GL.RENDERBUFFER, samples, format, width, height);
-    } else {
-      this.gl.renderbufferStorage(GL.RENDERBUFFER, format, width, height);
-    }
-
-    // this.gl.bindRenderbuffer(GL.RENDERBUFFER, null);
-
-    this.format = format;
-    this.width = width;
-    this.height = height;
-    this.samples = samples;
-
-    this._trackAllocatedMemory(
-      this.width * this.height * (this.samples || 1) * RENDERBUFFER_FORMATS[this.format].bpp
-    );
-
-    return this;
-  }
-
-  resize({width, height}) {
-    // Don't resize if width/height haven't changed
-    if (width !== this.width || height !== this.height) {
-      return this.initialize({width, height, format: this.format, samples: this.samples});
-    }
-    return this;
-  }
-
-  // PRIVATE METHODS
-  _createHandle() {
-    return this.gl.createRenderbuffer();
-  }
-
-  _deleteHandle() {
-    this.gl.deleteRenderbuffer(this.handle);
-    this._trackDeallocatedMemory();
-  }
-
-  _bindHandle(handle) {
-    this.gl.bindRenderbuffer(GL.RENDERBUFFER, handle);
-  }
-
-  _syncHandle(handle) {
-    this.format = this.getParameter(GL.RENDERBUFFER_INTERNAL_FORMAT);
-    this.width = this.getParameter(GL.RENDERBUFFER_WIDTH);
-    this.height = this.getParameter(GL.RENDERBUFFER_HEIGHT);
-    this.samples = this.getParameter(GL.RENDERBUFFER_SAMPLES);
-  }
-
-  // @param {Boolean} opt.autobind=true - method call will bind/unbind object
-  // @returns {GLenum|GLint} - depends on pname
-  _getParameter(pname) {
-    this.gl.bindRenderbuffer(GL.RENDERBUFFER, this.handle);
-    const value = this.gl.getRenderbufferParameter(GL.RENDERBUFFER, pname);
-    // this.gl.bindRenderbuffer(GL.RENDERBUFFER, null);
-    return value;
-  }
-}

package/src/classes/resource.d.ts

@@ -1,47 +0,0 @@
-export type ResourceProps = {
-  id?: string;
-  handle?: any
-}
-
-/**
- * Base class for WebGL object wrappers
- */
-export default class Resource {
-  readonly id: string;
-  readonly gl: WebGLRenderingContext;
-  readonly gl2: WebGL2RenderingContext;
-  readonly _handle: any;
-
-  readonly handle: any;
-
-  constructor(gl: WebGLRenderingContext, props?: ResourceProps);
-  toString(): string;
-  delete({ deleteChildren }?: { deleteChildren?: boolean }): this;
-  bind(funcOrHandle?: any): any;
-  unbind(): void;
-
-  /**
-   * Query a Resource parameter
-   *
-   * @param {GLenum} pname
-   * @return {GLint|GLfloat|GLenum} param
-   */
-  getParameter(pname: any, opts?: {}): any;
-  getParameters(opts?: {}): {};
-  /**
-   * Update a Resource setting
-   *
-   * @todo - cache parameter to avoid issuing WebGL calls?
-   *
-   * @param {GLenum} pname - parameter (GL constant, value or key)
-   * @param {GLint|GLfloat|GLenum} value
-   * @return {Resource} returns self to enable chaining
-   */
-  setParameter(pname: any, value: any): this;
-  setParameters(parameters: any): this;
-  stubRemovedMethods(className: any, version: any, methodNames: any): void;
-  initialize(opts: any): void;
-
-  _trackAllocatedMemory(bytes: number, name?: string): void;
-  _trackDeallocatedMemory(name?: string): void;
-}

package/src/classes/shader.d.ts

@@ -1,29 +0,0 @@
-import Resource, {ResourceProps} from './resource';
-
-export type ShaderProps = ResourceProps & {
-  source: string;
-  shaderType?: string;
-};
-
-/**
- * Encapsulates the compiled or linked Shaders that execute portions of the WebGL Pipeline
- */
-export class Shader extends Resource {
-  static getTypeName(shaderType: any): 'vertex-shader' | 'fragment-shader' | 'unknown';
-
-  constructor(gl: WebGLRenderingContext, props: ShaderProps);
-  initialize(options: ShaderProps): this;
-  getParameter(pname: any): any;
-  toString(): string;
-  getName(): string;
-  getSource(): string;
-  getTranslatedSource(): string;
-}
-
-export class VertexShader extends Shader {
-  constructor(gl: WebGLRenderingContext, props: any);
-}
-
-export class FragmentShader extends Shader {
-  constructor(gl: WebGLRenderingContext, props: any);
-}