@carbonenginejs/runtime-resource 0.9.2 → 0.11.0

package/dist/formats/dxbc/core/signature.js

@@ -0,0 +1,172 @@
+import { DxbcReader } from './DxbcReader.js';
+import { DxbcReadError } from './errors.js';
+
+const SIGNATURE_TABLE_HEADER_SIZE = 8;
+const semanticNameDecoder = new TextDecoder("latin1");
+
+/**
+ * Per-fourCC signature element layouts.
+ *
+ * `ISGN`/`OSGN`/`PCSG` use the 24-byte Shader Model 4 layout. `OSG5` prefixes
+ * a stream index. `ISG1`/`OSG1`/`PSG1` prefix a stream index and append a
+ * minimum-precision field.
+ */
+const SIGNATURE_ELEMENT_LAYOUTS = Object.freeze({
+  ISGN: {
+    stride: 24,
+    hasStream: false,
+    hasMinPrecision: false
+  },
+  OSGN: {
+    stride: 24,
+    hasStream: false,
+    hasMinPrecision: false
+  },
+  PCSG: {
+    stride: 24,
+    hasStream: false,
+    hasMinPrecision: false
+  },
+  OSG5: {
+    stride: 28,
+    hasStream: true,
+    hasMinPrecision: false
+  },
+  ISG1: {
+    stride: 32,
+    hasStream: true,
+    hasMinPrecision: true
+  },
+  OSG1: {
+    stride: 32,
+    hasStream: true,
+    hasMinPrecision: true
+  },
+  PSG1: {
+    stride: 32,
+    hasStream: true,
+    hasMinPrecision: true
+  }
+});
+
+/**
+ * Register component type names indexed by DXBC signature component-type ids.
+ */
+const DxbcComponentTypeNames = Object.freeze(["unknown", "uint32", "int32", "float32"]);
+
+/**
+ * DXBC input/output signature chunk reader for `ISGN`-family chunks.
+ */
+class DxbcSignatureChunk {
+  /**
+   * Creates an empty signature chunk; call a read entry point to populate its parameter records.
+   */
+  constructor() {
+    this.fourCC = "";
+    this.elements = [];
+    this.source = "memory";
+  }
+
+  /**
+  * Reads a signature chunk payload into semantic/register element records.
+  *
+  * @param {{fourCC:string,bytes:Uint8Array}} chunk Chunk record from `DxbcContainer`.
+  * @param {object} [options] Read options.
+  * @param {string} [options.source] Source name used in error details.
+  * @returns {DxbcSignatureChunk} This signature.
+  */
+  Read(chunk, options = {}) {
+    this.fourCC = chunk.fourCC;
+    this.source = options.source || "memory";
+    const layout = SIGNATURE_ELEMENT_LAYOUTS[this.fourCC];
+    if (!layout) {
+      throw new DxbcReadError("Unsupported DXBC signature chunk", {
+        source: this.source,
+        fourCC: this.fourCC
+      });
+    }
+    const bytes = chunk.bytes;
+    const reader = new DxbcReader(bytes, {
+      source: this.source
+    });
+    const elementCount = reader.readUint32();
+    const elementOffset = reader.readUint32() || SIGNATURE_TABLE_HEADER_SIZE;
+    if (elementOffset + elementCount * layout.stride > bytes.length) {
+      throw new DxbcReadError("DXBC signature elements lie outside the chunk", {
+        source: this.source,
+        fourCC: this.fourCC,
+        elementCount,
+        elementOffset,
+        chunkSize: bytes.length
+      });
+    }
+    this.elements = [];
+    reader.offset = elementOffset;
+    for (let index = 0; index < elementCount; index += 1) {
+      const stream = layout.hasStream ? reader.readUint32() : 0;
+      const semanticNameOffset = reader.readUint32();
+      const semanticIndex = reader.readUint32();
+      const systemValueType = reader.readUint32();
+      const componentType = reader.readUint32();
+      const registerIndex = reader.readUint32();
+      const mask = reader.readUint8();
+      const readWriteMask = reader.readUint8();
+      reader.Skip(2);
+      const minPrecision = layout.hasMinPrecision ? reader.readUint32() : 0;
+      this.elements.push({
+        semanticName: this._readSemanticName(bytes, semanticNameOffset, index),
+        semanticIndex,
+        systemValueType,
+        componentType,
+        componentTypeName: DxbcComponentTypeNames[componentType] || "unknown",
+        registerIndex,
+        mask,
+        readWriteMask,
+        stream,
+        minPrecision
+      });
+    }
+    return this;
+  }
+
+  /**
+  * Finds a signature element by semantic name and index.
+  *
+  * @param {string} semanticName Case-insensitive semantic name such as `"TEXCOORD"`.
+  * @param {number} [semanticIndex] Semantic index, defaulting to 0.
+  * @returns {object|null} Element record or null.
+  */
+  findElement(semanticName, semanticIndex = 0) {
+    const wanted = String(semanticName).toUpperCase();
+    return this.elements.find(element => element.semanticName.toUpperCase() === wanted && element.semanticIndex === semanticIndex) || null;
+  }
+
+  /**
+  * Resolves a null-terminated semantic name inside the chunk payload.
+  *
+  * @param {Uint8Array} bytes Chunk payload.
+  * @param {number} offset Name offset relative to the chunk payload start.
+  * @param {number} index Element index used in error details.
+  * @returns {string} Decoded semantic name.
+  * @private
+  */
+  _readSemanticName(bytes, offset, index) {
+    if (offset >= bytes.length) {
+      throw new DxbcReadError("DXBC signature semantic name lies outside the chunk", {
+        source: this.source,
+        fourCC: this.fourCC,
+        elementIndex: index,
+        offset,
+        chunkSize: bytes.length
+      });
+    }
+    let end = offset;
+    while (end < bytes.length && bytes[end] !== 0) {
+      end += 1;
+    }
+    return semanticNameDecoder.decode(bytes.subarray(offset, end));
+  }
+}
+
+export { DxbcComponentTypeNames, DxbcSignatureChunk };
+//# sourceMappingURL=signature.js.map

