@luma.gl/webgl 9.1.0-beta.8 → 9.2.0-alpha.1

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

@@ -1,6 +1,6 @@
-import type { Device, TextureProps, TextureViewProps, Sampler, SamplerProps, TextureCubeFace, ExternalImage, Texture1DData, Texture2DData, Texture3DData, TextureCubeData, TextureArrayData, TextureCubeArrayData } from '@luma.gl/core';
+import type { Device, TextureProps, TextureViewProps, Sampler, SamplerProps, CopyExternalImageOptions, CopyImageDataOptions } from '@luma.gl/core';
 import { Texture } from '@luma.gl/core';
-import { GL, GLPixelType, GLSamplerParameters, GLTexelDataFormat, GLTextureTarget } from '@luma.gl/constants';
+import { GL, GLTextureTarget, GLTextureCubeMapTarget, GLTexelDataFormat, GLPixelType, GLSamplerParameters } from '@luma.gl/constants';
 import { WebGLDevice } from "../webgl-device.js";
 import { WEBGLSampler } from "./webgl-sampler.js";
 import { WEBGLTextureView } from "./webgl-texture-view.js";
@@ -13,9 +13,6 @@ export declare class WEBGLTexture extends Texture {
     handle: WebGLTexture;
     sampler: WEBGLSampler;
     view: WEBGLTextureView;
-    mipmaps: boolean;
-    /** Whether the internal format is compressed */
-    compressed: boolean;
     /**
      * The WebGL target corresponding to the texture type
      * @note `target` cannot be modified by bind:
@@ -32,78 +29,36 @@ export declare class WEBGLTexture extends Texture {
     glType: GLPixelType;
     /** The WebGL constant corresponding to the WebGPU style constant in format */
     glInternalFormat: GL;
+    /** Whether the internal format is compressed */
+    compressed: boolean;
     /** Texture binding slot - TODO - move to texture view? */
-    textureUnit: number;
+    _textureUnit: number;
     constructor(device: Device, props: TextureProps);
-    /** Initialize texture with supplied props */
-    _initialize(propsWithData: TextureProps): void;
     destroy(): void;
     createView(props: TextureViewProps): WEBGLTextureView;
     setSampler(sampler?: Sampler | SamplerProps): void;
-    generateMipmap(options?: {
-        force?: boolean;
-    }): void;
-    copyExternalImage(options: {
-        image: ExternalImage;
-        sourceX?: number;
-        sourceY?: number;
-        width?: number;
-        height?: number;
-        depth?: number;
-        mipLevel?: number;
-        x?: number;
-        y?: number;
-        z?: number;
-        aspect?: 'all' | 'stencil-only' | 'depth-only';
-        colorSpace?: 'srgb';
-        premultipliedAlpha?: boolean;
-        flipY?: boolean;
-    }): {
+    copyImageData(options_: CopyImageDataOptions): void;
+    copyExternalImage(options_: CopyExternalImageOptions): {
         width: number;
         height: number;
     };
-    setTexture1DData(data: Texture1DData): void;
-    /** Set a simple texture */
-    setTexture2DData(lodData: Texture2DData, depth?: number): void;
-    /**
-     * Sets a 3D texture
-     * @param data
-     */
-    setTexture3DData(data: Texture3DData): void;
-    /**
-     * Set a Texture Cube Data
-     * @todo - could support TextureCubeArray with depth
-     * @param data
-     * @param index
-     */
-    setTextureCubeData(data: TextureCubeData, depth?: number): void;
-    /**
-     * Sets an entire texture array
-     * @param data
-     */
-    setTextureArrayData(data: TextureArrayData): void;
-    /**
-     * Sets an entire texture cube array
-     * @param data
-     */
-    setTextureCubeArrayData(data: TextureCubeArrayData): void;
-    setTextureCubeFaceData(lodData: Texture2DData, face: TextureCubeFace, depth?: number): void;
-    /** Update external texture (video frame or canvas) @deprecated Use ExternalTexture */
-    update(): void;
-    /** @todo update this method to accept LODs */
-    setImageDataForFace(options: any): void;
-    _getImageDataMap(faceData: Record<string | GL, any>): Record<GL, any>;
+    generateMipmapsWebGL(options?: {
+        force?: boolean;
+    }): void;
     /**
      * Sets sampler parameters on texture
      */
     _setSamplerParameters(parameters: GLSamplerParameters): void;
-    /**
-     * Copy a region of data from a CPU memory buffer into this texture.
-     * @todo -   GLUnpackParameters parameters
-     */
-    protected _setMipLevel(depth: number, mipLevel: number, textureData: Texture2DData, glTarget?: GL): void;
-    getActiveUnit(): number;
-    bind(textureUnit?: number): number;
-    unbind(textureUnit?: number): number | undefined;
+    _getActiveUnit(): number;
+    _bind(_textureUnit?: number): number;
+    _unbind(_textureUnit?: number): number | undefined;
 }
+/** Convert a WebGPU style texture constant to a WebGL style texture constant */
+export declare function getWebGLTextureTarget(dimension: '1d' | '2d' | '2d-array' | 'cube' | 'cube-array' | '3d'): GLTextureTarget;
+/**
+ * In WebGL, cube maps specify faces by overriding target instead of using the depth parameter.
+ * @note We still bind the texture using GL.TEXTURE_CUBE_MAP, but we need to use the face-specific target when setting mip levels.
+ * @returns glTarget unchanged, if dimension !== 'cube'.
+ */
+export declare function getWebGLCubeFaceTarget(glTarget: GLTextureTarget, dimension: '1d' | '2d' | '2d-array' | 'cube' | 'cube-array' | '3d', level: number): GLTextureTarget | GLTextureCubeMapTarget;
 //# sourceMappingURL=webgl-texture.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"webgl-texture.d.ts","sourceRoot":"","sources":["../../../src/adapter/resources/webgl-texture.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"webgl-texture.d.ts","sourceRoot":"","sources":["../../../src/adapter/resources/webgl-texture.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,MAAM,EACN,YAAY,EACZ,gBAAgB,EAChB,OAAO,EACP,YAAY,EACZ,wBAAwB,EACxB,oBAAoB,EAErB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAC,OAAO,EAAM,MAAM,eAAe,CAAC;AAC3C,OAAO,EACL,EAAE,EACF,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,WAAW,EAEX,mBAAmB,EAEpB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAAC,WAAW,EAAC,2BAAwB;AAC5C,OAAO,EAAC,YAAY,EAAC,2BAAwB;AAC7C,OAAO,EAAC,gBAAgB,EAAC,gCAA6B;AAEtD;;GAEG;AACH,qBAAa,YAAa,SAAQ,OAAO;IAEvC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,EAAE,EAAE,sBAAsB,CAAC;IACpC,MAAM,EAAE,YAAY,CAAC;IAGrB,OAAO,EAAE,YAAY,CAAa;IAClC,IAAI,EAAE,gBAAgB,CAAC;IAEvB;;;;;;;;OAQG;IACH,QAAQ,EAAE,eAAe,CAAC;IAC1B,uDAAuD;IACvD,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,uDAAuD;IACvD,MAAM,EAAE,WAAW,CAAC;IACpB,8EAA8E;IAC9E,gBAAgB,EAAE,EAAE,CAAC;IACrB,gDAAgD;IAChD,UAAU,EAAE,OAAO,CAAC;IAGpB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAK;gBAEb,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY;IAmDtC,OAAO,IAAI,IAAI;IAUxB,UAAU,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB;IAI5C,UAAU,CAAC,OAAO,GAAE,OAAO,GAAG,YAAiB,GAAG,IAAI;IAO/D,aAAa,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IA8CnD,iBAAiB,CAAC,QAAQ,EAAE,wBAAwB,GAAG;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC;IAyCtF,oBAAoB,CAAC,OAAO,CAAC,EAAE;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAC,GAAG,IAAI;IAuBvD;;OAEG;IACH,qBAAqB,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI;IA4C5D,cAAc,IAAI,MAAM;IAIxB,KAAK,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM;IAapC,OAAO,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAWnD;AAID,gFAAgF;AAChF,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,IAAI,GAAG,IAAI,GAAG,UAAU,GAAG,MAAM,GAAG,YAAY,GAAG,IAAI,GACjE,eAAe,CAWjB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,IAAI,GAAG,IAAI,GAAG,UAAU,GAAG,MAAM,GAAG,YAAY,GAAG,IAAI,EAClE,KAAK,EAAE,MAAM,GACZ,eAAe,GAAG,sBAAsB,CAE1C"}