@loaders.gl/textures 4.4.0-alpha.2 → 4.4.0

package/src/lib/utils/ktx-format-helper.ts

@@ -2,117 +2,132 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 
-import {GL_EXTENSIONS_CONSTANTS} from '../gl-extensions';
+/* eslint-disable camelcase */
+import type {TextureFormat} from '@loaders.gl/schema';
+import type {GLTextureFormat} from '../gl-types';
+import {
+  GL_COMPRESSED_R11_EAC,
+  GL_COMPRESSED_RED_GREEN_RGTC2_EXT,
+  GL_COMPRESSED_RED_RGTC1_EXT,
+  GL_COMPRESSED_RG11_EAC,
+  GL_COMPRESSED_RGB8_ETC2,
+  GL_COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2,
+  GL_COMPRESSED_RGBA8_ETC2_EAC,
+  GL_COMPRESSED_RGBA_ASTC_10x10_KHR,
+  GL_COMPRESSED_RGBA_ASTC_10x5_KHR,
+  GL_COMPRESSED_RGBA_ASTC_10x6_KHR,
+  GL_COMPRESSED_RGBA_ASTC_10x8_KHR,
+  GL_COMPRESSED_RGBA_ASTC_12x10_KHR,
+  GL_COMPRESSED_RGBA_ASTC_12x12_KHR,
+  GL_COMPRESSED_RGBA_ASTC_4x4_KHR,
+  GL_COMPRESSED_RGBA_ASTC_5x4_KHR,
+  GL_COMPRESSED_RGBA_ASTC_5x5_KHR,
+  GL_COMPRESSED_RGBA_ASTC_6x5_KHR,
+  GL_COMPRESSED_RGBA_ASTC_6x6_KHR,
+  GL_COMPRESSED_RGBA_ASTC_8x5_KHR,
+  GL_COMPRESSED_RGBA_ASTC_8x6_KHR,
+  GL_COMPRESSED_RGBA_ASTC_8x8_KHR,
+  GL_COMPRESSED_RGBA_PVRTC_2BPPV1_IMG,
+  GL_COMPRESSED_RGBA_PVRTC_4BPPV1_IMG,
+  GL_COMPRESSED_RGBA_S3TC_DXT1_EXT,
+  GL_COMPRESSED_RGBA_S3TC_DXT3_EXT,
+  GL_COMPRESSED_RGBA_S3TC_DXT5_EXT,
+  GL_COMPRESSED_RGB_S3TC_DXT1_EXT,
+  GL_COMPRESSED_SIGNED_R11_EAC,
+  GL_COMPRESSED_SIGNED_RED_GREEN_RGTC2_EXT,
+  GL_COMPRESSED_SIGNED_RED_RGTC1_EXT,
+  GL_COMPRESSED_SIGNED_RG11_EAC,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x10_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x5_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x6_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x8_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_12x10_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_12x12_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_4x4_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_5x4_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_5x5_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_6x5_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_6x6_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x5_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x6_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x8_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ETC2_EAC,
+  GL_COMPRESSED_SRGB8_ETC2,
+  GL_COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2,
+  GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT,
+  GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT,
+  GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT,
+  GL_COMPRESSED_SRGB_S3TC_DXT1_EXT
+} from '../gl-extensions';
+import {getTextureFormatFromWebGLFormat} from './texture-format-map';
 
