@luma.gl/webgl 8.5.10 → 8.6.0-alpha.1

package/src/classes/transform-feedback.d.ts

@@ -1,16 +0,0 @@
-import Resource, {ResourceProps} from './resource';
-
-export type TransformFeedbackProps = ResourceProps & {
-  [key: string]: any;
-};
-export default class TransformFeedback extends Resource {
-  static isSupported(gl: WebGLRenderingContext): boolean;
-
-  constructor(gl: WebGLRenderingContext, props?: TransformFeedbackProps);
-  initialize(props?: TransformFeedbackProps): this;
-  setProps(props: TransformFeedbackProps): void;
-  setBuffers(buffers?: {}): this;
-  setBuffer(locationOrName: any, bufferOrParams: any): this;
-  begin(primitiveMode?: any): this;
-  end(): this;
-}

package/src/classes/uniform-buffer-layout.d.ts

@@ -1,18 +0,0 @@
-/**
- * Std140 layout for uniforms
- */
-export default class UniformBufferLayout {
-  constructor(layout: any);
-  getBytes(): number;
-  getData(): any;
-  getSubData(
-    index: any
-  ): {
-    data: any;
-    offset: any;
-  };
-  setUniforms(values: any): this;
-  _setValue(key: any, value: any): void;
-  _addUniform(key: any, uniformType: any): void;
-  _alignTo(size: any, count: any): any;
-}

package/src/classes/uniforms.d.ts

@@ -1,63 +0,0 @@
-import {Matrix4} from '@math.gl/core';
-import Buffer from './buffer';
-import Framebuffer from './framebuffer';
-import Texture from './texture'
-
-
-interface NumberUniformDefinition {
-  type: 'number'
-  value: number
-  min: number
-  max: number
-}
-
-interface BooleanUniformDefinition {
-  type: 'boolean'
-  value: boolean
-}
-
-interface ArrayUniformDefinition {
-  type: 'array'
-  value: Array<any>
-}
-
-interface ObjectUniformDefinition {
-  type: 'object'
-  value: Object
-}
-
-type UniformDefinition = NumberUniformDefinition |
-  BooleanUniformDefinition |
-  ArrayUniformDefinition |
-  ObjectUniformDefinition
-
-// https://luma.gl/docs/developer-guide/shader-modules#getuniforms
-interface UniformsOptions {
-  [uniformName: string]: UniformDefinition
-}
-
-type Uniform = UniformDefinition |
-  Buffer | (() => Buffer) | Framebuffer |
-  Texture |
-  Matrix4 | // TODO: which other math.gl classes?
-  number | [number, number] | [number, number, number] | [number, number, number, number]
-
-interface Uniforms {
-  [uniformName: string]: Uniform
-}
-
-// Returns a Magic Uniform Setter
-export function getUniformSetter(gl: WebGLRenderingContext, location: number, info: object): any;
-
-export function parseUniformName(name: string): {name: string; isArray: boolean};
-
-/**
- * Basic checks of uniform values (with or without knowledge of program)
- * To facilitate early detection of e.g. undefined values in JavaScript
- */
-export function checkUniformValues(uniforms: object, source?: string, uniformMap?: object): boolean;
-
-/**
- * Creates a copy of the uniform
- */
-export function copyUniform(uniforms: object, key: string, value: any): void;

package/src/classes/vertex-array-object.d.ts

@@ -1,25 +0,0 @@
-import Resource, {ResourceProps} from './resource';
-
-export type VertexArrayObjectProps = ResourceProps & object;
-
-export default class VertexArrayObject extends Resource {
-  static isSupported(gl: WebGLRenderingContext, options?: VertexArrayObjectProps): boolean;
-  static getDefaultArray(gl: WebGLRenderingContext): any;
-  static getMaxAttributes(gl: WebGLRenderingContext): any;
-  static setConstant(gl: WebGLRenderingContext, location: any, array: any): void;
-
-  get MAX_ATTRIBUTES(): any;
-
-  constructor(gl: WebGLRenderingContext, opts?: VertexArrayObjectProps);
-  delete(): this;
-
-  initialize(props?: {}): this;
-  setProps(props: any): this;
-  setElementBuffer(elementBuffer?: any, opts?: {}): this;
-  setBuffer(location: any, buffer: any, accessor: any): this;
-  enable(location: any, enable?: boolean): this;
-  getConstantBuffer(elementCount: any, value: any): any;
-
-  // PRIVATE
-  // _normalizeConstantArrayValue(arrayValue);
-}

