@luma.gl/gltf 9.2.6 → 9.3.0-alpha.10

package/dist/parsers/parse-pbr-material.d.ts

@@ -1,8 +1,11 @@
-import type { Device } from '@luma.gl/core';
+import type { Device, SamplerProps, TextureFormat, TypedArray } from '@luma.gl/core';
+import { Texture } from '@luma.gl/core';
+import type { GLTFPostprocessed } from '@loaders.gl/gltf';
 import { type ParsedPBRMaterial } from "../pbr/pbr-material.js";
 import { type PBREnvironment } from "../pbr/pbr-environment.js";
 type GLTFTexture = {
     id: string;
+    index?: number;
     texture: {
         source: {
             image: any;
@@ -23,15 +26,77 @@ type GLTFPBRMetallicRoughness = {
     roughnessFactor?: number;
 };
 type GLTFPBRMaterial = {
+    extensions?: GLTFMaterialExtensions;
     unlit?: boolean;
     pbrMetallicRoughness?: GLTFPBRMetallicRoughness;
     normalTexture?: GLTFTexture;
     occlusionTexture?: GLTFTexture;
     emissiveTexture?: GLTFTexture;
     emissiveFactor?: [number, number, number];
-    alphaMode?: 'MASK' | 'BLEND';
+    alphaMode?: 'OPAQUE' | 'MASK' | 'BLEND';
+    doubleSided?: boolean;
     alphaCutoff?: number;
 };
+type GLTFMaterialSpecularExtension = {
+    specularFactor?: number;
+    specularTexture?: GLTFTexture;
+    specularColorFactor?: [number, number, number];
+    specularColorTexture?: GLTFTexture;
+};
+type GLTFMaterialIorExtension = {
+    ior?: number;
+};
+type GLTFMaterialTransmissionExtension = {
+    transmissionFactor?: number;
+    transmissionTexture?: GLTFTexture;
+};
+type GLTFMaterialVolumeExtension = {
+    thicknessFactor?: number;
+    thicknessTexture?: GLTFTexture;
+    attenuationDistance?: number;
+    attenuationColor?: [number, number, number];
+};
+type GLTFMaterialClearcoatExtension = {
+    clearcoatFactor?: number;
+    clearcoatTexture?: GLTFTexture;
+    clearcoatRoughnessFactor?: number;
+    clearcoatRoughnessTexture?: GLTFTexture;
+    clearcoatNormalTexture?: GLTFTexture;
+};
+type GLTFMaterialSheenExtension = {
+    sheenColorFactor?: [number, number, number];
+    sheenColorTexture?: GLTFTexture;
+    sheenRoughnessFactor?: number;
+    sheenRoughnessTexture?: GLTFTexture;
+};
+type GLTFMaterialIridescenceExtension = {
+    iridescenceFactor?: number;
+    iridescenceTexture?: GLTFTexture;
+    iridescenceIor?: number;
+    iridescenceThicknessMinimum?: number;
+    iridescenceThicknessMaximum?: number;
+    iridescenceThicknessTexture?: GLTFTexture;
+};
+type GLTFMaterialAnisotropyExtension = {
+    anisotropyStrength?: number;
+    anisotropyRotation?: number;
+    anisotropyTexture?: GLTFTexture;
+};
+type GLTFMaterialEmissiveStrengthExtension = {
+    emissiveStrength?: number;
+};
+type GLTFMaterialExtensions = {
+    KHR_materials_unlit?: Record<string, never>;
+    KHR_materials_specular?: GLTFMaterialSpecularExtension;
+    KHR_materials_ior?: GLTFMaterialIorExtension;
+    KHR_materials_transmission?: GLTFMaterialTransmissionExtension;
+    KHR_materials_volume?: GLTFMaterialVolumeExtension;
+    KHR_materials_clearcoat?: GLTFMaterialClearcoatExtension;
+    KHR_materials_sheen?: GLTFMaterialSheenExtension;
+    KHR_materials_iridescence?: GLTFMaterialIridescenceExtension;
+    KHR_materials_anisotropy?: GLTFMaterialAnisotropyExtension;
+    KHR_materials_emissive_strength?: GLTFMaterialEmissiveStrengthExtension;
+};
 export type ParsePBRMaterialOptions = {
     /** Debug PBR shader */
     pbrDebug?: boolean;
@@ -41,10 +106,58 @@ export type ParsePBRMaterialOptions = {
     useTangents?: boolean;
     /** provide an image based (texture cube) lighting environment */
     imageBasedLightingEnvironment?: PBREnvironment;
+    /** parent post-processed glTF, used to resolve extension texture infos */
+    gltf?: GLTFPostprocessed;
+    /** run primitive-attribute diagnostics such as missing TEXCOORD_0 / NORMAL */
+    validateAttributes?: boolean;
 };
 /**
  * Parses a GLTF material definition into uniforms and parameters for the PBR shader module
  */
 export declare function parsePBRMaterial(device: Device, material: GLTFPBRMaterial, attributes: Record<string, any>, options: ParsePBRMaterialOptions): ParsedPBRMaterial;
+/** One mip level as produced by loaders.gl compressed texture parsers */
+export type CompressedMipLevel = {
+    data: TypedArray;
+    width: number;
+    height: number;
+    textureFormat?: TextureFormat;
+};
+/**
+ * Compressed image from current loaders.gl releases.
+ * - `mipmaps` is a boolean (true), NOT an array
+ * - `data` is an Array of TextureLevel-like objects
+ * - Per-level `textureFormat` is already a luma.gl TextureFormat
+ * - Top-level `width`/`height` may be undefined
+ */
+export type CompressedImageDataArray = {
+    compressed: true;
+    mipmaps?: boolean;
+    width?: number;
+    height?: number;
+    data: CompressedMipLevel[];
+};
+/**
+ * Hypothetical future format where `mipmaps` is an actual array.
+ * Kept for forward compatibility.
+ */
+export type CompressedImageMipmapArray = {
+    compressed: true;
+    width?: number;
+    height?: number;
+    mipmaps: CompressedMipLevel[];
+};
+/** Union of all known loaders.gl compressed image shapes */
+export type CompressedImage = CompressedImageDataArray | CompressedImageMipmapArray;
+/**
+ * Create a texture from compressed image data produced by loaders.gl.
+ * Handles current loaders.gl compressed image layouts:
+ *
+ *   current:      {compressed, mipmaps: true, data: [{data, width, height, textureFormat}, ...]}
+ *   forward:      {compressed, mipmaps: [{data, width, height, textureFormat}, ...]}
+ */
+export declare function createCompressedTexture(device: Device, image: CompressedImage, baseOptions: {
+    id: string;
+    sampler: SamplerProps;
+}): Texture;
 export {};
 //# sourceMappingURL=parse-pbr-material.d.ts.map

package/dist/parsers/parse-pbr-material.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-pbr-material.d.ts","sourceRoot":"","sources":["../../src/parsers/parse-pbr-material.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,MAAM,EAAU,MAAM,eAAe,CAAC;AAInD,OAAO,EAAC,KAAK,iBAAiB,EAAC,+BAA4B;AAC3D,OAAO,EAAC,KAAK,cAAc,EAAC,kCAA+B;AAS3D,KAAK,WAAW,GAAG;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE;QAAC,MAAM,EAAE;YAAC,KAAK,EAAE,GAAG,CAAA;SAAC,CAAC;QAAC,OAAO,EAAE;YAAC,UAAU,EAAE,GAAG,CAAA;SAAC,CAAA;KAAC,CAAC;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC9B,gBAAgB,CAAC,EAAE,WAAW,CAAC;IAC/B,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,wBAAwB,CAAC,EAAE,WAAW,CAAC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oBAAoB,CAAC,EAAE,wBAAwB,CAAC;IAChD,aAAa,CAAC,EAAE,WAAW,CAAC;IAC5B,gBAAgB,CAAC,EAAE,WAAW,CAAC;IAC/B,eAAe,CAAC,EAAE,WAAW,CAAC;IAC9B,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,uBAAuB;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oBAAoB;IACpB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,mBAAmB;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iEAAiE;IACjE,6BAA6B,CAAC,EAAE,cAAc,CAAC;CAChD,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,eAAe,EACzB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,OAAO,EAAE,uBAAuB,GAC/B,iBAAiB,CAmDnB"}
+{"version":3,"file":"parse-pbr-material.d.ts","sourceRoot":"","sources":["../../src/parsers/parse-pbr-material.ts"],"names":[],"mappings":"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"}