-const VULKAN_TO_WEBGL_FORMAT_MAP: Record<number, number> = {
-  131: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGB_S3TC_DXT1_EXT,
-  132: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SRGB_S3TC_DXT1_EXT,
-  133: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_S3TC_DXT1_EXT,
-  134: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT,
-  135: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_S3TC_DXT3_EXT,
-  136: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT,
-  137: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_S3TC_DXT5_EXT,
-  138: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT,
-  139: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RED_RGTC1_EXT,
-  140: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SIGNED_RED_RGTC1_EXT,
-  141: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RED_GREEN_RGTC2_EXT,
-  142: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SIGNED_RED_GREEN_RGTC2_EXT,
-  147: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGB8_ETC2,
-  148: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SRGB8_ETC2,
-  149: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2,
-  150: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2,
-  151: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA8_ETC2_EAC,
-  152: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SRGB8_ALPHA8_ETC2_EAC,
-  153: GL_EXTENSIONS_CONSTANTS.COMPRESSED_R11_EAC,
-  154: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SIGNED_R11_EAC,
-  155: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RG11_EAC,
-  156: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SIGNED_RG11_EAC,
-  // @ts-ignore
-  157: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_4x4_KHR,
-  // @ts-ignore
-  158: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SRGB8_ALPHA8_ASTC_4x4_KHR,
-  // @ts-ignore
-  159: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_5x4_KHR,
-  // @ts-ignore
-  160: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SRGB8_ALPHA8_ASTC_5X4_KHR,
-  // @ts-ignore
-  161: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_5x5_KHR,
-  // @ts-ignore
-  162: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SRGB8_ALPHA8_ASTC_5x5_KHR,
-  // @ts-ignore
-  163: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_6x5_KHR,
-  // @ts-ignore
-  164: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SRGB8_ALPHA8_ASTC_6x5_KHR,
-  // @ts-ignore
-  165: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_6x6_KHR,
-  // @ts-ignore
-  166: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SRGB8_ALPHA8_ASTC_6x6_KHR,
-  // @ts-ignore
-  167: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_8x5_KHR,
-  // @ts-ignore
-  168: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SRGB8_ALPHA8_ASTC_8x5_KHR,
-  // @ts-ignore
-  169: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_8x6_KHR,
-  // @ts-ignore
-  170: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SRGB8_ALPHA8_ASTC_8x6_KHR,
-  // @ts-ignore
-  171: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_8x8_KHR,
-  // @ts-ignore
-  172: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SRGB8_ALPHA8_ASTC_8x8_KHR,
-  // @ts-ignore
-  173: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_10x5_KHR,
-  // @ts-ignore
-  174: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SRGB8_ALPHA8_ASTC_10x5_KHR,
-  // @ts-ignore
-  175: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_10x6_KHR,
-  // @ts-ignore
-  176: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SRGB8_ALPHA8_ASTC_10x6_KHR,
-  // @ts-ignore
-  177: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_10x8_KHR,
-  // @ts-ignore
-  178: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SRGB8_ALPHA8_ASTC_10x8_KHR,
-  // @ts-ignore
-  179: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_10x10_KHR,
-  // @ts-ignore
-  180: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SRGB8_ALPHA8_ASTC_10x10_KHR,
-  // @ts-ignore
-  181: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_12x10_KHR,
-  // @ts-ignore
-  182: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SRGB8_ALPHA8_ASTC_12x10_KHR,
-  // @ts-ignore
-  183: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_12x12_KHR,
-  // @ts-ignore
-  184: GL_EXTENSIONS_CONSTANTS.COMPRESSED_SRGB8_ALPHA8_ASTC_12x12_KHR,
-  1000054000: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_PVRTC_2BPPV1_IMG,
-  1000054001: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_PVRTC_4BPPV1_IMG,
-  // @ts-ignore
-  1000066000: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_4x4_KHR,
-  // @ts-ignore
-  1000066001: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_5x4_KHR,
-  // @ts-ignore
-  1000066002: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_5x5_KHR,
-  // @ts-ignore
-  1000066003: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_6x5_KHR,
-  // @ts-ignore
-  1000066004: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_6x6_KHR,
-  // @ts-ignore
-  1000066005: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_8x5_KHR,
-  // @ts-ignore
-  1000066006: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_8x6_KHR,
-  // @ts-ignore
-  1000066007: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_8x8_KHR,
-  // @ts-ignore
-  1000066008: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_10x5_KHR,
-  // @ts-ignore
-  1000066009: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_10x6_KHR,
-  // @ts-ignore
-  1000066010: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_10x8_KHR,
-  // @ts-ignore
-  1000066011: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_10x10_KHR,
-  // @ts-ignore
-  1000066012: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_12x10_KHR,
-  // @ts-ignore
-  1000066013: GL_EXTENSIONS_CONSTANTS.COMPRESSED_RGBA_ASTC_12x12_KHR
+const VULKAN_TO_WEBGL_FORMAT_MAP: Record<number, GLTextureFormat> = {
+  131: GL_COMPRESSED_RGB_S3TC_DXT1_EXT,
+  132: GL_COMPRESSED_SRGB_S3TC_DXT1_EXT,
+  133: GL_COMPRESSED_RGBA_S3TC_DXT1_EXT,
+  134: GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT,
+  135: GL_COMPRESSED_RGBA_S3TC_DXT3_EXT,
+  136: GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT,
+  137: GL_COMPRESSED_RGBA_S3TC_DXT5_EXT,
+  138: GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT,
+  139: GL_COMPRESSED_RED_RGTC1_EXT,
+  140: GL_COMPRESSED_SIGNED_RED_RGTC1_EXT,
+  141: GL_COMPRESSED_RED_GREEN_RGTC2_EXT,
+  142: GL_COMPRESSED_SIGNED_RED_GREEN_RGTC2_EXT,
+  147: GL_COMPRESSED_RGB8_ETC2,
+  148: GL_COMPRESSED_SRGB8_ETC2,
+  149: GL_COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2,
+  150: GL_COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2,
+  151: GL_COMPRESSED_RGBA8_ETC2_EAC,
+  152: GL_COMPRESSED_SRGB8_ALPHA8_ETC2_EAC,
+  153: GL_COMPRESSED_R11_EAC,
+  154: GL_COMPRESSED_SIGNED_R11_EAC,
+  155: GL_COMPRESSED_RG11_EAC,
+  156: GL_COMPRESSED_SIGNED_RG11_EAC,
+  157: GL_COMPRESSED_RGBA_ASTC_4x4_KHR,
+  158: GL_COMPRESSED_SRGB8_ALPHA8_ASTC_4x4_KHR,
+  159: GL_COMPRESSED_RGBA_ASTC_5x4_KHR,
+  160: GL_COMPRESSED_SRGB8_ALPHA8_ASTC_5x4_KHR,
+  161: GL_COMPRESSED_RGBA_ASTC_5x5_KHR,
+  162: GL_COMPRESSED_SRGB8_ALPHA8_ASTC_5x5_KHR,
+  163: GL_COMPRESSED_RGBA_ASTC_6x5_KHR,
+  164: GL_COMPRESSED_SRGB8_ALPHA8_ASTC_6x5_KHR,
+  165: GL_COMPRESSED_RGBA_ASTC_6x6_KHR,
+  166: GL_COMPRESSED_SRGB8_ALPHA8_ASTC_6x6_KHR,
+  167: GL_COMPRESSED_RGBA_ASTC_8x5_KHR,
+  168: GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x5_KHR,
+  169: GL_COMPRESSED_RGBA_ASTC_8x6_KHR,
+  170: GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x6_KHR,
+  171: GL_COMPRESSED_RGBA_ASTC_8x8_KHR,
+  172: GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x8_KHR,
+  173: GL_COMPRESSED_RGBA_ASTC_10x5_KHR,
+  174: GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x5_KHR,
+  175: GL_COMPRESSED_RGBA_ASTC_10x6_KHR,
+  176: GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x6_KHR,
+  177: GL_COMPRESSED_RGBA_ASTC_10x8_KHR,
+  178: GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x8_KHR,
+  179: GL_COMPRESSED_RGBA_ASTC_10x10_KHR,
+  180: GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x10_KHR,
+  181: GL_COMPRESSED_RGBA_ASTC_12x10_KHR,
+  182: GL_COMPRESSED_SRGB8_ALPHA8_ASTC_12x10_KHR,
+  183: GL_COMPRESSED_RGBA_ASTC_12x12_KHR,
+  184: GL_COMPRESSED_SRGB8_ALPHA8_ASTC_12x12_KHR,
+  1000054000: GL_COMPRESSED_RGBA_PVRTC_2BPPV1_IMG,
+  1000054001: GL_COMPRESSED_RGBA_PVRTC_4BPPV1_IMG,
+  1000066000: GL_COMPRESSED_RGBA_ASTC_4x4_KHR,
+  1000066001: GL_COMPRESSED_RGBA_ASTC_5x4_KHR,
+  1000066002: GL_COMPRESSED_RGBA_ASTC_5x5_KHR,
+  1000066003: GL_COMPRESSED_RGBA_ASTC_6x5_KHR,
+  1000066004: GL_COMPRESSED_RGBA_ASTC_6x6_KHR,
+  1000066005: GL_COMPRESSED_RGBA_ASTC_8x5_KHR,
+  1000066006: GL_COMPRESSED_RGBA_ASTC_8x6_KHR,
+  1000066007: GL_COMPRESSED_RGBA_ASTC_8x8_KHR,
+  1000066008: GL_COMPRESSED_RGBA_ASTC_10x5_KHR,
+  1000066009: GL_COMPRESSED_RGBA_ASTC_10x6_KHR,
+  1000066010: GL_COMPRESSED_RGBA_ASTC_10x8_KHR,
+  1000066011: GL_COMPRESSED_RGBA_ASTC_10x10_KHR,
+  1000066012: GL_COMPRESSED_RGBA_ASTC_12x10_KHR,
+  1000066013: GL_COMPRESSED_RGBA_ASTC_12x12_KHR
 };
 
 /**
@@ -122,6 +137,15 @@ const VULKAN_TO_WEBGL_FORMAT_MAP: Record<number, number> = {
  * @param vkFormat
  * @returns WebGL / OpenGL constant
  */
-export function mapVkFormatToWebGL(vkFormat: number): number {
+export function mapVkFormatToWebGL(vkFormat: number): GLTextureFormat | undefined {
   return VULKAN_TO_WEBGL_FORMAT_MAP[vkFormat];
 }
+
+/**
+ * Returns the canonical loaders.gl texture format corresponding to a Vulkan `vkFormat` value.
+ * @param vkFormat - Vulkan format constant from the KTX container.
+ * @returns Canonical texture format string, if known.
+ */
+export function mapVkFormatToTextureFormat(vkFormat: number): TextureFormat | undefined {
+  return getTextureFormatFromWebGLFormat(mapVkFormatToWebGL(vkFormat));
+}

package/src/lib/utils/texture-format-map.ts

@@ -0,0 +1,162 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+/* eslint-disable camelcase */
+import type {TextureFormat} from '@loaders.gl/schema';
+import type {GLTextureFormat} from '../gl-types';
+import {
+  GL_RGBA32F,
+  GL_COMPRESSED_R11_EAC,
+  GL_COMPRESSED_RED_GREEN_RGTC2_EXT,
+  GL_COMPRESSED_RED_RGTC1_EXT,
+  GL_COMPRESSED_RG11_EAC,
+  GL_COMPRESSED_RGB8_ETC2,
+  GL_COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2,
+  GL_COMPRESSED_RGB_ATC_WEBGL,
+  GL_COMPRESSED_RGB_ETC1_WEBGL,
+  GL_COMPRESSED_RGB_PVRTC_2BPPV1_IMG,
+  GL_COMPRESSED_RGB_PVRTC_4BPPV1_IMG,
+  GL_COMPRESSED_RGB_S3TC_DXT1_EXT,
+  GL_COMPRESSED_RGBA8_ETC2_EAC,
+  GL_COMPRESSED_RGBA_ASTC_10x10_KHR,
+  GL_COMPRESSED_RGBA_ASTC_10x5_KHR,
+  GL_COMPRESSED_RGBA_ASTC_10x6_KHR,
+  GL_COMPRESSED_RGBA_ASTC_10x8_KHR,
+  GL_COMPRESSED_RGBA_ASTC_12x10_KHR,
+  GL_COMPRESSED_RGBA_ASTC_12x12_KHR,
+  GL_COMPRESSED_RGBA_ASTC_4x4_KHR,
+  GL_COMPRESSED_RGBA_ASTC_5x4_KHR,
+  GL_COMPRESSED_RGBA_ASTC_5x5_KHR,
+  GL_COMPRESSED_RGBA_ASTC_6x5_KHR,
+  GL_COMPRESSED_RGBA_ASTC_6x6_KHR,
+  GL_COMPRESSED_RGBA_ASTC_8x5_KHR,
+  GL_COMPRESSED_RGBA_ASTC_8x6_KHR,
+  GL_COMPRESSED_RGBA_ASTC_8x8_KHR,
+  GL_COMPRESSED_RGBA_ATC_EXPLICIT_ALPHA_WEBGL,
+  GL_COMPRESSED_RGBA_ATC_INTERPOLATED_ALPHA_WEBGL,
+  GL_COMPRESSED_RGBA_PVRTC_2BPPV1_IMG,
+  GL_COMPRESSED_RGBA_PVRTC_4BPPV1_IMG,
+  GL_COMPRESSED_RGBA_S3TC_DXT1_EXT,
+  GL_COMPRESSED_RGBA_S3TC_DXT3_EXT,
+  GL_COMPRESSED_RGBA_S3TC_DXT5_EXT,
+  GL_COMPRESSED_SIGNED_R11_EAC,
+  GL_COMPRESSED_SIGNED_RED_GREEN_RGTC2_EXT,
+  GL_COMPRESSED_SIGNED_RED_RGTC1_EXT,
+  GL_COMPRESSED_SIGNED_RG11_EAC,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x10_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x5_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x6_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x8_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_12x10_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_12x12_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_4x4_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_5x4_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_5x5_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_6x5_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_6x6_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x5_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x6_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x8_KHR,
+  GL_COMPRESSED_SRGB8_ALPHA8_ETC2_EAC,
+  GL_COMPRESSED_SRGB8_ETC2,
+  GL_COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2,
+  GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT,
+  GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT,
+  GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT,
+  GL_COMPRESSED_SRGB_S3TC_DXT1_EXT
+} from '../gl-extensions';
+
+const WEBGL_TO_TEXTURE_FORMAT: Record<number, TextureFormat> = {
+  [GL_RGBA32F]: 'rgba32float',
+  [GL_COMPRESSED_RGB_S3TC_DXT1_EXT]: 'bc1-rgb-unorm-webgl',
+  [GL_COMPRESSED_SRGB_S3TC_DXT1_EXT]: 'bc1-rgb-unorm-srgb-webgl',
+  [GL_COMPRESSED_RGBA_S3TC_DXT1_EXT]: 'bc1-rgba-unorm',
+  [GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT]: 'bc1-rgba-unorm-srgb',
+  [GL_COMPRESSED_RGBA_S3TC_DXT3_EXT]: 'bc2-rgba-unorm',
+  [GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT]: 'bc2-rgba-unorm-srgb',
+  [GL_COMPRESSED_RGBA_S3TC_DXT5_EXT]: 'bc3-rgba-unorm',
+  [GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT]: 'bc3-rgba-unorm-srgb',
+  [GL_COMPRESSED_RED_RGTC1_EXT]: 'bc4-r-unorm',
+  [GL_COMPRESSED_SIGNED_RED_RGTC1_EXT]: 'bc4-r-snorm',
+  [GL_COMPRESSED_RED_GREEN_RGTC2_EXT]: 'bc5-rg-unorm',
+  [GL_COMPRESSED_SIGNED_RED_GREEN_RGTC2_EXT]: 'bc5-rg-snorm',
+  [GL_COMPRESSED_RGB8_ETC2]: 'etc2-rgb8unorm',
+  [GL_COMPRESSED_SRGB8_ETC2]: 'etc2-rgb8unorm-srgb',
+  [GL_COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2]: 'etc2-rgb8a1unorm',
+  [GL_COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2]: 'etc2-rgb8a1unorm-srgb',
+  [GL_COMPRESSED_RGBA8_ETC2_EAC]: 'etc2-rgba8unorm',
+  [GL_COMPRESSED_SRGB8_ALPHA8_ETC2_EAC]: 'etc2-rgba8unorm-srgb',
+  [GL_COMPRESSED_R11_EAC]: 'eac-r11unorm',
+  [GL_COMPRESSED_SIGNED_R11_EAC]: 'eac-r11snorm',
+  [GL_COMPRESSED_RG11_EAC]: 'eac-rg11unorm',
+  [GL_COMPRESSED_SIGNED_RG11_EAC]: 'eac-rg11snorm',
+  [GL_COMPRESSED_RGBA_ASTC_4x4_KHR]: 'astc-4x4-unorm',
+  [GL_COMPRESSED_SRGB8_ALPHA8_ASTC_4x4_KHR]: 'astc-4x4-unorm-srgb',
+  [GL_COMPRESSED_RGBA_ASTC_5x4_KHR]: 'astc-5x4-unorm',
+  [GL_COMPRESSED_SRGB8_ALPHA8_ASTC_5x4_KHR]: 'astc-5x4-unorm-srgb',
+  [GL_COMPRESSED_RGBA_ASTC_5x5_KHR]: 'astc-5x5-unorm',
+  [GL_COMPRESSED_SRGB8_ALPHA8_ASTC_5x5_KHR]: 'astc-5x5-unorm-srgb',
+  [GL_COMPRESSED_RGBA_ASTC_6x5_KHR]: 'astc-6x5-unorm',
+  [GL_COMPRESSED_SRGB8_ALPHA8_ASTC_6x5_KHR]: 'astc-6x5-unorm-srgb',
+  [GL_COMPRESSED_RGBA_ASTC_6x6_KHR]: 'astc-6x6-unorm',
+  [GL_COMPRESSED_SRGB8_ALPHA8_ASTC_6x6_KHR]: 'astc-6x6-unorm-srgb',
+  [GL_COMPRESSED_RGBA_ASTC_8x5_KHR]: 'astc-8x5-unorm',
+  [GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x5_KHR]: 'astc-8x5-unorm-srgb',
+  [GL_COMPRESSED_RGBA_ASTC_8x6_KHR]: 'astc-8x6-unorm',
+  [GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x6_KHR]: 'astc-8x6-unorm-srgb',
+  [GL_COMPRESSED_RGBA_ASTC_8x8_KHR]: 'astc-8x8-unorm',
+  [GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x8_KHR]: 'astc-8x8-unorm-srgb',
+  [GL_COMPRESSED_RGBA_ASTC_10x5_KHR]: 'astc-10x5-unorm',
+  [GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x5_KHR]: 'astc-10x5-unorm-srgb',
+  [GL_COMPRESSED_RGBA_ASTC_10x6_KHR]: 'astc-10x6-unorm',
+  [GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x6_KHR]: 'astc-10x6-unorm-srgb',
+  [GL_COMPRESSED_RGBA_ASTC_10x8_KHR]: 'astc-10x8-unorm',
+  [GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x8_KHR]: 'astc-10x8-unorm-srgb',
+  [GL_COMPRESSED_RGBA_ASTC_10x10_KHR]: 'astc-10x10-unorm',
+  [GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x10_KHR]: 'astc-10x10-unorm-srgb',
+  [GL_COMPRESSED_RGBA_ASTC_12x10_KHR]: 'astc-12x10-unorm',
+  [GL_COMPRESSED_SRGB8_ALPHA8_ASTC_12x10_KHR]: 'astc-12x10-unorm-srgb',
+  [GL_COMPRESSED_RGBA_ASTC_12x12_KHR]: 'astc-12x12-unorm',
+  [GL_COMPRESSED_SRGB8_ALPHA8_ASTC_12x12_KHR]: 'astc-12x12-unorm-srgb',
+  [GL_COMPRESSED_RGB_PVRTC_4BPPV1_IMG]: 'pvrtc-rgb4unorm-webgl',
+  [GL_COMPRESSED_RGBA_PVRTC_4BPPV1_IMG]: 'pvrtc-rgba4unorm-webgl',
+  [GL_COMPRESSED_RGB_PVRTC_2BPPV1_IMG]: 'pvrtc-rgb2unorm-webgl',
+  [GL_COMPRESSED_RGBA_PVRTC_2BPPV1_IMG]: 'pvrtc-rgba2unorm-webgl',
+  [GL_COMPRESSED_RGB_ETC1_WEBGL]: 'etc1-rgb-unorm-webgl',
+  [GL_COMPRESSED_RGB_ATC_WEBGL]: 'atc-rgb-unorm-webgl',
+  [GL_COMPRESSED_RGBA_ATC_EXPLICIT_ALPHA_WEBGL]: 'atc-rgba-unorm-webgl',
+  [GL_COMPRESSED_RGBA_ATC_INTERPOLATED_ALPHA_WEBGL]: 'atc-rgbai-unorm-webgl'
+};
+
+const TEXTURE_FORMAT_TO_WEBGL = Object.fromEntries(
+  Object.entries(WEBGL_TO_TEXTURE_FORMAT).map(([format, textureFormat]) => [
+    textureFormat,
+    Number(format)
+  ])
+) as Partial<Record<TextureFormat, GLTextureFormat>>;
+
+export function getTextureFormatFromWebGLFormat(
+  format?: GLTextureFormat
+): TextureFormat | undefined {
+  if (format === undefined) {
+    return undefined;
+  }
+
+  return WEBGL_TO_TEXTURE_FORMAT[format];
+}
+
+/**
+ * Returns the WebGL/OpenGL compressed texture constant for a canonical loaders.gl texture format.
+ * @param textureFormat - Canonical texture format string.
+ * @returns Matching WebGL/OpenGL constant, if known.
+ */
+export function getWebGLFormatFromTextureFormat(
+  textureFormat?: TextureFormat
+): GLTextureFormat | undefined {
+  if (textureFormat === undefined) {
+    return undefined;
+  }
+
+  return TEXTURE_FORMAT_TO_WEBGL[textureFormat];
+}

package/src/npy-worker.ts

@@ -0,0 +1,6 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+// Classic-worker entrypoint that lazily loads the ESM worker implementation.
+import(new URL('./workers/npy-worker.js', import.meta.url).toString());

package/src/radiance-hdr-loader.ts

@@ -0,0 +1,36 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+import type {LoaderWithParser, StrictLoaderOptions} from '@loaders.gl/loader-utils';
+import type {Texture} from '@loaders.gl/schema';
+import {VERSION} from './lib/utils/version';
+import type {RadianceHDRMetadata} from './lib/parsers/parse-hdr';
+import {isHDR, parseHDR} from './lib/parsers/parse-hdr';
+
+export type RadianceHDRLoaderOptions = StrictLoaderOptions & {
+  hdr?: {};
+};
+
+export const RadianceHDRLoader = {
+  dataType: null as unknown as Texture<RadianceHDRMetadata>,
+  batchType: null as never,
+
+  name: 'Radiance HDR',
+  id: 'hdr',
+  module: 'textures',
+  version: VERSION,
+  extensions: ['hdr'],
+  mimeTypes: ['image/vnd.radiance', 'image/x-hdr', 'application/octet-stream'],
+  binary: true,
+  tests: [isHDR],
+  options: {
+    hdr: {}
+  },
+  parseSync: parseHDR,
+  parse: async (arrayBuffer: ArrayBuffer) => parseHDR(arrayBuffer)
+} as const satisfies LoaderWithParser<
+  Texture<RadianceHDRMetadata>,
+  never,
+  RadianceHDRLoaderOptions
+>;

package/src/texture-array-loader.ts

@@ -0,0 +1,46 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+import type {LoaderContext, LoaderWithParser} from '@loaders.gl/loader-utils';
+import type {Texture} from '@loaders.gl/schema';
+import type {TextureLoaderOptions as TextureApiLoaderOptions} from './lib/texture-api/texture-api-types';
+import {VERSION} from './lib/utils/version';
+import {
+  parseCompositeImageManifest,
+  testCompositeImageManifestShape,
+  type ImageTextureArrayManifest
+} from './lib/composite-image/parse-composite-image';
+
+export type TextureArrayLoaderOptions = TextureApiLoaderOptions;
+export type {ImageTextureArrayManifest as TextureArrayManifest};
+
+export const TextureArrayLoader = {
+  dataType: null as unknown as Texture,
+  batchType: null as never,
+  id: 'texture-array',
+  name: 'Texture Array',
+  module: 'textures',
+  version: VERSION,
+  extensions: [],
+  mimeTypes: [],
+  text: true,
+  worker: false,
+  testText: (text: string) => testCompositeImageManifestShape(text, 'image-texture-array'),
+  options: {
+    image: {}
+  },
+  parse: async (
+    arrayBuffer: ArrayBuffer,
+    options?: TextureArrayLoaderOptions,
+    context?: LoaderContext
+  ) =>
+    await parseCompositeImageManifest(
+      new TextDecoder().decode(arrayBuffer),
+      'image-texture-array',
+      options,
+      context
+    ),
+  parseText: async (text: string, options?: TextureArrayLoaderOptions, context?: LoaderContext) =>
+    await parseCompositeImageManifest(text, 'image-texture-array', options, context)
+} as const satisfies LoaderWithParser<Texture, never, TextureArrayLoaderOptions>;

package/src/texture-cube-array-loader.ts

@@ -0,0 +1,49 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+import type {LoaderContext, LoaderWithParser} from '@loaders.gl/loader-utils';
+import type {Texture} from '@loaders.gl/schema';
+import type {TextureLoaderOptions as TextureApiLoaderOptions} from './lib/texture-api/texture-api-types';
+import {VERSION} from './lib/utils/version';
+import {
+  parseCompositeImageManifest,
+  testCompositeImageManifestShape,
+  type ImageTextureCubeArrayManifest
+} from './lib/composite-image/parse-composite-image';
+
+export type TextureCubeArrayLoaderOptions = TextureApiLoaderOptions;
+export type {ImageTextureCubeArrayManifest as TextureCubeArrayManifest};
+
+export const TextureCubeArrayLoader = {
+  dataType: null as unknown as Texture,
+  batchType: null as never,
+  id: 'texture-cube-array',
+  name: 'Texture Cube Array',
+  module: 'textures',
+  version: VERSION,
+  extensions: [],
+  mimeTypes: [],
+  text: true,
+  worker: false,
+  testText: (text: string) => testCompositeImageManifestShape(text, 'image-texture-cube-array'),
+  options: {
+    image: {}
+  },
+  parse: async (
+    arrayBuffer: ArrayBuffer,
+    options?: TextureCubeArrayLoaderOptions,
+    context?: LoaderContext
+  ) =>
+    await parseCompositeImageManifest(
+      new TextDecoder().decode(arrayBuffer),
+      'image-texture-cube-array',
+      options,
+      context
+    ),
+  parseText: async (
+    text: string,
+    options?: TextureCubeArrayLoaderOptions,
+    context?: LoaderContext
+  ) => await parseCompositeImageManifest(text, 'image-texture-cube-array', options, context)
+} as const satisfies LoaderWithParser<Texture, never, TextureCubeArrayLoaderOptions>;

package/src/texture-cube-loader.ts

@@ -0,0 +1,46 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+import type {LoaderContext, LoaderWithParser} from '@loaders.gl/loader-utils';
+import type {Texture} from '@loaders.gl/schema';
+import type {TextureLoaderOptions as TextureApiLoaderOptions} from './lib/texture-api/texture-api-types';
+import {VERSION} from './lib/utils/version';
+import {
+  parseCompositeImageManifest,
+  testCompositeImageManifestShape,
+  type ImageTextureCubeManifest
+} from './lib/composite-image/parse-composite-image';
+
+export type TextureCubeLoaderOptions = TextureApiLoaderOptions;
+export type {ImageTextureCubeManifest as TextureCubeManifest};
+
+export const TextureCubeLoader = {
+  dataType: null as unknown as Texture,
+  batchType: null as never,
+  id: 'texture-cube',
+  name: 'Texture Cube',
+  module: 'textures',
+  version: VERSION,
+  extensions: [],
+  mimeTypes: [],
+  text: true,
+  worker: false,
+  testText: (text: string) => testCompositeImageManifestShape(text, 'image-texture-cube'),
+  options: {
+    image: {}
+  },
+  parse: async (
+    arrayBuffer: ArrayBuffer,
+    options?: TextureCubeLoaderOptions,
+    context?: LoaderContext
+  ) =>
+    await parseCompositeImageManifest(
+      new TextDecoder().decode(arrayBuffer),
+      'image-texture-cube',
+      options,
+      context
+    ),
+  parseText: async (text: string, options?: TextureCubeLoaderOptions, context?: LoaderContext) =>
+    await parseCompositeImageManifest(text, 'image-texture-cube', options, context)
+} as const satisfies LoaderWithParser<Texture, never, TextureCubeLoaderOptions>;

package/src/texture-loader.ts

@@ -0,0 +1,49 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+import type {LoaderContext, LoaderWithParser} from '@loaders.gl/loader-utils';
+import type {Texture} from '@loaders.gl/schema';
+import type {TextureLoaderOptions as TextureApiLoaderOptions} from './lib/texture-api/texture-api-types';
+import {VERSION} from './lib/utils/version';
+import {
+  parseCompositeImageManifest,
+  testCompositeImageManifestShape,
+  type ImageTextureManifest
+} from './lib/composite-image/parse-composite-image';
+
+export type TextureManifestLoaderOptions = TextureApiLoaderOptions;
+export type {ImageTextureManifest as TextureManifest};
+
+export const TextureLoader = {
+  dataType: null as unknown as Texture,
+  batchType: null as never,
+  id: 'texture',
+  name: 'Texture',
+  module: 'textures',
+  version: VERSION,
+  extensions: [],
+  mimeTypes: [],
+  text: true,
+  worker: false,
+  testText: (text: string) => testCompositeImageManifestShape(text, 'image-texture'),
+  options: {
+    image: {}
+  },
+  parse: async (
+    arrayBuffer: ArrayBuffer,
+    options?: TextureManifestLoaderOptions,
+    context?: LoaderContext
+  ) =>
+    await parseCompositeImageManifest(
+      new TextDecoder().decode(arrayBuffer),
+      'image-texture',
+      options,
+      context
+    ),
+  parseText: async (
+    text: string,
+    options?: TextureManifestLoaderOptions,
+    context?: LoaderContext
+  ) => await parseCompositeImageManifest(text, 'image-texture', options, context)
+} as const satisfies LoaderWithParser<Texture, never, TextureManifestLoaderOptions>;

package/src/workers/compressed-texture-worker.ts

@@ -5,5 +5,4 @@
 import {createLoaderWorker} from '@loaders.gl/loader-utils';
 import {CompressedTextureLoader} from '../compressed-texture-loader';
 
-// @ts-expect-error
 createLoaderWorker(CompressedTextureLoader);