@driftengine/assets 4.4.1 → 4.5.0

package/README.md

@@ -2,7 +2,7 @@
 
 Model readers for seven formats, and the streaming loader that uploads them.
 
-**Cost: 15.6 KB gzipped on top of core.** Measured by `scripts/size-gate.test.mjs`, which fails if it drifts more than
+**Cost: 15.9 KB gzipped on top of core.** Measured by `scripts/size-gate.test.mjs`, which fails if it drifts more than
 3% — the number is a fact about the build rather than a claim in a document.
 
 Part of [DriftEngine](../../README.md). See [`docs/ARCHITECTURE.md`](../../docs/ARCHITECTURE.md)

package/dist/drawKey.d.ts

@@ -23,6 +23,15 @@ export interface DrawSurfaceOverride {
      * gallery and read as a black blotch. 0 says dielectric.
      */
     readonly metallicScale?: number;
+    /**
+     * Glass, in place of what the file says: the share of light that passes, how milky it is, and
+     * the colour it takes (`GlassOptions` in the renderer). For a model whose panes arrive as an
+     * opaque dark material, because its format or its exporter had no word for glass. Transmission
+     * above zero draws the part blended.
+     */
+    readonly transmission?: number;
+    readonly frost?: number;
+    readonly tint?: readonly [number, number, number];
 }
 /**
  * The fields a merged group carries, resolved from a material and its override.
@@ -47,6 +56,13 @@ export interface DrawGrouping {
     /** Whether both faces are drawn and lit. A merge of a two-sided part and a one-sided one would cull
      *  one of them or unhide the back of the other, so it is part of the key. */
     readonly doubleSided: boolean;
+    /**
+     * Glass. Zero transmission is not glass, and then frost is 0 and the tint white whatever the
+     * file or the override said, so a stray value on an opaque surface never splits a draw.
+     */
+    readonly transmission: number;
+    readonly frost: number;
+    readonly tint: readonly [number, number, number];
 }
 /**
  * Resolve what a part will actually be drawn with.
@@ -56,7 +72,7 @@ export interface DrawGrouping {
  * 0, which is the identity that lets a file saying nothing about a property draw the same as one
  * that did not have the property to say.
  *
- * The override wins over the material for the three fields it may carry, because a consumer dressing
+ * The override wins over the material for the fields it may carry, because a consumer dressing
  * a surface by name knows more than a default an exporter wrote. A cutout is not among them: it is
  * a fact about the *image* a material wears, so nothing outside the file has anything to say
  * about it.

package/dist/drawKey.js

@@ -1,3 +1,4 @@
+const CLEAR = [1, 1, 1];
 /**
  * Resolve what a part will actually be drawn with.
  *
@@ -6,12 +7,14 @@
  * 0, which is the identity that lets a file saying nothing about a property draw the same as one
  * that did not have the property to say.
  *
- * The override wins over the material for the three fields it may carry, because a consumer dressing
+ * The override wins over the material for the fields it may carry, because a consumer dressing
  * a surface by name knows more than a default an exporter wrote. A cutout is not among them: it is
  * a fact about the *image* a material wears, so nothing outside the file has anything to say
  * about it.
  */
 export function resolveDrawGrouping(material, override) {
+    const transmission = Math.max(0, override?.transmission ?? material?.transmission ?? 0);
+    const glass = transmission > 0;
     return {
         albedo: material?.albedo ?? -1,
         orm: material?.ormMap ?? -1,
@@ -23,8 +26,11 @@ export function resolveDrawGrouping(material, override) {
         metallicScale: override?.metallicScale ?? material?.metallicScale ?? 1,
         occlusionStrength: material?.occlusionStrength ?? 0,
         cutout: material?.cutout ?? 0,
-        blend: material?.blend === true,
+        blend: material?.blend === true || glass,
         doubleSided: material?.doubleSided === true,
+        transmission,
+        frost: glass ? (override?.frost ?? material?.frost ?? 0) : 0,
+        tint: glass ? (override?.tint ?? material?.tint ?? CLEAR) : CLEAR,
     };
 }
 /**
@@ -40,5 +46,5 @@ export function resolveDrawGrouping(material, override) {
  */
 export function drawKeyOf(material, override) {
     const g = resolveDrawGrouping(material, override);
-    return `${g.albedo}:${g.orm}:${g.normal}:${g.emissive}:${g.opacity}:${g.reflectivity}:${g.roughnessScale}:${g.metallicScale}:${g.occlusionStrength}:${g.cutout}:${g.blend ? 1 : 0}:${g.doubleSided ? 1 : 0}`;
+    return `${g.albedo}:${g.orm}:${g.normal}:${g.emissive}:${g.opacity}:${g.reflectivity}:${g.roughnessScale}:${g.metallicScale}:${g.occlusionStrength}:${g.cutout}:${g.blend ? 1 : 0}:${g.doubleSided ? 1 : 0}:${g.transmission}:${g.frost}:${g.tint[0]},${g.tint[1]},${g.tint[2]}`;
 }

package/dist/drftLoader.js

@@ -742,6 +742,7 @@ export class DrftLoader {
             cutout: 0,
             blend: false,
             doubleSided: false,
+            glass: null,
             reveal: this.outlinePart?.reveal ?? 0,
             instances: null,
         };
@@ -796,6 +797,7 @@ export class DrftLoader {
                 cutout,
                 blend,
                 doubleSided,
+                glass: glassOf(g),
             });
         }
         const key = drawKeyOf(material, override);
