@babylonjs/lite-gl 0.1.0 → 0.2.0

package/html-texture.d.ts

@@ -1,143 +1,44 @@
-/** Create a texture backed by an `<canvas>` / `<img>` / `<video>` element.
- *  The initial upload is performed immediately; call `updateHtmlElementTexture`
- *  to re-upload after the source has changed. */
-export declare function createHtmlElementTexture(engine: GLEngineContext, element: HTMLCanvasElement | HTMLImageElement | HTMLVideoElement, options?: GLHtmlElementTextureOptions): GLTexture;
-
-/** Read-only WebGL2 capability limits, queried once at context creation. */
-declare interface GLEngineCaps {
-    /** `gl.MAX_TEXTURE_SIZE` — largest supported texture dimension, in texels. */
-    readonly maxTextureSize: number;
-    /** `gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS` — number of sampler binding slots. */
-    readonly maxTextureUnits: number;
-    /** The `KHR_parallel_shader_compile` extension used for async link polling,
-     *  or null when unsupported — linking is then treated as synchronous. */
-    readonly parallelShaderCompile: {
-        COMPLETION_STATUS_KHR: number;
-    } | null;
-    /** True when 32-bit float color attachments are renderable
-     *  (`EXT_color_buffer_float`). Mirrors Babylon's `caps.textureFloatRender`. */
-    readonly textureFloatRender: boolean;
-    /** True when 32-bit float textures support linear filtering
-     *  (`OES_texture_float_linear`). Mirrors `caps.textureFloatLinearFiltering`. */
-    readonly textureFloatLinearFiltering: boolean;
-    /** True when 16-bit half-float color attachments are renderable
-     *  (`EXT_color_buffer_float` or `EXT_color_buffer_half_float`). Mirrors
-     *  `caps.textureHalfFloatRender`. */
-    readonly textureHalfFloatRender: boolean;
-    /** Half-float linear filtering — always `true` in WebGL2 (it is core).
-     *  Kept as a field to mirror Babylon's `caps.textureHalfFloatLinearFiltering`. */
-    readonly textureHalfFloatLinearFiltering: boolean;
-    /** Whether non-power-of-two textures need POT dimensions for mips / wrap.
-     *  Always `false` in WebGL2 (NPOT is core). Mirrors `engine.needPOTTextures`. */
-    readonly needPOTTextures: boolean;
-}
-
-/**
- * Pure-state handle for a WebGL2 canvas + its cached GL state.
- *
- * INVARIANT: consumers MUST NOT mutate GL state directly through `engine.gl`.
- * Doing so silently corrupts the cache in `_state`. The package owns every
- * GL call. (`engine.gl` is exposed only so downstream code that already has the
- * pattern of poking `engine._gl.getExtension(...)` can do that, but must NOT
- * call `bindTexture`/`useProgram`/`bindBuffer`/`viewport`/etc.)
- */
-declare interface GLEngineContext {
-    /** The canvas the WebGL2 context was acquired from. An `OffscreenCanvas` is
-     *  supported for worker render paths (e.g. the Lottie player); it has no CSS
-     *  box, so it must be sized explicitly via `setGLEngineSize` rather than the
-     *  CSS-derived `resizeGLEngine`. */
-    readonly canvas: HTMLCanvasElement | OffscreenCanvas;
-    /** The raw WebGL2 context. Do NOT mutate GL state through it — see the
-     *  type-level invariant above; the package owns every state-changing call. */
-    readonly gl: WebGL2RenderingContext;
-    /** Queried capability limits for this context. */
-    readonly caps: GLEngineCaps;
-
-/** Options for `createHtmlElementTexture` — the base texture options plus
- *  HTML-source-specific settings. */
-export declare interface GLHtmlElementTextureOptions extends GLTextureOptions {
-    /** High-level sampling preset. When set, derives `minFilter`/`magFilter`
-     *  (and `generateMipMaps` for `TRILINEAR`). Explicit `minFilter` /
-     *  `magFilter` / `generateMipMaps` options still take precedence. Omit for
-     *  the GL defaults (linear min + mag, no mipmaps). */
-    samplingMode?: GLSamplingMode;
-    /** Build a full mip chain after each upload. Independent of the core
-     *  texture options (this factory's mip behavior is sampling-mode-driven):
-     *  defaults to `true` only when `samplingMode` is `TRILINEAR`, otherwise
-     *  `false`. */
-    generateMipMaps?: boolean;
-}
-
-/** High-level sampling presets, mirroring Babylon's `Texture.*_SAMPLINGMODE`
- *  numeric constants. Each resolves to GL min/mag filters (and mip generation
- *  for `TRILINEAR`). */
-export declare const GLSamplingMode: {
-    /** Nearest min + mag, no mipmaps. (`Texture.NEAREST_SAMPLINGMODE`) */
-    readonly NEAREST: 1;
-    /** Linear min + mag, no mipmaps. (`Texture.BILINEAR_SAMPLINGMODE`) */
-    readonly BILINEAR: 2;
-    /** Linear mag + linear-mipmap-linear min, mipmaps generated.
-     *  (`Texture.TRILINEAR_SAMPLINGMODE`) */
-    readonly TRILINEAR: 3;
-};
-
-/** One of the {@link GLSamplingMode} preset values (`1`, `2` or `3`). */
-export declare type GLSamplingMode = (typeof GLSamplingMode)[keyof typeof GLSamplingMode];
-
-/**
- * Pure-state texture handle. The `handle` field is MUTABLE so the same logical
- * texture survives a `webglcontextrestored` event — every consumer keeps the
- * same `GLTexture` reference; only the internal `WebGLTexture` is swapped.
- *
- * `loadTexture2D` also uses the same handle for the 1×1 placeholder upload AND
- * the final image upload — so a `bindTexture(engine, unit, tex)` made before the
- * image has decoded remains valid once the image arrives.
- */
-declare interface GLTexture {
-    /** The live `WebGLTexture`. MUTABLE — swapped for a fresh handle on
-     *  `webglcontextrestored` while consumers keep the same `GLTexture` reference. */
-    handle: WebGLTexture;
-    /** GL texture target (always `gl.TEXTURE_2D` for this package). */
-    readonly target: GLenum;
-    /** Texture width in texels. Updated once an async upload resolves. */
-    width: number;
-    /** Texture height in texels. Updated once an async upload resolves. */
-    height: number;
-    /** True when the texture is safe to sample with final content (placeholders
-     *  read as not-ready until their image/upload completes). */
-    isReady: boolean;
-
-/** Texture sampling / wrap options. All have GL-spec defaults. Mipmaps are NOT
- *  a create option — generate the chain explicitly via {@link generateTextureMipMaps}. */
-declare interface GLTextureOptions {
-    /** Default: false (matches Babylon's default raw-texture behaviour). */
-    invertY?: boolean;
-    /** Default: gl.LINEAR. */
-    minFilter?: GLenum;
-    /** Default: gl.LINEAR. */
-    magFilter?: GLenum;
-    /** Default: gl.CLAMP_TO_EDGE. May be `gl.REPEAT` / `gl.MIRRORED_REPEAT`
-     *  (NPOT-safe in WebGL2). */
-    wrapS?: GLenum;
-    /** Default: gl.CLAMP_TO_EDGE. May be `gl.REPEAT` / `gl.MIRRORED_REPEAT`. */
-    wrapT?: GLenum;
-    /** `gl.pixelStorei(UNPACK_ALIGNMENT)` for the upload (1/2/4/8). Default 4.
-     *  Use 1 for tightly-packed non-RGBA rows. */
-    unpackAlignment?: number;
-    /** Premultiply alpha at upload (`UNPACK_PREMULTIPLY_ALPHA_WEBGL`). Default
-     *  false. */
-    premultiplyAlpha?: boolean;
-    /** Explicit sized internalFormat for `texImage2D`. When provided it is used
-     *  verbatim and the inline LDR resolver is bypassed — this is how
-     *  {@link createFloatTexture} injects its `RGBA16F` / `RGBA32F` choice
-     *  without the byte path ever referencing the float-format table (keeping it
-     *  tree-shakeable out of RGBA8-only bundles). Default: derived from
-     *  `format`/`type` via the LDR resolver. */
-    internalFormat?: GLenum;
-}
-
-/** Re-upload the texture from its source element. No-op when the context is
- *  lost/disposed or the texture is disposed. */
-export declare function updateHtmlElementTexture(engine: GLEngineContext, tex: GLTexture): void;
-
-export { }
+/**
+ * HTML element textures.
+ *
+ * Part of the public API via the `@babylonjs/lite-gl` barrel. The package is
+ * `sideEffects: false`, so consumers that don't need it (everything except
+ * NeonBrush's `InputGlow`) tree-shake it out.
+ */
+import type { GLEngineContext } from "./context.js";
+import { type GLTexture, type GLTextureOptions } from "./texture.js";
+/** High-level sampling presets, mirroring Babylon's `Texture.*_SAMPLINGMODE`
+ *  numeric constants. Each resolves to GL min/mag filters (and mip generation
+ *  for `TRILINEAR`). */
+export declare const GLSamplingMode: {
+    /** Nearest min + mag, no mipmaps. (`Texture.NEAREST_SAMPLINGMODE`) */
+    readonly NEAREST: 1;
+    /** Linear min + mag, no mipmaps. (`Texture.BILINEAR_SAMPLINGMODE`) */
+    readonly BILINEAR: 2;
+    /** Linear mag + linear-mipmap-linear min, mipmaps generated.
+     *  (`Texture.TRILINEAR_SAMPLINGMODE`) */
+    readonly TRILINEAR: 3;
+};
+/** One of the {@link GLSamplingMode} preset values (`1`, `2` or `3`). */
+export type GLSamplingMode = (typeof GLSamplingMode)[keyof typeof GLSamplingMode];
+/** Options for `createHtmlElementTexture` — the base texture options plus
+ *  HTML-source-specific settings. */
+export interface GLHtmlElementTextureOptions extends GLTextureOptions {
+    /** High-level sampling preset. When set, derives `minFilter`/`magFilter`
+     *  (and `generateMipMaps` for `TRILINEAR`). Explicit `minFilter` /
+     *  `magFilter` / `generateMipMaps` options still take precedence. Omit for
+     *  the GL defaults (linear min + mag, no mipmaps). */
+    samplingMode?: GLSamplingMode;
+    /** Build a full mip chain after each upload. Independent of the core
+     *  texture options (this factory's mip behavior is sampling-mode-driven):
+     *  defaults to `true` only when `samplingMode` is `TRILINEAR`, otherwise
+     *  `false`. */
+    generateMipMaps?: boolean;
+}
+/** Create a texture backed by an `<canvas>` / `<img>` / `<video>` element.
+ *  The initial upload is performed immediately; call `updateHtmlElementTexture`
+ *  to re-upload after the source has changed. */
+export declare function createHtmlElementTexture(engine: GLEngineContext, element: HTMLCanvasElement | HTMLImageElement | HTMLVideoElement, options?: GLHtmlElementTextureOptions): GLTexture;
+/** Re-upload the texture from its source element. No-op when the context is
+ *  lost/disposed or the texture is disposed. */
+export declare function updateHtmlElementTexture(engine: GLEngineContext, tex: GLTexture): void;

package/html-texture.js

@@ -1,89 +1,95 @@
-import { s as setUnpackState, i as bindTextureForUpload } from "./texture-DaMd1gGm.js";
-const GLSamplingMode = {
-  /** Nearest min + mag, no mipmaps. (`Texture.NEAREST_SAMPLINGMODE`) */
-  NEAREST: 1,
-  /** Linear min + mag, no mipmaps. (`Texture.BILINEAR_SAMPLINGMODE`) */
-  BILINEAR: 2,
-  /** Linear mag + linear-mipmap-linear min, mipmaps generated.
-   *  (`Texture.TRILINEAR_SAMPLINGMODE`) */
-  TRILINEAR: 3
+import { bindTextureForUpload, setUnpackState } from "./texture.js";
+/** High-level sampling presets, mirroring Babylon's `Texture.*_SAMPLINGMODE`
+ *  numeric constants. Each resolves to GL min/mag filters (and mip generation
+ *  for `TRILINEAR`). */
+export const GLSamplingMode = {
+    /** Nearest min + mag, no mipmaps. (`Texture.NEAREST_SAMPLINGMODE`) */
+    NEAREST: 1,
+    /** Linear min + mag, no mipmaps. (`Texture.BILINEAR_SAMPLINGMODE`) */
+    BILINEAR: 2,
+    /** Linear mag + linear-mipmap-linear min, mipmaps generated.
+     *  (`Texture.TRILINEAR_SAMPLINGMODE`) */
+    TRILINEAR: 3,
 };
-function createHtmlElementTexture(engine, element, options) {
-  const gl = engine.gl;
-  const handle = gl.createTexture();
-  if (handle === null) {
-    throw new Error("lite-gl: gl.createTexture returned null");
-  }
-  const opts = options ?? {};
-  const sm = opts.samplingMode;
-  const minFilter = opts.minFilter ?? samplingMinFilter(gl, sm);
-  const magFilter = opts.magFilter ?? samplingMagFilter(gl, sm);
-  const wrapS = opts.wrapS ?? gl.CLAMP_TO_EDGE;
-  const wrapT = opts.wrapT ?? gl.CLAMP_TO_EDGE;
-  const invertY = opts.invertY ?? false;
-  const generateMipMaps = opts.generateMipMaps ?? sm === GLSamplingMode.TRILINEAR;
-  const sizeOf = () => {
-    if (element instanceof HTMLVideoElement) {
-      return [element.videoWidth || 1, element.videoHeight || 1];
+/** Create a texture backed by an `<canvas>` / `<img>` / `<video>` element.
+ *  The initial upload is performed immediately; call `updateHtmlElementTexture`
+ *  to re-upload after the source has changed. */
+export function createHtmlElementTexture(engine, element, options) {
+    const gl = engine.gl;
+    const handle = gl.createTexture();
+    if (handle === null) {
+        throw new Error("lite-gl: gl.createTexture returned null");
     }
-    if (element instanceof HTMLImageElement) {
-      return [element.naturalWidth || 1, element.naturalHeight || 1];
-    }
-    return [element.width || 1, element.height || 1];
-  };
-  const upload = (target) => {
-    const g = target.gl;
-    setUnpackState(target, invertY, false);
-    bindTextureForUpload(target, tex.handle);
-    g.texImage2D(g.TEXTURE_2D, 0, g.RGBA, g.RGBA, g.UNSIGNED_BYTE, element);
-    const [w, h] = sizeOf();
-    tex.width = w;
-    tex.height = h;
-    g.texParameteri(g.TEXTURE_2D, g.TEXTURE_MIN_FILTER, minFilter);
-    g.texParameteri(g.TEXTURE_2D, g.TEXTURE_MAG_FILTER, magFilter);
-    g.texParameteri(g.TEXTURE_2D, g.TEXTURE_WRAP_S, wrapS);
-    g.texParameteri(g.TEXTURE_2D, g.TEXTURE_WRAP_T, wrapT);
-    if (generateMipMaps) {
-      g.generateMipmap(g.TEXTURE_2D);
-    }
-  };
-  const [w0, h0] = sizeOf();
-  const tex = {
-    handle,
-    target: gl.TEXTURE_2D,
-    width: w0,
-    height: h0,
-    isReady: true,
-    _disposed: false,
-    _refCount: 1,
-    _upload: upload,
-    _wasReady: true
-  };
-  upload(engine);
-  engine._textures.push(tex);
-  return tex;
+    const opts = options ?? {};
+    const sm = opts.samplingMode;
+    const minFilter = opts.minFilter ?? samplingMinFilter(gl, sm);
+    const magFilter = opts.magFilter ?? samplingMagFilter(gl, sm);
+    const wrapS = opts.wrapS ?? gl.CLAMP_TO_EDGE;
+    const wrapT = opts.wrapT ?? gl.CLAMP_TO_EDGE;
+    const invertY = opts.invertY ?? false;
+    const generateMipMaps = opts.generateMipMaps ?? sm === GLSamplingMode.TRILINEAR;
+    const sizeOf = () => {
+        if (element instanceof HTMLVideoElement) {
+            return [element.videoWidth || 1, element.videoHeight || 1];
+        }
+        if (element instanceof HTMLImageElement) {
+            return [element.naturalWidth || 1, element.naturalHeight || 1];
+        }
+        return [element.width || 1, element.height || 1];
+    };
+    const upload = (target) => {
+        const g = target.gl;
+        setUnpackState(target, invertY, false);
+        bindTextureForUpload(target, tex.handle);
+        g.texImage2D(g.TEXTURE_2D, 0, g.RGBA, g.RGBA, g.UNSIGNED_BYTE, element);
+        const [w, h] = sizeOf();
+        tex.width = w;
+        tex.height = h;
+        g.texParameteri(g.TEXTURE_2D, g.TEXTURE_MIN_FILTER, minFilter);
+        g.texParameteri(g.TEXTURE_2D, g.TEXTURE_MAG_FILTER, magFilter);
+        g.texParameteri(g.TEXTURE_2D, g.TEXTURE_WRAP_S, wrapS);
+        g.texParameteri(g.TEXTURE_2D, g.TEXTURE_WRAP_T, wrapT);
+        if (generateMipMaps) {
+            g.generateMipmap(g.TEXTURE_2D);
+        }
+    };
+    const [w0, h0] = sizeOf();
+    const tex = {
+        handle,
+        target: gl.TEXTURE_2D,
+        width: w0,
+        height: h0,
+        isReady: true,
+        _disposed: false,
+        _refCount: 1,
+        _upload: upload,
+        _wasReady: true,
+    };
+    upload(engine);
+    engine._textures.push(tex);
+    return tex;
 }
-function updateHtmlElementTexture(engine, tex) {
-  if (engine._isLost || engine._disposed || tex._disposed) {
-    return;
-  }
-  tex._upload(engine);
+/** Re-upload the texture from its source element. No-op when the context is
+ *  lost/disposed or the texture is disposed. */
+export function updateHtmlElementTexture(engine, tex) {
+    if (engine._isLost || engine._disposed || tex._disposed) {
+        return;
+    }
+    tex._upload(engine);
 }
+/* ────────────────────────────  internal helpers  ──────────────────────────── */
+/** Resolve a sampling preset to a GL min filter. Defaults to `gl.LINEAR`. */
 function samplingMinFilter(gl, mode) {
-  if (mode === GLSamplingMode.NEAREST) {
-    return gl.NEAREST;
-  }
-  if (mode === GLSamplingMode.TRILINEAR) {
-    return gl.LINEAR_MIPMAP_LINEAR;
-  }
-  return gl.LINEAR;
+    if (mode === GLSamplingMode.NEAREST) {
+        return gl.NEAREST;
+    }
+    if (mode === GLSamplingMode.TRILINEAR) {
+        return gl.LINEAR_MIPMAP_LINEAR;
+    }
+    return gl.LINEAR;
 }
+/** Resolve a sampling preset to a GL mag filter. Defaults to `gl.LINEAR`. */
 function samplingMagFilter(gl, mode) {
-  return mode === GLSamplingMode.NEAREST ? gl.NEAREST : gl.LINEAR;
+    return mode === GLSamplingMode.NEAREST ? gl.NEAREST : gl.LINEAR;
 }
-export {
-  GLSamplingMode,
-  createHtmlElementTexture,
-  updateHtmlElementTexture
-};
-//# sourceMappingURL=html-texture.js.map
+//# sourceMappingURL=html-texture.js.map

package/html-texture.js.map

@@ -1 +1 @@
-{"version":3,"file":"html-texture.js","sources":["../src/html-texture.ts"],"sourcesContent":["/**\n * Sub-entry: HTML element textures.\n *\n * Dynamic-importable via `import { ... } from \"@babylonjs/lite-gl/html-texture\"`\n * so consumers that don't need it (everything except NeonBrush's `InputGlow`)\n * don't pull it into their bundles.\n */\nimport type { GLEngineContext } from \"./context.js\";\nimport { bindTextureForUpload, setUnpackState, type GLTexture, type GLTextureOptions } from \"./texture.js\";\n\n/** High-level sampling presets, mirroring Babylon's `Texture.*_SAMPLINGMODE`\n *  numeric constants. Each resolves to GL min/mag filters (and mip generation\n *  for `TRILINEAR`). */\nexport const GLSamplingMode = {\n    /** Nearest min + mag, no mipmaps. (`Texture.NEAREST_SAMPLINGMODE`) */\n    NEAREST: 1,\n    /** Linear min + mag, no mipmaps. (`Texture.BILINEAR_SAMPLINGMODE`) */\n    BILINEAR: 2,\n    /** Linear mag + linear-mipmap-linear min, mipmaps generated.\n     *  (`Texture.TRILINEAR_SAMPLINGMODE`) */\n    TRILINEAR: 3,\n} as const;\n\n/** One of the {@link GLSamplingMode} preset values (`1`, `2` or `3`). */\nexport type GLSamplingMode = (typeof GLSamplingMode)[keyof typeof GLSamplingMode];\n\n/** Options for `createHtmlElementTexture` — the base texture options plus\n *  HTML-source-specific settings. */\nexport interface GLHtmlElementTextureOptions extends GLTextureOptions {\n    /** High-level sampling preset. When set, derives `minFilter`/`magFilter`\n     *  (and `generateMipMaps` for `TRILINEAR`). Explicit `minFilter` /\n     *  `magFilter` / `generateMipMaps` options still take precedence. Omit for\n     *  the GL defaults (linear min + mag, no mipmaps). */\n    samplingMode?: GLSamplingMode;\n    /** Build a full mip chain after each upload. Independent of the core\n     *  texture options (this factory's mip behavior is sampling-mode-driven):\n     *  defaults to `true` only when `samplingMode` is `TRILINEAR`, otherwise\n     *  `false`. */\n    generateMipMaps?: boolean;\n}\n\n/** Create a texture backed by an `<canvas>` / `<img>` / `<video>` element.\n *  The initial upload is performed immediately; call `updateHtmlElementTexture`\n *  to re-upload after the source has changed. */\nexport function createHtmlElementTexture(\n    engine: GLEngineContext,\n    element: HTMLCanvasElement | HTMLImageElement | HTMLVideoElement,\n    options?: GLHtmlElementTextureOptions\n): GLTexture {\n    const gl = engine.gl;\n    const handle = gl.createTexture();\n    if (handle === null) {\n        throw new Error(\"lite-gl: gl.createTexture returned null\");\n    }\n    const opts = options ?? {};\n    const sm = opts.samplingMode;\n    const minFilter = opts.minFilter ?? samplingMinFilter(gl, sm);\n    const magFilter = opts.magFilter ?? samplingMagFilter(gl, sm);\n    const wrapS = opts.wrapS ?? gl.CLAMP_TO_EDGE;\n    const wrapT = opts.wrapT ?? gl.CLAMP_TO_EDGE;\n    const invertY = opts.invertY ?? false;\n    const generateMipMaps = opts.generateMipMaps ?? sm === GLSamplingMode.TRILINEAR;\n\n    const sizeOf = (): [number, number] => {\n        if (element instanceof HTMLVideoElement) {\n            return [element.videoWidth || 1, element.videoHeight || 1];\n        }\n        if (element instanceof HTMLImageElement) {\n            return [element.naturalWidth || 1, element.naturalHeight || 1];\n        }\n        return [element.width || 1, element.height || 1];\n    };\n\n    const upload = (target: GLEngineContext): void => {\n        const g = target.gl;\n        setUnpackState(target, invertY, false);\n        bindTextureForUpload(target, tex.handle);\n        g.texImage2D(g.TEXTURE_2D, 0, g.RGBA, g.RGBA, g.UNSIGNED_BYTE, element);\n        const [w, h] = sizeOf();\n        tex.width = w;\n        tex.height = h;\n        g.texParameteri(g.TEXTURE_2D, g.TEXTURE_MIN_FILTER, minFilter);\n        g.texParameteri(g.TEXTURE_2D, g.TEXTURE_MAG_FILTER, magFilter);\n        g.texParameteri(g.TEXTURE_2D, g.TEXTURE_WRAP_S, wrapS);\n        g.texParameteri(g.TEXTURE_2D, g.TEXTURE_WRAP_T, wrapT);\n        if (generateMipMaps) {\n            g.generateMipmap(g.TEXTURE_2D);\n        }\n    };\n\n    const [w0, h0] = sizeOf();\n    const tex: GLTexture = {\n        handle,\n        target: gl.TEXTURE_2D,\n        width: w0,\n        height: h0,\n        isReady: true,\n        _disposed: false,\n        _refCount: 1,\n        _upload: upload,\n        _wasReady: true,\n    };\n    upload(engine);\n    engine._textures.push(tex);\n    return tex;\n}\n\n/** Re-upload the texture from its source element. No-op when the context is\n *  lost/disposed or the texture is disposed. */\nexport function updateHtmlElementTexture(engine: GLEngineContext, tex: GLTexture): void {\n    if (engine._isLost || engine._disposed || tex._disposed) {\n        return;\n    }\n    tex._upload(engine);\n}\n\n/* ────────────────────────────  internal helpers  ──────────────────────────── */\n\n/** Resolve a sampling preset to a GL min filter. Defaults to `gl.LINEAR`. */\nfunction samplingMinFilter(gl: WebGL2RenderingContext, mode: GLSamplingMode | undefined): GLenum {\n    if (mode === GLSamplingMode.NEAREST) {\n        return gl.NEAREST;\n    }\n    if (mode === GLSamplingMode.TRILINEAR) {\n        return gl.LINEAR_MIPMAP_LINEAR;\n    }\n    return gl.LINEAR;\n}\n\n/** Resolve a sampling preset to a GL mag filter. Defaults to `gl.LINEAR`. */\nfunction samplingMagFilter(gl: WebGL2RenderingContext, mode: GLSamplingMode | undefined): GLenum {\n    return mode === GLSamplingMode.NEAREST ? gl.NEAREST : gl.LINEAR;\n}\n"],"names":[],"mappings":";AAaO,MAAM,iBAAiB;AAAA;AAAA,EAE1B,SAAS;AAAA;AAAA,EAET,UAAU;AAAA;AAAA;AAAA,EAGV,WAAW;AACf;AAuBO,SAAS,yBACZ,QACA,SACA,SACS;AACT,QAAM,KAAK,OAAO;AAClB,QAAM,SAAS,GAAG,cAAA;AAClB,MAAI,WAAW,MAAM;AACjB,UAAM,IAAI,MAAM,yCAAyC;AAAA,EAC7D;AACA,QAAM,OAAO,WAAW,CAAA;AACxB,QAAM,KAAK,KAAK;AAChB,QAAM,YAAY,KAAK,aAAa,kBAAkB,IAAI,EAAE;AAC5D,QAAM,YAAY,KAAK,aAAa,kBAAkB,IAAI,EAAE;AAC5D,QAAM,QAAQ,KAAK,SAAS,GAAG;AAC/B,QAAM,QAAQ,KAAK,SAAS,GAAG;AAC/B,QAAM,UAAU,KAAK,WAAW;AAChC,QAAM,kBAAkB,KAAK,mBAAmB,OAAO,eAAe;AAEtE,QAAM,SAAS,MAAwB;AACnC,QAAI,mBAAmB,kBAAkB;AACrC,aAAO,CAAC,QAAQ,cAAc,GAAG,QAAQ,eAAe,CAAC;AAAA,IAC7D;AACA,QAAI,mBAAmB,kBAAkB;AACrC,aAAO,CAAC,QAAQ,gBAAgB,GAAG,QAAQ,iBAAiB,CAAC;AAAA,IACjE;AACA,WAAO,CAAC,QAAQ,SAAS,GAAG,QAAQ,UAAU,CAAC;AAAA,EACnD;AAEA,QAAM,SAAS,CAAC,WAAkC;AAC9C,UAAM,IAAI,OAAO;AACjB,mBAAe,QAAQ,SAAS,KAAK;AACrC,yBAAqB,QAAQ,IAAI,MAAM;AACvC,MAAE,WAAW,EAAE,YAAY,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,OAAO;AACtE,UAAM,CAAC,GAAG,CAAC,IAAI,OAAA;AACf,QAAI,QAAQ;AACZ,QAAI,SAAS;AACb,MAAE,cAAc,EAAE,YAAY,EAAE,oBAAoB,SAAS;AAC7D,MAAE,cAAc,EAAE,YAAY,EAAE,oBAAoB,SAAS;AAC7D,MAAE,cAAc,EAAE,YAAY,EAAE,gBAAgB,KAAK;AACrD,MAAE,cAAc,EAAE,YAAY,EAAE,gBAAgB,KAAK;AACrD,QAAI,iBAAiB;AACjB,QAAE,eAAe,EAAE,UAAU;AAAA,IACjC;AAAA,EACJ;AAEA,QAAM,CAAC,IAAI,EAAE,IAAI,OAAA;AACjB,QAAM,MAAiB;AAAA,IACnB;AAAA,IACA,QAAQ,GAAG;AAAA,IACX,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,SAAS;AAAA,IACT,WAAW;AAAA,IACX,WAAW;AAAA,IACX,SAAS;AAAA,IACT,WAAW;AAAA,EAAA;AAEf,SAAO,MAAM;AACb,SAAO,UAAU,KAAK,GAAG;AACzB,SAAO;AACX;AAIO,SAAS,yBAAyB,QAAyB,KAAsB;AACpF,MAAI,OAAO,WAAW,OAAO,aAAa,IAAI,WAAW;AACrD;AAAA,EACJ;AACA,MAAI,QAAQ,MAAM;AACtB;AAKA,SAAS,kBAAkB,IAA4B,MAA0C;AAC7F,MAAI,SAAS,eAAe,SAAS;AACjC,WAAO,GAAG;AAAA,EACd;AACA,MAAI,SAAS,eAAe,WAAW;AACnC,WAAO,GAAG;AAAA,EACd;AACA,SAAO,GAAG;AACd;AAGA,SAAS,kBAAkB,IAA4B,MAA0C;AAC7F,SAAO,SAAS,eAAe,UAAU,GAAG,UAAU,GAAG;AAC7D;"}
+{"version":3,"file":"html-texture.js","sourceRoot":"","sources":["../src/html-texture.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * HTML element textures.\n *\n * Part of the public API via the `@babylonjs/lite-gl` barrel. The package is\n * `sideEffects: false`, so consumers that don't need it (everything except\n * NeonBrush's `InputGlow`) tree-shake it out.\n */\nimport type { GLEngineContext } from \"./context.js\";\nimport { bindTextureForUpload, setUnpackState, type GLTexture, type GLTextureOptions } from \"./texture.js\";\n\n/** High-level sampling presets, mirroring Babylon's `Texture.*_SAMPLINGMODE`\n *  numeric constants. Each resolves to GL min/mag filters (and mip generation\n *  for `TRILINEAR`). */\nexport const GLSamplingMode = {\n    /** Nearest min + mag, no mipmaps. (`Texture.NEAREST_SAMPLINGMODE`) */\n    NEAREST: 1,\n    /** Linear min + mag, no mipmaps. (`Texture.BILINEAR_SAMPLINGMODE`) */\n    BILINEAR: 2,\n    /** Linear mag + linear-mipmap-linear min, mipmaps generated.\n     *  (`Texture.TRILINEAR_SAMPLINGMODE`) */\n    TRILINEAR: 3,\n} as const;\n\n/** One of the {@link GLSamplingMode} preset values (`1`, `2` or `3`). */\nexport type GLSamplingMode = (typeof GLSamplingMode)[keyof typeof GLSamplingMode];\n\n/** Options for `createHtmlElementTexture` — the base texture options plus\n *  HTML-source-specific settings. */\nexport interface GLHtmlElementTextureOptions extends GLTextureOptions {\n    /** High-level sampling preset. When set, derives `minFilter`/`magFilter`\n     *  (and `generateMipMaps` for `TRILINEAR`). Explicit `minFilter` /\n     *  `magFilter` / `generateMipMaps` options still take precedence. Omit for\n     *  the GL defaults (linear min + mag, no mipmaps). */\n    samplingMode?: GLSamplingMode;\n    /** Build a full mip chain after each upload. Independent of the core\n     *  texture options (this factory's mip behavior is sampling-mode-driven):\n     *  defaults to `true` only when `samplingMode` is `TRILINEAR`, otherwise\n     *  `false`. */\n    generateMipMaps?: boolean;\n}\n\n/** Create a texture backed by an `<canvas>` / `<img>` / `<video>` element.\n *  The initial upload is performed immediately; call `updateHtmlElementTexture`\n *  to re-upload after the source has changed. */\nexport function createHtmlElementTexture(\n    engine: GLEngineContext,\n    element: HTMLCanvasElement | HTMLImageElement | HTMLVideoElement,\n    options?: GLHtmlElementTextureOptions\n): GLTexture {\n    const gl = engine.gl;\n    const handle = gl.createTexture();\n    if (handle === null) {\n        throw new Error(\"lite-gl: gl.createTexture returned null\");\n    }\n    const opts = options ?? {};\n    const sm = opts.samplingMode;\n    const minFilter = opts.minFilter ?? samplingMinFilter(gl, sm);\n    const magFilter = opts.magFilter ?? samplingMagFilter(gl, sm);\n    const wrapS = opts.wrapS ?? gl.CLAMP_TO_EDGE;\n    const wrapT = opts.wrapT ?? gl.CLAMP_TO_EDGE;\n    const invertY = opts.invertY ?? false;\n    const generateMipMaps = opts.generateMipMaps ?? sm === GLSamplingMode.TRILINEAR;\n\n    const sizeOf = (): [number, number] => {\n        if (element instanceof HTMLVideoElement) {\n            return [element.videoWidth || 1, element.videoHeight || 1];\n        }\n        if (element instanceof HTMLImageElement) {\n            return [element.naturalWidth || 1, element.naturalHeight || 1];\n        }\n        return [element.width || 1, element.height || 1];\n    };\n\n    const upload = (target: GLEngineContext): void => {\n        const g = target.gl;\n        setUnpackState(target, invertY, false);\n        bindTextureForUpload(target, tex.handle);\n        g.texImage2D(g.TEXTURE_2D, 0, g.RGBA, g.RGBA, g.UNSIGNED_BYTE, element);\n        const [w, h] = sizeOf();\n        tex.width = w;\n        tex.height = h;\n        g.texParameteri(g.TEXTURE_2D, g.TEXTURE_MIN_FILTER, minFilter);\n        g.texParameteri(g.TEXTURE_2D, g.TEXTURE_MAG_FILTER, magFilter);\n        g.texParameteri(g.TEXTURE_2D, g.TEXTURE_WRAP_S, wrapS);\n        g.texParameteri(g.TEXTURE_2D, g.TEXTURE_WRAP_T, wrapT);\n        if (generateMipMaps) {\n            g.generateMipmap(g.TEXTURE_2D);\n        }\n    };\n\n    const [w0, h0] = sizeOf();\n    const tex: GLTexture = {\n        handle,\n        target: gl.TEXTURE_2D,\n        width: w0,\n        height: h0,\n        isReady: true,\n        _disposed: false,\n        _refCount: 1,\n        _upload: upload,\n        _wasReady: true,\n    };\n    upload(engine);\n    engine._textures.push(tex);\n    return tex;\n}\n\n/** Re-upload the texture from its source element. No-op when the context is\n *  lost/disposed or the texture is disposed. */\nexport function updateHtmlElementTexture(engine: GLEngineContext, tex: GLTexture): void {\n    if (engine._isLost || engine._disposed || tex._disposed) {\n        return;\n    }\n    tex._upload(engine);\n}\n\n/* ────────────────────────────  internal helpers  ──────────────────────────── */\n\n/** Resolve a sampling preset to a GL min filter. Defaults to `gl.LINEAR`. */\nfunction samplingMinFilter(gl: WebGL2RenderingContext, mode: GLSamplingMode | undefined): GLenum {\n    if (mode === GLSamplingMode.NEAREST) {\n        return gl.NEAREST;\n    }\n    if (mode === GLSamplingMode.TRILINEAR) {\n        return gl.LINEAR_MIPMAP_LINEAR;\n    }\n    return gl.LINEAR;\n}\n\n/** Resolve a sampling preset to a GL mag filter. Defaults to `gl.LINEAR`. */\nfunction samplingMagFilter(gl: WebGL2RenderingContext, mode: GLSamplingMode | undefined): GLenum {\n    return mode === GLSamplingMode.NEAREST ? gl.NEAREST : gl.LINEAR;\n}\n"]}