package/src/classes/vertex-array.d.ts

@@ -1,37 +0,0 @@
-import Program from './program'; 
-import ProgramConfiguration from './program-configuration';
-import VertexArrayObject from './vertex-array-object';
-import Accessor from './accessor';
-
-export type VertexArrayProps = {
-  program?: Program;
-  configuration?: ProgramConfiguration;
-  attributes?: any[];
-  elements?: any;
-  bindOnUse?: boolean;
-};
-
-export default class VertexArray {
-  readonly attributes: object;
-
-  constructor(gl: WebGLRenderingContext, opts?: {});
-  delete(): void;
-  initialize(props?: {}): this;
-  reset(): this;
-  setProps(props: any): this;
-  clearDrawParams(): void;
-  getDrawParams(): any;
-  setAttributes(attributes: any): this;
-  setElementBuffer(elementBuffer?: any, accessor?: {}): this;
-  setBuffer(locationOrName: any, buffer: any, appAccessor?: {}): this;
-  setConstant(locationOrName: any, arrayValue: any, appAccessor?: {}): this;
-  unbindBuffers(): this;
-  bindBuffers(): this;
-  bindForDraw(vertexCount: any, instanceCount: any, func: any): any;
-  setElements(elementBuffer?: any, accessor?: {}): this;
-
-  // FOR TESTING
-  readonly configuration: ProgramConfiguration | null;
-  readonly accessors: Accessor[];
-  readonly vertexArrayObject: VertexArrayObject;
-}

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

@@ -1 +0,0 @@
-export function getDebugTableForProgramConfiguration(config: any): {};

package/src/debug/debug-uniforms.d.ts

@@ -1,11 +0,0 @@
-export function getDebugTableForUniforms(options?: {
-  header?: string;
-  program: any;
-  uniforms: any;
-  undefinedOnly?: boolean;
-}): {
-  table: {};
-  count: number;
-  unusedTable: {};
-  unusedCount: number;
-};

package/src/debug/debug-vertex-array.d.ts

@@ -1 +0,0 @@
-export function getDebugTableForVertexArray(options?: {vertexArray: any; header?: string}): {};

package/src/glsl-utils/format-glsl-error.d.ts

@@ -1,16 +0,0 @@
-export default function formatGLSLCompilerError(errLog: any, src: any, shaderType: any): string;
-
-/**
- * Parse a GLSL compiler error log into a string showing the source code around each error.
- * Based on https://github.com/wwwtyro/gl-format-compiler-error (public domain)
- */
-export function parseGLSLCompilerError(
-  errLog: any,
-  src: any,
-  shaderType: any,
-  shaderName: any
-): {
-  shaderName: string;
-  errors: string;
-  warnings: string;
-};

package/src/glsl-utils/format-glsl-error.js