@@ -814,6 +816,7 @@ export class DrftLoader {
                 cutout,
                 blend,
                 doubleSided,
+                glass: glassOf(g),
                 members: [],
             };
             this.groups.set(key, group);
@@ -854,6 +857,7 @@ export class DrftLoader {
                 cutout,
                 blend,
                 doubleSided,
+                glass: group.glass,
                 reveal: 0,
                 instances: null,
             };
@@ -947,6 +951,7 @@ export class DrftLoader {
                 cutout: group.cutout,
                 blend: group.blend,
                 doubleSided: group.doubleSided,
+                glass: group.glass,
                 reveal: 1,
                 instances: null,
             });
@@ -1068,6 +1073,12 @@ export class DrftLoader {
         };
     }
 }
+/** A group's glass as the renderer takes it, or null for a group that lets no light through. */
+function glassOf(g) {
+    if (g.transmission <= 0)
+        return null;
+    return { transmission: g.transmission, frost: g.frost, tint: [g.tint[0], g.tint[1], g.tint[2]] };
+}
 /**
  * The MIME type a codec's bytes carry, or `null` for one the browser has no decoder for.
  *

package/dist/gltf.d.ts

@@ -80,16 +80,35 @@ interface GltfSpecularGlossiness {
         texCoord?: number;
     };
 }
+/**
+ * The three extensions that together say a material is glass: how much light passes
+ * (`KHR_materials_transmission`), how much of it is scattered on the way and the colour it takes
+ * (`KHR_materials_diffuse_transmission`), and the colour a thickness of it absorbs towards
+ * (`KHR_materials_volume`). Only the fields this reader maps are named.
+ */
+interface GltfTransmission {
+    transmissionFactor?: number;
+}
+interface GltfDiffuseTransmission {
+    diffuseTransmissionFactor?: number;
+    diffuseTransmissionColorFactor?: number[];
+}
+interface GltfVolume {
+    attenuationColor?: number[];
+}
 interface GltfMaterial {
     pbrMetallicRoughness?: GltfPbrMetallicRoughness;
     /**
-     * The material extensions this reader knows. One, and everything else is ignored.
+     * The material extensions this reader knows, and everything else is ignored.
      *
-     * Read as an optional field rather than as `Record<string, unknown>` so that adding a second
-     * costs a name here and a branch in `pbrOf`, and so that a typo in either is a compile error.
+     * Read as optional fields rather than as `Record<string, unknown>` so that adding one costs a
+     * name here and a branch where it is read, and so that a typo in either is a compile error.
      */
     extensions?: {
         KHR_materials_pbrSpecularGlossiness?: GltfSpecularGlossiness;
+        KHR_materials_transmission?: GltfTransmission;
+        KHR_materials_diffuse_transmission?: GltfDiffuseTransmission;
+        KHR_materials_volume?: GltfVolume;
     };
     normalTexture?: {
         index: number;

package/dist/gltf.js

@@ -428,6 +428,7 @@ function materialOf(material) {
      * A separate occlusion image is dropped rather than loaded into a second unit. One map, one
      * unit, and `textureUnitBudget.test.ts` says the next unit belongs to emissive.
      */
+    const glass = glassOf(material, modulated ? undefined : roughness);
     const occlusion = material?.occlusionTexture;
     const occlusionStrength = modulated && occlusion !== undefined && occlusion.index === ormMap
         ? (occlusion.strength ?? 1)
@@ -447,7 +448,7 @@ function materialOf(material) {
          * cannot say the material blends, and a leaf whose shape is all in its texture's alpha drew as a
          * solid card. So it is said.
          */
-        blend: blends,
+        blend: blends || glass.transmission > 0,
         /* Seen from both faces: a curtain, a leaf card. The specification's default is one face. */
         doubleSided: material?.doubleSided === true,
         /* Only in MASK mode: the specification says `alphaCutoff` has no meaning in the other two. */
@@ -463,8 +464,42 @@ function materialOf(material) {
         metallicScale: modulated ? (pbr?.metallicFactor ?? 1) : 1,
         occlusionStrength,
         albedo: pbr?.baseColorTexture?.index ?? -1,
+        transmission: glass.transmission,
+        frost: glass.frost,
+        tint: glass.tint,
     };
 }
+const unit = (value, fallback) => Math.min(1, Math.max(0, value ?? fallback));
+/**
+ * What a material's extensions say about letting light through, as this engine's glass.
+ *
+ * **Rough glass is frosted glass.** `KHR_materials_transmission` says its roughness blurs what is
+ * seen through the surface, and that blur is exactly what `frost` is, so a transmissive material's
+ * roughness raises its frost and a diffusely transmitting share raises it too — whichever says
+ * more. Only transmission makes a material glass: a surface stating diffuse transmission alone is a
+ * leaf or a sheet of paper, which this engine's glass would draw see-through and let every shadow
+ * pass, so it stays the opaque surface it was. What that gives up is a paper shade stated by that
+ * extension alone, which arrives opaque; a per-material override is the door for it.
+ *
+ * `roughness` is `undefined` where a map carries the roughness per texel: the factor then only
+ * scales the map, so it says nothing about how rough the glass is, and frost comes from the
+ * diffuse share alone rather than from a number the file did not state.
+ */
+function glassOf(material, roughness) {
+    const ext = material?.extensions;
+    const transmission = unit(ext?.KHR_materials_transmission?.transmissionFactor, 0);
+    if (transmission <= 0)
+        return { transmission: 0, frost: 0, tint: [1, 1, 1] };
+    const diffuse = ext?.KHR_materials_diffuse_transmission;
+    const frost = Math.max(unit(diffuse?.diffuseTransmissionFactor, 0), unit(roughness, 0));
+    const colour = diffuse?.diffuseTransmissionColorFactor ?? ext?.KHR_materials_volume?.attenuationColor;
+    const tint = [
+        unit(colour?.[0], 1),
+        unit(colour?.[1], 1),
+        unit(colour?.[2], 1),
+    ];
+    return { transmission, frost, tint };
+}
 /** The required extensions this reader implements, or follows far enough to fail loudly. */
 const KNOWN_REQUIRED = new Set([
     'KHR_materials_pbrSpecularGlossiness',

package/dist/loadProgress.d.ts

@@ -1,4 +1,4 @@
-import type { MeshHandle, InstancedHandle, MeshInstances } from '@driftengine/core';
+import type { GlassOptions, MeshHandle, InstancedHandle, MeshInstances } from '@driftengine/core';
 /**
  * The vocabulary of a load in flight: which phase it is in, how far it has got, and what a
  * finished part is.
@@ -120,6 +120,13 @@ export interface DrftPart {
     readonly blend: boolean;
     /** Whether both faces are seen: glTF's `doubleSided`. Drawn without culling, each face lit as the front. */
     readonly doubleSided: boolean;
+    /**
+     * The glass this part is, from its file or from `DrftLoaderOptions.surface`, or null for a part
+     * that lets no light through. A glass part is also `blend`, so a caller drawing blended parts
+     * translucent passes this as the draw's `glass` and every pane arrives as the file or the
+     * override said. One object per merged group, shared by its parts, so it is not rebuilt per draw.
+     */
+    readonly glass: GlassOptions | null;
     /**
      * The copies this part is drawn as, or null for a part drawn once.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@driftengine/assets",
-  "version": "4.4.1",
+  "version": "4.5.0",
   "description": "Model readers and the streaming loader for the .drft container",
   "license": "Apache-2.0",
   "type": "module",
@@ -27,11 +27,11 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@driftengine/drft": "4.4.1",
-    "@driftengine/texture": "4.4.1"
+    "@driftengine/drft": "4.5.0",
+    "@driftengine/texture": "4.5.0"
   },
   "peerDependencies": {
-    "@driftengine/core": "4.4.1"
+    "@driftengine/core": "4.5.0"
   },
   "author": "Drift Technologies",
   "repository": {

package/src/drawKey.ts

@@ -25,6 +25,15 @@ export interface DrawSurfaceOverride {
    * gallery and read as a black blotch. 0 says dielectric.
    */
   readonly metallicScale?: number;
+  /**
+   * Glass, in place of what the file says: the share of light that passes, how milky it is, and
+   * the colour it takes (`GlassOptions` in the renderer). For a model whose panes arrive as an
+   * opaque dark material, because its format or its exporter had no word for glass. Transmission
+   * above zero draws the part blended.
+   */
+  readonly transmission?: number;
+  readonly frost?: number;
+  readonly tint?: readonly [number, number, number];
 }
 
 /**
@@ -50,8 +59,17 @@ export interface DrawGrouping {
   /** Whether both faces are drawn and lit. A merge of a two-sided part and a one-sided one would cull
    *  one of them or unhide the back of the other, so it is part of the key. */
   readonly doubleSided: boolean;
+  /**
+   * Glass. Zero transmission is not glass, and then frost is 0 and the tint white whatever the
+   * file or the override said, so a stray value on an opaque surface never splits a draw.
+   */
+  readonly transmission: number;
+  readonly frost: number;
+  readonly tint: readonly [number, number, number];
 }
 
+const CLEAR: readonly [number, number, number] = [1, 1, 1];
+
 /**
  * Resolve what a part will actually be drawn with.
  *
@@ -60,7 +78,7 @@ export interface DrawGrouping {
  * 0, which is the identity that lets a file saying nothing about a property draw the same as one
  * that did not have the property to say.
  *
- * The override wins over the material for the three fields it may carry, because a consumer dressing
+ * The override wins over the material for the fields it may carry, because a consumer dressing
  * a surface by name knows more than a default an exporter wrote. A cutout is not among them: it is
  * a fact about the *image* a material wears, so nothing outside the file has anything to say
  * about it.
@@ -69,6 +87,8 @@ export function resolveDrawGrouping(
   material: DrftMaterial | undefined,
   override?: DrawSurfaceOverride,
 ): DrawGrouping {
+  const transmission = Math.max(0, override?.transmission ?? material?.transmission ?? 0);
+  const glass = transmission > 0;
   return {
     albedo: material?.albedo ?? -1,
     orm: material?.ormMap ?? -1,
@@ -80,8 +100,11 @@ export function resolveDrawGrouping(
     metallicScale: override?.metallicScale ?? material?.metallicScale ?? 1,
     occlusionStrength: material?.occlusionStrength ?? 0,
     cutout: material?.cutout ?? 0,
-    blend: material?.blend === true,
+    blend: material?.blend === true || glass,
     doubleSided: material?.doubleSided === true,
+    transmission,
+    frost: glass ? (override?.frost ?? material?.frost ?? 0) : 0,
+    tint: glass ? (override?.tint ?? material?.tint ?? CLEAR) : CLEAR,
   };
 }
 
@@ -101,5 +124,5 @@ export function drawKeyOf(
   override?: DrawSurfaceOverride,
 ): string {
   const g = resolveDrawGrouping(material, override);
-  return `${g.albedo}:${g.orm}:${g.normal}:${g.emissive}:${g.opacity}:${g.reflectivity}:${g.roughnessScale}:${g.metallicScale}:${g.occlusionStrength}:${g.cutout}:${g.blend ? 1 : 0}:${g.doubleSided ? 1 : 0}`;
+  return `${g.albedo}:${g.orm}:${g.normal}:${g.emissive}:${g.opacity}:${g.reflectivity}:${g.roughnessScale}:${g.metallicScale}:${g.occlusionStrength}:${g.cutout}:${g.blend ? 1 : 0}:${g.doubleSided ? 1 : 0}:${g.transmission}:${g.frost}:${g.tint[0]},${g.tint[1]},${g.tint[2]}`;
 }

package/src/drftLoader.ts

@@ -2,7 +2,7 @@
 
 import type { MeshData } from '@driftengine/drft';
 import type { MeshHandle, RendererApi } from '@driftengine/core';
-import type { SurfaceTextureHandle } from '@driftengine/core';
+import type { GlassOptions, SurfaceTextureHandle } from '@driftengine/core';
 import { MeshBuilder, concatMeshes, createMeshInstances, placeMesh } from '@driftengine/core';
 import type { DrftMaterial } from '@driftengine/drft';
 import type { DrftSdfvEntry } from '@driftengine/drft';
@@ -11,7 +11,7 @@ import type { DrftFieldPlacement } from './fieldPlacement.ts';
 import type { DrftTexture } from '@driftengine/drft';
 import { TextureSet, textureColorSpaces } from './drftTextures.ts';
 import { drawKeyOf, resolveDrawGrouping } from './drawKey.ts';
-import type { DrawSurfaceOverride } from './drawKey.ts';
+import type { DrawGrouping, DrawSurfaceOverride } from './drawKey.ts';
 import {
   streamDrft,
   CODEC_JPEG,
@@ -260,6 +260,8 @@ export class DrftLoader {
       cutout: number;
       blend: boolean;
       doubleSided: boolean;
+      /** Built once when the group is made, and shared by every part drawn from it. */
+      glass: GlassOptions | null;
       /** The group's parts, placed, joined once when the group is built. See `concatMeshes`. */
       members: MeshData[];
     }
@@ -964,6 +966,7 @@ export class DrftLoader {
       cutout: 0,
       blend: false,
       doubleSided: false,
+      glass: null,
       reveal: this.outlinePart?.reveal ?? 0,
       instances: null,
     };
@@ -1033,6 +1036,7 @@ export class DrftLoader {
         cutout,
         blend,
         doubleSided,
+        glass: glassOf(g),
       });
     }
 