package/dist/formats/dxbc/core/signature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.js","sources":["../../../../../src/formats/dxbc/core/signature.js"],"sourcesContent":["import { DxbcReader } from \"./DxbcReader.js\";\nimport { DxbcReadError } from \"./errors.js\";\n\nconst SIGNATURE_TABLE_HEADER_SIZE = 8;\n\nconst semanticNameDecoder = new TextDecoder(\"latin1\");\n\n/**\n * Per-fourCC signature element layouts.\n *\n * `ISGN`/`OSGN`/`PCSG` use the 24-byte Shader Model 4 layout. `OSG5` prefixes\n * a stream index. `ISG1`/`OSG1`/`PSG1` prefix a stream index and append a\n * minimum-precision field.\n */\nconst SIGNATURE_ELEMENT_LAYOUTS = Object.freeze({\n    ISGN: { stride: 24, hasStream: false, hasMinPrecision: false },\n    OSGN: { stride: 24, hasStream: false, hasMinPrecision: false },\n    PCSG: { stride: 24, hasStream: false, hasMinPrecision: false },\n    OSG5: { stride: 28, hasStream: true, hasMinPrecision: false },\n    ISG1: { stride: 32, hasStream: true, hasMinPrecision: true },\n    OSG1: { stride: 32, hasStream: true, hasMinPrecision: true },\n    PSG1: { stride: 32, hasStream: true, hasMinPrecision: true }\n});\n\n/**\n * Register component type names indexed by DXBC signature component-type ids.\n */\nexport const DxbcComponentTypeNames = Object.freeze([ \"unknown\", \"uint32\", \"int32\", \"float32\" ]);\n\n/**\n * DXBC input/output signature chunk reader for `ISGN`-family chunks.\n */\nexport class DxbcSignatureChunk\n{\n    /**\n     * Creates an empty signature chunk; call a read entry point to populate its parameter records.\n     */\n    constructor()\n    {\n        this.fourCC = \"\";\n        this.elements = [];\n        this.source = \"memory\";\n    }\n\n    /**\n   * Reads a signature chunk payload into semantic/register element records.\n   *\n   * @param {{fourCC:string,bytes:Uint8Array}} chunk Chunk record from `DxbcContainer`.\n   * @param {object} [options] Read options.\n   * @param {string} [options.source] Source name used in error details.\n   * @returns {DxbcSignatureChunk} This signature.\n   */\n    Read(chunk, options = {})\n    {\n        this.fourCC = chunk.fourCC;\n        this.source = options.source || \"memory\";\n        const layout = SIGNATURE_ELEMENT_LAYOUTS[this.fourCC];\n        if (!layout)\n        {\n            throw new DxbcReadError(\"Unsupported DXBC signature chunk\", {\n                source: this.source,\n                fourCC: this.fourCC\n            });\n        }\n\n        const bytes = chunk.bytes;\n        const reader = new DxbcReader(bytes, { source: this.source });\n        const elementCount = reader.readUint32();\n        const elementOffset = reader.readUint32() || SIGNATURE_TABLE_HEADER_SIZE;\n        if (elementOffset + elementCount * layout.stride > bytes.length)\n        {\n            throw new DxbcReadError(\"DXBC signature elements lie outside the chunk\", {\n                source: this.source,\n                fourCC: this.fourCC,\n                elementCount,\n                elementOffset,\n                chunkSize: bytes.length\n            });\n        }\n\n        this.elements = [];\n        reader.offset = elementOffset;\n        for (let index = 0; index < elementCount; index += 1)\n        {\n            const stream = layout.hasStream ? reader.readUint32() : 0;\n            const semanticNameOffset = reader.readUint32();\n            const semanticIndex = reader.readUint32();\n            const systemValueType = reader.readUint32();\n            const componentType = reader.readUint32();\n            const registerIndex = reader.readUint32();\n            const mask = reader.readUint8();\n            const readWriteMask = reader.readUint8();\n            reader.Skip(2);\n            const minPrecision = layout.hasMinPrecision ? reader.readUint32() : 0;\n\n            this.elements.push({\n                semanticName: this._readSemanticName(bytes, semanticNameOffset, index),\n                semanticIndex,\n                systemValueType,\n                componentType,\n                componentTypeName: DxbcComponentTypeNames[componentType] || \"unknown\",\n                registerIndex,\n                mask,\n                readWriteMask,\n                stream,\n                minPrecision\n            });\n        }\n        return this;\n    }\n\n    /**\n   * Finds a signature element by semantic name and index.\n   *\n   * @param {string} semanticName Case-insensitive semantic name such as `\"TEXCOORD\"`.\n   * @param {number} [semanticIndex] Semantic index, defaulting to 0.\n   * @returns {object|null} Element record or null.\n   */\n    findElement(semanticName, semanticIndex = 0)\n    {\n        const wanted = String(semanticName).toUpperCase();\n        return this.elements.find(\n            (element) => element.semanticName.toUpperCase() === wanted && element.semanticIndex === semanticIndex\n        ) || null;\n    }\n\n    /**\n   * Resolves a null-terminated semantic name inside the chunk payload.\n   *\n   * @param {Uint8Array} bytes Chunk payload.\n   * @param {number} offset Name offset relative to the chunk payload start.\n   * @param {number} index Element index used in error details.\n   * @returns {string} Decoded semantic name.\n   * @private\n   */\n    _readSemanticName(bytes, offset, index)\n    {\n        if (offset >= bytes.length)\n        {\n            throw new DxbcReadError(\"DXBC signature semantic name lies outside the chunk\", {\n                source: this.source,\n                fourCC: this.fourCC,\n                elementIndex: index,\n                offset,\n                chunkSize: bytes.length\n            });\n        }\n        let end = offset;\n        while (end < bytes.length && bytes[end] !== 0)\n        {\n            end += 1;\n        }\n        return semanticNameDecoder.decode(bytes.subarray(offset, end));\n    }\n}\n"],"names":["SIGNATURE_TABLE_HEADER_SIZE","semanticNameDecoder","TextDecoder","SIGNATURE_ELEMENT_LAYOUTS","Object","freeze","ISGN","stride","hasStream","hasMinPrecision","OSGN","PCSG","OSG5","ISG1","OSG1","PSG1","DxbcComponentTypeNames","DxbcSignatureChunk","constructor","fourCC","elements","source","Read","chunk","options","layout","DxbcReadError","bytes","reader","DxbcReader","elementCount","readUint32","elementOffset","length","chunkSize","offset","index","stream","semanticNameOffset","semanticIndex","systemValueType","componentType","registerIndex","mask","readUint8","readWriteMask","Skip","minPrecision","push","semanticName","_readSemanticName","componentTypeName","findElement","wanted","String","toUpperCase","find","element","elementIndex","end","decode","subarray"],"mappings":"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"}