@@ -1,107 +0,0 @@
-// TODO - formatGLSLCompilerError should not depend on this
-import getShaderName from './get-shader-name';
-import getShaderTypeName from './get-shader-type-name';
-
-// Formats GLSL compiler error log into single string
-export default function formatGLSLCompilerError(errLog, src, shaderType) {
-  const {shaderName, errors, warnings} = parseGLSLCompilerError(errLog, src, shaderType);
-  return `GLSL compilation error in ${shaderName}\n\n${errors}\n${warnings}`;
-}
-
-/**
- * Parse a GLSL compiler error log into a string showing the source code around each error.
- * Based on https://github.com/wwwtyro/gl-format-compiler-error (public domain)
- */
-/* eslint-disable no-continue, max-statements */
-export function parseGLSLCompilerError(errLog, src, shaderType, shaderName) {
-  const errorStrings = errLog.split(/\r?\n/);
-  const errors = {};
-  const warnings = {};
-
-  // Patch the shader name
-  const name = shaderName || getShaderName(src) || '(unnamed)';
-  const shaderDescription = `${getShaderTypeName(shaderType)} shader ${name}`;
-
-  // Parse the error - note: browser and driver dependent
-  for (let i = 0; i < errorStrings.length; i++) {
-    const errorString = errorStrings[i];
-    if (errorString.length <= 1) {
-      continue;
-    }
-    const segments = errorString.split(':');
-    const type = segments[0];
-    const line = parseInt(segments[2], 10);
-    if (isNaN(line)) {
-      throw new Error(`GLSL compilation error in ${shaderDescription}: ${errLog}`);
-    }
-    if (type !== 'WARNING') {
-      errors[line] = errorString;
-    } else {
-      warnings[line] = errorString;
-    }
-  }
-
-  // Format the error inline with the code
-  const lines = addLineNumbers(src);
-
-  return {
-    shaderName: shaderDescription,
-    errors: formatErrors(errors, lines),
-    warnings: formatErrors(warnings, lines)
-  };
-}
-
-// helper function, outputs annotated errors or warnings
-function formatErrors(errors, lines) {
-  let message = '';
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-    if (!errors[i + 3] && !errors[i + 2] && !errors[i + 1]) {
-      continue;
-    }
-    message += `${line}\n`;
-    if (errors[i + 1]) {
-      const error = errors[i + 1];
-      const segments = error.split(':', 3);
-      const type = segments[0];
-      const column = parseInt(segments[1], 10) || 0;
-      const err = error.substring(segments.join(':').length + 1).trim();
-      message += padLeft(`^^^ ${type}: ${err}\n\n`, column);
-    }
-  }
-  return message;
-}
-
-/**
- * Prepends line numbers to each line of a string.
- * The line numbers will be left-padded with spaces to ensure an
- * aligned layout when rendered using monospace fonts.
- * @param {String} string - multi-line string to add line numbers to
- * @param {Number} start=1 - number of spaces to add
- * @param {String} delim =': ' - injected between line number and original line
- * @return {String[]} strings - array of string, one per line, with line numbers added
- */
-function addLineNumbers(string, start = 1, delim = ': ') {
-  const lines = string.split(/\r?\n/);
-  const maxDigits = String(lines.length + start - 1).length;
-  return lines.map((line, i) => {
-    const lineNumber = String(i + start);
-    const digits = lineNumber.length;
-    const prefix = padLeft(lineNumber, maxDigits - digits);
-    return prefix + delim + line;
-  });
-}
-
-/**
- * Pads a string with a number of spaces (space characters) to the left
- * @param {String} string - string to pad
- * @param {Number} digits - number of spaces to add
- * @return {String} string - The padded string
- */
-function padLeft(string, digits) {
-  let result = '';
-  for (let i = 0; i < digits; ++i) {
-    result += ' ';
-  }
-  return `${result}${string}`;
-}

package/src/glsl-utils/get-shader-name.js

@@ -1,7 +0,0 @@
-// Supports GLSLIFY style naming of shaders
-// #define SHADER_NAME ...
-export default function getShaderName(shader, defaultName = 'unnamed') {
-  const SHADER_NAME_REGEXP = /#define[\s*]SHADER_NAME[\s*]([A-Za-z0-9_-]+)[\s*]/;
-  const match = shader.match(SHADER_NAME_REGEXP);
-  return match ? match[1] : defaultName;
-}

package/src/glsl-utils/get-shader-type-name.js

@@ -1,13 +0,0 @@
-const GL_FRAGMENT_SHADER = 0x8b30;
-const GL_VERTEX_SHADER = 0x8b31;
-
-export default function getShaderTypeName(type) {
-  switch (type) {
-    case GL_FRAGMENT_SHADER:
-      return 'fragment';
-    case GL_VERTEX_SHADER:
-      return 'vertex';
-    default:
-      return 'unknown type';
-  }
-}

package/src/glsl-utils/get-shader-version.js

@@ -1,12 +0,0 @@
-// returns GLSL shader version of given shader string
-export default function getShaderVersion(source) {
-  let version = 100;
-  const words = source.match(/[^\s]+/g);
-  if (words.length >= 2 && words[0] === '#version') {
-    const v = parseInt(words[1], 10);
-    if (Number.isFinite(v)) {
-      version = v;
-    }
-  }
-  return version;
-}

package/src/glsl-utils/index.js

@@ -1,8 +0,0 @@
-// PARSE SHADER ERRORS
-export {default as formatGLSLCompilerError, parseGLSLCompilerError} from './format-glsl-error';
-
-// PARSE SHADER SOURCE
-export {default as getShaderName} from './get-shader-name';
-export {default as getShaderVersion} from './get-shader-version';
-
-export {default as getShaderTypeName} from './get-shader-type-name';

package/src/index.d.ts

