@openglobus/og 0.28.7 → 1.0.0-rc1

package/lib/utils/gltf/types.d.ts

@@ -22,6 +22,21 @@ export interface GltfMetadata {
                 texCoord?: number;
             };
         };
+        extensions?: {
+            KHR_materials_pbrSpecularGlossiness?: {
+                diffuseFactor?: number[];
+                diffuseTexture?: {
+                    index: number;
+                    texCoord?: number;
+                };
+                specularFactor?: number[];
+                glossinessFactor?: number;
+                specularGlossinessTexture?: {
+                    index: number;
+                    texCoord?: number;
+                };
+            };
+        };
         normalTexture?: {
             index: number;
             texCoord?: number;
@@ -80,7 +95,7 @@ export interface GltfPrimitive {
 }
 export type PrimitiveAttributes = {
     POSITION: number;
-    NORMAL: number;
+    NORMAL?: number;
 } & Record<string, number>;
 export interface GltfNode {
     camera?: number;
@@ -143,7 +158,7 @@ export interface Primitive {
     name: string;
     indices?: ArrayBufferLike;
     vertices: ArrayBufferLike;
-    normals: ArrayBufferLike;
+    normals?: ArrayBufferLike;
     texCoords?: ArrayBufferLike;
     material?: Material;
     mode: PrimitiveMode;
@@ -153,7 +168,10 @@ export interface Material {
     name: string;
     baseColorFactor?: number[];
     baseColorTexture?: Texture;
+    metallicFactor?: number;
+    roughnessFactor?: number;
     metallicRoughnessTexture?: Texture;
+    specularGlossinessTexture?: Texture;
     normalTexture?: NormalTexture;
     occlusionTexture?: OcclusionTexture;
     emissiveTexture?: Texture;

package/lib/utils/shared.d.ts

@@ -20,6 +20,8 @@ export declare function isEmpty(v: any): boolean;
  */
 export declare function isUndef(obj?: any): boolean;
 export declare function isUndefExt(obj: any, defVal: any): any;
+export declare function fnv1a32(bytes: Uint8Array | Uint8ClampedArray): string;
+export declare function normalizeUri(src: string, baseUri?: string): string;
 export declare function stamp(obj: any): number;
 export declare function isString(s: any): boolean;
 export declare function rgbToStringHTML(rgb: NumberArray3 | Vec3): string;
@@ -74,8 +76,9 @@ export declare function parseHTML(htmlStr: string): HTMLElement[];
 export declare function print2d(id: string, text: string, x: number, y: number): void;
 export declare function isNumber(value: any): boolean;
 export declare function defaultString(str?: string, def?: string): string;
-export declare function createVector3(v?: number | Vec3 | Vec2 | NumberArray3 | NumberArray2 | null, def?: Vec3): Vec3;
-export declare function createVector4(v?: Vec4 | NumberArray4 | null, def?: Vec4): Vec4;
+export declare function createVec2(v?: number | Vec2 | NumberArray2 | null, def?: Vec2): Vec2;
+export declare function createVec3(v?: number | Vec3 | Vec2 | NumberArray3 | NumberArray2 | null, def?: Vec3): Vec3;
+export declare function createVec4(v?: Vec4 | NumberArray4 | null, def?: Vec4): Vec4;
 export declare function createColorRGBA(c?: string | NumberArray4 | Vec4 | null, def?: Vec4): Vec4;
 export declare function createColorRGB(c?: string | NumberArray3 | Vec3 | null, def?: Vec3): Vec3;
 export declare function createExtent(e?: Extent | [[number, number], [number, number]] | null, def?: Extent): Extent;
@@ -193,6 +196,7 @@ export type TypedArray = Int8Array | Uint8Array | Uint8ClampedArray | Int16Array
  * @param {TypedArray | number[]} b
  */
 export declare function concatTypedArrays(a: TypedArray, b: TypedArray | number[]): TypedArray;
+export declare function insertTypedArray<T extends TypedArray>(arr: T, starting: number, insert: T | number[]): T;
 /**
  * Concatenates two the same  arrays
  * @param {TypedArray | number[]} [a=[]] - First array
@@ -238,7 +242,7 @@ export declare function spliceTypedArray<T extends TypedArray>(arr: T, starting:
 /**
  * Returns 64-bit triangle coordinate array from inside of the source triangle array.
  * @static
- * @param {TypedArray | number[]} sourceArr - Source array
+ * @param {TypedArray | number[]} srcArr - Source array
  * @param {number} gridSize - Source array square matrix size
  * @param {number} i0 - First row index source array matrix
  * @param {number} j0 - First column index
@@ -246,7 +250,7 @@ export declare function spliceTypedArray<T extends TypedArray>(arr: T, starting:
  * @return {Float64Array} Triangle coordinates array from the source array.
  * @TODO: optimization
  */
-export declare function getMatrixSubArray64(sourceArr: TypedArray | number[], gridSize: number, i0: number, j0: number, size: number): Float64Array;
+export declare function getMatrixSubArray64(srcArr: TypedArray | number[], gridSize: number, i0: number, j0: number, size: number): Float64Array;
 /**
  * Returns 32-bit triangle coordinate array from inside of the source triangle array.
  * @static
@@ -262,7 +266,7 @@ export declare function getMatrixSubArray32(sourceArr: TypedArray | number[], gr
  * Returns two float32 triangle coordinate arrays from inside of the source triangle array.
  * @TODO: optimization
  */
-export declare function getMatrixSubArrayBoundsExt(sourceArr: TypedArray | number[], sourceArrHigh: TypedArray | number[], sourceArrLow: TypedArray | number[], noDataVertices: TypedArray | number[] | undefined, gridSize: number, i0: number, j0: number, size: number, outArr: TypedArray | number[], outArrHigh: TypedArray | number[], outArrLow: TypedArray | number[], outBounds: any, outNoDataVertices: TypedArray | number[]): void;
+export declare function getMatrixSubArrayBoundsExt(srcArr: TypedArray | number[], noDataVertices: TypedArray | number[] | undefined, gridSize: number, i0: number, j0: number, size: number, srcRelativeCenter: Vec3, dstRelativeCenter: Vec3, outArr: TypedArray | number[], outArrHigh: TypedArray | number[], outArrLow: TypedArray | number[], outBounds: any, outNoDataVertices: TypedArray | number[]): void;
 export declare function cloneArray(items: any[]): any[];
 /**
  * Promise for load images
@@ -271,6 +275,8 @@ export declare function cloneArray(items: any[]): any[];
  * @returns {Promise<Image>} Returns promise.
  */
 export declare function loadImage(url: string): Promise<HTMLImageElement>;
+export declare function ensureImageReady(image: HTMLImageElement): Promise<boolean>;
+export declare function prepareTextureImage(image: HTMLImageElement): Promise<HTMLImageElement | HTMLCanvasElement | null>;
 /**
  * Gets image is loaded
  * @param {HTMLImageElement} image

package/lib/utils/textureResourceMeta.d.ts

@@ -0,0 +1,9 @@
+export declare const OG_TEXTURE_RESOURCE_META_KEY: unique symbol;
+export interface ITextureResourceMeta {
+    resourceKey?: string;
+    sourceUri?: string;
+    mimeType?: string;
+    byteLength?: number;
+}
+export declare function getTextureResourceMeta(target: object | null | undefined): ITextureResourceMeta | undefined;
+export declare function setTextureResourceMeta(target: object | null | undefined, meta: ITextureResourceMeta | undefined): void;

package/lib/webgl/BaseFramebuffer.d.ts

@@ -6,6 +6,7 @@ export interface IBaseFramebufferParams {
     depthComponent?: string;
     size?: number;
     filter?: string;
+    sharedDepthFramebuffer?: BaseFramebuffer | null;
 }
 export declare class BaseFramebuffer {
     static __counter__: number;
@@ -13,6 +14,7 @@ export declare class BaseFramebuffer {
     handler: Handler;
     _fbo: WebGLFramebuffer | null;
     protected _depthRenderbuffer: WebGLRenderbuffer | null;
+    protected _sharedDepthFramebuffer: BaseFramebuffer | null;
     _width: number;
     _height: number;
     protected _depthComponent: string;
@@ -21,8 +23,13 @@ export declare class BaseFramebuffer {
     protected _useDepth: boolean;
     protected _filter: string;
     constructor(handler: Handler, options?: IBaseFramebufferParams);
+    static blitTo(destFramebuffer: BaseFramebuffer, sourceFramebuffer: BaseFramebuffer, glAttachmentIndex: number | null, glMask: number, glFilter: number): void;
+    blitDepthFrom(sourceFramebuffer: BaseFramebuffer, glFilter?: number): void;
     get width(): number;
     get height(): number;
+    get depthRenderbuffer(): WebGLRenderbuffer | null;
+    get sharedDepthFramebuffer(): BaseFramebuffer | null;
+    get sharedDepthRenderbuffer(): WebGLRenderbuffer | null;
     /**
      * Sets framebuffer viewport size.
      * @public

package/lib/webgl/Framebuffer.d.ts

@@ -5,8 +5,6 @@ import type { TypedArray } from "../utils/shared";
 import type { NumberArray4 } from "../math/Vec4";
 export interface ITargetParams {
     internalFormat?: string;
-    format?: string;
-    type?: string;
     attachment?: string;
     filter?: string;
     readAsync?: boolean;
@@ -20,8 +18,8 @@ export interface IFrameBufferParams extends IBaseFramebufferParams {
 type TypedArrayConstructor = Uint8ArrayConstructor | Float32ArrayConstructor;
 interface ITarget {
     internalFormat: string;
-    format: string;
-    type: string;
+    pixelFormat: string;
+    pixelType: string;
     attachment: string;
     filter: string;
     pixelBufferIndex: number;
@@ -52,6 +50,11 @@ export declare class Framebuffer extends BaseFramebuffer {
     pixelBuffers: IPixelBuffer[];
     protected _skipFrame: boolean;
     constructor(handler: Handler, options?: IFrameBufferParams);
+    static getTargetReadParams(internalFormat: string): {
+        pixelFormat: string;
+        pixelType: string;
+        TypeArrayConstructor: TypedArrayConstructor;
+    };
     static createTargets(targets?: ITargetParams[]): ITarget[];
     destroy(): void;
     /**
@@ -60,11 +63,11 @@ export declare class Framebuffer extends BaseFramebuffer {
      * @override
      */
     init(): void;
+    protected _attachExternalDepthRenderbuffer(depthRenderbuffer: WebGLRenderbuffer | null): void;
     /**
      * Check your constructor has targets like this
      * targets: [{
-     *  internalFormat: "RGBA",
-     *  type: "UNSIGNED_BYTE",
+     *  internalFormat: "RGBA8",
      *  attachment: "COLOR_ATTACHMENT",
      *  readAsync: true
      * }],

package/lib/webgl/Handler.d.ts

@@ -4,8 +4,7 @@ import type { EventsHandler } from "../Events";
 import type { TypedArray } from "../utils/shared";
 import { Vec2 } from "../math/Vec2";
 import type { NumberArray2 } from "../math/Vec2";
-import { ProgramController } from "./ProgramController";
-import { Program } from "./Program";
+import { ShaderProgram } from "./ShaderProgram";
 import { Stack } from "../Stack";
 export type WebGLContextExt = {
     type: string;
@@ -100,17 +99,17 @@ declare class Handler {
      */
     gl: WebGLContextExt | null;
     /**
-     * Shader program controller list.
+     * Shader program list.
      * @public
-     * @type {Record<string, ProgramController>}
+     * @type {Record<string, ShaderProgram>}
      */
-    programs: Record<string, ProgramController>;
+    programs: Record<string, ShaderProgram>;
     /**
-     * Current active shader program controller.
+     * Current active shader program.
      * @public
-     * @type {ProgramController}
+     * @type {ShaderProgram}
      */
-    activeProgram: ProgramController | null;
+    activeProgram: ShaderProgram | null;
     /**
      * Handler parameters.
      * @private
@@ -157,24 +156,23 @@ declare class Handler {
     createTexture: Record<string, CreateTextureFunc>;
     createTextureDefault: CreateTextureFunc;
     ONCANVASRESIZE: Function | null;
-    createTexture_n: CreateTextureFunc;
-    createTexture_l: CreateTextureFunc;
-    createTexture_mm: CreateTextureFunc;
-    createTexture_a: CreateTextureFunc;
     intersectionObserver?: IntersectionObserver;
     resizeObserver?: ResizeObserver;
     protected _requestAnimationFrameId: number;
+    protected _clipControlZeroToOne: boolean;
+    clipControl: ((origin: number, depth: number) => void) | undefined;
+    protected _getMipmapLevels(width: number, height: number): number;
     constructor(canvasTarget: string | HTMLCanvasElement | undefined, params?: IHandlerParameters);
     set frameDelay(delay: number);
     isInitialized(): boolean;
     protected _createCanvas(): void;
     /**
      * The return value is null if the extension is not supported, or an extension object otherwise.
-     * @param {WebGLRenderingContext | WebGL2RenderingContext | null} gl - WebGl context pointer.
+     * @param {WebGL2RenderingContext | null} gl - WebGl context pointer.
      * @param {string} name - Extension name.
      * @returns {any} -
      */
-    static getExtension(gl: WebGLRenderingContext | WebGL2RenderingContext | null, name: string): any | undefined;
+    static getExtension(gl: WebGL2RenderingContext | null, name: string): any | undefined;
     /**
      * Returns a drawing context on the canvas, or null if the context identifier is not supported.
      * @param {HTMLCanvasElement} canvas - HTML canvas object.
@@ -189,24 +187,24 @@ declare class Handler {
      */
     setFrameCallback(callback: Function): void;
     /**
-     * Creates empty texture.
+     * Creates an empty immutable 2D texture (WebGL2).
      * @public
-     * @param {number} [width=1] - Specifies the width of the texture image.
-     * @param {number} [height=1] - Specifies the width of the texture image.
-     * @param {string} [filter="NEAREST"] - Specifies GL_TEXTURE_MIN(MAX)_FILTER texture value.
-     * @param {string} [internalFormat="RGBA"] - Specifies the color components in the texture.
-     * @param {string} [format="RGBA"] - Specifies the format of the texel data.
-     * @param {string} [type="UNSIGNED_BYTE"] - Specifies the data type of the texel data.
-     * @param {number} [level=0] - Specifies the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.
-     * @returns {WebGLTexture | null} - WebGL texture object.
+     * @param {number} [width=1] - Texture width in pixels.
+     * @param {number} [height=1] - Texture height in pixels.
+     * @param {string} [filter="NEAREST"] - GL_TEXTURE_MIN_FILTER and GL_TEXTURE_MAG_FILTER value.
+     * @param {string} [internalFormat="RGBA8"] - Sized internal format (e.g. "RGBA8", "RGBA16F", "R16F").
+     * @param {string} [param="CLAMP_TO_EDGE"] - GL_TEXTURE_WRAP_S/T value.
+     * @param {number} [levels=1] - Number of mipmap levels (immutable storage).
+     * @returns {WebGLTexture | null} - Created WebGL texture object.
      */
-    createEmptyTexture2DExt(width?: number, height?: number, filter?: string, internalFormat?: string, format?: string, type?: string, param?: string, level?: number): WebGLTexture | null;
+    createEmptyTexture2DExt(width?: number, height?: number, filter?: string, internalFormat?: string, param?: string, levels?: number): WebGLTexture | null;
     /**
      * Creates Empty NEAREST filtered texture.
      * @public
      * @param {number} width - Empty texture width.
      * @param {number} height - Empty texture height.
-     * @param {number} [internalFormat]
+     * @param {number} [internalFormat] - Internal texture format, `gl.RGBA` by default.
+     * @param {number} [texParami] - Wrap mode for S/T axes, `gl.CLAMP_TO_EDGE` by default.
      * @returns {WebGLTexture | null} - WebGL texture object.
      */
     createEmptyTexture_n(width: number, height: number, internalFormat?: number | null, texParami?: number | null): WebGLTexture | null;
@@ -223,53 +221,13 @@ declare class Handler {
     /**
      * Creates NEAREST filter texture.
      * @public
-     * @param {HTMLCanvasElement | Image} image - Image or Canvas object.
-     * @param {number} [internalFormat]
-     * @param {number} [texParami]
-     * @param {WebGLTexture | null} [texture=null]
-     * @returns {WebGLTexture | null} - WebGL texture object.
-     */
-    createTexture_n_webgl1(image: ImageSource, internalFormat?: number | null, texParami?: number | null, texture?: WebGLTexture | null): WebGLTexture | null;
-    /**
-     * Creates LINEAR filter texture.
-     * @public
-     * @param {ImageSource} image - Image or Canvas object.
-     * @param {number} [internalFormat]
-     * @param {number} [texParami]
-     * @param {WebGLTexture | null} [texture]
-     * @returns {WebGLTexture | null} - WebGL texture object.
-     */
-    createTexture_l_webgl1(image: ImageSource, internalFormat?: number | null, texParami?: number | null, texture?: WebGLTexture | null): WebGLTexture | null;
-    /**
-     * Creates MIPMAP filter texture.
-     * @public
-     * @param {ImageSource} image - Image or Canvas object.
-     * @param {number} [internalFormat]
-     * @param {number} [texParami]
-     * @param {WebGLTexture | null} [texture]
-     * @returns {WebGLTexture | null} - WebGL texture object.
-     */
-    createTexture_mm_webgl1(image: ImageSource, internalFormat?: number | null, texParami?: number | null, texture?: WebGLTexture | null): WebGLTexture | null;
-    /**
-     * Creates ANISOTROPY filter texture.
-     * @public
      * @param {ImageSource} image - Image or Canvas object.
      * @param {number} [internalFormat]
      * @param {number} [texParami]
      * @param {WebGLTexture | null} [texture]
      * @returns {WebGLTexture | null} - WebGL texture object.
      */
-    createTexture_a_webgl1(image: ImageSource, internalFormat?: number | null, texParami?: number | null, texture?: WebGLTexture | null): WebGLTexture | null;
-    /**
-     * Creates NEAREST filter texture.
-     * @public
-     * @param {ImageSource} image - Image or Canvas object.
-     * @param {number} [internalFormat]
-     * @param {number} [texParami]
-     * @param {WebGLTexture | null} [texture]
-     * @returns {WebGLTexture | null} - WebGL texture object.
-     */
-    createTexture_n_webgl2(image: ImageSource, internalFormat?: number | null, texParami?: number | null, texture?: WebGLTexture | null): WebGLTexture | null;
+    createTexture_n(image: ImageSource, internalFormat?: number | null, texParami?: number | null, texture?: WebGLTexture | null): WebGLTextureExt | null;
     /**
      * Creates LINEAR filter texture.
      * @public
@@ -279,7 +237,7 @@ declare class Handler {
      * @param {WebGLTexture | null} [texture]
      * @returns {WebGLTexture | null} - WebGL texture object.
      */
-    createTexture_l_webgl2(image: ImageSource, internalFormat?: number | null, texParami?: number | null, texture?: WebGLTexture | null): WebGLTexture | null;
+    createTexture_l(image: ImageSource, internalFormat?: number | null, texParami?: number | null, texture?: WebGLTexture | null): WebGLTextureExt | null;
     /**
      * Creates MIPMAP filter texture.
      * @public
@@ -289,7 +247,7 @@ declare class Handler {
      * @param {WebGLTexture | null} [texture]
      * @returns {WebGLTexture | null} - WebGL texture object.
      */
-    createTexture_mm_webgl2(image: ImageSource, internalFormat?: number | null, texParami?: number | null, texture?: WebGLTexture | null): WebGLTexture | null;
+    createTexture_mm(image: ImageSource, internalFormat?: number | null, texParami?: number | null, texture?: WebGLTexture | null): WebGLTextureExt | null;
     /**
      * Creates ANISOTROPY filter texture.
      * @public
@@ -299,7 +257,7 @@ declare class Handler {
      * @param {WebGLTexture | null} [texture]
      * @returns {WebGLTexture | null} - WebGL texture object.
      */
-    createTexture_a_webgl2(image: ImageSource, internalFormat?: number | null, texParami?: number | null, texture?: WebGLTexture | null): WebGLTexture | null;
+    createTexture_a(image: ImageSource, internalFormat?: number | null, texParami?: number | null, texture?: WebGLTexture | null): WebGLTextureExt | null;
     /**
      * Creates cube texture.
      * @public
@@ -310,17 +268,19 @@ declare class Handler {
      * @param {string} params.ny - Negative Y or bottom image url.
      * @param {string} params.pz - Positive Z or face image url.
      * @param {string} params.nz - Negative Z or back image url.
+     * @param {number} [colorSpace=gl.SRGB8_ALPHA8] - Cube texture internal format (for example gl.SRGB8_ALPHA8 or gl.RGBA8).
+     * @param {number} [textureFilter=gl.LINEAR] - Cube texture filter (for example gl.LINEAR or gl.NEAREST).
      * @returns {WebGLTexture | null} - WebGL texture object.
      */
-    loadCubeMapTexture(params: Texture3DParams): WebGLTexture | null;
+    loadCubeMapTexture(params: Texture3DParams, colorSpace?: number | null, textureFilter?: number | null): WebGLTextureExt | null;
     /**
      * Adds shader program to the handler.
      * @public
-     * @param {Program} program - Shader program.
+     * @param {ShaderProgram} program - Shader program.
      * @param {boolean} [activate] - If false program will not compile.
-     * @return {Program} -
+     * @return {ShaderProgram} -
      */
-    addProgram(program: Program, activate?: boolean): Program;
+    addProgram(program: ShaderProgram, activate?: boolean): ShaderProgram;
     /**
      * Removes shader program from handler.
      * @public
@@ -330,15 +290,15 @@ declare class Handler {
     /**
      * Adds shader programs to the handler.
      * @public
-     * @param {Array.<Program>} programsArr - Shader program array.
+     * @param {Array.<ShaderProgram>} programsArr - Shader program array.
      */
-    addPrograms(programsArr: Program[]): void;
+    addPrograms(programsArr: ShaderProgram[]): void;
     /**
      * Used in addProgram
      * @protected
-     * @param {ProgramController} sc - Program controller
+     * @param {ShaderProgram} program - ShaderProgram
      */
-    protected _initProgramController(sc: ProgramController): void;
+    protected _initProgram(program: ShaderProgram): void;
     /**
      * Used in init function.
      * @private
@@ -353,7 +313,7 @@ declare class Handler {
      */
     initializeExtension(extensionStr: string, showLog?: boolean): any;
     /**
-     * Main function that initialize handler.
+     * Main function that initializes handler.
      * @public
      */
     initialize(): void;
@@ -363,41 +323,54 @@ declare class Handler {
      * @protected
      */
     protected _setDefaults(): void;
+    /**
+     * Returns true when clip-control depth range is currently ZERO_TO_ONE.
+     * @public
+     * @returns {boolean} -
+     */
+    get isClipControlZeroToOne(): boolean;
+    /**
+     * Switches clip-control depth range between ZERO_TO_ONE and NEGATIVE_ONE_TO_ONE.
+     * If EXT_clip_control is unavailable, the internal ZERO_TO_ONE flag is reset to false.
+     * @public
+     * @param {boolean} useZeroToOne - True sets ZERO_TO_ONE, false sets NEGATIVE_ONE_TO_ONE.
+     */
+    setClipControlZeroToOne(useZeroToOne: boolean): void;
     getCanvasSize(): NumberArray2;
     /**
-     * Creates STREAM_DRAW ARRAY buffer.
+     * Creates ARRAY_BUFFER storage for frequently updated data.
      * @public
-     * @param {number} itemSize - Array item size.
-     * @param {number} numItems - Items quantity.
-     * @param {number} [usage=STATIC_DRAW] - Parameter of the bufferData call can be one of STATIC_DRAW, DYNAMIC_DRAW, or STREAM_DRAW.
-     * @param {number} [bytes=4] -
+     * @param {number} itemSize - Number of scalar components per item.
+     * @param {number} numItems - Number of items.
+     * @param {number} [usage=STREAM_DRAW] - GL usage hint (STATIC_DRAW, DYNAMIC_DRAW or STREAM_DRAW).
+     * @param {number} [bytes=4] - Bytes per scalar component.
      * @return {WebGLBufferExt} -
      */
     createStreamArrayBuffer(itemSize: number, numItems: number, usage?: number, bytes?: number): WebGLBufferExt;
     /**
-     * Sets stream buffer.
+     * Uploads data to an existing ARRAY_BUFFER via bufferSubData.
      * @public
-     * @param {WebGLBufferExt} buffer -
-     * @param {TypedArray} array -
-     * @param {number} [offset=0] -
+     * @param {WebGLBufferExt} buffer - Target ARRAY_BUFFER.
+     * @param {TypedArray} array - Source data to upload.
+     * @param {number} [offset=0] - Byte offset in the target buffer.
      * @return {WebGLBufferExt} -
      */
     setStreamArrayBuffer(buffer: WebGLBufferExt, array: TypedArray, offset?: number): WebGLBufferExt;
     /**
-     * Creates ARRAY buffer.
+     * Creates and initializes ARRAY_BUFFER from a typed array.
      * @public
-     * @param {TypedArray} array - Input array.
-     * @param {number} itemSize - Array item size.
-     * @param {number} numItems - Items quantity.
-     * @param {number} [usage=STATIC_DRAW] - Parameter of the bufferData call can be one of STATIC_DRAW, DYNAMIC_DRAW, or STREAM_DRAW.
+     * @param {TypedArray} array - Source data.
+     * @param {number} itemSize - Number of scalar components per item.
+     * @param {number} [numItems] - Number of items (computed from array length when omitted).
+     * @param {number} [usage=STATIC_DRAW] - GL usage hint (STATIC_DRAW, DYNAMIC_DRAW or STREAM_DRAW).
      * @return {WebGLBufferExt} -
      */
     createArrayBuffer(array: TypedArray, itemSize: number, numItems?: number, usage?: number): WebGLBufferExt;
     /**
-     * Creates ARRAY buffer specific length.
+     * Creates ARRAY_BUFFER storage with a specific byte length and no initial data.
      * @public
-     * @param {number} size -
-     * @param {number} [usage=STATIC_DRAW] - Parameter of the bufferData call can be one of STATIC_DRAW, DYNAMIC_DRAW, or STREAM_DRAW.
+     * @param {number} size - Buffer size in bytes.
+     * @param {number} [usage=STATIC_DRAW] - GL usage hint (STATIC_DRAW, DYNAMIC_DRAW or STREAM_DRAW).
      * @return {WebGLBufferExt} -
      */
     createArrayBufferLength(size: number, usage?: number): WebGLBufferExt;
@@ -472,14 +445,23 @@ declare class Handler {
      */
     protected _animationFrameCallback(): void;
     /**
-     * Creates default texture object.
+     * Creates a default 2x2 texture and passes it to callback.
+     * If `params.color` is set, a solid color texture is created.
+     * If `params.url` is set, the image is loaded asynchronously.
+     * Otherwise a fallback gray texture is created.
+     * @public
+     * @param {IDefaultTextureParams | null} params - Texture source parameters.
+     * @param {function(WebGLTextureExt): void} success - Callback with created texture.
+     */
+    createDefaultTexture(params: IDefaultTextureParams | null, success: (texture: WebGLTextureExt) => void, internalFormat?: number | null): void;
+    /**
+     * Deletes texture if it is not marked as default.
      * @public
-     * @param {IDefaultTextureParams | null} params - Texture parameters.
-     * @param {function(WebGLTextureExt): void} [success] - Creation callback.
+     * @param {WebGLTextureExt | null | undefined} texture - Texture to delete.
      */
-    createDefaultTexture(params: IDefaultTextureParams | null, success: (texture: WebGLTextureExt) => void): void;
     deleteTexture(texture: WebGLTextureExt | null | undefined): void;
     /**
+     * Releases handler resources, WebGL objects, observers and canvas.
      * @public
      */
     destroy(): void;