@flighthq/texture-formats 0.3.1-next.975.01aea94 → 0.4.0-edge.1908.751021c

package/dist/parseBasis.js

@@ -109,8 +109,10 @@ function hasBasisSignature(bytes) {
 const basisTotalSlicesOffset = 14;
 const basisTexFormatOffset = 20;
 const basisTexTypeOffset = 23;
-const basisSliceDescOffsetField = 63;
-const basisHeaderMinSize = 67; // through m_slice_desc_file_ofs (offset 63, 4 bytes)
+// Both codebook byte lengths are packed U24 fields. Accounting for those six bytes places
+// m_tables_file_size at 61..64 and m_slice_desc_file_ofs immediately after it, at 65..68.
+const basisSliceDescOffsetField = 65;
+const basisHeaderMinSize = 69; // through m_slice_desc_file_ofs (offset 65, 4 bytes)
 const basisSliceDescSize = 23;
 const basisTextureType2d = 0;
 const basisTextureType2dArray = 1;

package/dist/parseBasis.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseBasis.js","sourceRoot":"","sources":["../src/parseBasis.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,MAAM,UAAU,0BAA0B,CAAC,KAA2B;IACpE,MAAM,OAAO,GAAiB,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC/C,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACrD,OAAO,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACpD,CAAC;AAED,wGAAwG;AACxG,8EAA8E;AAC9E,EAAE;AACF,uGAAuG;AACvG,oGAAoG;AACpG,sGAAsG;AACtG,iGAAiG;AACjG,4FAA4F;AAC5F,EAAE;AACF,qGAAqG;AACrG,uGAAuG;AACvG,uGAAuG;AACvG,sGAAsG;AACtG,MAAM,UAAU,UAAU,CAAC,KAA2B;IACpD,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,kBAAkB,CAAC,KAA2B,EAAE,OAAsB;IAC7E,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,OAAO,EAAE,wBAAwB,CAAC,CAAC;IAChF,IAAI,KAAK,CAAC,UAAU,GAAG,kBAAkB;QAAE,OAAO,MAAM,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IAEtF,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,6BAA6B;IAC5E,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,6BAA6B;IAC5E,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,2BAA2B;IACvF,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;IACvE,IAAI,WAAW,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,WAAW,CAAC,CAAC;IAC3E,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;IAEjE,MAAM,eAAe,GAAG,gBAAgB,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;IAC3E,MAAM,eAAe,GAAG,iBAAiB,CAAC,eAAe,CAAC,CAAC;IAE3D,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;IACvD,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,kBAAkB,CAAC,EAAE,CAAC;QACjE,OAAO,MAAM,CAAC,OAAO,EAAE,2BAA2B,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,WAAW,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC3C,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU;QACnC,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACxC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB;QAC3C,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB;QAC3C,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC5C,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,qBAAqB;QAC/C,IAAI,UAAU,GAAG,UAAU,GAAG,KAAK,CAAC,UAAU;YAAE,OAAO,MAAM,CAAC,OAAO,EAAE,2BAA2B,CAAC,CAAC;QAEpG,IAAI,UAAU,KAAK,CAAC,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;YACzC,SAAS,GAAG,KAAK,CAAC;YAClB,UAAU,GAAG,MAAM,CAAC;QACtB,CAAC;QACD,IAAI,UAAU,GAAG,CAAC,GAAG,QAAQ;YAAE,QAAQ,GAAG,UAAU,GAAG,CAAC,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM;QACN,MAAM,EAAE,UAAU,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;QAC9C,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM;QACN,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC;QAChC,gBAAgB,EAAE,MAAM;QACxB,KAAK,EAAE,SAAS,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;KAC5C,CAAC;AACJ,CAAC;AAMD,SAAS,MAAM,CAAC,OAAiC,EAAE,MAA0C;IAC3F,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;IACnD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,oBAAoB,CAC3B,WAAmB,EACnB,WAAmB;IAEnB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IACxC,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,kBAAkB,CAAC;QACxB,KAAK,uBAAuB;YAC1B,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAChD,KAAK,4BAA4B;YAC/B,IAAI,WAAW,KAAK,CAAC,IAAI,WAAW,GAAG,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC5D,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,CAAC,EAAE,CAAC;QACzD,KAAK,2BAA2B;YAC9B,OAAO,IAAI,CAAC;QACd,KAAK,sBAAsB;YACzB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAChD;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,KAA2B;IACpD,kFAAkF;IAClF,OAAO,KAAK,CAAC,UAAU,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AACzE,CAAC;AAED,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAClC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAChC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAC9B,MAAM,yBAAyB,GAAG,EAAE,CAAC;AACrC,MAAM,kBAAkB,GAAG,EAAE,CAAC,CAAC,qDAAqD;AACpF,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAE9B,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAC7B,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAClC,MAAM,4BAA4B,GAAG,CAAC,CAAC;AACvC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AACtC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAEjC,MAAM,cAAc,GAAqD;IACvE,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,OAAO;CACX,CAAC"}
+{"version":3,"file":"parseBasis.js","sourceRoot":"","sources":["../src/parseBasis.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/texture-formats",
-  "version": "0.3.1-next.975.01aea94",
+  "version": "0.4.0-edge.1908.751021c",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,7 +38,7 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/types": "0.3.1-next.975.01aea94"
+    "@flighthq/types": "0.4.0-edge.1908.751021c"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/explainTextureContainerParse.test.ts

@@ -23,7 +23,7 @@ describe('explainTextureContainerParse', () => {
       reason: 'format-unsupported',
     });
 
-    const basis = new Uint8Array(67);
+    const basis = new Uint8Array(69);
     basis.set([0x73, 0x42]);
     expect(explainTextureContainerParse(basis)).toEqual({
       container: 'basis',

package/src/parseBasis.test.ts

@@ -1,3 +1,4 @@
+import type { TextureContainer } from '@flighthq/types/contract';
 import { describe, expect, it } from 'vitest';
 
 import { getBasisParseFailureReason, parseBasis } from './parseBasis';
@@ -18,6 +19,18 @@ interface BasisOptions {
   slices: readonly BasisSlice[];
 }
 
+interface BasisFixtureExpectation {
+  expected: Readonly<TextureContainer>;
+  levelIndices: readonly number[];
+  path: string;
+}
+
+interface UnsupportedBasisFixtureExpectation {
+  path: string;
+  reason: 'format-unsupported';
+  texFormat: number;
+}
+
 const basisHeaderSize = 77;
 const basisSliceDescSize = 23;
 
@@ -40,7 +53,7 @@ function buildBasis(opts: BasisOptions): Uint8Array {
   setU24(dv, 17, totalImages); // m_total_images
   bytes[20] = texFormat; // m_tex_format
   bytes[23] = texType; // m_tex_type
-  dv.setUint32(63, sliceTableOffset, true); // m_slice_desc_file_ofs
+  dv.setUint32(65, sliceTableOffset, true); // m_slice_desc_file_ofs
   let off = sliceTableOffset;
   for (const slice of slices) {
     setU24(dv, off, slice.imageIndex);
@@ -61,19 +74,37 @@ describe('getBasisParseFailureReason', () => {
 });
 
 describe('parseBasis', () => {
+  it.each(BASIS_FIXTURE_EXPECTATIONS)('matches the exact measured semantics of $path', (fixture) => {
+    expect(parseBasis(buildMeasuredBasisFixture(fixture))).toEqual(fixture.expected);
+  });
+
+  it.each(UNSUPPORTED_BASIS_FIXTURE_EXPECTATIONS)(
+    'continues to decline unsupported fixture $path as $reason',
+    ({ reason, texFormat }) => {
+      const bytes = buildBasis({
+        slices: [{ fileOfs: 100, fileSize: 8, height: 4, imageIndex: 0, levelIndex: 0, width: 4 }],
+        texFormat,
+      });
+      expect(parseBasis(bytes)).toBeNull();
+      expect(getBasisParseFailureReason(bytes)).toBe(reason);
+    },
+  );
+
   it('parses a single-slice ETC1S image', () => {
     const container = parseBasis(
       buildBasis({ slices: [{ fileOfs: 100, fileSize: 8, height: 4, imageIndex: 0, levelIndex: 0, width: 4 }] }),
     );
-    expect(container).not.toBeNull();
-    expect(container!.format).toBe('etc1s');
-    expect(container!.width).toBe(4);
-    expect(container!.height).toBe(4);
-    expect(container!.mipLevels).toBe(1);
-    expect(container!.layers).toBe(1);
-    expect(container!.faces).toBe(1);
-    expect(container!.supercompression).toBe('None');
-    expect(container!.levels).toEqual([{ byteLength: 8, byteOffset: 100, height: 4, width: 4 }]);
+    expect(container).toEqual({
+      depth: 1,
+      faces: 1,
+      format: 'etc1s',
+      height: 4,
+      layers: 1,
+      levels: [{ byteLength: 8, byteOffset: 100, height: 4, width: 4 }],
+      mipLevels: 1,
+      supercompression: 'None',
+      width: 4,
+    });
   });
 
   it('reports a mip chain from the slice level indices', () => {
@@ -173,7 +204,216 @@ describe('parseBasis', () => {
     const bytes = buildBasis({
       slices: [{ fileOfs: 100, fileSize: 8, height: 4, imageIndex: 0, levelIndex: 0, width: 4 }],
     });
-    new DataView(bytes.buffer).setUint32(63, 1_000_000, true); // corrupt m_slice_desc_file_ofs
+    new DataView(bytes.buffer).setUint32(65, 1_000_000, true); // corrupt m_slice_desc_file_ofs
     expect(parseBasis(bytes)).toBeNull();
   });
 });
+
+function buildMeasuredBasisFixture(fixture: Readonly<BasisFixtureExpectation>): Uint8Array {
+  return buildBasis({
+    slices: fixture.expected.levels.map((level, index) => ({
+      fileOfs: level.byteOffset,
+      fileSize: level.byteLength,
+      height: level.height,
+      imageIndex: 0,
+      levelIndex: fixture.levelIndices[index]!,
+      width: level.width,
+    })),
+    texFormat: fixture.expected.format === 'uastc' ? 1 : 0,
+  });
+}
+
+// Fetch: `npm run fixtures -- texture-container-fixtures`.
+// Pinned release 0.1.1 manifest SHA256: 4332d1473b8c47fefd73015d4c7b3ba67edbda3c6faba2c69597f62a47a15744.
+const BASIS_FIXTURE_EXPECTATIONS: readonly BasisFixtureExpectation[] = [
+  {
+    expected: {
+      depth: 1,
+      faces: 1,
+      format: 'etc1s',
+      height: 512,
+      layers: 1,
+      levels: [
+        { byteLength: 62_601, byteOffset: 45_273, height: 512, width: 768 },
+        { byteLength: 40_817, byteOffset: 107_874, height: 512, width: 768 },
+      ],
+      mipLevels: 1,
+      supercompression: 'None',
+      width: 768,
+    },
+    levelIndices: [0, 0],
+    path: 'basis/webgl/texture_test/assets/alpha3.basis',
+  },
+  {
+    expected: {
+      depth: 1,
+      faces: 1,
+      format: 'etc1s',
+      height: 512,
+      layers: 1,
+      levels: [
+        { byteLength: 48_567, byteOffset: 10_417, height: 512, width: 768 },
+        { byteLength: 12_500, byteOffset: 58_984, height: 256, width: 384 },
+        { byteLength: 3_173, byteOffset: 71_484, height: 128, width: 192 },
+        { byteLength: 827, byteOffset: 74_657, height: 64, width: 96 },
+        { byteLength: 217, byteOffset: 75_484, height: 32, width: 48 },
+        { byteLength: 61, byteOffset: 75_701, height: 16, width: 24 },
+        { byteLength: 14, byteOffset: 75_762, height: 8, width: 12 },
+        { byteLength: 7, byteOffset: 75_776, height: 4, width: 6 },
+        { byteLength: 4, byteOffset: 75_783, height: 2, width: 3 },
+        { byteLength: 4, byteOffset: 75_787, height: 1, width: 1 },
+      ],
+      mipLevels: 10,
+      supercompression: 'None',
+      width: 768,
+    },
+    levelIndices: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9],
+    path: 'basis/webgl/texture_test/assets/kodim01_mipmapped.basis',
+  },
+  {
+    expected: {
+      depth: 1,
+      faces: 1,
+      format: 'etc1s',
+      height: 512,
+      layers: 1,
+      levels: [{ byteLength: 51_390, byteOffset: 33_914, height: 512, width: 768 }],
+      mipLevels: 1,
+      supercompression: 'None',
+      width: 768,
+    },
+    levelIndices: [0],
+    path: 'basis/webgl/texture_test/assets/kodim03.basis',
+  },
+  {
+    expected: {
+      depth: 1,
+      faces: 1,
+      format: 'uastc',
+      height: 512,
+      layers: 1,
+      levels: [{ byteLength: 393_216, byteOffset: 100, height: 512, width: 768 }],
+      mipLevels: 1,
+      supercompression: 'None',
+      width: 768,
+    },
+    levelIndices: [0],
+    path: 'basis/webgl/texture_test/assets/kodim03_uastc.basis',
+  },
+  {
+    expected: {
+      depth: 1,
+      faces: 1,
+      format: 'uastc',
+      height: 768,
+      layers: 1,
+      levels: [{ byteLength: 393_216, byteOffset: 100, height: 768, width: 512 }],
+      mipLevels: 1,
+      supercompression: 'None',
+      width: 512,
+    },
+    levelIndices: [0],
+    path: 'basis/webgl/texture_test/assets/kodim18_uastc.basis',
+  },
+  {
+    expected: {
+      depth: 1,
+      faces: 1,
+      format: 'etc1s',
+      height: 512,
+      layers: 1,
+      levels: [{ byteLength: 39_560, byteOffset: 12_936, height: 512, width: 768 }],
+      mipLevels: 1,
+      supercompression: 'None',
+      width: 768,
+    },
+    levelIndices: [0],
+    path: 'basis/webgl/texture_test/assets/kodim20.basis',
+  },
+  {
+    expected: {
+      depth: 1,
+      faces: 1,
+      format: 'etc1s',
+      height: 1_024,
+      layers: 1,
+      levels: [{ byteLength: 52_083, byteOffset: 38_700, height: 1_024, width: 1_024 }],
+      mipLevels: 1,
+      supercompression: 'None',
+      width: 1_024,
+    },
+    levelIndices: [0],
+    path: 'basis/webgl/texture_test/assets/kodim20_1024x1024.basis',
+  },
+  {
+    expected: {
+      depth: 1,
+      faces: 1,
+      format: 'uastc',
+      height: 1_024,
+      layers: 1,
+      levels: [{ byteLength: 1_048_576, byteOffset: 100, height: 1_024, width: 1_024 }],
+      mipLevels: 1,
+      supercompression: 'None',
+      width: 1_024,
+    },
+    levelIndices: [0],
+    path: 'basis/webgl/texture_test/assets/kodim26_uastc_1024.basis',
+  },
+  {
+    expected: {
+      depth: 1,
+      faces: 1,
+      format: 'etc1s',
+      height: 8,
+      layers: 1,
+      levels: [
+        { byteLength: 1, byteOffset: 223, height: 8, width: 8 },
+        { byteLength: 2, byteOffset: 224, height: 8, width: 8 },
+      ],
+      mipLevels: 1,
+      supercompression: 'None',
+      width: 8,
+    },
+    levelIndices: [0, 0],
+    path: 'ktx/basis/alpha_simple.basis',
+  },
+  {
+    expected: {
+      depth: 1,
+      faces: 1,
+      format: 'etc1s',
+      height: 1_024,
+      layers: 1,
+      levels: [{ byteLength: 64_199, byteOffset: 7_361, height: 1_024, width: 1_024 }],
+      mipLevels: 1,
+      supercompression: 'None',
+      width: 1_024,
+    },
+    levelIndices: [0],
+    path: 'ktx/basis/color_grid.basis',
+  },
+  {
+    expected: {
+      depth: 1,
+      faces: 1,
+      format: 'etc1s',
+      height: 768,
+      layers: 1,
+      levels: [{ byteLength: 45_303, byteOffset: 10_382, height: 768, width: 512 }],
+      mipLevels: 1,
+      supercompression: 'None',
+      width: 512,
+    },
+    levelIndices: [0],
+    path: 'ktx/basis/kodim17.basis',
+  },
+];
+
+const UNSUPPORTED_BASIS_FIXTURE_EXPECTATIONS: readonly UnsupportedBasisFixtureExpectation[] = [
+  { path: 'basis/webgl/texture_test/assets/base.basis', reason: 'format-unsupported', texFormat: 6 },
+  { path: 'basis/webgl/texture_test/assets/desk.basis', reason: 'format-unsupported', texFormat: 2 },
+  { path: 'basis/webgl/texture_test/assets/desk_6x6.basis', reason: 'format-unsupported', texFormat: 3 },
+  { path: 'basis/webgl/texture_test/assets/desk_6x6i.basis', reason: 'format-unsupported', texFormat: 4 },
+  { path: 'basis/webgl/texture_test/assets/kodim23_hdr.basis', reason: 'format-unsupported', texFormat: 2 },
+];