@@ -1,71 +0,0 @@
-// luma.gl Base WebGL wrapper library
-// Provides simple class/function wrappers around the low level webgl objects
-// These classes are intentionally close to the WebGL API
-// but make it easier to use.
-// Higher level abstractions can be built on these classes
-
-// Initialize any global state
-export {lumaStats} from './init';
-
-// UTILS
-export {requestAnimationFrame, cancelAnimationFrame} from './webgl-utils/request-animation-frame';
-
-// WebGL Functions
-export {cloneTextureFrom} from './webgl-utils/texture-utils';
-export {getKeyValue, getKey} from './webgl-utils/constants-to-keys';
-export {getContextInfo, getGLContextInfo, getContextLimits} from './features/limits';
-export {FEATURES} from './features/webgl-features-table';
-export {hasFeature, hasFeatures, getFeatures} from './features/features';
-export {default as canCompileGLGSExtension} from './features/check-glsl-extension';
-
-// WebGL Helper Classes
-export {default as Accessor} from './classes/accessor';
-
-// WebGL1 classes
-export {default as Buffer, BufferProps} from './classes/buffer';
-export {default as Framebuffer} from './classes/framebuffer';
-export {default as Renderbuffer} from './classes/renderbuffer';
-export {default as Query} from './classes/query';
-export {Shader, VertexShader, FragmentShader, ShaderProps} from './classes/shader';
-export {default as Program, ProgramProps} from './classes/program';
-export {default as Texture2D, Texture2DProps} from './classes/texture-2d';
-export {default as TextureCube, TextureCubeProps} from './classes/texture-cube';
-export {default as Texture3D, Texture3DProps} from './classes/texture-3d';
-export {default as TransformFeedback, TransformFeedbackProps} from './classes/transform-feedback';
-export {default as VertexArrayObject, VertexArrayObjectProps} from './classes/vertex-array-object';
-export {default as VertexArray, VertexArrayProps} from './classes/vertex-array';
-
-export {default as UniformBufferLayout} from './classes/uniform-buffer-layout';
-
-export {clear, clearBuffer} from './classes/clear';
-
-// Copy and Blit
-export {
-  readPixelsToArray,
-  readPixelsToBuffer,
-  copyToDataUrl,
-  copyToImage,
-  copyToTexture,
-  blit
-} from './classes/copy-and-blit';
-
-// WebGL2 classes & Extensions
-
-// experimental WebGL exports
-
-export {setPathPrefix, loadFile, loadImage} from './utils/load-file';
-
-// PARSE SHADER SOURCE
-export {default as getShaderName} from './glsl-utils/get-shader-name';
-export {default as getShaderVersion} from './glsl-utils/get-shader-version';
-
-// UTILS
-export {log} from '@luma.gl/gltools';
-export {assert} from './utils/assert';
-export {uid, isObjectEmpty} from './utils/utils';
-
-// INTERNAL
-export {parseUniformName, getUniformSetter} from './classes/uniforms';
-export {getDebugTableForUniforms} from './debug/debug-uniforms';
-export {getDebugTableForVertexArray} from './debug/debug-vertex-array';
-export {getDebugTableForProgramConfiguration} from './debug/debug-program-configuration';

package/src/index.js

