@onerjs/loaders 8.46.4 → 8.46.8

package/glTF/2.0/materialLoadingAdapter.d.ts

@@ -2,7 +2,6 @@ import { type Material } from "@onerjs/core/Materials/material.js";
 import { type BaseTexture } from "@onerjs/core/Materials/Textures/baseTexture.js";
 import { type Nullable } from "@onerjs/core/types.js";
 import { type Color3 } from "@onerjs/core/Maths/math.color.js";
-import { type Vector3 } from "@onerjs/core/Maths/math.vector.js";
 /**
  * Interface for material loading adapters that provides a unified OpenPBR-like interface
  * for both OpenPBR and PBR materials, eliminating conditional branches in extensions.
@@ -12,6 +11,10 @@ export interface IMaterialLoadingAdapter {
      * Gets the underlying material
      */
     readonly material: Material;
+    /**
+     * Finalizes material properties after loading is complete.
+     */
+    finalize?(): void;
     /**
      * Whether the material should be treated as unlit
      */
@@ -193,6 +196,10 @@ export interface IMaterialLoadingAdapter {
      * Sets the scattering coefficient
      */
     transmissionScatter: Color3;
+    /**
+     * Sets the transmission scatter texture
+     */
+    transmissionScatterTexture: Nullable<BaseTexture>;
     /**
      * Sets the scattering anisotropy (-1 to 1)
      */
@@ -213,6 +220,11 @@ export interface IMaterialLoadingAdapter {
      * Configures transmission for thin-surface transmission (KHR_materials_transmission)
      */
     configureTransmission(): void;
+    configureVolume(): void;
+    /**
+     * Sets whether the material is thin-walled (i.e. non-volumetric) or not.
+     */
+    geometryThinWalled: boolean;
     /**
      * Sets the thickness texture
      */
@@ -225,11 +237,6 @@ export interface IMaterialLoadingAdapter {
      * Configures subsurface properties
      */
     configureSubsurface(): void;
-    /**
-     * @internal
-     * Sets/gets the extinction coefficient
-     */
-    extinctionCoefficient: Vector3;
     /**
      * Sets/gets the subsurface weight
      */
@@ -247,13 +254,13 @@ export interface IMaterialLoadingAdapter {
      */
     subsurfaceColorTexture: Nullable<BaseTexture>;
     /**
-     * Sets/gets the surface tint of the material (when using subsurface scattering)
+     * Sets/gets the diffuse transmission tint of the material
      */
-    subsurfaceConstantTint: Color3;
+    diffuseTransmissionTint: Color3;
     /**
-     * Sets/gets the surface tint texture of the material (when using subsurface scattering)
+     * Sets/gets the diffuse transmission tint texture of the material
      */
-    subsurfaceConstantTintTexture: Nullable<BaseTexture>;
+    diffuseTransmissionTintTexture: Nullable<BaseTexture>;
     /**
      * Sets/gets the subsurface radius (used for subsurface scattering)
      */
@@ -266,6 +273,10 @@ export interface IMaterialLoadingAdapter {
      * Sets/gets the subsurface scattering anisotropy
      */
     subsurfaceScatterAnisotropy: number;
+    /**
+     * Does this material have a translucent surface (i.e. either transmission or subsurface)?
+     */
+    isTranslucent(): boolean;
     /**
      * Configures initial settings for fuzz for material.
      */

package/glTF/2.0/materialLoadingAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"materialLoadingAdapter.js","sourceRoot":"","sources":["../../../../../dev/loaders/src/glTF/2.0/materialLoadingAdapter.ts"],"names":[],"mappings":"","sourcesContent":["import { type Material } from \"core/Materials/material\";\r\nimport { type BaseTexture } from \"core/Materials/Textures/baseTexture\";\r\nimport { type Nullable } from \"core/types\";\r\nimport { type Color3 } from \"core/Maths/math.color\";\r\nimport { type Vector3 } from \"core/Maths/math.vector\";\r\n\r\n/**\r\n * Interface for material loading adapters that provides a unified OpenPBR-like interface\r\n * for both OpenPBR and PBR materials, eliminating conditional branches in extensions.\r\n */\r\nexport interface IMaterialLoadingAdapter {\r\n    /**\r\n     * Gets the underlying material\r\n     */\r\n    readonly material: Material;\r\n\r\n    /**\r\n     * Whether the material should be treated as unlit\r\n     */\r\n    isUnlit: boolean;\r\n\r\n    // ========================================\r\n    // CULLING PROPERTIES\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the back face culling\r\n     */\r\n    backFaceCulling: boolean;\r\n\r\n    /**\r\n     * Sets/gets the two sided lighting\r\n     */\r\n    twoSidedLighting: boolean;\r\n\r\n    // ========================================\r\n    // ALPHA PROPERTIES\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the alpha cutoff value (used for alpha test mode)\r\n     */\r\n    alphaCutOff: number;\r\n\r\n    /**\r\n     * Sets/gets whether to use alpha from albedo/base color texture\r\n     */\r\n    useAlphaFromBaseColorTexture: boolean;\r\n\r\n    /**\r\n     * Sets/Gets whether the transparency is treated as alpha coverage\r\n     */\r\n    transparencyAsAlphaCoverage: boolean;\r\n\r\n    // ========================================\r\n    // BASE PARAMETERS\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the base color\r\n     */\r\n    baseColor: Color3;\r\n\r\n    /**\r\n     * Sets/gets the base color texture\r\n     */\r\n    baseColorTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the base diffuse roughness\r\n     */\r\n    baseDiffuseRoughness: number;\r\n\r\n    /**\r\n     * Sets/gets the base diffuse roughness texture\r\n     */\r\n    baseDiffuseRoughnessTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the base metalness\r\n     */\r\n    baseMetalness: number;\r\n\r\n    /**\r\n     * Sets/gets the base metalness texture\r\n     */\r\n    baseMetalnessTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets whether to use roughness from metallic texture green channel\r\n     */\r\n    useRoughnessFromMetallicTextureGreen: boolean;\r\n\r\n    /**\r\n     * Sets whether to use metallic from metallic texture blue channel\r\n     */\r\n    useMetallicFromMetallicTextureBlue: boolean;\r\n\r\n    // ========================================\r\n    // SPECULAR PARAMETERS\r\n    // ========================================\r\n\r\n    /**\r\n     * Configures specular properties and enables OpenPBR BRDF model for edge color support\r\n     * @param enableEdgeColor - Whether to enable edge color support\r\n     */\r\n    enableSpecularEdgeColor(enableEdgeColor?: boolean): void;\r\n\r\n    /**\r\n     * Sets/gets the specular weight\r\n     */\r\n    specularWeight: number;\r\n\r\n    /**\r\n     * Sets/gets the specular weight texture\r\n     */\r\n    specularWeightTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the specular color\r\n     */\r\n    specularColor: Color3;\r\n\r\n    /**\r\n     * Sets/gets the specular color texture\r\n     */\r\n    specularColorTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the specular roughness\r\n     */\r\n    specularRoughness: number;\r\n\r\n    /**\r\n     * Sets/gets the specular roughness texture\r\n     */\r\n    specularRoughnessTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the specular IOR\r\n     */\r\n    specularIor: number;\r\n\r\n    // ========================================\r\n    // EMISSION PARAMETERS\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the emissive color\r\n     */\r\n    emissionColor: Color3;\r\n\r\n    /**\r\n     * Sets/gets the emissive luminance\r\n     */\r\n    emissionLuminance: number;\r\n\r\n    /**\r\n     * Sets/gets the emissive texture\r\n     */\r\n    emissionColorTexture: Nullable<BaseTexture>;\r\n\r\n    // ========================================\r\n    // AMBIENT OCCLUSION\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the ambient occlusion texture\r\n     */\r\n    ambientOcclusionTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the ambient occlusion texture strength/level\r\n     */\r\n    ambientOcclusionTextureStrength: number;\r\n\r\n    // ========================================\r\n    // COAT PARAMETERS\r\n    // ========================================\r\n\r\n    /**\r\n     * Configures clear coat for PBR material\r\n     */\r\n    configureCoat(): void;\r\n\r\n    /**\r\n     * Sets/gets the coat weight\r\n     */\r\n    coatWeight: number;\r\n\r\n    /**\r\n     * Sets/gets the coat weight texture\r\n     */\r\n    coatWeightTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the coat color\r\n     */\r\n    coatColor: Color3;\r\n\r\n    /**\r\n     * Sets the coat color texture\r\n     */\r\n    coatColorTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the coat roughness\r\n     */\r\n    coatRoughness: number;\r\n\r\n    /**\r\n     * Sets/gets the coat roughness texture\r\n     */\r\n    coatRoughnessTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the coat index of refraction (IOR)\r\n     */\r\n    coatIor: number;\r\n\r\n    /**\r\n     * Sets the coat darkening\r\n     */\r\n    coatDarkening: number;\r\n\r\n    /**\r\n     * Sets the coat darkening texture\r\n     */\r\n    coatDarkeningTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the coat roughness anisotropy\r\n     */\r\n    coatRoughnessAnisotropy: number;\r\n\r\n    /**\r\n     * Sets the coat tangent angle for anisotropy\r\n     */\r\n    geometryCoatTangentAngle: number;\r\n\r\n    /**\r\n     * Sets the coat tangent texture for anisotropy\r\n     */\r\n    geometryCoatTangentTexture: Nullable<BaseTexture>;\r\n\r\n    // ========================================\r\n    // TRANSMISSION LAYER\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets the transmission weight\r\n     */\r\n    transmissionWeight: number;\r\n\r\n    /**\r\n     * Sets the transmission weight texture\r\n     */\r\n    transmissionWeightTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the attenuation distance\r\n     */\r\n    transmissionDepth: number;\r\n\r\n    /**\r\n     * Sets the attenuation color\r\n     */\r\n    transmissionColor: Color3;\r\n\r\n    /**\r\n     * Sets the scattering coefficient\r\n     */\r\n    transmissionScatter: Color3;\r\n\r\n    /**\r\n     * Sets the scattering anisotropy (-1 to 1)\r\n     */\r\n    transmissionScatterAnisotropy: number;\r\n\r\n    /**\r\n     * Sets the dispersion Abbe number\r\n     */\r\n    transmissionDispersionAbbeNumber: number;\r\n\r\n    /**\r\n     * Sets the dispersion scale\r\n     */\r\n    transmissionDispersionScale: number;\r\n\r\n    /**\r\n     * The refraction background texture\r\n     */\r\n    refractionBackgroundTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Configures transmission for thin-surface transmission (KHR_materials_transmission)\r\n     */\r\n    configureTransmission(): void;\r\n\r\n    // ========================================\r\n    // VOLUME PROPERTIES\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets the thickness texture\r\n     */\r\n    volumeThicknessTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the thickness factor\r\n     */\r\n    volumeThickness: number;\r\n\r\n    // ========================================\r\n    // SUBSURFACE PROPERTIES (Subsurface Scattering)\r\n    // ========================================\r\n\r\n    /**\r\n     * Configures subsurface properties\r\n     */\r\n    configureSubsurface(): void;\r\n\r\n    /**\r\n     * @internal\r\n     * Sets/gets the extinction coefficient\r\n     */\r\n    extinctionCoefficient: Vector3;\r\n\r\n    /**\r\n     * Sets/gets the subsurface weight\r\n     */\r\n    subsurfaceWeight: number;\r\n\r\n    /**\r\n     * Sets/gets the subsurface weight texture\r\n     */\r\n    subsurfaceWeightTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the subsurface color\r\n     */\r\n    subsurfaceColor: Color3;\r\n\r\n    /**\r\n     * Sets/gets the subsurface color texture\r\n     */\r\n    subsurfaceColorTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the surface tint of the material (when using subsurface scattering)\r\n     */\r\n    subsurfaceConstantTint: Color3;\r\n\r\n    /**\r\n     * Sets/gets the surface tint texture of the material (when using subsurface scattering)\r\n     */\r\n    subsurfaceConstantTintTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the subsurface radius (used for subsurface scattering)\r\n     */\r\n    subsurfaceRadius: number;\r\n\r\n    /**\r\n     * Sets/gets the subsurface radius scale (used for subsurface scattering)\r\n     */\r\n    subsurfaceRadiusScale: Color3;\r\n\r\n    /**\r\n     * Sets/gets the subsurface scattering anisotropy\r\n     */\r\n    subsurfaceScatterAnisotropy: number;\r\n\r\n    // ========================================\r\n    // FUZZ LAYER (Sheen)\r\n    // ========================================\r\n\r\n    /**\r\n     * Configures initial settings for fuzz for material.\r\n     */\r\n    configureFuzz(): void;\r\n\r\n    /**\r\n     * Sets the fuzz weight\r\n     */\r\n    fuzzWeight: number;\r\n\r\n    /**\r\n     * Sets the fuzz weight texture\r\n     */\r\n    fuzzWeightTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the fuzz color\r\n     */\r\n    fuzzColor: Color3;\r\n\r\n    /**\r\n     * Sets the fuzz color texture\r\n     */\r\n    fuzzColorTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the fuzz roughness\r\n     */\r\n    fuzzRoughness: number;\r\n\r\n    /**\r\n     * Sets the fuzz roughness texture\r\n     */\r\n    fuzzRoughnessTexture: Nullable<BaseTexture>;\r\n\r\n    // ========================================\r\n    // ANISOTROPY\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the specular roughness anisotropy\r\n     */\r\n    specularRoughnessAnisotropy: number;\r\n\r\n    /**\r\n     * Sets the anisotropy rotation\r\n     */\r\n    geometryTangentAngle: number;\r\n\r\n    /**\r\n     * Sets/gets the anisotropy texture\r\n     */\r\n    geometryTangentTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Configures glTF-style anisotropy for OpenPBR materials\r\n     * @param useGltfStyle - Whether to use glTF-style anisotropy (default: true)\r\n     */\r\n    configureGltfStyleAnisotropy(useGltfStyle?: boolean): void;\r\n\r\n    // ========================================\r\n    // THIN FILM IRIDESCENCE\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets the thin film weight\r\n     */\r\n    thinFilmWeight: number;\r\n\r\n    /**\r\n     * Sets the thin film IOR\r\n     */\r\n    thinFilmIor: number;\r\n\r\n    /**\r\n     * Sets the thin film thickness minimum\r\n     */\r\n    thinFilmThicknessMinimum: number;\r\n\r\n    /**\r\n     * Sets the thin film thickness maximum\r\n     */\r\n    thinFilmThicknessMaximum: number;\r\n\r\n    /**\r\n     * Sets the thin film iridescence texture\r\n     */\r\n    thinFilmWeightTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the thin film thickness texture\r\n     */\r\n    thinFilmThicknessTexture: Nullable<BaseTexture>;\r\n\r\n    // ========================================\r\n    // UNLIT MATERIALS\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets the unlit flag\r\n     */\r\n    unlit: boolean;\r\n\r\n    // ========================================\r\n    // GEOMETRY PARAMETERS\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the geometry opacity\r\n     */\r\n    geometryOpacity: number;\r\n\r\n    /**\r\n     * Sets/gets the geometry normal texture\r\n     */\r\n    geometryNormalTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the normal map inversions for PBR material only\r\n     * @param invertX - Whether to invert the normal map on the X axis\r\n     * @param invertY - Whether to invert the normal map on the Y axis\r\n     */\r\n    setNormalMapInversions(invertX: boolean, invertY: boolean): void;\r\n\r\n    /**\r\n     * Sets/gets the coat normal texture\r\n     */\r\n    geometryCoatNormalTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the coat normal texture scale\r\n     */\r\n    geometryCoatNormalTextureScale: number;\r\n}\r\n"]}
+{"version":3,"file":"materialLoadingAdapter.js","sourceRoot":"","sources":["../../../../../dev/loaders/src/glTF/2.0/materialLoadingAdapter.ts"],"names":[],"mappings":"","sourcesContent":["import { type Material } from \"core/Materials/material\";\r\nimport { type BaseTexture } from \"core/Materials/Textures/baseTexture\";\r\nimport { type Nullable } from \"core/types\";\r\nimport { type Color3 } from \"core/Maths/math.color\";\r\n\r\n/**\r\n * Interface for material loading adapters that provides a unified OpenPBR-like interface\r\n * for both OpenPBR and PBR materials, eliminating conditional branches in extensions.\r\n */\r\nexport interface IMaterialLoadingAdapter {\r\n    /**\r\n     * Gets the underlying material\r\n     */\r\n    readonly material: Material;\r\n\r\n    /**\r\n     * Finalizes material properties after loading is complete.\r\n     */\r\n    finalize?(): void;\r\n\r\n    /**\r\n     * Whether the material should be treated as unlit\r\n     */\r\n    isUnlit: boolean;\r\n\r\n    // ========================================\r\n    // CULLING PROPERTIES\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the back face culling\r\n     */\r\n    backFaceCulling: boolean;\r\n\r\n    /**\r\n     * Sets/gets the two sided lighting\r\n     */\r\n    twoSidedLighting: boolean;\r\n\r\n    // ========================================\r\n    // ALPHA PROPERTIES\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the alpha cutoff value (used for alpha test mode)\r\n     */\r\n    alphaCutOff: number;\r\n\r\n    /**\r\n     * Sets/gets whether to use alpha from albedo/base color texture\r\n     */\r\n    useAlphaFromBaseColorTexture: boolean;\r\n\r\n    /**\r\n     * Sets/Gets whether the transparency is treated as alpha coverage\r\n     */\r\n    transparencyAsAlphaCoverage: boolean;\r\n\r\n    // ========================================\r\n    // BASE PARAMETERS\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the base color\r\n     */\r\n    baseColor: Color3;\r\n\r\n    /**\r\n     * Sets/gets the base color texture\r\n     */\r\n    baseColorTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the base diffuse roughness\r\n     */\r\n    baseDiffuseRoughness: number;\r\n\r\n    /**\r\n     * Sets/gets the base diffuse roughness texture\r\n     */\r\n    baseDiffuseRoughnessTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the base metalness\r\n     */\r\n    baseMetalness: number;\r\n\r\n    /**\r\n     * Sets/gets the base metalness texture\r\n     */\r\n    baseMetalnessTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets whether to use roughness from metallic texture green channel\r\n     */\r\n    useRoughnessFromMetallicTextureGreen: boolean;\r\n\r\n    /**\r\n     * Sets whether to use metallic from metallic texture blue channel\r\n     */\r\n    useMetallicFromMetallicTextureBlue: boolean;\r\n\r\n    // ========================================\r\n    // SPECULAR PARAMETERS\r\n    // ========================================\r\n\r\n    /**\r\n     * Configures specular properties and enables OpenPBR BRDF model for edge color support\r\n     * @param enableEdgeColor - Whether to enable edge color support\r\n     */\r\n    enableSpecularEdgeColor(enableEdgeColor?: boolean): void;\r\n\r\n    /**\r\n     * Sets/gets the specular weight\r\n     */\r\n    specularWeight: number;\r\n\r\n    /**\r\n     * Sets/gets the specular weight texture\r\n     */\r\n    specularWeightTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the specular color\r\n     */\r\n    specularColor: Color3;\r\n\r\n    /**\r\n     * Sets/gets the specular color texture\r\n     */\r\n    specularColorTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the specular roughness\r\n     */\r\n    specularRoughness: number;\r\n\r\n    /**\r\n     * Sets/gets the specular roughness texture\r\n     */\r\n    specularRoughnessTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the specular IOR\r\n     */\r\n    specularIor: number;\r\n\r\n    // ========================================\r\n    // EMISSION PARAMETERS\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the emissive color\r\n     */\r\n    emissionColor: Color3;\r\n\r\n    /**\r\n     * Sets/gets the emissive luminance\r\n     */\r\n    emissionLuminance: number;\r\n\r\n    /**\r\n     * Sets/gets the emissive texture\r\n     */\r\n    emissionColorTexture: Nullable<BaseTexture>;\r\n\r\n    // ========================================\r\n    // AMBIENT OCCLUSION\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the ambient occlusion texture\r\n     */\r\n    ambientOcclusionTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the ambient occlusion texture strength/level\r\n     */\r\n    ambientOcclusionTextureStrength: number;\r\n\r\n    // ========================================\r\n    // COAT PARAMETERS\r\n    // ========================================\r\n\r\n    /**\r\n     * Configures clear coat for PBR material\r\n     */\r\n    configureCoat(): void;\r\n\r\n    /**\r\n     * Sets/gets the coat weight\r\n     */\r\n    coatWeight: number;\r\n\r\n    /**\r\n     * Sets/gets the coat weight texture\r\n     */\r\n    coatWeightTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the coat color\r\n     */\r\n    coatColor: Color3;\r\n\r\n    /**\r\n     * Sets the coat color texture\r\n     */\r\n    coatColorTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the coat roughness\r\n     */\r\n    coatRoughness: number;\r\n\r\n    /**\r\n     * Sets/gets the coat roughness texture\r\n     */\r\n    coatRoughnessTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the coat index of refraction (IOR)\r\n     */\r\n    coatIor: number;\r\n\r\n    /**\r\n     * Sets the coat darkening\r\n     */\r\n    coatDarkening: number;\r\n\r\n    /**\r\n     * Sets the coat darkening texture\r\n     */\r\n    coatDarkeningTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the coat roughness anisotropy\r\n     */\r\n    coatRoughnessAnisotropy: number;\r\n\r\n    /**\r\n     * Sets the coat tangent angle for anisotropy\r\n     */\r\n    geometryCoatTangentAngle: number;\r\n\r\n    /**\r\n     * Sets the coat tangent texture for anisotropy\r\n     */\r\n    geometryCoatTangentTexture: Nullable<BaseTexture>;\r\n\r\n    // ========================================\r\n    // TRANSMISSION LAYER\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets the transmission weight\r\n     */\r\n    transmissionWeight: number;\r\n\r\n    /**\r\n     * Sets the transmission weight texture\r\n     */\r\n    transmissionWeightTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the attenuation distance\r\n     */\r\n    transmissionDepth: number;\r\n\r\n    /**\r\n     * Sets the attenuation color\r\n     */\r\n    transmissionColor: Color3;\r\n\r\n    /**\r\n     * Sets the scattering coefficient\r\n     */\r\n    transmissionScatter: Color3;\r\n\r\n    /**\r\n     * Sets the transmission scatter texture\r\n     */\r\n    transmissionScatterTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the scattering anisotropy (-1 to 1)\r\n     */\r\n    transmissionScatterAnisotropy: number;\r\n\r\n    /**\r\n     * Sets the dispersion Abbe number\r\n     */\r\n    transmissionDispersionAbbeNumber: number;\r\n\r\n    /**\r\n     * Sets the dispersion scale\r\n     */\r\n    transmissionDispersionScale: number;\r\n\r\n    /**\r\n     * The refraction background texture\r\n     */\r\n    refractionBackgroundTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Configures transmission for thin-surface transmission (KHR_materials_transmission)\r\n     */\r\n    configureTransmission(): void;\r\n\r\n    // ========================================\r\n    // VOLUME PROPERTIES\r\n    // ========================================\r\n\r\n    configureVolume(): void;\r\n\r\n    /**\r\n     * Sets whether the material is thin-walled (i.e. non-volumetric) or not.\r\n     */\r\n    geometryThinWalled: boolean;\r\n\r\n    /**\r\n     * Sets the thickness texture\r\n     */\r\n    volumeThicknessTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the thickness factor\r\n     */\r\n    volumeThickness: number;\r\n\r\n    // ========================================\r\n    // SUBSURFACE PROPERTIES (Subsurface Scattering)\r\n    // ========================================\r\n\r\n    /**\r\n     * Configures subsurface properties\r\n     */\r\n    configureSubsurface(): void;\r\n\r\n    /**\r\n     * Sets/gets the subsurface weight\r\n     */\r\n    subsurfaceWeight: number;\r\n\r\n    /**\r\n     * Sets/gets the subsurface weight texture\r\n     */\r\n    subsurfaceWeightTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the subsurface color\r\n     */\r\n    subsurfaceColor: Color3;\r\n\r\n    /**\r\n     * Sets/gets the subsurface color texture\r\n     */\r\n    subsurfaceColorTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the diffuse transmission tint of the material\r\n     */\r\n    diffuseTransmissionTint: Color3;\r\n\r\n    /**\r\n     * Sets/gets the diffuse transmission tint texture of the material\r\n     */\r\n    diffuseTransmissionTintTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the subsurface radius (used for subsurface scattering)\r\n     */\r\n    subsurfaceRadius: number;\r\n\r\n    /**\r\n     * Sets/gets the subsurface radius scale (used for subsurface scattering)\r\n     */\r\n    subsurfaceRadiusScale: Color3;\r\n\r\n    /**\r\n     * Sets/gets the subsurface scattering anisotropy\r\n     */\r\n    subsurfaceScatterAnisotropy: number;\r\n\r\n    /**\r\n     * Does this material have a translucent surface (i.e. either transmission or subsurface)?\r\n     */\r\n    isTranslucent(): boolean;\r\n\r\n    // ========================================\r\n    // FUZZ LAYER (Sheen)\r\n    // ========================================\r\n\r\n    /**\r\n     * Configures initial settings for fuzz for material.\r\n     */\r\n    configureFuzz(): void;\r\n\r\n    /**\r\n     * Sets the fuzz weight\r\n     */\r\n    fuzzWeight: number;\r\n\r\n    /**\r\n     * Sets the fuzz weight texture\r\n     */\r\n    fuzzWeightTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the fuzz color\r\n     */\r\n    fuzzColor: Color3;\r\n\r\n    /**\r\n     * Sets the fuzz color texture\r\n     */\r\n    fuzzColorTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the fuzz roughness\r\n     */\r\n    fuzzRoughness: number;\r\n\r\n    /**\r\n     * Sets the fuzz roughness texture\r\n     */\r\n    fuzzRoughnessTexture: Nullable<BaseTexture>;\r\n\r\n    // ========================================\r\n    // ANISOTROPY\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the specular roughness anisotropy\r\n     */\r\n    specularRoughnessAnisotropy: number;\r\n\r\n    /**\r\n     * Sets the anisotropy rotation\r\n     */\r\n    geometryTangentAngle: number;\r\n\r\n    /**\r\n     * Sets/gets the anisotropy texture\r\n     */\r\n    geometryTangentTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Configures glTF-style anisotropy for OpenPBR materials\r\n     * @param useGltfStyle - Whether to use glTF-style anisotropy (default: true)\r\n     */\r\n    configureGltfStyleAnisotropy(useGltfStyle?: boolean): void;\r\n\r\n    // ========================================\r\n    // THIN FILM IRIDESCENCE\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets the thin film weight\r\n     */\r\n    thinFilmWeight: number;\r\n\r\n    /**\r\n     * Sets the thin film IOR\r\n     */\r\n    thinFilmIor: number;\r\n\r\n    /**\r\n     * Sets the thin film thickness minimum\r\n     */\r\n    thinFilmThicknessMinimum: number;\r\n\r\n    /**\r\n     * Sets the thin film thickness maximum\r\n     */\r\n    thinFilmThicknessMaximum: number;\r\n\r\n    /**\r\n     * Sets the thin film iridescence texture\r\n     */\r\n    thinFilmWeightTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the thin film thickness texture\r\n     */\r\n    thinFilmThicknessTexture: Nullable<BaseTexture>;\r\n\r\n    // ========================================\r\n    // UNLIT MATERIALS\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets the unlit flag\r\n     */\r\n    unlit: boolean;\r\n\r\n    // ========================================\r\n    // GEOMETRY PARAMETERS\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the geometry opacity\r\n     */\r\n    geometryOpacity: number;\r\n\r\n    /**\r\n     * Sets/gets the geometry normal texture\r\n     */\r\n    geometryNormalTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the normal map inversions for PBR material only\r\n     * @param invertX - Whether to invert the normal map on the X axis\r\n     * @param invertY - Whether to invert the normal map on the Y axis\r\n     */\r\n    setNormalMapInversions(invertX: boolean, invertY: boolean): void;\r\n\r\n    /**\r\n     * Sets/gets the coat normal texture\r\n     */\r\n    geometryCoatNormalTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the coat normal texture scale\r\n     */\r\n    geometryCoatNormalTextureScale: number;\r\n}\r\n"]}

package/glTF/2.0/openpbrMaterialLoadingAdapter.d.ts

@@ -4,13 +4,11 @@ import { type BaseTexture } from "@onerjs/core/Materials/Textures/baseTexture.js
 import { type Nullable } from "@onerjs/core/types.js";
 import { Color3 } from "@onerjs/core/Maths/math.color.js";
 import { type IMaterialLoadingAdapter } from "./materialLoadingAdapter.js";
-import { Vector3 } from "@onerjs/core/Maths/math.vector.js";
 /**
  * Material Loading Adapter for OpenPBR materials that provides a unified OpenPBR-like interface.
  */
 export declare class OpenPBRMaterialLoadingAdapter implements IMaterialLoadingAdapter {
     private _material;
-    private _extinctionCoefficient;
     /**
      * Creates a new instance of the OpenPBRMaterialLoadingAdapter.
      * @param material - The OpenPBR material to adapt.
@@ -402,7 +400,15 @@ export declare class OpenPBRMaterialLoadingAdapter implements IMaterialLoadingAd
      * @returns The scatter coefficient as a Vector3
      */
     get transmissionScatter(): Color3;
+    /**
+     * Sets the transmission scatter texture.
+     * @param value The transmission scatter texture or null
+     */
     set transmissionScatterTexture(value: Nullable<BaseTexture>);
+    /**
+     * Gets the transmission scatter texture.
+     * @returns The transmission scatter texture or null
+     */
     get transmissionScatterTexture(): Nullable<BaseTexture>;
     /**
      * Sets the transmission scattering anisotropy.
@@ -447,6 +453,15 @@ export declare class OpenPBRMaterialLoadingAdapter implements IMaterialLoadingAd
      * @param value The refraction background texture or null
      */
     set refractionBackgroundTexture(value: Nullable<BaseTexture>);
+    configureVolume(): void;
+    /**
+     * Sets whether the material is thin-walled (i.e. non-volumetric) or not.
+     */
+    set geometryThinWalled(value: boolean);
+    /**
+     * Gets whether the material is thin-walled (i.e. non-volumetric) or not.
+     */
+    get geometryThinWalled(): boolean;
     /**
      * Sets the thickness texture.
      * @param value The thickness texture or null
@@ -461,15 +476,6 @@ export declare class OpenPBRMaterialLoadingAdapter implements IMaterialLoadingAd
      * Configures subsurface properties for PBR material
      */
     configureSubsurface(): void;
-    /**
-     * Sets the extinction coefficient of the volume.
-     * @param value The extinction coefficient as a Vector3
-     */
-    set extinctionCoefficient(value: Vector3);
-    /**
-     * Gets the extinction coefficient of the volume.
-     */
-    get extinctionCoefficient(): Vector3;
     /**
      * Sets the subsurface weight
      */
@@ -489,18 +495,20 @@ export declare class OpenPBRMaterialLoadingAdapter implements IMaterialLoadingAd
      * @param value The subsurface tint texture or null
      */
     set subsurfaceColorTexture(value: Nullable<BaseTexture>);
+    private _diffuseTransmissionTint;
+    private _diffuseTransmissionTintTexture;
     /**
-     * Sets the surface tint of the material (when using subsurface scattering)
+     * Sets the diffuse transmission tint of the material
      */
-    set subsurfaceConstantTint(value: Color3);
+    set diffuseTransmissionTint(value: Color3);
     /**
-     * Gets the surface tint of the material (when using subsurface scattering)
+     * Gets the diffuse transmission tint of the material
      */
-    get subsurfaceConstantTint(): Color3;
+    get diffuseTransmissionTint(): Color3;
     /**
-     * Sets the surface tint texture of the material (when using subsurface scattering)
+     * Sets the diffuse transmission tint texture of the material
      */
-    set subsurfaceConstantTintTexture(value: Nullable<BaseTexture>);
+    set diffuseTransmissionTintTexture(value: Nullable<BaseTexture>);
     /**
      * Gets the subsurface radius for subsurface scattering.
      * subsurfaceRadiusScale * subsurfaceRadius gives the mean free path per color channel.
@@ -528,6 +536,11 @@ export declare class OpenPBRMaterialLoadingAdapter implements IMaterialLoadingAd
      * @param value The anisotropy intensity value
      */
     set subsurfaceScatterAnisotropy(value: number);
+    /**
+     * Does this material have a translucent surface (i.e. either transmission or subsurface)?
+     * @returns True if the material is translucent, false otherwise
+     */
+    isTranslucent(): boolean;
     /**
      * Configures fuzz for OpenPBR.
      * Enables fuzz and sets up proper configuration.
@@ -671,4 +684,5 @@ export declare class OpenPBRMaterialLoadingAdapter implements IMaterialLoadingAd
      * @param value The scale value for the coat normal texture
      */
     set geometryCoatNormalTextureScale(value: number);
+    finalize(): void;
 }

package/glTF/2.0/openpbrMaterialLoadingAdapter.js

@@ -1,5 +1,4 @@
 import { Color3 } from "@onerjs/core/Maths/math.color.js";
-import { Vector3 } from "@onerjs/core/Maths/math.vector.js";
 /**
  * Material Loading Adapter for OpenPBR materials that provides a unified OpenPBR-like interface.
  */
@@ -9,7 +8,8 @@ export class OpenPBRMaterialLoadingAdapter {
      * @param material - The OpenPBR material to adapt.
      */
     constructor(material) {
-        this._extinctionCoefficient = Vector3.Zero();
+        this._diffuseTransmissionTint = Color3.White();
+        this._diffuseTransmissionTintTexture = null;
         this._material = material;
     }
     /**
@@ -562,7 +562,9 @@ export class OpenPBRMaterialLoadingAdapter {
      * Configures transmission for OpenPBR material.
      */
     configureTransmission() {
-        // OpenPBR transmission will be configured differently when available
+        // Material is thin-walled until otherwise specified by the glTF volume extension.
+        this._material.geometryThinWalled = 1.0;
+        this._material.transmissionDepth = 0.0;
     }
     /**
      * Sets the transmission weight.
@@ -570,13 +572,6 @@ export class OpenPBRMaterialLoadingAdapter {
      */
     set transmissionWeight(value) {
         this._material.transmissionWeight = value;
-        // If the transmission weight is greater than 0, let's check if the base color
-        // is set and use that for a surface tint in OpenPBR. This may later be
-        // overridden by the volume properties but, without volume, this will give us
-        // glTF compatibility in OpenPBR.
-        this._material.transmissionColor = this._material.baseColor;
-        this._material.transmissionColorTexture = this._material.baseColorTexture;
-        this._material.transmissionDepth = 0.0;
     }
     /**
      * Sets the transmission weight texture.
@@ -606,9 +601,17 @@ export class OpenPBRMaterialLoadingAdapter {
     get transmissionScatter() {
         return this._material.transmissionScatter;
     }
+    /**
+     * Sets the transmission scatter texture.
+     * @param value The transmission scatter texture or null
+     */
     set transmissionScatterTexture(value) {
         this._material.transmissionScatterTexture = value;
     }
+    /**
+     * Gets the transmission scatter texture.
+     * @returns The transmission scatter texture or null
+     */
     get transmissionScatterTexture() {
         return this._material.transmissionScatterTexture;
     }
@@ -686,6 +689,25 @@ export class OpenPBRMaterialLoadingAdapter {
     set refractionBackgroundTexture(value) {
         this._material.backgroundRefractionTexture = value;
     }
+    // ========================================
+    // VOLUME PROPERTIES
+    // ========================================
+    configureVolume() {
+        // If we're configuring volume, we assume the material is not thin-walled (i.e. it's volumetric).
+        this._material.geometryThinWalled = 0.0;
+    }
+    /**
+     * Sets whether the material is thin-walled (i.e. non-volumetric) or not.
+     */
+    set geometryThinWalled(value) {
+        this._material.geometryThinWalled = value ? 1.0 : 0.0;
+    }
+    /**
+     * Gets whether the material is thin-walled (i.e. non-volumetric) or not.
+     */
+    get geometryThinWalled() {
+        return this._material.geometryThinWalled ? true : false;
+    }
     /**
      * Sets the thickness texture.
      * @param value The thickness texture or null
@@ -708,78 +730,63 @@ export class OpenPBRMaterialLoadingAdapter {
      * Configures subsurface properties for PBR material
      */
     configureSubsurface() {
-        // TODO
-    }
-    /**
-     * Sets the extinction coefficient of the volume.
-     * @param value The extinction coefficient as a Vector3
-     */
-    set extinctionCoefficient(value) {
-        this._extinctionCoefficient = value;
-    }
-    /**
-     * Gets the extinction coefficient of the volume.
-     */
-    get extinctionCoefficient() {
-        return this._extinctionCoefficient;
+        // glTF diffuse transmission is thin-walled (before volume extension is applied) will map to the subsurface slab and, without a
+        this._material.geometryThinWalled = 1.0;
+        this._material.subsurfaceScatterAnisotropy = 1.0;
     }
     /**
      * Sets the subsurface weight
      */
     set subsurfaceWeight(value) {
-        // TODO
+        this._material.subsurfaceWeight = value;
     }
     get subsurfaceWeight() {
-        // TODO
-        return 0;
+        return this._material.subsurfaceWeight;
     }
     /**
      * Sets the subsurface weight texture
      */
     set subsurfaceWeightTexture(value) {
-        // TODO
+        this._material.subsurfaceWeightTexture = value;
     }
     /**
      * Sets the subsurface color.
      * @param value The subsurface tint color as a Color3
      */
     set subsurfaceColor(value) {
-        // TODO
+        this._material.subsurfaceColor = value;
     }
     /**
      * Sets the subsurface color texture.
      * @param value The subsurface tint texture or null
      */
     set subsurfaceColorTexture(value) {
-        // TODO
+        this._material.subsurfaceColorTexture = value;
     }
     /**
-     * Sets the surface tint of the material (when using subsurface scattering)
+     * Sets the diffuse transmission tint of the material
      */
-    set subsurfaceConstantTint(value) {
-        // There is no equivalent in OpenPBR
-        // Maybe multiply this by subsurfaceColor?
+    set diffuseTransmissionTint(value) {
+        this._diffuseTransmissionTint = value;
     }
     /**
-     * Gets the surface tint of the material (when using subsurface scattering)
+     * Gets the diffuse transmission tint of the material
      */
-    get subsurfaceConstantTint() {
-        return Color3.White();
+    get diffuseTransmissionTint() {
+        return this._diffuseTransmissionTint;
     }
     /**
-     * Sets the surface tint texture of the material (when using subsurface scattering)
+     * Sets the diffuse transmission tint texture of the material
      */
-    set subsurfaceConstantTintTexture(value) {
-        // There is no equivalent in OpenPBR
-        // Maybe multiply this by subsurfaceColorTexture?
+    set diffuseTransmissionTintTexture(value) {
+        this._diffuseTransmissionTintTexture = value;
     }
     /**
      * Gets the subsurface radius for subsurface scattering.
      * subsurfaceRadiusScale * subsurfaceRadius gives the mean free path per color channel.
      */
     get subsurfaceRadius() {
-        // TODO
-        return 0;
+        return this._material.subsurfaceRadius;
     }
     /**
      * Sets the subsurface radius for subsurface scattering.
@@ -787,15 +794,14 @@ export class OpenPBRMaterialLoadingAdapter {
      * @param value The subsurface radius value
      */
     set subsurfaceRadius(value) {
-        // TODO
+        this._material.subsurfaceRadius = value;
     }
     /**
      * Gets the subsurface radius scale for subsurface scattering.
      * subsurfaceRadiusScale * subsurfaceRadius gives the mean free path per color channel.
      */
     get subsurfaceRadiusScale() {
-        // TODO
-        return Color3.White();
+        return this._material.subsurfaceRadiusScale;
     }
     /**
      * Sets the subsurface radius scale for subsurface scattering.
@@ -803,14 +809,21 @@ export class OpenPBRMaterialLoadingAdapter {
      * @param value The subsurface radius scale as a Color3
      */
     set subsurfaceRadiusScale(value) {
-        // TODO
+        this._material.subsurfaceRadiusScale = value;
     }
     /**
      * Sets the subsurface scattering anisotropy.
      * @param value The anisotropy intensity value
      */
     set subsurfaceScatterAnisotropy(value) {
-        // TODO
+        this._material.subsurfaceScatterAnisotropy = value;
+    }
+    /**
+     * Does this material have a translucent surface (i.e. either transmission or subsurface)?
+     * @returns True if the material is translucent, false otherwise
+     */
+    isTranslucent() {
+        return this.transmissionWeight > 0 || this.subsurfaceWeight > 0;
     }
     // ========================================
     // FUZZ LAYER (Sheen)
@@ -1031,5 +1044,50 @@ export class OpenPBRMaterialLoadingAdapter {
             this._material.geometryCoatNormalTexture.level = value;
         }
     }
+    finalize() {
+        // Do final configuration for the material to handle any interactions/dependencies between properties that we had to defer until all properties were loaded.
+        // If the material is volumetric, we may need to create a coat layer to handle the surface tint.
+        if ((this._diffuseTransmissionTint && !this._diffuseTransmissionTint.equals(Color3.White())) || this._diffuseTransmissionTintTexture) {
+            if (this._material.geometryThinWalled) {
+                // Use the subsurface slab for surface tinting.
+                this.subsurfaceColor = this._diffuseTransmissionTint;
+                this.subsurfaceColorTexture = this._diffuseTransmissionTintTexture;
+            }
+            else {
+                // The material is volumetric and we have surface tinting, so we need to move that tinting to the coat layer to preserve it.
+                // TODO: If we already have a coat slab, we'll have to merge the two.
+                if (this._material.coatWeight == 0 && (!this.baseColor.equals(Color3.White()) || this.baseColorTexture)) {
+                    this._material.coatWeight = this.subsurfaceWeight;
+                    this._material.coatWeightTexture = this.subsurfaceWeightTexture;
+                    this._material.coatColor = this._diffuseTransmissionTint;
+                    this._material.coatColorTexture = this._diffuseTransmissionTintTexture;
+                    this._material.coatIor = this._material.specularIor; // Use the same IOR for the coat as the specular layer to try to match the original reflection as closely as possible.
+                    this._material.coatDarkening = 0.0;
+                    this._material.coatRoughness = this._material.specularRoughness;
+                    this._material.coatRoughnessTexture = this._material.specularRoughnessTexture;
+                }
+            }
+        }
+        // If the material has transmission, we need to use the base color to tint the transmission.
+        if (this.transmissionWeight > 0) {
+            if (this._material.geometryThinWalled || this._material.transmissionDepth === 0) {
+                // If the material is thin-walled or has no attenuation depth, we can use the base color as the transmission color directly.
+                this._material.transmissionColor = this._material.baseColor;
+                this._material.transmissionColorTexture = this._material.baseColorTexture;
+            }
+            else if (this._material.coatWeight == 0 && (!this.baseColor.equals(Color3.White()) || this.baseColorTexture !== null)) {
+                // Otherwise, we have volumetric attenuation so we need to use the coat layer to preserve the base color tinting of glTF.
+                // TODO: If we already have a coat slab, we'll have to merge the two.
+                this._material.coatWeight = this.transmissionWeight;
+                this._material.coatWeightTexture = this.transmissionWeightTexture;
+                this._material.coatColor = this.baseColor;
+                this._material.coatColorTexture = this.baseColorTexture;
+                this._material.coatIor = this._material.specularIor; // Use the same IOR for the coat as the specular layer to try to match the original reflection as closely as possible.
+                this._material.coatDarkening = 0.0;
+                this._material.coatRoughness = this._material.specularRoughness;
+                this._material.coatRoughnessTexture = this._material.specularRoughnessTexture;
+            }
+        }
+    }
 }
 //# sourceMappingURL=openpbrMaterialLoadingAdapter.js.map