gputex 0.3.4 → 0.5.0

package/dist/testing.d.ts

@@ -75,6 +75,16 @@ declare function encodeBC7Mode6Block(pixels: BC7Pixels): BC7Block;
  * Throws if the block doesn't start with the mode 6 field.
  */
 declare function decodeBC7Mode6Block(block: BC7Block): Float32Array;
+/**
+ * Decode a BC7 mode 1 block to 16 normalized [0, 1] RGBA pixels (64 floats).
+ * Throws if the block doesn't start with the mode 1 field.
+ */
+declare function decodeBC7Mode1Block(block: BC7Block): Float32Array;
+/**
+ * Decode a BC7 mode 4 block to 16 normalized [0, 1] RGBA pixels (64 floats).
+ * Throws if the block doesn't start with the mode 4 field.
+ */
+declare function decodeBC7Mode4Block(block: BC7Block): Float32Array;
 /**
  * Encode a BC7 block. Currently this always produces a mode 6 block —
  * see the file header for why other modes are deliberately out of scope.
@@ -82,9 +92,10 @@ declare function decodeBC7Mode6Block(block: BC7Block): Float32Array;
 declare function encodeBC7Block(pixels: BC7Pixels): BC7Block;
 /**
  * Decode a BC7 block, dispatching on the mode field. This reference
- * supports mode 6 only; other modes throw. Encoders outside this
- * project (AMD Compressonator, bc7enc, ...) routinely pick other modes,
- * so this decoder is mainly for round-tripping our own output.
+ * supports modes 1, 4 and 6 — the modes the GPU encoder emits (or has
+ * emitted); other modes throw. Encoders outside this project (AMD
+ * Compressonator, bc7enc, ...) routinely pick other modes, so this
+ * decoder is mainly for round-tripping our own output.
  */
 declare function decodeBC7Block(block: BC7Block): Float32Array;
 
@@ -94,27 +105,53 @@ type ASTC4x4Pixels = Readonly<ArrayLike<number>>;
 type ASTC4x4Block = Uint8Array;
 /**
  * Encode 16 RGBA pixels (64 floats in [0, 1]) as a single ASTC 4×4 LDR
- * block using the narrow subset described at the top of this file.
+ * block using the narrow subset described at the top of this file. The
+ * block class (CEM 0 / 8 / 12) is picked from the 8-bit content: exact
+ * grayscale + opaque → luminance, opaque → RGB, otherwise RGBA.
  *
- * Algorithm:
- *   1. Quantise input to 8-bit.
- *   2. Farthest-pair in 4D → initial (e0, e1).
- *   3. Assign per-texel 2-bit indices by nearest palette entry.
+ * Algorithm per class:
+ *   1. Quantise input to 8-bit; classify.
+ *   2. Farthest-pair over the class's channels → initial (e0, e1).
+ *   3. Assign per-texel indices by nearest palette entry.
  *   4. One LSQ refit pass; accept only if total error strictly decreases.
- *   5. Flip endpoints (and invert indices) if sum(e0.rgb) > sum(e1.rgb)
- *      so the decoder doesn't apply blue contraction.
+ *   5. CEM 8/12: flip endpoints (and reflect weights) if
+ *      sum(e0.rgb) > sum(e1.rgb) so the decoder skips blue contraction.
  *   6. Pack block mode, CEM, endpoints, weights into 128 bits.
  */
 declare function encodeASTC4x4Block(pixels: ASTC4x4Pixels): ASTC4x4Block;
 /**
  * Decode an ASTC 4×4 block produced by this encoder (or by any other
- * encoder that respects our narrow subset: block mode 0x042, single
- * partition, CEM 12). Handles the blue-contraction branch even though
- * our encoder doesn't produce it, so externally-supplied blocks round-
- * trip predictably.
+ * encoder that respects our narrow subset: block modes 0x042/0x053/0x253,
+ * single partition, CEM 0/8/12 with 8-bit endpoints). Handles the
+ * blue-contraction branch even though our encoder doesn't produce it, so
+ * externally-supplied blocks round-trip predictably.
+ *
+ * The CEM is validated against the block mode's expected pairing (we only
+ * ever emit the three fixed combinations above).
  *
  * Output: 16 RGBA pixels as 64 floats in [0, 1].
  */
 declare function decodeASTC4x4Block(block: ASTC4x4Block): Float32Array;
 
-export { type ASTC4x4Block, type ASTC4x4Pixels, type BC1Block, type BC1Pixels, type BC1Quality, type BC4Block, type BC4Values, type BC5Block, type BC5Decoded, type BC7Block, type BC7Pixels, decodeASTC4x4Block, decodeBC1Block, decodeBC4Block, decodeBC5Block, decodeBC7Block, decodeBC7Mode6Block, encodeASTC4x4Block, encodeBC1Block, encodeBC4Block, encodeBC5Block, encodeBC7Block, encodeBC7Mode6Block, readBC7Mode };
+/** 48-value input: 16 RGB triplets, channel-interleaved, row-major, each in [0, 1]. */
+type ETC2Pixels = Readonly<ArrayLike<number>>;
+/** Exactly 8 bytes of ETC2 RGB8 block data. */
+type ETC2Block = Uint8Array;
+type ETC2Quality = 'fast' | 'high';
+type ETC2Mode = 'individual' | 'differential' | 'T' | 'H' | 'planar';
+/**
+ * Encode a 4×4 RGB block (48 floats in [0, 1], row-major) into an 8-byte
+ * ETC2 RGB8 block. Emits individual, differential or planar mode.
+ */
+declare function encodeETC2Block(pixels: ETC2Pixels, { quality }?: {
+    quality?: ETC2Quality;
+}): ETC2Block;
+/** Which of the five ETC2 RGB8 modes a packed block uses. */
+declare function readETC2Mode(block: ETC2Block): ETC2Mode;
+/**
+ * Decode an 8-byte ETC2 RGB8 block to 48 normalised [0, 1] values (16 RGB
+ * triplets, row-major). Handles all five modes.
+ */
+declare function decodeETC2Block(block: ETC2Block): Float32Array;
+
+export { type ASTC4x4Block, type ASTC4x4Pixels, type BC1Block, type BC1Pixels, type BC1Quality, type BC4Block, type BC4Values, type BC5Block, type BC5Decoded, type BC7Block, type BC7Pixels, type ETC2Block, type ETC2Mode, type ETC2Pixels, type ETC2Quality, decodeASTC4x4Block, decodeBC1Block, decodeBC4Block, decodeBC5Block, decodeBC7Block, decodeBC7Mode1Block, decodeBC7Mode4Block, decodeBC7Mode6Block, decodeETC2Block, encodeASTC4x4Block, encodeBC1Block, encodeBC4Block, encodeBC5Block, encodeBC7Block, encodeBC7Mode6Block, encodeETC2Block, readBC7Mode, readETC2Mode };