@@ -1,70 +0,0 @@
-// luma.gl Base WebGL wrapper library
-// Provides simple class/function wrappers around the low level webgl objects
-// These classes are intentionally close to the WebGL API
-// but make it easier to use.
-// Higher level abstractions can be built on these classes
-
-// Initialize any global state
-export {lumaStats} from './init';
-
-// UTILS
-export {requestAnimationFrame, cancelAnimationFrame} from './webgl-utils/request-animation-frame';
-
-// WebGL Functions
-export {cloneTextureFrom} from './webgl-utils/texture-utils';
-export {getKeyValue, getKey} from './webgl-utils/constants-to-keys';
-export {getContextInfo, getGLContextInfo, getContextLimits} from './features/limits';
-export {FEATURES} from './features/webgl-features-table';
-export {hasFeature, hasFeatures, getFeatures} from './features/features';
-export {default as canCompileGLGSExtension} from './features/check-glsl-extension';
-
-// WebGL Helper Classes
-export {default as Accessor} from './classes/accessor';
-
-// WebGL1 classes
-export {default as Buffer} from './classes/buffer';
-export {Shader, VertexShader, FragmentShader} from './classes/shader';
-export {default as Program} from './classes/program';
-export {default as Framebuffer} from './classes/framebuffer';
-export {default as Renderbuffer} from './classes/renderbuffer';
-export {default as Texture2D} from './classes/texture-2d';
-export {default as TextureCube} from './classes/texture-cube';
-
-export {clear, clearBuffer} from './classes/clear';
-
-// Copy and Blit
-export {
-  readPixelsToArray,
-  readPixelsToBuffer,
-  copyToDataUrl,
-  copyToImage,
-  copyToTexture,
-  blit
-} from './classes/copy-and-blit';
-
-// WebGL2 classes & Extensions
-export {default as Query} from './classes/query';
-export {default as Texture3D} from './classes/texture-3d';
-export {default as TransformFeedback} from './classes/transform-feedback';
-export {default as VertexArrayObject} from './classes/vertex-array-object';
-export {default as VertexArray} from './classes/vertex-array';
-export {default as UniformBufferLayout} from './classes/uniform-buffer-layout';
-
-// experimental WebGL exports
-
-export {setPathPrefix, loadFile, loadImage} from './utils/load-file';
-
-// PARSE SHADER SOURCE
-export {default as getShaderName} from './glsl-utils/get-shader-name';
-export {default as getShaderVersion} from './glsl-utils/get-shader-version';
-
-// UTILS
-export {log} from '@luma.gl/gltools';
-export {assert} from './utils/assert';
-export {uid, isObjectEmpty} from './utils/utils';
-
-// INTERNAL
-export {parseUniformName, getUniformSetter} from './classes/uniforms';
-export {getDebugTableForUniforms} from './debug/debug-uniforms';
-export {getDebugTableForVertexArray} from './debug/debug-vertex-array';
-export {getDebugTableForProgramConfiguration} from './debug/debug-program-configuration';

package/src/init.d.ts

@@ -1,12 +0,0 @@
-import {Stats} from 'probe.gl';
-
-export class StatsManager {
-  constructor();
-  get(name: any): Stats; // TODO: Isn't this get(name: string): Stats;
-}
-
-export const lumaStats: StatsManager;
-
-// luma global object - TODO - add types
-declare const _default: any;
-export default _default;

package/src/types.d.ts

@@ -1,8 +0,0 @@
-export type AccessorObject = {
-  size?: number;
-  index?: number;
-  type?: number;
-  divisor?: number;
-  offset?: number;
-  stride?: number;
-};

package/src/utils/assert.d.ts

@@ -1 +0,0 @@
-export function assert(condition: any, message?: string): void;

package/src/utils/is-old-ie.d.ts

@@ -1 +0,0 @@
-export function isOldIE(opts?: {}): boolean;

package/src/utils/utils.d.ts

@@ -1,13 +0,0 @@
-/**
- * Returns a UID.
- * @param {String} id= - Identifier base name
- * @return {number} uid
- **/
-export function uid(id?: string): string;
-/**
- * Verifies if a given number is power of two or not.
- * @param {object} n - The number to check.
- * @return {Array} Returns true if the given number is power of 2, false otherwise.
- **/
-export function isPowerOfTwo(n: any): boolean;
-export function isObjectEmpty(obj: any): boolean;

package/src/utils/utils.js

@@ -1,36 +0,0 @@
-import {assert} from './assert';
-
-const uidCounters = {};
-
-/**
- * Returns a UID.
- * @param {string} id= - Identifier base name
- * @return {string} uid
- **/
-export function uid(id = 'id') {
-  uidCounters[id] = uidCounters[id] || 1;
-  const count = uidCounters[id]++;
-  return `${id}-${count}`;
-}
-
-/**
- * Verifies if a given number is power of two or not.
- * @param {object} n - The number to check.
- * @return {boolean} Returns true if the given number is power of 2, false otherwise.
- **/
-export function isPowerOfTwo(n) {
-  assert(typeof n === 'number', 'Input must be a number');
-  return n && (n & (n - 1)) === 0;
-}
-
-// Returns true if given object is empty, false otherwise.
-export function isObjectEmpty(obj) {
-  let isEmpty = true;
-  /* eslint-disable no-unused-vars  */
-  for (const key in obj) {
-    isEmpty = false;
-    break;
-  }
-  /* eslint-enable no-unused-vars  */
-  return isEmpty;
-}

package/src/webgl-utils/request-animation-frame.d.ts

@@ -1,3 +0,0 @@
-// / <reference types="@types/node" />
-export function requestAnimationFrame(callback: any): number | NodeJS.Timeout;
-export function cancelAnimationFrame(timerId: any): void;