@@ -1052,6 +1056,7 @@ export class DrftLoader {
         cutout,
         blend,
         doubleSided,
+        glass: glassOf(g),
         members: [],
       };
       this.groups.set(key, group);
@@ -1093,6 +1098,7 @@ export class DrftLoader {
         cutout,
         blend,
         doubleSided,
+        glass: group.glass,
         reveal: 0,
         instances: null,
       };
@@ -1190,6 +1196,7 @@ export class DrftLoader {
         cutout: group.cutout,
         blend: group.blend,
         doubleSided: group.doubleSided,
+        glass: group.glass,
         reveal: 1,
         instances: null,
       });
@@ -1309,6 +1316,12 @@ export class DrftLoader {
   }
 }
 
+/** A group's glass as the renderer takes it, or null for a group that lets no light through. */
+function glassOf(g: DrawGrouping): GlassOptions | null {
+  if (g.transmission <= 0) return null;
+  return { transmission: g.transmission, frost: g.frost, tint: [g.tint[0], g.tint[1], g.tint[2]] };
+}
+
 /**
  * The MIME type a codec's bytes carry, or `null` for one the browser has no decoder for.
  *

package/src/gltf.ts

@@ -77,15 +77,36 @@ interface GltfSpecularGlossiness {
   /** RGB the specular colour, A the glossiness. Both multiply the factors above. */
   specularGlossinessTexture?: { index: number; texCoord?: number };
 }