package/dist/formats/dxbc/index.js

@@ -0,0 +1,2 @@
+export { CjsDxbcFormat, CjsDxbcFormat as default } from './CjsDxbcFormat.js';
+//# sourceMappingURL=index.js.map

package/dist/formats/dxbc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/formats/fbx/core/helpers.js

@@ -1032,12 +1032,18 @@ function adler32(bytes) {
  * property arrays.
  */
 class DeflateBitReader {
+  /**
+   * Creates a DeflateBitReader over caller-provided FBX bytes and reader
+   * options.
+   */
   constructor(bytes) {
     this.bytes = bytes;
     this.byteOffset = 0;
     this.bitBuffer = 0;
     this.bitCount = 0;
   }
+
+  /** Reads bits from the current FBX binary reader. */
   readBits(count) {
     let value = 0,
       shift = 0,
@@ -1059,16 +1065,25 @@ class DeflateBitReader {
     }
     return value;
   }
+
+  /**
+   * Moves the compressed-bit cursor to the next byte boundary for the FBX
+   * binary reader.
+   */
   alignByte() {
     this.bitBuffer = 0;
     this.bitCount = 0;
   }
+
+  /** Reads aligned byte from the current FBX binary reader. */
   readAlignedByte() {
     if (this.byteOffset >= this.bytes.byteLength) {
       throw new Error("fbx: compressed array stored block is truncated");
     }
     return this.bytes[this.byteOffset++];
   }
+
+  /** Reads aligned U16 LE from the current FBX binary reader. */
   readAlignedU16LE() {
     const low = this.readAlignedByte(),
       high = this.readAlignedByte();
@@ -1081,6 +1096,7 @@ class DeflateBitReader {
  * inflating compressed FBX property arrays.
  */
 class DeflateHuffmanTable {
+  /** Creates a DeflateHuffmanTable with caller-provided initial state. */
   constructor(lengths) {
     this.tables = [];
     this.maxBits = 0;
@@ -1113,6 +1129,11 @@ class DeflateHuffmanTable {
       this.tables[length][reversed] = symbol;
     }
   }
+
+  /**
+   * Decodes one symbol through the canonical Deflate Huffman table for the FBX
+   * decoder.
+   */
   decode(reader) {
     let code = 0;
     for (let length = 1; length <= this.maxBits; length++) {