@luma.gl/webgl 8.6.0-alpha.4 → 9.0.0-alpha.3

package/dist/adapter/resources/webgl-texture.d.ts

@@ -0,0 +1,193 @@
+import { Device, TextureProps, Sampler, SamplerProps } from '@luma.gl/api';
+import { Texture } from '@luma.gl/api';
+import GL from '@luma.gl/constants';
+import type { WebGLSamplerParameters } from '../../types/webgl';
+import WebGLDevice from '../webgl-device';
+import WEBGLSampler from './webgl-sampler';
+export type { TextureProps };
+declare type SetImageDataOptions = {
+    target?: number;
+    level?: number;
+    dataFormat?: any;
+    width: number;
+    height: number;
+    depth?: number;
+    format: any;
+    type?: any;
+    offset?: number;
+    data: any;
+    compressed?: boolean;
+    parameters?: Record<GL, any>;
+    /** @deprecated */
+    pixels?: any;
+};
+/**
+ * @param {*} pixels, data -
+ *  null - create empty texture of specified format
+ *  Typed array - init from image data in typed array
+ *  Buffer|WebGLBuffer - (WEBGL2) init from image data in WebGLBuffer
+ *  HTMLImageElement|Image - Inits with content of image. Auto width/height
+ *  HTMLCanvasElement - Inits with contents of canvas. Auto width/height
+ *  HTMLVideoElement - Creates video texture. Auto width/height
+ *
+ * @param  x - xOffset from where texture to be updated
+ * @param  y - yOffset from where texture to be updated
+ * @param  width - width of the sub image to be updated
+ * @param  height - height of the sub image to be updated
+ * @param  level - mip level to be updated
+ * @param {GLenum} format - internal format of image data.
+ * @param {GLenum} type
+ *  - format of array (autodetect from type) or
+ *  - (WEBGL2) format of buffer or ArrayBufferView
+ * @param {GLenum} dataFormat - format of image data.
+ * @param {Number} offset - (WEBGL2) offset from start of buffer
+ * @parameters - temporary settings to be applied, can be used to supply pixel store settings.
+ */
+declare type SetSubImageDataOptions = {
+    target?: number;
+    level?: number;
+    dataFormat?: any;
+    width?: number;
+    height?: number;
+    depth?: number;
+    format?: any;
+    type?: any;
+    offset?: number;
+    data: any;
+    parameters?: Record<GL, any>;
+    compressed?: boolean;
+    x?: number;
+    y?: number;
+    /** @deprecated */
+    pixels?: any;
+};
+declare type SetImageData3DOptions = {
+    level?: number;
+    dataFormat?: any;
+    width: number;
+    height: number;
+    depth?: number;
+    format: any;
+    type?: any;
+    offset?: number;
+    data: any;
+    parameters?: Record<GL, any>;
+};
+export default class WEBGLTexture extends Texture {
+    static FACES: number[];
+    readonly MAX_ATTRIBUTES: number;
+    readonly device: WebGLDevice;
+    readonly gl: WebGLRenderingContext;
+    readonly gl2: WebGL2RenderingContext | null;
+    readonly handle: WebGLTexture;
+    data: any;
+    width: number;
+    height: number;
+    depth: number;
+    format: GL;
+    type: GL;
+    dataFormat: GL;
+    mipmaps: boolean;
+    /**
+     * @note `target` cannot be modified by bind:
+     * textures are special because when you first bind them to a target,
+     * they get special information. When you first bind a texture as a
+     * GL_TEXTURE_2D, you are saying that this texture is a 2D texture.
+     * And it will always be a 2D texture; this state cannot be changed ever.
+     * A texture that was first bound as a GL_TEXTURE_2D, must always be bound as a GL_TEXTURE_2D;
+     * attempting to bind it as GL_TEXTURE_3D will give rise to a run-time error
+     * */
+    target: GL;
+    textureUnit: number;
+    /** Sampler object (currently unused) */
+    sampler: WEBGLSampler;
+    /**
+     * Program.draw() checks the loaded flag of all textures to avoid
+     * Textures that are still loading from promises
+     * Set to true as soon as texture has been initialized with valid data
+     */
+    loaded: boolean;
+    _video: {
+        video: HTMLVideoElement;
+        parameters: any;
+        lastTime: number;
+    };
+    constructor(device: Device, props: TextureProps);
+    destroy(): void;
+    toString(): string;
+    initialize(props?: TextureProps): this;
+    initializeCube(props?: TextureProps): this;
+    setSampler(sampler?: Sampler | SamplerProps): this;
+    /**
+     * If size has changed, reinitializes with current format
+     * @note note clears image and mipmaps
+     */
+    resize({ height, width, mipmaps }: {
+        height: any;
+        width: any;
+        mipmaps?: boolean;
+    }): this;
+    /** Update external texture (video frame) */
+    update(): this;
+    generateMipmap(params?: {}): this;
+    setImageData(options: SetImageDataOptions): this;
+    /**
+     * Redefines an area of an existing texture
+     * Note: does not allocate storage
+     * Redefines an area of an existing texture
+     */
+    setSubImageData({ target, pixels, data, x, y, width, height, level, format, type, dataFormat, compressed, offset, parameters }: SetSubImageDataOptions): void;
+    /**
+     * Defines a two-dimensional texture image or cube-map texture image with
+     * pixels from the current framebuffer (rather than from client memory).
+     * (gl.copyTexImage2D wrapper)
+     *
+     * Note that binding a texture into a Framebuffer's color buffer and
+     * rendering can be faster.
+     */
+    copyFramebuffer(opts?: {}): any;
+    getActiveUnit(): number;
+    bind(textureUnit?: number): number;
+    unbind(textureUnit?: number): number;
+    _getDataType({ data, compressed }: {
+        data: any;
+        compressed?: boolean;
+    }): {
+        data: any;
+        dataType: string;
+    };
+    _deduceParameters(opts: any): {
+        dataFormat: any;
+        type: any;
+        compressed: any;
+        width: any;
+        height: any;
+        format: any;
+        data: any;
+    };
+    _deduceImageSize(data: any, width: any, height: any): {
+        width: number;
+        height: number;
+    };
+    setCubeMapImageData(options: {
+        width: any;
+        height: any;
+        pixels: any;
+        data: any;
+        format?: any;
+        type?: any;
+    }): Promise<void>;
+    /** @todo update this method to accept LODs */
+    setImageDataForFace(options: any): this;
+    /** Image 3D copies from Typed Array or WebGLBuffer */
+    setImageData3D({ level, dataFormat, format, type, // = GL.UNSIGNED_BYTE,
+    width, height, depth, offset, data, parameters }: SetImageData3DOptions): this;
+    /**
+     * Sets sampler parameters on texture
+     * @note: Applies NPOT workaround if appropriate
+     */
+    _setSamplerParameters(parameters: WebGLSamplerParameters): this;
+    /** @deprecated For LegacyTexture subclass */
+    protected _getWebGL1NPOTParameterOverride(pname: number, value: number): number;
+}
+//# sourceMappingURL=webgl-texture.d.ts.map

