@driftengine/drft 4.4.2 → 4.5.0

package/dist/drftFormat.d.ts

@@ -20,7 +20,7 @@ export declare const DRFT_VERSION_MAJOR = 1;
  * Additive revisions within a generation: new optional chunks, new attribute bits, new
  * enum values with a defined fallback. Never a changed meaning.
  */
-export declare const DRFT_VERSION_MINOR = 18;
+export declare const DRFT_VERSION_MINOR = 19;
 /** Bytes before the chunk table. */
 export declare const HEADER_BYTES = 32;
 /** Bytes per chunk table entry. */
@@ -488,9 +488,18 @@ export interface DrftMaterial {
      * tree's cards are not drawn. Absent means false, which is how every surface before it was drawn.
      */
     readonly doubleSided?: boolean;
+    /**
+     * Glass, 1.19: the share of light that passes, 0 opaque to 1 clear. Absent or 0 is not glass,
+     * which is what every surface before it was. See the engine's `glass.ts`.
+     */
+    readonly transmission?: number;
+    /** How milky the glass is, 0 see-through to 1 fully diffusing. 1.19. */
+    readonly frost?: number;
+    /** The colour light takes through the glass; white is clear. 1.19. */
+    readonly tint?: readonly [number, number, number];
 }
 /** Floats in a `MATL` entry, then the signed texture indices that follow them. */
-export declare const MATERIAL_FLOATS = 15;
+export declare const MATERIAL_FLOATS = 20;
 /**
  * Albedo, normal, ORM and emissive.
  *
@@ -501,7 +510,11 @@ export declare const MATERIAL_FLOATS = 15;
  * them is speculative — only unbound, and the plans that bind them need no second stride bump.
  */
 export declare const MATERIAL_INDICES = 4;
-/** A `u32` of flags after them, since 1.18: bit 0 is `blend`, bit 1 is `doubleSided`. */
+/**
+ * A `u32` of flags after them, since 1.18: bit 0 is `blend`, bit 1 is `doubleSided`. Glass's five
+ * floats — transmission, frost, tint — follow the flags word, since 1.19, which is why the float
+ * count is twenty while the entry is still laid out floats, indices, flags, floats.
+ */
 export declare const MATERIAL_FLAGS = 1;
 export declare const MATERIAL_ENTRY_BYTES: number;
 /** What `HEAD` says about the asset as a whole. */

package/dist/drftFormat.js

@@ -20,7 +20,7 @@ export const DRFT_VERSION_MAJOR = 1;
  * Additive revisions within a generation: new optional chunks, new attribute bits, new
  * enum values with a defined fallback. Never a changed meaning.
  */
-export const DRFT_VERSION_MINOR = 18;
+export const DRFT_VERSION_MINOR = 19;
 /** Bytes before the chunk table. */
 export const HEADER_BYTES = 32;
 /** Bytes per chunk table entry. */
@@ -394,7 +394,7 @@ export function codecName(codec) {
                     : `codec ${codec}`;
 }
 /** Floats in a `MATL` entry, then the signed texture indices that follow them. */
-export const MATERIAL_FLOATS = 15;
+export const MATERIAL_FLOATS = 20;
 /**
  * Albedo, normal, ORM and emissive.
  *
@@ -405,7 +405,11 @@ export const MATERIAL_FLOATS = 15;
  * them is speculative — only unbound, and the plans that bind them need no second stride bump.
  */
 export const MATERIAL_INDICES = 4;
-/** A `u32` of flags after them, since 1.18: bit 0 is `blend`, bit 1 is `doubleSided`. */
+/**
+ * A `u32` of flags after them, since 1.18: bit 0 is `blend`, bit 1 is `doubleSided`. Glass's five
+ * floats — transmission, frost, tint — follow the flags word, since 1.19, which is why the float
+ * count is twenty while the entry is still laid out floats, indices, flags, floats.
+ */
 export const MATERIAL_FLAGS = 1;
 export const MATERIAL_ENTRY_BYTES = MATERIAL_FLOATS * 4 + MATERIAL_INDICES * 4 + MATERIAL_FLAGS * 4;
 /**

package/dist/drftRead.js

@@ -536,6 +536,16 @@ export function readMaterials(buffer, chunk) {
             blend: has(76, 4) ? (view.getUint32(at + 76, true) & 1) !== 0 : false,
             /* One-sided unless it says otherwise, which is how every file before the bit was drawn. */
             doubleSided: has(76, 4) ? (view.getUint32(at + 76, true) & 2) !== 0 : false,
+            /* Not glass, which is what every file before 1.19 meant. */
+            transmission: has(80, 4) ? view.getFloat32(at + 80, true) : 0,
+            frost: has(84, 4) ? view.getFloat32(at + 84, true) : 0,
+            tint: has(88, 12)
+                ? [
+                    view.getFloat32(at + 88, true),
+                    view.getFloat32(at + 92, true),
+                    view.getFloat32(at + 96, true),
+                ]
+                : [1, 1, 1],
         });
     }
     return out;

package/dist/drftWrite.js

