@lightningjs/renderer 0.6.0 → 0.6.1

package/dist/src/core/lib/WebGlContextWrapper.d.ts

@@ -0,0 +1,496 @@
+/**
+ * Optimized WebGL Context Wrapper
+ *
+ * @remarks
+ * This class contains the subset of the WebGLRenderingContext & WebGL2RenderingContext
+ * API that is used by the renderer. Select high volume WebGL methods include
+ * caching optimizations to avoid making WebGL calls if the state is already set
+ * to the desired value.
+ *
+ * While most methods contained are direct passthroughs to the WebGL context,
+ * some methods combine multiple WebGL calls into one for convenience, modify
+ * arguments to be more convenient, or are replaced by more specific methods.
+ *
+ * Not all methods are optimized. Only methods that are called frequently
+ * and/or have a high cost are optimized.
+ *
+ * A subset of GLenum constants are also exposed as properties on this class
+ * for convenience.
+ */
+export declare class WebGlContextWrapper {
+    private gl;
+    private activeTextureUnit;
+    private texture2dUnits;
+    private texture2dParams;
+    private scissorEnabled;
+    private scissorX;
+    private scissorY;
+    private scissorWidth;
+    private scissorHeight;
+    private blendEnabled;
+    private blendSrcRgb;
+    private blendDstRgb;
+    private blendSrcAlpha;
+    private blendDstAlpha;
+    private boundArrayBuffer;
+    private boundElementArrayBuffer;
+    private curProgram;
+    private programUniforms;
+    readonly canvas: HTMLCanvasElement | OffscreenCanvas;
+    readonly MAX_RENDERBUFFER_SIZE: 34024;
+    readonly MAX_TEXTURE_SIZE: 3379;
+    readonly MAX_VIEWPORT_DIMS: 3386;
+    readonly MAX_VERTEX_TEXTURE_IMAGE_UNITS: 35660;
+    readonly MAX_TEXTURE_IMAGE_UNITS: 34930;
+    readonly MAX_COMBINED_TEXTURE_IMAGE_UNITS: 35661;
+    readonly MAX_VERTEX_ATTRIBS: 34921;
+    readonly MAX_VARYING_VECTORS: 36348;
+    readonly MAX_VERTEX_UNIFORM_VECTORS: 36347;
+    readonly MAX_FRAGMENT_UNIFORM_VECTORS: 36349;
+    readonly TEXTURE_MAG_FILTER: 10240;
+    readonly TEXTURE_MIN_FILTER: 10241;
+    readonly TEXTURE_WRAP_S: 10242;
+    readonly TEXTURE_WRAP_T: 10243;
+    readonly LINEAR: 9729;
+    readonly CLAMP_TO_EDGE: 33071;
+    readonly RGBA: 6408;
+    readonly UNSIGNED_BYTE: 5121;
+    readonly UNPACK_PREMULTIPLY_ALPHA_WEBGL: 37441;
+    readonly FLOAT: 5126;
+    readonly TRIANGLES: 4;
+    readonly UNSIGNED_SHORT: 5123;
+    readonly ONE: 1;
+    readonly ONE_MINUS_SRC_ALPHA: 771;
+    readonly VERTEX_SHADER: 35633;
+    readonly FRAGMENT_SHADER: 35632;
+    readonly STATIC_DRAW: 35044;
+    readonly COMPILE_STATUS: 35713;
+    readonly LINK_STATUS: 35714;
+    readonly DYNAMIC_DRAW: 35048;
+    constructor(gl: WebGLRenderingContext | WebGL2RenderingContext);
+    /**
+     * Returns true if the WebGL context is WebGL2
+     *
+     * @returns
+     */
+    isWebGl2(): boolean;
+    /**
+     * ```
+     * gl.activeTexture(textureUnit + gl.TEXTURE0);
+     * ```
+     *
+     * @remarks
+     * **WebGL Difference**: `textureUnit` is based from 0, not `gl.TEXTURE0`.
+     *
+     * @param textureUnit
+     */
+    activeTexture(textureUnit: number): void;
+    /**
+     * ```
+     * gl.bindTexture(gl.TEXTURE_2D, texture);
+     * ```
+     * @remarks
+     * **WebGL Difference**: Bind target is always `gl.TEXTURE_2D`
+     *
+     * @param texture
+     */
+    bindTexture(texture: WebGLTexture | null): void;
+    private _getActiveTexture;
+    /**
+     * ```
+     * gl.texParameteri(gl.TEXTURE_2D, pname, param);
+     * ```
+     * @remarks
+     * **WebGL Difference**: Bind target is always `gl.TEXTURE_2D`
+     *
+     * @param pname
+     * @param param
+     * @returns
+     */
+    texParameteri(pname: number, param: number): void;
+    /**
+     * ```
+     * gl.texImage2D(
+     *   gl.TEXTURE_2D,
+     *   level,
+     *   internalFormat,
+     *   width,
+     *   height,
+     *   border,
+     *   format,
+     *   type,
+     *   pixels,
+     * );
+     * ```
+     * @remarks
+     * **WebGL Difference**: Bind target is always `gl.TEXTURE_2D`
+     *
+     * @param level
+     * @param internalFormat
+     * @param width
+     * @param height
+     * @param border
+     * @param format
+     * @param type
+     * @param pixels
+     */
+    texImage2D(level: GLint, internalformat: GLint, width: GLsizei, height: GLsizei, border: GLint, format: GLenum, type: GLenum, pixels: ArrayBufferView | null): void;
+    texImage2D(level: GLint, internalformat: GLint, format: GLenum, type: GLenum, source: TexImageSource): void;
+    /**
+     * ```
+     * gl.pixelStorei(pname, param);
+     * ```
+     *
+     * @param pname
+     * @param param
+     */
+    pixelStorei(pname: GLenum, param: GLint | GLboolean): void;
+    /**
+     * ```
+     * gl.generateMipmap(gl.TEXTURE_2D);
+     * ```
+     *
+     * @remarks
+     * **WebGL Difference**: Bind target is always `gl.TEXTURE_2D`
+     */
+    generateMipmap(): void;
+    /**
+     * ```
+     * gl.createTexture();
+     * ```
+     *
+     * @returns
+     */
+    createTexture(): WebGLTexture | null;
+    /**
+     * ```
+     * gl.deleteTexture(texture);
+     * ```
+     *
+     * @param texture
+     */
+    deleteTexture(texture: WebGLTexture | null): void;
+    /**
+     * ```
+     * gl.viewport(x, y, width, height);
+     * ```
+     */
+    viewport(x: GLint, y: GLint, width: GLsizei, height: GLsizei): void;
+    /**
+     * ```
+     * gl.clearColor(red, green, blue, alpha);
+     * ```
+     *
+     * @param red
+     * @param green
+     * @param blue
+     * @param alpha
+     */
+    clearColor(red: GLclampf, green: GLclampf, blue: GLclampf, alpha: GLclampf): void;
+    /**
+     * ```
+     * gl["enable"|"disable"](gl.SCISSOR_TEST);
+     * ```
+     * @param enable
+     */
+    setScissorTest(enable: boolean): void;
+    /**
+     * ```
+     * gl.scissor(x, y, width, height);
+     * ```
+     *
+     * @param x
+     * @param y
+     * @param width
+     * @param height
+     */
+    scissor(x: GLint, y: GLint, width: GLsizei, height: GLsizei): void;
+    /**
+     * ```
+     * gl["enable"|"disable"](gl.BLEND);
+     * ```
+     *
+     * @param blend
+     * @returns
+     */
+    setBlend(blend: boolean): void;
+    /**
+     * ```
+     * gl.blendFunc(src, dst);
+     * ```
+     *
+     * @param src
+     * @param dst
+     */
+    blendFunc(src: GLenum, dst: GLenum): void;
+    /**
+     * ```
+     * createBuffer();
+     * ```
+     *
+     * @returns
+     */
+    createBuffer(): WebGLBuffer | null;
+    /**
+     * ```
+     * gl.clear(gl.COLOR_BUFFER_BIT);
+     * ```
+     *
+     * @remarks
+     * **WebGL Difference**: Clear mask is always `gl.COLOR_BUFFER_BIT`
+     */
+    clear(): void;
+    /**
+     * ```
+     * gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
+     * gl.bufferData(gl.ARRAY_BUFFER, data, usage);
+     * ```
+     *
+     * @remarks
+     * **WebGL Combo**: `gl.bindBuffer` and `gl.bufferData` are combined into one function.
+     *
+     * @param buffer
+     * @param data
+     * @param usage
+     */
+    arrayBufferData(buffer: WebGLBuffer | null, data: ArrayBufferView, usage: GLenum): void;
+    /**
+     * ```
+     * gl.bindBuffer(gl.ELEMENT_ARRAY_BUFFER, buffer);
+     * gl.bufferData(gl.ELEMENT_ARRAY_BUFFER, data, usage);
+     * ```
+     * @remarks
+     * **WebGL Combo**: `gl.bindBuffer` and `gl.bufferData` are combined into one function.
+     *
+     * @param buffer
+     * @param data
+     * @param usage
+     */
+    elementArrayBufferData(buffer: WebGLBuffer | null, data: ArrayBufferView, usage: GLenum): void;
+    /**
+     * ```
+     * gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
+     * gl.vertexAttribPointer(index, size, type, normalized, stride, offset);
+     * ```
+     *
+     * @remarks
+     * **WebGL Combo**: `gl.bindBuffer` and `gl.vertexAttribPointer` are combined into one function.
+     *
+     * @param buffer
+     * @param index
+     * @param size
+     * @param type
+     * @param normalized
+     * @param stride
+     * @param offset
+     */
+    vertexAttribPointer(buffer: WebGLBuffer, index: GLuint, size: GLint, type: GLenum, normalized: GLboolean, stride: GLsizei, offset: GLintptr): void;
+    /**
+     * ```
+     * gl.useProgram(program);
+     * ```
+     *
+     * @param program
+     * @returns
+     */
+    useProgram(program: WebGLProgram | null): void;
+    setUniform<T extends keyof UniformMethodMap>(type: T, location: WebGLUniformLocation, ...args: UniformMethodMap[T]): void;
+    /**
+     * ```
+     * gl.getParameter(pname);
+     * ```
+     *
+     * @param pname
+     * @returns
+     */
+    getParameter(pname: GLenum): any;
+    /**
+     * ```
+     * gl.drawElements(mode, count, type, offset);
+     * ```
+     *
+     * @param mode
+     * @param count
+     * @param type
+     * @param offset
+     */
+    drawElements(mode: GLenum, count: GLsizei, type: GLenum, offset: GLintptr): void;
+    /**
+     * ```
+     * gl.drawArrays(mode, first, count);
+     * ```
+     *
+     * @param name
+     * @returns
+     */
+    getExtension(name: string): any;
+    /**
+     * ```
+     * gl.createVertexArray();
+     * ```
+     *
+     * @returns
+     */
+    createVertexArray(): WebGLVertexArrayObject | null;
+    /**
+     * ```
+     * gl.bindVertexArray(vertexArray);
+     * ```
+     *
+     * @param vertexArray
+     */
+    bindVertexArray(vertexArray: WebGLVertexArrayObject | null): void;
+    /**
+     * ```
+     * gl.getAttribLocation(program, name);
+     * ```
+     *
+     * @param program
+     * @param name
+     * @returns
+     */
+    getAttribLocation(program: WebGLProgram, name: string): number;
+    /**
+     * ```
+     * gl.getUniformLocation(program, name);
+     * ```
+     *
+     * @param program
+     * @param name
+     * @returns
+     */
+    getUniformLocation(program: WebGLProgram, name: string): WebGLUniformLocation | null;
+    /**
+     * ```
+     * gl.enableVertexAttribArray(index);
+     * ```
+     *
+     * @param index
+     */
+    enableVertexAttribArray(index: number): void;
+    /**
+     * ```
+     * gl.disableVertexAttribArray(index);
+     * ```
+     *
+     * @param index
+     */
+    disableVertexAttribArray(index: number): void;
+    /**
+     * ```
+     * gl.createShader(type);
+     * ```
+     *
+     * @param type
+     * @returns
+     */
+    createShader(type: number): WebGLShader | null;
+    /**
+     * ```
+     * gl.compileShader(shader);
+     * ```
+     *
+     * @param shader
+     * @returns
+     */
+    compileShader(shader: WebGLShader): void;
+    /**
+     * ```
+     * gl.attachShader(program, shader);
+     * ```
+     *
+     * @param program
+     * @param shader
+     */
+    attachShader(program: WebGLProgram, shader: WebGLShader): void;
+    /**
+     * ```
+     * gl.linkProgram(program);
+     * ```
+     *
+     * @param program
+     */
+    linkProgram(program: WebGLProgram): void;
+    /**
+     * ```
+     * gl.deleteProgram(shader);
+     * ```
+     *
+     * @param shader
+     */
+    deleteProgram(shader: WebGLProgram): void;
+    /**
+     * ```
+     * gl.getShaderParameter(shader, pname);
+     * ```
+     *
+     * @param shader
+     * @param pname
+     */
+    getShaderParameter(shader: WebGLShader, pname: GLenum): any;
+    /**
+     * ```
+     * gl.getShaderInfoLog(shader);
+     * ```
+     *
+     * @param shader
+     */
+    getShaderInfoLog(shader: WebGLShader): string | null;
+    /**
+     * ```
+     * gl.createProgram();
+     * ```
+     *
+     * @returns
+     */
+    createProgram(): WebGLProgram | null;
+    /**
+     * ```
+     * gl.getProgramParameter(program, pname);
+     * ```
+     *
+     * @param program
+     * @param pname
+     * @returns
+     */
+    getProgramParameter(program: WebGLProgram, pname: GLenum): any;
+    /**
+     * ```
+     * gl.getProgramInfoLog(program);
+     * ```
+     *
+     * @param program
+     * @returns
+     */
+    getProgramInfoLog(program: WebGLProgram): string | null;
+    /**
+     * ```
+     * gl.shaderSource(shader, source);
+     * ```
+     *
+     * @param shader
+     * @param source
+     */
+    shaderSource(shader: WebGLShader, source: string): void;
+    /**
+     * ```
+     * gl.deleteShader(shader);
+     * ```
+     *
+     * @param shader
+     */
+    deleteShader(shader: WebGLShader): void;
+}
+type IsUniformMethod<MethodName, MethodType> = MethodName extends `uniform${string}` ? MethodType extends (location: WebGLUniformLocation | null, ...args: any[]) => void ? true : false : false;
+export type UniformMethodMap = {
+    [Key in keyof WebGLRenderingContext as IsUniformMethod<Key, WebGLRenderingContext[Key]> extends true ? Key : never]: WebGLRenderingContext[Key] extends (location: WebGLUniformLocation | null, ...args: infer T) => void ? T : never;
+};
+/**
+ *
+ *
+ * @param a
+ * @param b
+ * @returns
+ */
+export declare function compareArrays<T>(a: T[], b: T[]): boolean;
+export {};