package/dist/adapter/resources/webgl-texture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgl-texture.d.ts","sourceRoot":"","sources":["../../../src/adapter/resources/webgl-texture.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,MAAM,EACN,YAAY,EACZ,OAAO,EACP,YAAY,EAGb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAC,OAAO,EAA6C,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACpC,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,mBAAmB,CAAC;AAW9D,OAAO,WAAW,MAAM,iBAAiB,CAAC;AAE1C,OAAO,YAAY,MAAM,iBAAiB,CAAC;AAE3C,YAAY,EAAC,YAAY,EAAC,CAAC;AAE3B,aAAK,mBAAmB,GAAG;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,GAAG,CAAC;IACZ,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,GAAG,CAAC;IACV,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAC7B,kBAAkB;IAClB,MAAM,CAAC,EAAE,GAAG,CAAC;CACd,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,aAAK,sBAAsB,GAAG;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,GAAG,CAAC;IACV,UAAU,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,kBAAkB;IAClB,MAAM,CAAC,EAAE,GAAG,CAAC;CACd,CAAC;AAEF,aAAK,qBAAqB,GAAG;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,GAAG,CAAC;IACZ,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,GAAG,CAAC;IACV,UAAU,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;CAC9B,CAAC;AAIF,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,OAAO;IAE/C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAOpB;IAEF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,EAAE,EAAE,qBAAqB,CAAC;IACnC,QAAQ,CAAC,GAAG,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAE9B,IAAI,MAAC;IAEL,KAAK,EAAE,MAAM,CAAa;IAC1B,MAAM,EAAE,MAAM,CAAa;IAC3B,KAAK,EAAE,MAAM,CAAa;IAE1B,MAAM,EAAE,EAAE,CAAa;IACvB,IAAI,EAAE,EAAE,CAAa;IACrB,UAAU,EAAE,EAAE,CAAa;IAC3B,OAAO,EAAE,OAAO,CAAa;IAE7B;;;;;;;;SAQK;IACL,MAAM,EAAE,EAAE,CAAC;IACX,WAAW,EAAE,MAAM,CAAa;IAEhC,wCAAwC;IACxC,OAAO,EAAE,YAAY,CAAa;IAElC;;;;OAIG;IACH,MAAM,EAAE,OAAO,CAAS;IACxB,MAAM,EAAE;QACN,KAAK,EAAE,gBAAgB,CAAC;QACxB,UAAU,EAAE,GAAG,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;gBAEU,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY;IAyB/C,OAAO,IAAI,IAAI;IAUf,QAAQ,IAAI,MAAM;IAKlB,UAAU,CAAC,KAAK,GAAE,YAAiB,GAAG,IAAI;IAoH1C,cAAc,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI;IAsB1C,UAAU,CAAC,OAAO,GAAE,OAAO,GAAG,YAAiB,GAAG,IAAI;IAgBtD;;;OAGG;IACH,MAAM,CAAC,EAAC,MAAM,EAAE,KAAK,EAAE,OAAe,EAAC;;;;KAAA,GAAG,IAAI;IAc9C,4CAA4C;IAC5C,MAAM,IAAI,IAAI;IAmBd,cAAc,CAAC,MAAM,KAAK,GAAG,IAAI;IAqCjC,YAAY,CAAC,OAAO,EAAE,mBAAmB;IAuIzC;;;;OAIG;IACH,eAAe,CAAC,EACd,MAAoB,EACpB,MAAa,EACb,IAAW,EACX,CAAK,EACL,CAAK,EACL,KAAkB,EAClB,MAAoB,EACpB,KAAS,EACT,MAAoB,EACpB,IAAgB,EAChB,UAA4B,EAC5B,UAAkB,EAClB,MAAU,EACV,UAAkC,EACnC,EAAE,sBAAsB;IA8DzB;;;;;;;OAOG;IACH,eAAe,CAAC,IAAI,KAAK;IAOzB,aAAa,IAAI,MAAM;IAIvB,IAAI,CAAC,WAAW,SAAmB;IAYnC,MAAM,CAAC,WAAW,SAAmB;IAcrC,YAAY,CAAC,EAAC,IAAI,EAAE,UAAkB,EAAC;;;KAAA;;;;IAuBvC,iBAAiB,CAAC,IAAI,KAAA;;;;;;;;;IAgBtB,gBAAgB,CAAC,IAAI,KAAA,EAAE,KAAK,KAAA,EAAE,MAAM,KAAA,GAAG;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC;IAmChE,mBAAmB,CAAC,OAAO,EAAE;QACjC,KAAK,EAAE,GAAG,CAAC;QACX,MAAM,EAAE,GAAG,CAAC;QACZ,MAAM,EAAE,GAAG,CAAC;QACZ,IAAI,EAAE,GAAG,CAAC;QACV,MAAM,CAAC,EAAE,GAAG,CAAC;QACb,IAAI,CAAC,EAAE,GAAG,CAAC;KACZ,GAAG,OAAO,CAAC,IAAI,CAAC;IA+CjB,8CAA8C;IAC9C,mBAAmB,CAAC,OAAO,KAAA;IAoC3B,sDAAsD;IACtD,cAAc,CAAC,EACb,KAAS,EACT,UAAU,EACV,MAAM,EACN,IAAI,EAAE,sBAAsB;IAC5B,KAAK,EACL,MAAM,EACN,KAAS,EACT,MAAU,EACV,IAAI,EACJ,UAAsD,EACvD,EAAE,qBAAqB;IAwDxB;;;OAGG;IACH,qBAAqB,CAAC,UAAU,EAAE,sBAAsB;IAmCxD,6CAA6C;IAC7C,SAAS,CAAC,+BAA+B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;CAqBhF"}