@@ -366,6 +366,12 @@ function buildMaterials(materials) {
         view.setFloat32(at + 68, material.occlusionStrength, true);
         view.setFloat32(at + 72, material.cutout, true);
         view.setUint32(at + 76, (material.blend === true ? 1 : 0) | (material.doubleSided === true ? 2 : 0), true);
+        /* Glass, 1.19: after the flags word, so every earlier offset stays where readers expect it. */
+        view.setFloat32(at + 80, material.transmission ?? 0, true);
+        view.setFloat32(at + 84, material.frost ?? 0, true);
+        view.setFloat32(at + 88, material.tint?.[0] ?? 1, true);
+        view.setFloat32(at + 92, material.tint?.[1] ?? 1, true);
+        view.setFloat32(at + 96, material.tint?.[2] ?? 1, true);
         at += MATERIAL_ENTRY_BYTES;
     }
     return { code: CHUNK_MATL, flags: 0, bytes };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@driftengine/drft",
-  "version": "4.4.2",
+  "version": "4.5.0",
   "description": "The .drft container: a streaming format for baked 3D scenes",
   "license": "Apache-2.0",
   "type": "module",
@@ -27,9 +27,9 @@
   ],
   "sideEffects": false,
   "devDependencies": {
-    "@driftengine/core": "4.4.2",
-    "@driftengine/entities": "4.4.2",
-    "@driftengine/texture": "4.4.2"
+    "@driftengine/core": "4.5.0",
+    "@driftengine/entities": "4.5.0",
+    "@driftengine/texture": "4.5.0"
   },
   "author": "Drift Technologies",
   "repository": {

package/src/drftFormat.ts

@@ -23,7 +23,7 @@ export const DRFT_VERSION_MAJOR = 1;
  * Additive revisions within a generation: new optional chunks, new attribute bits, new
  * enum values with a defined fallback. Never a changed meaning.
  */
-export const DRFT_VERSION_MINOR = 18;
+export const DRFT_VERSION_MINOR = 19;
 
 /** Bytes before the chunk table. */
 export const HEADER_BYTES = 32;
@@ -582,10 +582,19 @@ export interface DrftMaterial {
    * tree's cards are not drawn. Absent means false, which is how every surface before it was drawn.
    */
   readonly doubleSided?: boolean;
+  /**
+   * Glass, 1.19: the share of light that passes, 0 opaque to 1 clear. Absent or 0 is not glass,
+   * which is what every surface before it was. See the engine's `glass.ts`.
+   */
+  readonly transmission?: number;
+  /** How milky the glass is, 0 see-through to 1 fully diffusing. 1.19. */
+  readonly frost?: number;
+  /** The colour light takes through the glass; white is clear. 1.19. */
+  readonly tint?: readonly [number, number, number];
 }
 
 /** Floats in a `MATL` entry, then the signed texture indices that follow them. */
-export const MATERIAL_FLOATS = 15;
+export const MATERIAL_FLOATS = 20;
 /**
  * Albedo, normal, ORM and emissive.
  *
@@ -596,7 +605,11 @@ export const MATERIAL_FLOATS = 15;
  * them is speculative — only unbound, and the plans that bind them need no second stride bump.
  */
 export const MATERIAL_INDICES = 4;
-/** A `u32` of flags after them, since 1.18: bit 0 is `blend`, bit 1 is `doubleSided`. */
+/**
+ * A `u32` of flags after them, since 1.18: bit 0 is `blend`, bit 1 is `doubleSided`. Glass's five
+ * floats — transmission, frost, tint — follow the flags word, since 1.19, which is why the float
+ * count is twenty while the entry is still laid out floats, indices, flags, floats.
+ */
 export const MATERIAL_FLAGS = 1;
 export const MATERIAL_ENTRY_BYTES = MATERIAL_FLOATS * 4 + MATERIAL_INDICES * 4 + MATERIAL_FLAGS * 4;
 

package/src/drftRead.ts

@@ -758,6 +758,16 @@ export function readMaterials(buffer: ArrayBuffer, chunk: DrftChunk): DrftMateri
       blend: has(76, 4) ? (view.getUint32(at + 76, true) & 1) !== 0 : false,
       /* One-sided unless it says otherwise, which is how every file before the bit was drawn. */
       doubleSided: has(76, 4) ? (view.getUint32(at + 76, true) & 2) !== 0 : false,
+      /* Not glass, which is what every file before 1.19 meant. */
+      transmission: has(80, 4) ? view.getFloat32(at + 80, true) : 0,
+      frost: has(84, 4) ? view.getFloat32(at + 84, true) : 0,
+      tint: has(88, 12)
+        ? [
+            view.getFloat32(at + 88, true),
+            view.getFloat32(at + 92, true),
+            view.getFloat32(at + 96, true),
+          ]
+        : [1, 1, 1],
     });
   }
   return out;

package/src/drftWrite.ts

@@ -563,6 +563,12 @@ function buildMaterials(materials: readonly DrftMaterial[]): PendingChunk {
       (material.blend === true ? 1 : 0) | (material.doubleSided === true ? 2 : 0),
       true,
     );
+    /* Glass, 1.19: after the flags word, so every earlier offset stays where readers expect it. */
+    view.setFloat32(at + 80, material.transmission ?? 0, true);
+    view.setFloat32(at + 84, material.frost ?? 0, true);
+    view.setFloat32(at + 88, material.tint?.[0] ?? 1, true);
+    view.setFloat32(at + 92, material.tint?.[1] ?? 1, true);
+    view.setFloat32(at + 96, material.tint?.[2] ?? 1, true);
     at += MATERIAL_ENTRY_BYTES;
   }
   return { code: CHUNK_MATL, flags: 0, bytes };