+/**
+ * The three extensions that together say a material is glass: how much light passes
+ * (`KHR_materials_transmission`), how much of it is scattered on the way and the colour it takes
+ * (`KHR_materials_diffuse_transmission`), and the colour a thickness of it absorbs towards
+ * (`KHR_materials_volume`). Only the fields this reader maps are named.
+ */
+interface GltfTransmission {
+  transmissionFactor?: number;
+}
+interface GltfDiffuseTransmission {
+  diffuseTransmissionFactor?: number;
+  diffuseTransmissionColorFactor?: number[];
+}
+interface GltfVolume {
+  attenuationColor?: number[];
+}
 interface GltfMaterial {
   pbrMetallicRoughness?: GltfPbrMetallicRoughness;
   /**
-   * The material extensions this reader knows. One, and everything else is ignored.
+   * The material extensions this reader knows, and everything else is ignored.
    *
-   * Read as an optional field rather than as `Record<string, unknown>` so that adding a second
-   * costs a name here and a branch in `pbrOf`, and so that a typo in either is a compile error.
+   * Read as optional fields rather than as `Record<string, unknown>` so that adding one costs a
+   * name here and a branch where it is read, and so that a typo in either is a compile error.
    */
-  extensions?: { KHR_materials_pbrSpecularGlossiness?: GltfSpecularGlossiness };
+  extensions?: {
+    KHR_materials_pbrSpecularGlossiness?: GltfSpecularGlossiness;
+    KHR_materials_transmission?: GltfTransmission;
+    KHR_materials_diffuse_transmission?: GltfDiffuseTransmission;
+    KHR_materials_volume?: GltfVolume;
+  };
   normalTexture?: { index: number; texCoord?: number; scale?: number };
   /** `strength` is a mix from 1, not a multiply: 0 means unoccluded. */
   occlusionTexture?: { index: number; texCoord?: number; strength?: number };
@@ -640,6 +661,8 @@ function materialOf(material: GltfMaterial | undefined): DrftMaterial {
    * A separate occlusion image is dropped rather than loaded into a second unit. One map, one
    * unit, and `textureUnitBudget.test.ts` says the next unit belongs to emissive.
    */
+  const glass = glassOf(material, modulated ? undefined : roughness);
+
   const occlusion = material?.occlusionTexture;
   const occlusionStrength =
     modulated && occlusion !== undefined && occlusion.index === ormMap
@@ -662,7 +685,7 @@ function materialOf(material: GltfMaterial | undefined): DrftMaterial {
      * cannot say the material blends, and a leaf whose shape is all in its texture's alpha drew as a
      * solid card. So it is said.
      */
-    blend: blends,
+    blend: blends || glass.transmission > 0,
     /* Seen from both faces: a curtain, a leaf card. The specification's default is one face. */
     doubleSided: material?.doubleSided === true,
     /* Only in MASK mode: the specification says `alphaCutoff` has no meaning in the other two. */
@@ -678,9 +701,49 @@ function materialOf(material: GltfMaterial | undefined): DrftMaterial {
     metallicScale: modulated ? (pbr?.metallicFactor ?? 1) : 1,
     occlusionStrength,
     albedo: pbr?.baseColorTexture?.index ?? -1,
+    transmission: glass.transmission,
+    frost: glass.frost,
+    tint: glass.tint,
   };
 }
 
+const unit = (value: number | undefined, fallback: number): number =>
+  Math.min(1, Math.max(0, value ?? fallback));
+
+/**
+ * What a material's extensions say about letting light through, as this engine's glass.
+ *
+ * **Rough glass is frosted glass.** `KHR_materials_transmission` says its roughness blurs what is
+ * seen through the surface, and that blur is exactly what `frost` is, so a transmissive material's
+ * roughness raises its frost and a diffusely transmitting share raises it too — whichever says
+ * more. Only transmission makes a material glass: a surface stating diffuse transmission alone is a
+ * leaf or a sheet of paper, which this engine's glass would draw see-through and let every shadow
+ * pass, so it stays the opaque surface it was. What that gives up is a paper shade stated by that
+ * extension alone, which arrives opaque; a per-material override is the door for it.
+ *
+ * `roughness` is `undefined` where a map carries the roughness per texel: the factor then only
+ * scales the map, so it says nothing about how rough the glass is, and frost comes from the
+ * diffuse share alone rather than from a number the file did not state.
+ */
+function glassOf(
+  material: GltfMaterial | undefined,
+  roughness: number | undefined,
+): { transmission: number; frost: number; tint: [number, number, number] } {
+  const ext = material?.extensions;
+  const transmission = unit(ext?.KHR_materials_transmission?.transmissionFactor, 0);
+  if (transmission <= 0) return { transmission: 0, frost: 0, tint: [1, 1, 1] };
+  const diffuse = ext?.KHR_materials_diffuse_transmission;
+  const frost = Math.max(unit(diffuse?.diffuseTransmissionFactor, 0), unit(roughness, 0));
+  const colour =
+    diffuse?.diffuseTransmissionColorFactor ?? ext?.KHR_materials_volume?.attenuationColor;
+  const tint: [number, number, number] = [
+    unit(colour?.[0], 1),
+    unit(colour?.[1], 1),
+    unit(colour?.[2], 1),
+  ];
+  return { transmission, frost, tint };
+}
+
 /** What a caller can tell the reader about what it is going to do with the result. */
 export interface GltfReadOptions {
   /**

package/src/loadProgress.ts

@@ -1,4 +1,4 @@
-import type { MeshHandle, InstancedHandle, MeshInstances } from '@driftengine/core';
+import type { GlassOptions, MeshHandle, InstancedHandle, MeshInstances } from '@driftengine/core';
 
 /**
  * The vocabulary of a load in flight: which phase it is in, how far it has got, and what a
@@ -134,6 +134,13 @@ export interface DrftPart {
   readonly blend: boolean;
   /** Whether both faces are seen: glTF's `doubleSided`. Drawn without culling, each face lit as the front. */
   readonly doubleSided: boolean;
+  /**
+   * The glass this part is, from its file or from `DrftLoaderOptions.surface`, or null for a part
+   * that lets no light through. A glass part is also `blend`, so a caller drawing blended parts
+   * translucent passes this as the draw's `glass` and every pane arrives as the file or the
+   * override said. One object per merged group, shared by its parts, so it is not rebuilt per draw.
+   */
+  readonly glass: GlassOptions | null;
   /**
    * The copies this part is drawn as, or null for a part drawn once.
    *