@carbonenginejs/runtime 0.1.0-alpha.4 → 0.1.0-alpha.5

package/dist/resource/imageio/ImageIO.js

@@ -0,0 +1,142 @@
+import { ImageIOResult } from '#imageio';
+import { CjsDdsFormat } from '../formats/dds/CjsDdsFormat.js';
+import { CjsGifFormat } from '../formats/gif/CjsGifFormat.js';
+import { CjsJpegFormat } from '../formats/jpeg/CjsJpegFormat.js';
+import { CjsPngFormat } from '../formats/png/CjsPngFormat.js';
+import { CjsTgaFormat } from '../formats/tga/CjsTgaFormat.js';
+
+// Source: imageio/include/Tr2ImageHandler.h
+// Source: imageio/Tr2ImageHandler.cpp
+//
+// Carbon's ImageIO entry points: a registry of per-format handler tables, and
+// ReadImage / IsSaveSupported / SaveImage, which pick the handler by the
+// filename's extension. It routes and never decodes: each image format's
+// `Format.carbon` table does the work (resource/format/CjsImageFormat.js).
+//
+// A namespace of free functions becomes a class of statics, camelCase.
+const Code = ImageIOResult.Code;
+
+/** Registered handler tables, first match wins (GetImageHandlers). */
+const handlers = [];
+let registered = false;
+
+/** Carbon's `ImageIO` registry and entry points (imageio/Tr2ImageHandler.cpp). */
+class ImageIO {
+  /**
+   * Register the built-in image formats once (Tr2ImageHandler.cpp:26-42).
+   * Carbon registers Bmp, Dds, Jpeg, Png, Psd, Tga and Vta; ours register as
+   * each format gains its `carbon` table.
+   */
+  static registerImageIOHandlers() {
+    if (registered) return;
+    registered = true;
+    // Carbon's order (Bmp, Dds, Jpeg, Png, Psd, Tga, Vta) for the ones we have, then ours.
+    ImageIO.registerImageHandler(CjsDdsFormat.carbon);
+    ImageIO.registerImageHandler(CjsJpegFormat.carbon);
+    ImageIO.registerImageHandler(CjsPngFormat.carbon);
+    ImageIO.registerImageHandler(CjsTgaFormat.carbon);
+    ImageIO.registerImageHandler(CjsGifFormat.carbon);
+  }
+
+  /**
+   * Register a handler table (Tr2ImageHandler.cpp:79-82).
+   *
+   * @param {{checkExtension: Function, readImage: Function, isSaveSupported: Function, save: Function}} imageHandler Handler table.
+   */
+  static registerImageHandler(imageHandler) {
+    handlers.push(imageHandler);
+  }
+
+  /**
+   * The text after the last '.', or "" (Tr2ImageHandler.cpp:45-49).
+   *
+   * @param {string} filename File name.
+   * @returns {string} Extension.
+   */
+  static getExtension(filename) {
+    const dot = filename.lastIndexOf(".");
+    return dot >= 0 ? filename.slice(dot + 1) : "";
+  }
+
+  /**
+   * The first handler that claims an extension, or null (Tr2ImageHandler.cpp:51-63).
+   *
+   * @param {string} extension Extension, without the dot.
+   * @returns {object|null} Handler table.
+   */
+  static getImageHandler(extension) {
+    ImageIO.registerImageIOHandlers();
+    return handlers.find(handler => handler.checkExtension(extension)) ?? null;
+  }
+
+  /**
+   * Read an image into a bitmap, picking the handler by the filename in the
+   * load parameters (Tr2ImageHandler.cpp:95-106).
+   *
+   * adapted: a stream becomes the file's bytes.
+   *
+   * @param {Uint8Array|ArrayBuffer} bytes File bytes.
+   * @param {import("#imageio").LoadParameters} loadParameters Load parameters.
+   * @param {import("#imageio").HostBitmap} bitmap Destination bitmap.
+   * @param {import("#imageio").Metadata|null} [metadata] Optional metadata out.
+   * @returns {ImageIOResult} The result.
+   */
+  static readImage(bytes, loadParameters, bitmap, metadata = null) {
+    const handler = ImageIO.getImageHandler(ImageIO.getExtension(loadParameters.filename));
+    if (!handler) return new ImageIOResult(Code.UNRECOGNIZED_IMAGE_TYPE);
+    return handler.readImage(bytes, loadParameters, bitmap, metadata);
+  }
+
+  /**
+   * `readImage` that also serves formats whose decoder is asynchronous (PNG).
+   *
+   * Not Carbon: see CjsImageFormat.readImageAsync.
+   *
+   * @param {Uint8Array|ArrayBuffer} bytes File bytes.
+   * @param {import("#imageio").LoadParameters} loadParameters Load parameters.
+   * @param {import("#imageio").HostBitmap} bitmap Destination bitmap.
+   * @param {import("#imageio").Metadata|null} [metadata] Optional metadata out.
+   * @returns {Promise<ImageIOResult>} The result.
+   */
+  static async readImageAsync(bytes, loadParameters, bitmap, metadata = null) {
+    const handler = ImageIO.getImageHandler(ImageIO.getExtension(loadParameters.filename));
+    if (!handler) return new ImageIOResult(Code.UNRECOGNIZED_IMAGE_TYPE);
+    return handler.readImageAsync(bytes, loadParameters, bitmap, metadata);
+  }
+
+  /**
+   * Whether an image of these dimensions can be saved under a filename
+   * (Tr2ImageHandler.cpp:117-128).
+   *
+   * @param {string} filename Destination file name.
+   * @param {import("#imageio").BitmapDimensions} dimensions Image description.
+   * @returns {ImageIOResult} OK if supported.
+   */
+  static isSaveSupported(filename, dimensions) {
+    const handler = ImageIO.getImageHandler(ImageIO.getExtension(filename));
+    if (!handler) return new ImageIOResult(Code.UNRECOGNIZED_IMAGE_TYPE);
+    return handler.isSaveSupported(dimensions);
+  }
+
+  /**
+   * Save a bitmap in the format a filename names (Tr2ImageHandler.cpp:140-151).
+   *
+   * adapted: Carbon writes to a stream; this returns `{result, bytes}`.
+   *
+   * @param {string} filename Destination file name.
+   * @param {import("#imageio").HostBitmap} bitmap Bitmap to save.
+   * @param {import("#imageio").Metadata|null} [metadata] Optional metadata.
+   * @returns {{result: ImageIOResult, bytes: Uint8Array|null}} The outcome.
+   */
+  static saveImage(filename, bitmap, metadata = null) {
+    const handler = ImageIO.getImageHandler(ImageIO.getExtension(filename));
+    if (!handler) return {
+      result: new ImageIOResult(Code.UNRECOGNIZED_IMAGE_TYPE),
+      bytes: null
+    };
+    return handler.save(bitmap, metadata);
+  }
+}
+
+export { ImageIO };
+//# sourceMappingURL=ImageIO.js.map

package/dist/resource/imageio/ImageIO.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageIO.js","sources":["../../../../src/resource/imageio/ImageIO.js"],"sourcesContent":["// Source: imageio/include/Tr2ImageHandler.h\n// Source: imageio/Tr2ImageHandler.cpp\n//\n// Carbon's ImageIO entry points: a registry of per-format handler tables, and\n// ReadImage / IsSaveSupported / SaveImage, which pick the handler by the\n// filename's extension. It routes and never decodes: each image format's\n// `Format.carbon` table does the work (resource/format/CjsImageFormat.js).\n//\n// A namespace of free functions becomes a class of statics, camelCase.\nimport { ImageIOResult } from \"#imageio\";\nimport { CjsDdsFormat } from \"../formats/dds/CjsDdsFormat.js\";\nimport { CjsGifFormat } from \"../formats/gif/CjsGifFormat.js\";\nimport { CjsJpegFormat } from \"../formats/jpeg/CjsJpegFormat.js\";\nimport { CjsPngFormat } from \"../formats/png/CjsPngFormat.js\";\nimport { CjsTgaFormat } from \"../formats/tga/CjsTgaFormat.js\";\n\nconst Code = ImageIOResult.Code;\n\n/** Registered handler tables, first match wins (GetImageHandlers). */\nconst handlers = [];\n\nlet registered = false;\n\n\n/** Carbon's `ImageIO` registry and entry points (imageio/Tr2ImageHandler.cpp). */\nexport class ImageIO\n{\n\n  /**\n   * Register the built-in image formats once (Tr2ImageHandler.cpp:26-42).\n   * Carbon registers Bmp, Dds, Jpeg, Png, Psd, Tga and Vta; ours register as\n   * each format gains its `carbon` table.\n   */\n  static registerImageIOHandlers()\n  {\n    if (registered) return;\n\n    registered = true;\n    // Carbon's order (Bmp, Dds, Jpeg, Png, Psd, Tga, Vta) for the ones we have, then ours.\n    ImageIO.registerImageHandler(CjsDdsFormat.carbon);\n    ImageIO.registerImageHandler(CjsJpegFormat.carbon);\n    ImageIO.registerImageHandler(CjsPngFormat.carbon);\n    ImageIO.registerImageHandler(CjsTgaFormat.carbon);\n    ImageIO.registerImageHandler(CjsGifFormat.carbon);\n  }\n\n  /**\n   * Register a handler table (Tr2ImageHandler.cpp:79-82).\n   *\n   * @param {{checkExtension: Function, readImage: Function, isSaveSupported: Function, save: Function}} imageHandler Handler table.\n   */\n  static registerImageHandler(imageHandler)\n  {\n    handlers.push(imageHandler);\n  }\n\n  /**\n   * The text after the last '.', or \"\" (Tr2ImageHandler.cpp:45-49).\n   *\n   * @param {string} filename File name.\n   * @returns {string} Extension.\n   */\n  static getExtension(filename)\n  {\n    const dot = filename.lastIndexOf(\".\");\n\n    return dot >= 0 ? filename.slice(dot + 1) : \"\";\n  }\n\n  /**\n   * The first handler that claims an extension, or null (Tr2ImageHandler.cpp:51-63).\n   *\n   * @param {string} extension Extension, without the dot.\n   * @returns {object|null} Handler table.\n   */\n  static getImageHandler(extension)\n  {\n    ImageIO.registerImageIOHandlers();\n\n    return handlers.find(handler => handler.checkExtension(extension)) ?? null;\n  }\n\n  /**\n   * Read an image into a bitmap, picking the handler by the filename in the\n   * load parameters (Tr2ImageHandler.cpp:95-106).\n   *\n   * adapted: a stream becomes the file's bytes.\n   *\n   * @param {Uint8Array|ArrayBuffer} bytes File bytes.\n   * @param {import(\"#imageio\").LoadParameters} loadParameters Load parameters.\n   * @param {import(\"#imageio\").HostBitmap} bitmap Destination bitmap.\n   * @param {import(\"#imageio\").Metadata|null} [metadata] Optional metadata out.\n   * @returns {ImageIOResult} The result.\n   */\n  static readImage(bytes, loadParameters, bitmap, metadata = null)\n  {\n    const handler = ImageIO.getImageHandler(ImageIO.getExtension(loadParameters.filename));\n\n    if (!handler) return new ImageIOResult(Code.UNRECOGNIZED_IMAGE_TYPE);\n\n    return handler.readImage(bytes, loadParameters, bitmap, metadata);\n  }\n\n  /**\n   * `readImage` that also serves formats whose decoder is asynchronous (PNG).\n   *\n   * Not Carbon: see CjsImageFormat.readImageAsync.\n   *\n   * @param {Uint8Array|ArrayBuffer} bytes File bytes.\n   * @param {import(\"#imageio\").LoadParameters} loadParameters Load parameters.\n   * @param {import(\"#imageio\").HostBitmap} bitmap Destination bitmap.\n   * @param {import(\"#imageio\").Metadata|null} [metadata] Optional metadata out.\n   * @returns {Promise<ImageIOResult>} The result.\n   */\n  static async readImageAsync(bytes, loadParameters, bitmap, metadata = null)\n  {\n    const handler = ImageIO.getImageHandler(ImageIO.getExtension(loadParameters.filename));\n\n    if (!handler) return new ImageIOResult(Code.UNRECOGNIZED_IMAGE_TYPE);\n\n    return handler.readImageAsync(bytes, loadParameters, bitmap, metadata);\n  }\n\n  /**\n   * Whether an image of these dimensions can be saved under a filename\n   * (Tr2ImageHandler.cpp:117-128).\n   *\n   * @param {string} filename Destination file name.\n   * @param {import(\"#imageio\").BitmapDimensions} dimensions Image description.\n   * @returns {ImageIOResult} OK if supported.\n   */\n  static isSaveSupported(filename, dimensions)\n  {\n    const handler = ImageIO.getImageHandler(ImageIO.getExtension(filename));\n\n    if (!handler) return new ImageIOResult(Code.UNRECOGNIZED_IMAGE_TYPE);\n\n    return handler.isSaveSupported(dimensions);\n  }\n\n  /**\n   * Save a bitmap in the format a filename names (Tr2ImageHandler.cpp:140-151).\n   *\n   * adapted: Carbon writes to a stream; this returns `{result, bytes}`.\n   *\n   * @param {string} filename Destination file name.\n   * @param {import(\"#imageio\").HostBitmap} bitmap Bitmap to save.\n   * @param {import(\"#imageio\").Metadata|null} [metadata] Optional metadata.\n   * @returns {{result: ImageIOResult, bytes: Uint8Array|null}} The outcome.\n   */\n  static saveImage(filename, bitmap, metadata = null)\n  {\n    const handler = ImageIO.getImageHandler(ImageIO.getExtension(filename));\n\n    if (!handler) return { result: new ImageIOResult(Code.UNRECOGNIZED_IMAGE_TYPE), bytes: null };\n\n    return handler.save(bitmap, metadata);\n  }\n\n}\n"],"names":["Code","ImageIOResult","handlers","registered","ImageIO","registerImageIOHandlers","registerImageHandler","CjsDdsFormat","carbon","CjsJpegFormat","CjsPngFormat","CjsTgaFormat","CjsGifFormat","imageHandler","push","getExtension","filename","dot","lastIndexOf","slice","getImageHandler","extension","find","handler","checkExtension","readImage","bytes","loadParameters","bitmap","metadata","UNRECOGNIZED_IMAGE_TYPE","readImageAsync","isSaveSupported","dimensions","saveImage","result","save"],"mappings":"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"}

package/dist/resource/imageio/index.js

@@ -0,0 +1,17 @@
+import { blue } from '#blue';
+import { HostBitmap } from '#imageio';
+export * from '#imageio';
+export { ImageIO } from './ImageIO.js';
+
+// Carbon's imageio library as the resource layer exposes it: the CPU image
+// containers (which live in global/imageio because the abstraction layer shares
+// them) re-exported here, plus the handler registry that reaches the image
+// formats.
+//
+// HostBitmap is registered with blue.classes, so a layer that may not import
+// the resource layer - trinityal - can still build one by name.
+blue.classes.RegisterClasses([{
+  name: "HostBitmap",
+  type: HostBitmap
+}]);
+//# sourceMappingURL=index.js.map

package/dist/resource/imageio/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../src/resource/imageio/index.js"],"sourcesContent":["// Carbon's imageio library as the resource layer exposes it: the CPU image\n// containers (which live in global/imageio because the abstraction layer shares\n// them) re-exported here, plus the handler registry that reaches the image\n// formats.\n//\n// HostBitmap is registered with blue.classes, so a layer that may not import\n// the resource layer - trinityal - can still build one by name.\nimport { blue } from \"#blue\";\nimport { HostBitmap } from \"#imageio\";\n\nexport * from \"#imageio\";\nexport * from \"./ImageIO.js\";\n\nblue.classes.RegisterClasses([\n  { name: \"HostBitmap\", type: HostBitmap }\n]);\n"],"names":["blue","classes","RegisterClasses","name","type","HostBitmap"],"mappings":";;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AAOAA,IAAI,CAACC,OAAO,CAACC,eAAe,CAAC,CAC3B;AAAEC,EAAAA,IAAI,EAAE,YAAY;AAAEC,EAAAA,IAAI,EAAEC;AAAW,CAAC,CACzC,CAAC"}

package/dist/resource/index.js

@@ -45,6 +45,13 @@ export { Tr2RenderStateSetup } from './shader/reflection/Tr2RenderStateSetup.js'
 export { SHADER_STAGE_COUNT, ShaderStageType, requireShaderStageType } from './shader/reflection/shaderStage.js';
 export { Tr2SamplerSetup } from './shader/sampler/Tr2SamplerSetup.js';
 export { RegisterShaderResources, ShaderResourceExtensions } from './shader/registerShaderResources.js';
+export { CjsTextureArrayConstructor, RegisterTextureArray, TextureArrayPrefix } from './texture/CjsTextureArrayConstructor.js';
+export { CjsTexturePipelineStepArray } from './texture/CjsTexturePipelineStepArray.js';
+export { CjsTexturePipelineStepPack } from './texture/CjsTexturePipelineStepPack.js';
+export { CjsTexturePackConstructor, RegisterTexturePack, TexturePackPrefix } from './texture/CjsTexturePackConstructor.js';
+export { CjsTexturePipelineStepConvert } from './texture/CjsTexturePipelineStepConvert.js';
+export { CjsTexturePipelineStepResize } from './texture/CjsTexturePipelineStepResize.js';
+export { RegisterTextureResources, TextureResourceExtensions } from './texture/registerTextureResources.js';
 export { CjsTextureArrayRes } from './texture/CjsTextureArrayRes.js';
 export { CjsTextureArrayResParameterProxy } from './texture/CjsTextureArrayResParameterProxy.js';
 export { RegisterSolidColorTexture, SolidColorTextureConstructor } from './texture/SolidColorTextureConstructor.js';

package/dist/resource/index.js.map

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

package/dist/resource/shader/reflection/Tr2EffectResource.js

@@ -1,5 +1,5 @@
 import { assertCarbonRecord } from '../../format/carbonRecordGuard.js';
-import { CjsSchema, type } from '#schema';
+import { CjsSchema, impl, type } from '#schema';
 import { CjsModel } from '#model';
 import '#utils/is';
 import { recordText, toRecordText } from './carbonRecordFields.js';
@@ -23,6 +23,26 @@ class Tr2EffectResource extends CjsModel {
   /** arrayElements (uint32_t) */
   arrayElements = 0;
 
+  /**
+   * The member parameter names, layer (or channel) 0 first, when a browser
+   * backend merged several of this stage's textures into the one bound at this
+   * register; null otherwise.
+   *
+   * Not Carbon. WebGL2 has sixteen texture units, so a family of maps
+   * (Detail1Map..Detail3Map) is merged into one texture when the container is
+   * built, and the pass's backend block records the merge. The reader copies it
+   * here so the effect can keep its named parameters and bind the assembled
+   * texture in their place. The members' own registers stay reflected; the
+   * backend no longer declares them.
+   */
+  arrayLayers = null;
+
+  /**
+   * Whether the merge packs the members as channels of one 2D texture, rather
+   * than stacking them as layers of a 2D array. Not Carbon; see `arrayLayers`.
+   */
+  packed = false;
+
   /**
    * Build one SRV or UAV from its Carbon v15 description record.
    *
@@ -111,7 +131,9 @@ CjsSchema.define(Tr2EffectResource, {
     isAutoregister: type.boolean,
     name: type.string,
     type: [type.int32, type.enum("Type")],
-    arrayElements: type.uint32
+    arrayElements: type.uint32,
+    arrayLayers: [impl.custom, type.list("string")],
+    packed: [impl.custom, type.boolean]
   }
 });
 

package/dist/resource/shader/reflection/Tr2EffectResource.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2EffectResource.js","sources":["../../../../../src/resource/shader/reflection/Tr2EffectResource.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2EffectDescription.h\nimport { assertCarbonRecord } from \"../../format/carbonRecordGuard.js\";\nimport { CjsSchema, impl, type } from \"#schema\";\nimport { CjsModel } from \"#model\";\nimport {\n} from \"#utils/is\";\nimport { recordText, toRecordText } from \"./carbonRecordFields.js\";\n\n/** Reflected SRV or UAV resource metadata. */\nexport class Tr2EffectResource extends CjsModel\n{\n\n  /** isSRGB (bool) */\n  isSRGB = false;\n\n  /** isAutoregister (bool) */\n  isAutoregister = false;\n\n  /** name (const char*) */\n  name = \"\";\n\n  /** type (Type - enum Type) */\n  type = 0;\n\n  /** arrayElements (uint32_t) */\n  arrayElements = 0;\n\n  /**\n   * Build one SRV or UAV from its Carbon v15 description record.\n   *\n   * Both a texture record and a UAV record land here, and they are not the same\n   * shape: a UAV record carries no `isSRGB` at all. Carbon's reader hardcodes\n   * `isSRGB = false` for UAVs rather than reading a byte, and `Uav::Save` omits\n   * it, so the field being absent is correct rather than missing — reading\n   * `undefined` through `!!` reproduces Carbon exactly. The array size is spelled\n   * `count` in the record and `arrayElements` on the class.\n   *\n   * @param {object} record Carbon texture or UAV record.\n   * @returns {Tr2EffectResource} Reflected resource.\n   */\n  static fromCarbonBinary(record)\n  {\n    assertCarbonRecord(record, \"resource\");\n\n    const resource = new this();\n    resource.name = recordText(record.name);\n    resource.type = record.type;\n    resource.arrayElements = record.count;\n    resource.isSRGB = !!record.isSRGB;\n    resource.isAutoregister = !!record.isAutoregister;\n    return resource;\n  }\n\n  /**\n   * Emit this resource as a Carbon v15 texture or UAV record.\n   *\n   * A UAV record is one byte shorter: it carries no `isSRGB`, because Carbon's\n   * reader hardcodes it false and `Uav::Save` omits it. Emitting the field\n   * anyway would desynchronise every following field in the stage.\n   *\n   * @param {number} registerIndex Register this resource is bound at.\n   * @param {boolean} [uav] Whether to emit the UAV shape.\n   * @returns {object} Carbon texture or UAV record.\n   */\n  toCarbonBinary(registerIndex, uav = false)\n  {\n    const record = {\n      registerIndex,\n      name: toRecordText(this.name),\n      type: this.type,\n      count: this.arrayElements,\n      isAutoregister: this.isAutoregister ? 1 : 0\n    };\n    if (uav)\n    {\n      return record;\n    }\n    return {\n      registerIndex,\n      name: record.name,\n      type: record.type,\n      count: record.count,\n      isSRGB: this.isSRGB ? 1 : 0,\n      isAutoregister: record.isAutoregister\n    };\n  }\n\n  static BINDLESS_SAMPLER = 100;\n\n  static Type = Object.freeze({\n    TEXTURE_1D: 1,\n    TEXTURE_2D: 2,\n    TEXTURE_3D: 3,\n    TEXTURE_CUBE: 4,\n    TEXTURE_TYPELESS: 5,\n    BUFFER: 6,\n    STRUCTURED_BUFFER: 7,\n    TBUFFER: 8,\n    BYTEADDRESS_BUFFER: 9,\n    UAV_RWTYPED: 10,\n    UAV_RWSTRUCTURED: 11,\n    UAV_RWBYTEADDRESS: 12,\n    UAV_APPEND_STRUCTURED: 13,\n    UAV_CONSUME_STRUCTURED: 14,\n    UAV_RWSTRUCTURED_WITH_COUNTER: 15\n  });\n\n}\n\n// Declared imperatively rather than with decorators, so this module stays\n// plain ESM that loads from source without a transform. The decorator\n// expressions are reused verbatim, so the registered metadata is identical.\n// Statics belong in `methods`: decorateMethod targets the prototype and\n// would register a static as an instance field.\nCjsSchema.define(Tr2EffectResource, {\n  className: \"Tr2EffectResource\",\n  family: \"shader\",\n  fields: {\n    isSRGB: type.boolean,\n    isAutoregister: type.boolean,\n    name: type.string,\n    type: [ type.int32, type.enum(\"Type\") ],\n    arrayElements: type.uint32\n  }\n});\n"],"names":["Tr2EffectResource","CjsModel","isSRGB","isAutoregister","name","type","arrayElements","fromCarbonBinary","record","assertCarbonRecord","resource","recordText","count","toCarbonBinary","registerIndex","uav","toRecordText","BINDLESS_SAMPLER","Type","Object","freeze","TEXTURE_1D","TEXTURE_2D","TEXTURE_3D","TEXTURE_CUBE","TEXTURE_TYPELESS","BUFFER","STRUCTURED_BUFFER","TBUFFER","BYTEADDRESS_BUFFER","UAV_RWTYPED","UAV_RWSTRUCTURED","UAV_RWBYTEADDRESS","UAV_APPEND_STRUCTURED","UAV_CONSUME_STRUCTURED","UAV_RWSTRUCTURED_WITH_COUNTER","CjsSchema","define","className","family","fields","boolean","string","int32","enum","uint32"],"mappings":"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"}
+{"version":3,"file":"Tr2EffectResource.js","sources":["../../../../../src/resource/shader/reflection/Tr2EffectResource.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2EffectDescription.h\nimport { assertCarbonRecord } from \"../../format/carbonRecordGuard.js\";\nimport { CjsSchema, impl, type } from \"#schema\";\nimport { CjsModel } from \"#model\";\nimport {\n} from \"#utils/is\";\nimport { recordText, toRecordText } from \"./carbonRecordFields.js\";\n\n/** Reflected SRV or UAV resource metadata. */\nexport class Tr2EffectResource extends CjsModel\n{\n\n  /** isSRGB (bool) */\n  isSRGB = false;\n\n  /** isAutoregister (bool) */\n  isAutoregister = false;\n\n  /** name (const char*) */\n  name = \"\";\n\n  /** type (Type - enum Type) */\n  type = 0;\n\n  /** arrayElements (uint32_t) */\n  arrayElements = 0;\n\n  /**\n   * The member parameter names, layer (or channel) 0 first, when a browser\n   * backend merged several of this stage's textures into the one bound at this\n   * register; null otherwise.\n   *\n   * Not Carbon. WebGL2 has sixteen texture units, so a family of maps\n   * (Detail1Map..Detail3Map) is merged into one texture when the container is\n   * built, and the pass's backend block records the merge. The reader copies it\n   * here so the effect can keep its named parameters and bind the assembled\n   * texture in their place. The members' own registers stay reflected; the\n   * backend no longer declares them.\n   */\n  arrayLayers = null;\n\n  /**\n   * Whether the merge packs the members as channels of one 2D texture, rather\n   * than stacking them as layers of a 2D array. Not Carbon; see `arrayLayers`.\n   */\n  packed = false;\n\n  /**\n   * Build one SRV or UAV from its Carbon v15 description record.\n   *\n   * Both a texture record and a UAV record land here, and they are not the same\n   * shape: a UAV record carries no `isSRGB` at all. Carbon's reader hardcodes\n   * `isSRGB = false` for UAVs rather than reading a byte, and `Uav::Save` omits\n   * it, so the field being absent is correct rather than missing — reading\n   * `undefined` through `!!` reproduces Carbon exactly. The array size is spelled\n   * `count` in the record and `arrayElements` on the class.\n   *\n   * @param {object} record Carbon texture or UAV record.\n   * @returns {Tr2EffectResource} Reflected resource.\n   */\n  static fromCarbonBinary(record)\n  {\n    assertCarbonRecord(record, \"resource\");\n\n    const resource = new this();\n    resource.name = recordText(record.name);\n    resource.type = record.type;\n    resource.arrayElements = record.count;\n    resource.isSRGB = !!record.isSRGB;\n    resource.isAutoregister = !!record.isAutoregister;\n    return resource;\n  }\n\n  /**\n   * Emit this resource as a Carbon v15 texture or UAV record.\n   *\n   * A UAV record is one byte shorter: it carries no `isSRGB`, because Carbon's\n   * reader hardcodes it false and `Uav::Save` omits it. Emitting the field\n   * anyway would desynchronise every following field in the stage.\n   *\n   * @param {number} registerIndex Register this resource is bound at.\n   * @param {boolean} [uav] Whether to emit the UAV shape.\n   * @returns {object} Carbon texture or UAV record.\n   */\n  toCarbonBinary(registerIndex, uav = false)\n  {\n    const record = {\n      registerIndex,\n      name: toRecordText(this.name),\n      type: this.type,\n      count: this.arrayElements,\n      isAutoregister: this.isAutoregister ? 1 : 0\n    };\n    if (uav)\n    {\n      return record;\n    }\n    return {\n      registerIndex,\n      name: record.name,\n      type: record.type,\n      count: record.count,\n      isSRGB: this.isSRGB ? 1 : 0,\n      isAutoregister: record.isAutoregister\n    };\n  }\n\n  static BINDLESS_SAMPLER = 100;\n\n  static Type = Object.freeze({\n    TEXTURE_1D: 1,\n    TEXTURE_2D: 2,\n    TEXTURE_3D: 3,\n    TEXTURE_CUBE: 4,\n    TEXTURE_TYPELESS: 5,\n    BUFFER: 6,\n    STRUCTURED_BUFFER: 7,\n    TBUFFER: 8,\n    BYTEADDRESS_BUFFER: 9,\n    UAV_RWTYPED: 10,\n    UAV_RWSTRUCTURED: 11,\n    UAV_RWBYTEADDRESS: 12,\n    UAV_APPEND_STRUCTURED: 13,\n    UAV_CONSUME_STRUCTURED: 14,\n    UAV_RWSTRUCTURED_WITH_COUNTER: 15\n  });\n\n}\n\n// Declared imperatively rather than with decorators, so this module stays\n// plain ESM that loads from source without a transform. The decorator\n// expressions are reused verbatim, so the registered metadata is identical.\n// Statics belong in `methods`: decorateMethod targets the prototype and\n// would register a static as an instance field.\nCjsSchema.define(Tr2EffectResource, {\n  className: \"Tr2EffectResource\",\n  family: \"shader\",\n  fields: {\n    isSRGB: type.boolean,\n    isAutoregister: type.boolean,\n    name: type.string,\n    type: [ type.int32, type.enum(\"Type\") ],\n    arrayElements: type.uint32,\n    arrayLayers: [ impl.custom, type.list(\"string\") ],\n    packed: [ impl.custom, type.boolean ]\n  }\n});\n"],"names":["Tr2EffectResource","CjsModel","isSRGB","isAutoregister","name","type","arrayElements","arrayLayers","packed","fromCarbonBinary","record","assertCarbonRecord","resource","recordText","count","toCarbonBinary","registerIndex","uav","toRecordText","BINDLESS_SAMPLER","Type","Object","freeze","TEXTURE_1D","TEXTURE_2D","TEXTURE_3D","TEXTURE_CUBE","TEXTURE_TYPELESS","BUFFER","STRUCTURED_BUFFER","TBUFFER","BYTEADDRESS_BUFFER","UAV_RWTYPED","UAV_RWSTRUCTURED","UAV_RWBYTEADDRESS","UAV_APPEND_STRUCTURED","UAV_CONSUME_STRUCTURED","UAV_RWSTRUCTURED_WITH_COUNTER","CjsSchema","define","className","family","fields","boolean","string","int32","enum","uint32","impl","custom","list"],"mappings":"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"}

package/dist/resource/shader/reflection/Tr2Pass.js

@@ -2,9 +2,12 @@ import { assertCarbonRecord } from '../../format/carbonRecordGuard.js';
 import { CjsSchema, impl, type } from '#schema';
 import { CjsModel } from '#model';
 import '#utils/is';
-import { SHADER_STAGE_COUNT, requireShaderStageType } from './shaderStage.js';
+import { SHADER_STAGE_COUNT, requireShaderStageType, ShaderStageType } from './shaderStage.js';
 import { Tr2EffectStageInput } from './Tr2EffectStageInput.js';
 import { recordBytes, toRecordBlob } from './carbonRecordFields.js';
+import { peekBackendEngineId, CARBON_BACKEND_ENGINE_ID } from '../../format/carbonEffect/backendEngineId.js';
+import { readBackendBlock } from '../../format/carbonEffect/carbonEffectBackendBlock.js';
+import { readGlslBackendBlock } from '../../formats/webgl/core/glslBackendBlock.js';
 
 // Source: trinity/trinity/Shader/Tr2EffectDescription.h
 
@@ -53,9 +56,11 @@ class Tr2Pass extends CjsModel {
    * explicit empty slots rather than left as holes. The stage's own type byte
    * decides where it lands; position in the record does not.
    *
-   * The optional backend block is retained verbatim and not interpreted here. It
-   * is the one place the container diverges by backend, and deciding what it
-   * means is the engine's job, not the reader's.
+   * The optional backend block is retained verbatim. It is the one place the
+   * container diverges by backend, and deciding what it means is the engine's
+   * job, not the reader's - with one exception: the texture merges it records
+   * are copied onto the pixel stage's reflected resources
+   * (`readMergedResources`).
    *
    * @param {object} record Carbon pass record.
    * @returns {Tr2Pass} Reflected pass.
@@ -106,9 +111,72 @@ class Tr2Pass extends CjsModel {
         if (stage?.exists && stage.signature) stage.signature.backendBlock = pass.backendBlock;
       }
     }
+
+    // The one part of the block that is not the backend's alone: which textures
+    // were merged. The effect binds by register from this reflection, so the
+    // merged register has to say what it now holds.
+    const pixel = pass.stageInputs[ShaderStageType.PIXEL_SHADER];
+    for (const merge of Tr2Pass.readMergedResources(pass.backendBlock)) {
+      const resource = pixel.resources.get(merge.register);
+      if (!resource) {
+        throw new Error(`Backend block merges into t${merge.register}, which the pixel stage does not reflect`);
+      }
+      resource.arrayLayers = merge.arrayLayers;
+      resource.packed = merge.packed;
+    }
     return pass;
   }
 
+  /**
+   * The texture merges a pass's backend block records, each at the register the
+   * merged texture binds to.
+   *
+   * Not Carbon; see `Tr2EffectResource.arrayLayers`. The merge list is shared by
+   * both browser backends, but where the merged texture landed is not: WebGPU
+   * tags the binding with the merge's id, and the GLSL emitter declares it as
+   * `s` + the merge's output name at the first member it met. A merge with no
+   * such binding was never sampled in this body, so it is left out. Blocks of
+   * any other backend record no merges.
+   *
+   * @param {{bytes: Uint8Array}|null} backendBlock The pass's backend block.
+   * @returns {Array<{register: number, arrayLayers: string[], packed: boolean}>} The merges.
+   */
+  static readMergedResources(backendBlock) {
+    if (!backendBlock) return [];
+    const engine = peekBackendEngineId(backendBlock.bytes);
+    let transforms;
+    let registerOf;
+    if (engine === CARBON_BACKEND_ENGINE_ID.webgpu) {
+      const block = readBackendBlock(backendBlock.bytes, {
+        source: "Tr2Pass.backendBlock"
+      });
+      const bindings = block.bindGroups.flatMap(group => group.bindings);
+      transforms = block.transforms;
+      registerOf = transform => bindings.find(binding => binding.transformId === transform.id)?.registerIndex;
+    } else if (engine === CARBON_BACKEND_ENGINE_ID.webgl2) {
+      const block = readGlslBackendBlock(backendBlock.bytes, {
+        source: "Tr2Pass.backendBlock"
+      });
+      const bindings = block.stages.pixel?.bindings ?? [];
+      transforms = block.transforms;
+      registerOf = transform => bindings.find(binding => binding.kind === "resource" && binding.name === `s${transform.output.name}`)?.registerIndex;
+    } else {
+      return [];
+    }
+    const merges = [];
+    for (const transform of transforms) {
+      if (transform.kind !== "texture-2d-array" && transform.kind !== "texture-2d-packed") continue;
+      const register = registerOf(transform);
+      if (register === undefined) continue;
+      merges.push({
+        register,
+        arrayLayers: transform.inputs.map(input => input.parameter),
+        packed: transform.kind === "texture-2d-packed"
+      });
+    }
+    return merges;
+  }
+
   /**
    * The populated stages in the order they should be written.
    *
@@ -173,7 +241,10 @@ CjsSchema.define(Tr2Pass, {
     indirectLayout: type.rawStruct("Tr2IndirectDrawBufferLayout"),
     renderStateValues: [impl.adapted, impl.reason("Carbon interns the state block while reading (Tr2EffectStateManager::RegisterRenderStateSetup, .h:118) and keeps only the renderStates index (Tr2EffectDescription.h:202). Ours interns at the Trinity boundary, so the authored state/value pairs are retained until then; see Tr2EffectStateManager.registerShaderHandles."), type.rawStruct("CjsEffectRenderStateValues")],
     stageOrder: [impl.custom, impl.reason("Carbon indexes pass stages by type in a fixed array and loses the file's ordering; the port retains it so a body can be re-emitted as the file that produced it."), type.rawStruct("CjsEffectStageOrder")],
-    backendBlock: [impl.custom, impl.reason("Carbon ends a pass at its render states; CarbonEngineJS containers may append one per-pass block carrying the backend program, which the resource retains uninterpreted."), type.rawStruct("CjsEffectBackendBlock")]
+    backendBlock: [impl.custom, impl.reason("Carbon ends a pass at its render states; CarbonEngineJS containers may append one per-pass block carrying the backend program, which the resource retains, reading only its texture merges."), type.rawStruct("CjsEffectBackendBlock")]
+  },
+  methods: {
+    readMergedResources: impl.custom
   }
 });
 

package/dist/resource/shader/reflection/Tr2Pass.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2Pass.js","sources":["../../../../../src/resource/shader/reflection/Tr2Pass.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2EffectDescription.h\nimport { assertCarbonRecord } from \"../../format/carbonRecordGuard.js\";\nimport { CjsSchema, impl, type } from \"#schema\";\nimport { CjsModel } from \"#model\";\nimport {\n} from \"#utils/is\";\nimport { requireShaderStageType, SHADER_STAGE_COUNT } from \"./shaderStage.js\";\nimport { Tr2EffectStageInput } from \"./Tr2EffectStageInput.js\";\nimport { recordBytes, toRecordBlob } from \"./carbonRecordFields.js\";\n\n/** Reflected effect pass; Carbon's interned program and state handles are kept as authored data. */\nexport class Tr2Pass extends CjsModel\n{\n\n  /** stageInputs (Tr2EffectStageInput) */\n  stageInputs = [];\n\n  /** renderStates (unsigned int) */\n  renderStates = 0;\n\n  /** shaderTypeMask (unsigned int) */\n  shaderTypeMask = 0;\n\n  /** shaderProgram (unsigned int) */\n  shaderProgram = 0;\n\n  /** resourceSetDesc (Tr2ResourceSetDescriptionAL) */\n  resourceSetDesc = null;\n\n  /** indirectLayout (Tr2IndirectDrawBufferLayout) */\n  indirectLayout = null;\n\n  /** Exact authored render-state pairs retained before an engine creates a state handle. */\n  renderStateValues = [];\n\n  /** Optional per-pass backend block, absent in a stock Carbon file. */\n  backendBlock = null;\n\n  /**\n   * Stage types in the order the file stored them.\n   *\n   * `stageInputs` is indexed by stage type, as Carbon's fixed array is, so the\n   * file's ordering is not recoverable from it. That ordering is authored rather\n   * than derivable: measured over 288,528 passes in the shipped corpus, 156 put\n   * geometry before pixel (`0,3,1`) and 12 put it after (`0,1,3`). Any sort loses\n   * one group or the other, so the sequence is kept.\n   */\n  stageOrder = [];\n\n  /**\n   * Build one pass from its Carbon v15 description record.\n   *\n   * Carbon writes only the stages a pass actually uses, but the class keeps a\n   * fixed six-slot array indexed by stage type, so absent stages are filled with\n   * explicit empty slots rather than left as holes. The stage's own type byte\n   * decides where it lands; position in the record does not.\n   *\n   * The optional backend block is retained verbatim and not interpreted here. It\n   * is the one place the container diverges by backend, and deciding what it\n   * means is the engine's job, not the reader's.\n   *\n   * @param {object} record Carbon pass record.\n   * @returns {Tr2Pass} Reflected pass.\n   */\n  static fromCarbonBinary(record)\n  {\n    assertCarbonRecord(record, \"pass\");\n\n    const pass = new this();\n    const renderStateIds = new Set();\n    pass.renderStateValues = record.renderStates.map(entry =>\n    {\n      if (renderStateIds.has(entry.state))\n      {\n        throw new Error(\n          `Carbon effect render-state id ${entry.state} is duplicated`\n        );\n      }\n      renderStateIds.add(entry.state);\n      return { state: entry.state, value: entry.value };\n    });\n\n    pass.stageInputs = Array.from(\n      { length: SHADER_STAGE_COUNT },\n      (_, stageType) => Tr2EffectStageInput.createEmpty(stageType)\n    );\n    pass.shaderTypeMask = 0;\n\n    for (const stageRecord of record.stages)\n    {\n      const stage = Tr2EffectStageInput.fromCarbonBinary(stageRecord);\n      const stageType = requireShaderStageType(stage.stageType);\n      if ((pass.shaderTypeMask & (1 << stageType)) !== 0)\n      {\n        throw new Error(\n          `Carbon effect stage type ${stageType} is duplicated`\n        );\n      }\n      pass.stageInputs[stageType] = stage;\n      pass.shaderTypeMask = (pass.shaderTypeMask | (1 << stageType)) >>> 0;\n    }\n\n    pass.stageOrder = record.stages.map(stage => stage.type);\n    pass.backendBlock = record.backendBlock\n      ? { bytes: recordBytes(record.backendBlock), size: record.backendBlock.size }\n      : null;\n\n    // THE BLOCK RIDES THE SIGNATURE, STILL UNINTERPRETED. Carbon's signature is\n    // the one thing Trinity hands a backend at CreateShader besides the\n    // bytecode (Tr2EffectDescription.cpp:589-593), and backends consume it\n    // without adding to it - Metal even refuses a field it cannot honour\n    // (Tr2ShaderALMetal.mm:24-27). Our per-pass block is backend information\n    // of exactly that kind, so it travels the same road: stamped on every stage\n    // of the pass, read by the backend whose block it is, ignored by the rest.\n    // The pass keeps its own copy for the format libraries that read it today.\n    if (pass.backendBlock)\n    {\n      for (const stage of pass.stageInputs)\n      {\n        if (stage?.exists && stage.signature) stage.signature.backendBlock = pass.backendBlock;\n      }\n    }\n\n    return pass;\n  }\n\n\n  /**\n   * The populated stages in the order they should be written.\n   *\n   * A retained order wins; anything present but unlisted follows in stage-type\n   * order, so a pass assembled by hand still emits every stage it has.\n   *\n   * @returns {Array<object>} Stages in file order.\n   */\n  #orderedStages()\n  {\n    const present = this.stageInputs.filter(stage => stage?.exists);\n    const ordered = [];\n    for (const stageType of this.stageOrder)\n    {\n      const stage = present.find(entry => entry.stageType === stageType);\n      if (stage && !ordered.includes(stage)) ordered.push(stage);\n    }\n    for (const stage of present)\n    {\n      if (!ordered.includes(stage)) ordered.push(stage);\n    }\n    return ordered;\n  }\n\n  /**\n   * Emit this pass as a Carbon v15 record.\n   *\n   * Only stages that exist are written, in ascending stage type. The class keeps\n   * six slots because Carbon addresses them positionally in memory; the file\n   * stores a count and only the populated ones.\n   *\n   * Render states are sorted by id because Carbon holds them in a `std::map`.\n   *\n   * @returns {object} Carbon pass record.\n   */\n  toCarbonBinary()\n  {\n    const record = {\n      stages: this.#orderedStages().map(stage => stage.toCarbonBinary()),\n      renderStates: this.renderStateValues\n        .map(entry => ({ state: entry.state, value: entry.value }))\n        .sort((left, right) => left.state - right.state)\n    };\n    if (this.backendBlock)\n    {\n      record.backendBlock = toRecordBlob(\n        this.backendBlock.bytes,\n        this.backendBlock.size\n      );\n    }\n    return record;\n  }\n}\n\n// Declared imperatively rather than with decorators, so this module stays\n// plain ESM that loads from source without a transform. The decorator\n// expressions are reused verbatim, so the registered metadata is identical.\n// Statics belong in `methods`: decorateMethod targets the prototype and\n// would register a static as an instance field.\nCjsSchema.define(Tr2Pass, {\n  className: \"Tr2Pass\",\n  family: \"shader\",\n  fields: {\n    stageInputs: type.list(\"Tr2EffectStageInput\"),\n    renderStates: type.uint32,\n    shaderTypeMask: type.uint32,\n    shaderProgram: type.uint32,\n    resourceSetDesc: type.rawStruct(\"Tr2ResourceSetDescriptionAL\"),\n    indirectLayout: type.rawStruct(\"Tr2IndirectDrawBufferLayout\"),\n    renderStateValues: [ impl.adapted, impl.reason(\"Carbon interns the state block while reading (Tr2EffectStateManager::RegisterRenderStateSetup, .h:118) and keeps only the renderStates index (Tr2EffectDescription.h:202). Ours interns at the Trinity boundary, so the authored state/value pairs are retained until then; see Tr2EffectStateManager.registerShaderHandles.\"), type.rawStruct(\"CjsEffectRenderStateValues\") ],\n    stageOrder: [ impl.custom, impl.reason(\"Carbon indexes pass stages by type in a fixed array and loses the file's ordering; the port retains it so a body can be re-emitted as the file that produced it.\"), type.rawStruct(\"CjsEffectStageOrder\") ],\n    backendBlock: [ impl.custom, impl.reason(\"Carbon ends a pass at its render states; CarbonEngineJS containers may append one per-pass block carrying the backend program, which the resource retains uninterpreted.\"), type.rawStruct(\"CjsEffectBackendBlock\") ]\n  }\n});\n"],"names":["Tr2Pass","CjsModel","stageInputs","renderStates","shaderTypeMask","shaderProgram","resourceSetDesc","indirectLayout","renderStateValues","backendBlock","stageOrder","fromCarbonBinary","record","assertCarbonRecord","pass","renderStateIds","Set","map","entry","has","state","Error","add","value","Array","from","length","SHADER_STAGE_COUNT","_","stageType","Tr2EffectStageInput","createEmpty","stageRecord","stages","stage","requireShaderStageType","type","bytes","recordBytes","size","exists","signature","#orderedStages","present","filter","ordered","find","includes","push","toCarbonBinary","sort","left","right","toRecordBlob","CjsSchema","define","className","family","fields","list","uint32","rawStruct","impl","adapted","reason","custom"],"mappings":"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"}
+{"version":3,"file":"Tr2Pass.js","sources":["../../../../../src/resource/shader/reflection/Tr2Pass.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Tr2EffectDescription.h\nimport { assertCarbonRecord } from \"../../format/carbonRecordGuard.js\";\nimport { CjsSchema, impl, type } from \"#schema\";\nimport { CjsModel } from \"#model\";\nimport {\n} from \"#utils/is\";\nimport { requireShaderStageType, SHADER_STAGE_COUNT, ShaderStageType } from \"./shaderStage.js\";\nimport { Tr2EffectStageInput } from \"./Tr2EffectStageInput.js\";\nimport { recordBytes, toRecordBlob } from \"./carbonRecordFields.js\";\nimport { CARBON_BACKEND_ENGINE_ID, peekBackendEngineId } from \"../../format/carbonEffect/backendEngineId.js\";\nimport { readBackendBlock } from \"../../format/carbonEffect/carbonEffectBackendBlock.js\";\nimport { readGlslBackendBlock } from \"../../formats/webgl/core/glslBackendBlock.js\";\n\n/** Reflected effect pass; Carbon's interned program and state handles are kept as authored data. */\nexport class Tr2Pass extends CjsModel\n{\n\n  /** stageInputs (Tr2EffectStageInput) */\n  stageInputs = [];\n\n  /** renderStates (unsigned int) */\n  renderStates = 0;\n\n  /** shaderTypeMask (unsigned int) */\n  shaderTypeMask = 0;\n\n  /** shaderProgram (unsigned int) */\n  shaderProgram = 0;\n\n  /** resourceSetDesc (Tr2ResourceSetDescriptionAL) */\n  resourceSetDesc = null;\n\n  /** indirectLayout (Tr2IndirectDrawBufferLayout) */\n  indirectLayout = null;\n\n  /** Exact authored render-state pairs retained before an engine creates a state handle. */\n  renderStateValues = [];\n\n  /** Optional per-pass backend block, absent in a stock Carbon file. */\n  backendBlock = null;\n\n  /**\n   * Stage types in the order the file stored them.\n   *\n   * `stageInputs` is indexed by stage type, as Carbon's fixed array is, so the\n   * file's ordering is not recoverable from it. That ordering is authored rather\n   * than derivable: measured over 288,528 passes in the shipped corpus, 156 put\n   * geometry before pixel (`0,3,1`) and 12 put it after (`0,1,3`). Any sort loses\n   * one group or the other, so the sequence is kept.\n   */\n  stageOrder = [];\n\n  /**\n   * Build one pass from its Carbon v15 description record.\n   *\n   * Carbon writes only the stages a pass actually uses, but the class keeps a\n   * fixed six-slot array indexed by stage type, so absent stages are filled with\n   * explicit empty slots rather than left as holes. The stage's own type byte\n   * decides where it lands; position in the record does not.\n   *\n   * The optional backend block is retained verbatim. It is the one place the\n   * container diverges by backend, and deciding what it means is the engine's\n   * job, not the reader's - with one exception: the texture merges it records\n   * are copied onto the pixel stage's reflected resources\n   * (`readMergedResources`).\n   *\n   * @param {object} record Carbon pass record.\n   * @returns {Tr2Pass} Reflected pass.\n   */\n  static fromCarbonBinary(record)\n  {\n    assertCarbonRecord(record, \"pass\");\n\n    const pass = new this();\n    const renderStateIds = new Set();\n    pass.renderStateValues = record.renderStates.map(entry =>\n    {\n      if (renderStateIds.has(entry.state))\n      {\n        throw new Error(\n          `Carbon effect render-state id ${entry.state} is duplicated`\n        );\n      }\n      renderStateIds.add(entry.state);\n      return { state: entry.state, value: entry.value };\n    });\n\n    pass.stageInputs = Array.from(\n      { length: SHADER_STAGE_COUNT },\n      (_, stageType) => Tr2EffectStageInput.createEmpty(stageType)\n    );\n    pass.shaderTypeMask = 0;\n\n    for (const stageRecord of record.stages)\n    {\n      const stage = Tr2EffectStageInput.fromCarbonBinary(stageRecord);\n      const stageType = requireShaderStageType(stage.stageType);\n      if ((pass.shaderTypeMask & (1 << stageType)) !== 0)\n      {\n        throw new Error(\n          `Carbon effect stage type ${stageType} is duplicated`\n        );\n      }\n      pass.stageInputs[stageType] = stage;\n      pass.shaderTypeMask = (pass.shaderTypeMask | (1 << stageType)) >>> 0;\n    }\n\n    pass.stageOrder = record.stages.map(stage => stage.type);\n    pass.backendBlock = record.backendBlock\n      ? { bytes: recordBytes(record.backendBlock), size: record.backendBlock.size }\n      : null;\n\n    // THE BLOCK RIDES THE SIGNATURE, STILL UNINTERPRETED. Carbon's signature is\n    // the one thing Trinity hands a backend at CreateShader besides the\n    // bytecode (Tr2EffectDescription.cpp:589-593), and backends consume it\n    // without adding to it - Metal even refuses a field it cannot honour\n    // (Tr2ShaderALMetal.mm:24-27). Our per-pass block is backend information\n    // of exactly that kind, so it travels the same road: stamped on every stage\n    // of the pass, read by the backend whose block it is, ignored by the rest.\n    // The pass keeps its own copy for the format libraries that read it today.\n    if (pass.backendBlock)\n    {\n      for (const stage of pass.stageInputs)\n      {\n        if (stage?.exists && stage.signature) stage.signature.backendBlock = pass.backendBlock;\n      }\n    }\n\n    // The one part of the block that is not the backend's alone: which textures\n    // were merged. The effect binds by register from this reflection, so the\n    // merged register has to say what it now holds.\n    const pixel = pass.stageInputs[ShaderStageType.PIXEL_SHADER];\n\n    for (const merge of Tr2Pass.readMergedResources(pass.backendBlock))\n    {\n      const resource = pixel.resources.get(merge.register);\n\n      if (!resource)\n      {\n        throw new Error(`Backend block merges into t${merge.register}, which the pixel stage does not reflect`);\n      }\n\n      resource.arrayLayers = merge.arrayLayers;\n      resource.packed = merge.packed;\n    }\n\n    return pass;\n  }\n\n  /**\n   * The texture merges a pass's backend block records, each at the register the\n   * merged texture binds to.\n   *\n   * Not Carbon; see `Tr2EffectResource.arrayLayers`. The merge list is shared by\n   * both browser backends, but where the merged texture landed is not: WebGPU\n   * tags the binding with the merge's id, and the GLSL emitter declares it as\n   * `s` + the merge's output name at the first member it met. A merge with no\n   * such binding was never sampled in this body, so it is left out. Blocks of\n   * any other backend record no merges.\n   *\n   * @param {{bytes: Uint8Array}|null} backendBlock The pass's backend block.\n   * @returns {Array<{register: number, arrayLayers: string[], packed: boolean}>} The merges.\n   */\n  static readMergedResources(backendBlock)\n  {\n    if (!backendBlock) return [];\n\n    const engine = peekBackendEngineId(backendBlock.bytes);\n    let transforms;\n    let registerOf;\n\n    if (engine === CARBON_BACKEND_ENGINE_ID.webgpu)\n    {\n      const block = readBackendBlock(backendBlock.bytes, { source: \"Tr2Pass.backendBlock\" });\n      const bindings = block.bindGroups.flatMap(group => group.bindings);\n\n      transforms = block.transforms;\n      registerOf = transform => bindings.find(binding => binding.transformId === transform.id)?.registerIndex;\n    }\n    else if (engine === CARBON_BACKEND_ENGINE_ID.webgl2)\n    {\n      const block = readGlslBackendBlock(backendBlock.bytes, { source: \"Tr2Pass.backendBlock\" });\n      const bindings = block.stages.pixel?.bindings ?? [];\n\n      transforms = block.transforms;\n      registerOf = transform => bindings.find(binding => binding.kind === \"resource\" && binding.name === `s${transform.output.name}`)?.registerIndex;\n    }\n    else\n    {\n      return [];\n    }\n\n    const merges = [];\n\n    for (const transform of transforms)\n    {\n      if (transform.kind !== \"texture-2d-array\" && transform.kind !== \"texture-2d-packed\") continue;\n\n      const register = registerOf(transform);\n\n      if (register === undefined) continue;\n\n      merges.push({\n        register,\n        arrayLayers: transform.inputs.map(input => input.parameter),\n        packed: transform.kind === \"texture-2d-packed\"\n      });\n    }\n\n    return merges;\n  }\n\n\n  /**\n   * The populated stages in the order they should be written.\n   *\n   * A retained order wins; anything present but unlisted follows in stage-type\n   * order, so a pass assembled by hand still emits every stage it has.\n   *\n   * @returns {Array<object>} Stages in file order.\n   */\n  #orderedStages()\n  {\n    const present = this.stageInputs.filter(stage => stage?.exists);\n    const ordered = [];\n    for (const stageType of this.stageOrder)\n    {\n      const stage = present.find(entry => entry.stageType === stageType);\n      if (stage && !ordered.includes(stage)) ordered.push(stage);\n    }\n    for (const stage of present)\n    {\n      if (!ordered.includes(stage)) ordered.push(stage);\n    }\n    return ordered;\n  }\n\n  /**\n   * Emit this pass as a Carbon v15 record.\n   *\n   * Only stages that exist are written, in ascending stage type. The class keeps\n   * six slots because Carbon addresses them positionally in memory; the file\n   * stores a count and only the populated ones.\n   *\n   * Render states are sorted by id because Carbon holds them in a `std::map`.\n   *\n   * @returns {object} Carbon pass record.\n   */\n  toCarbonBinary()\n  {\n    const record = {\n      stages: this.#orderedStages().map(stage => stage.toCarbonBinary()),\n      renderStates: this.renderStateValues\n        .map(entry => ({ state: entry.state, value: entry.value }))\n        .sort((left, right) => left.state - right.state)\n    };\n    if (this.backendBlock)\n    {\n      record.backendBlock = toRecordBlob(\n        this.backendBlock.bytes,\n        this.backendBlock.size\n      );\n    }\n    return record;\n  }\n}\n\n// Declared imperatively rather than with decorators, so this module stays\n// plain ESM that loads from source without a transform. The decorator\n// expressions are reused verbatim, so the registered metadata is identical.\n// Statics belong in `methods`: decorateMethod targets the prototype and\n// would register a static as an instance field.\nCjsSchema.define(Tr2Pass, {\n  className: \"Tr2Pass\",\n  family: \"shader\",\n  fields: {\n    stageInputs: type.list(\"Tr2EffectStageInput\"),\n    renderStates: type.uint32,\n    shaderTypeMask: type.uint32,\n    shaderProgram: type.uint32,\n    resourceSetDesc: type.rawStruct(\"Tr2ResourceSetDescriptionAL\"),\n    indirectLayout: type.rawStruct(\"Tr2IndirectDrawBufferLayout\"),\n    renderStateValues: [ impl.adapted, impl.reason(\"Carbon interns the state block while reading (Tr2EffectStateManager::RegisterRenderStateSetup, .h:118) and keeps only the renderStates index (Tr2EffectDescription.h:202). Ours interns at the Trinity boundary, so the authored state/value pairs are retained until then; see Tr2EffectStateManager.registerShaderHandles.\"), type.rawStruct(\"CjsEffectRenderStateValues\") ],\n    stageOrder: [ impl.custom, impl.reason(\"Carbon indexes pass stages by type in a fixed array and loses the file's ordering; the port retains it so a body can be re-emitted as the file that produced it.\"), type.rawStruct(\"CjsEffectStageOrder\") ],\n    backendBlock: [ impl.custom, impl.reason(\"Carbon ends a pass at its render states; CarbonEngineJS containers may append one per-pass block carrying the backend program, which the resource retains, reading only its texture merges.\"), type.rawStruct(\"CjsEffectBackendBlock\") ]\n  },\n  methods: {\n    readMergedResources: impl.custom\n  }\n});\n"],"names":["Tr2Pass","CjsModel","stageInputs","renderStates","shaderTypeMask","shaderProgram","resourceSetDesc","indirectLayout","renderStateValues","backendBlock","stageOrder","fromCarbonBinary","record","assertCarbonRecord","pass","renderStateIds","Set","map","entry","has","state","Error","add","value","Array","from","length","SHADER_STAGE_COUNT","_","stageType","Tr2EffectStageInput","createEmpty","stageRecord","stages","stage","requireShaderStageType","type","bytes","recordBytes","size","exists","signature","pixel","ShaderStageType","PIXEL_SHADER","merge","readMergedResources","resource","resources","get","register","arrayLayers","packed","engine","peekBackendEngineId","transforms","registerOf","CARBON_BACKEND_ENGINE_ID","webgpu","block","readBackendBlock","source","bindings","bindGroups","flatMap","group","transform","find","binding","transformId","id","registerIndex","webgl2","readGlslBackendBlock","kind","name","output","merges","undefined","push","inputs","input","parameter","#orderedStages","present","filter","ordered","includes","toCarbonBinary","sort","left","right","toRecordBlob","CjsSchema","define","className","family","fields","list","uint32","rawStruct","impl","adapted","reason","custom","methods"],"mappings":"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"}

package/dist/resource/texture/CjsTextureArrayConstructor.js

@@ -0,0 +1,97 @@
+import { IBlueDynamicResourceConstructor } from '#blue';
+import { TriTextureRes } from './TriTextureRes.js';
+import { Tr2TexturePipeline } from './Tr2TexturePipeline.js';
+import { Tr2TexturePipelineStepGenerateMips } from './Tr2TexturePipelineStepGenerateMips.js';
+import { CjsTexturePipelineStepConvert } from './CjsTexturePipelineStepConvert.js';
+import { CjsTexturePipelineStepResize } from './CjsTexturePipelineStepResize.js';
+import { CjsTexturePipelineStepArray } from './CjsTexturePipelineStepArray.js';
+
+// Not Carbon: `dynamic:/texturearray` is ours, registered in
+// /docs/architecture/non-carbon-extensions.md.
+
+/** The prefix an array path starts with. */
+const TextureArrayPrefix = "dynamic:/texturearray/";
+
+/**
+ * `dynamic:/texturearray/<path>;<path>...` - separate images as the layers of
+ * one 2D texture array, layer 0 first.
+ *
+ * The string is the aggregate's whole identity: an effect keeps its named
+ * parameters, and whatever binds the merged sampler reads their current paths
+ * and asks for this string. A changed layer is a different string, so a
+ * different cached array - nothing is mutated in place. Two effects naming the
+ * same maps share one array.
+ *
+ * The query becomes a recipe - Convert, Resize, Array, GenerateMips - run
+ * through Carbon's `.ctr` route. Kept in the cache after release: a rebuild
+ * re-downloads and re-decodes every layer.
+ */
+class CjsTextureArrayConstructor extends IBlueDynamicResourceConstructor {
+  /**
+   * @param {object} resourceManager The `CjsResMan` that loads the layers.
+   */
+  constructor(resourceManager) {
+    super();
+    this._resourceManager = resourceManager;
+  }
+
+  /**
+   * An assembled array costs downloads and decodes to rebuild, so it is kept.
+   *
+   * @returns {boolean} Always true.
+   */
+  IsCacheable() {
+    return true;
+  }
+
+  /**
+   * Build the texture array a query describes. The recipe starts at once; the
+   * texture is prepared when it finishes.
+   *
+   * @param {string} query Text after `dynamic:/texturearray/`.
+   * @returns {TriTextureRes} The texture resource.
+   */
+  GetResource(query) {
+    const texture = new TriTextureRes();
+    texture.Initialize(TextureArrayPrefix + query, "");
+    const pipeline = CjsTextureArrayConstructor.buildRecipe(query);
+    if (!pipeline) {
+      const error = new Error(`Failed to parse ${TextureArrayPrefix}${query} texture path`);
+      error.code = "CJS_TEXTURE_PROCEDURAL_PATH_INVALID";
+      texture.SetError(error);
+      return texture;
+    }
+    texture.LoadPipeline(pipeline, this._resourceManager);
+    return texture;
+  }
+
+  /**
+   * The recipe for an array query, or null when it names no layers.
+   *
+   * @param {string} query `path;path;...`, layer 0 first.
+   * @returns {Tr2TexturePipeline|null} The recipe.
+   */
+  static buildRecipe(query) {
+    const paths = String(query).split(";").map(part => part.trim()).filter(part => part);
+    if (paths.length === 0) return null;
+    const array = new CjsTexturePipelineStepArray();
+    array.paths = paths;
+    const pipeline = new Tr2TexturePipeline();
+    pipeline.steps = [new CjsTexturePipelineStepConvert(), new CjsTexturePipelineStepResize(), array, new Tr2TexturePipelineStepGenerateMips()];
+    return pipeline;
+  }
+}
+
+/**
+ * Registers `dynamic:/texturearray` on a manager.
+ *
+ * @param {object} resourceManager Manager to register on.
+ * @returns {object} The same manager, for chaining.
+ */
+function RegisterTextureArray(resourceManager) {
+  resourceManager.RegisterResourceConstructor("texturearray", new CjsTextureArrayConstructor(resourceManager));
+  return resourceManager;
+}
+
+export { CjsTextureArrayConstructor, RegisterTextureArray, TextureArrayPrefix };
+//# sourceMappingURL=CjsTextureArrayConstructor.js.map

package/dist/resource/texture/CjsTextureArrayConstructor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsTextureArrayConstructor.js","sources":["../../../../src/resource/texture/CjsTextureArrayConstructor.js"],"sourcesContent":["// Not Carbon: `dynamic:/texturearray` is ours, registered in\n// /docs/architecture/non-carbon-extensions.md.\nimport { IBlueDynamicResourceConstructor } from \"#blue\";\nimport { TriTextureRes } from \"./TriTextureRes.js\";\nimport { Tr2TexturePipeline } from \"./Tr2TexturePipeline.js\";\nimport { Tr2TexturePipelineStepGenerateMips } from \"./Tr2TexturePipelineStepGenerateMips.js\";\nimport { CjsTexturePipelineStepConvert } from \"./CjsTexturePipelineStepConvert.js\";\nimport { CjsTexturePipelineStepResize } from \"./CjsTexturePipelineStepResize.js\";\nimport { CjsTexturePipelineStepArray } from \"./CjsTexturePipelineStepArray.js\";\n\n/** The prefix an array path starts with. */\nexport const TextureArrayPrefix = \"dynamic:/texturearray/\";\n\n/**\n * `dynamic:/texturearray/<path>;<path>...` - separate images as the layers of\n * one 2D texture array, layer 0 first.\n *\n * The string is the aggregate's whole identity: an effect keeps its named\n * parameters, and whatever binds the merged sampler reads their current paths\n * and asks for this string. A changed layer is a different string, so a\n * different cached array - nothing is mutated in place. Two effects naming the\n * same maps share one array.\n *\n * The query becomes a recipe - Convert, Resize, Array, GenerateMips - run\n * through Carbon's `.ctr` route. Kept in the cache after release: a rebuild\n * re-downloads and re-decodes every layer.\n */\nexport class CjsTextureArrayConstructor extends IBlueDynamicResourceConstructor\n{\n\n  /**\n   * @param {object} resourceManager The `CjsResMan` that loads the layers.\n   */\n  constructor(resourceManager)\n  {\n    super();\n    this._resourceManager = resourceManager;\n  }\n\n  /**\n   * An assembled array costs downloads and decodes to rebuild, so it is kept.\n   *\n   * @returns {boolean} Always true.\n   */\n  IsCacheable()\n  {\n    return true;\n  }\n\n  /**\n   * Build the texture array a query describes. The recipe starts at once; the\n   * texture is prepared when it finishes.\n   *\n   * @param {string} query Text after `dynamic:/texturearray/`.\n   * @returns {TriTextureRes} The texture resource.\n   */\n  GetResource(query)\n  {\n    const texture = new TriTextureRes();\n    texture.Initialize(TextureArrayPrefix + query, \"\");\n\n    const pipeline = CjsTextureArrayConstructor.buildRecipe(query);\n\n    if (!pipeline)\n    {\n      const error = new Error(`Failed to parse ${TextureArrayPrefix}${query} texture path`);\n      error.code = \"CJS_TEXTURE_PROCEDURAL_PATH_INVALID\";\n      texture.SetError(error);\n      return texture;\n    }\n\n    texture.LoadPipeline(pipeline, this._resourceManager);\n    return texture;\n  }\n\n  /**\n   * The recipe for an array query, or null when it names no layers.\n   *\n   * @param {string} query `path;path;...`, layer 0 first.\n   * @returns {Tr2TexturePipeline|null} The recipe.\n   */\n  static buildRecipe(query)\n  {\n    const paths = String(query).split(\";\").map(part => part.trim()).filter(part => part);\n\n    if (paths.length === 0) return null;\n\n    const array = new CjsTexturePipelineStepArray();\n    array.paths = paths;\n\n    const pipeline = new Tr2TexturePipeline();\n    pipeline.steps = [\n      new CjsTexturePipelineStepConvert(),\n      new CjsTexturePipelineStepResize(),\n      array,\n      new Tr2TexturePipelineStepGenerateMips()\n    ];\n    return pipeline;\n  }\n\n}\n\n/**\n * Registers `dynamic:/texturearray` on a manager.\n *\n * @param {object} resourceManager Manager to register on.\n * @returns {object} The same manager, for chaining.\n */\nexport function RegisterTextureArray(resourceManager)\n{\n  resourceManager.RegisterResourceConstructor(\"texturearray\", new CjsTextureArrayConstructor(resourceManager));\n  return resourceManager;\n}\n"],"names":["TextureArrayPrefix","CjsTextureArrayConstructor","IBlueDynamicResourceConstructor","constructor","resourceManager","_resourceManager","IsCacheable","GetResource","query","texture","TriTextureRes","Initialize","pipeline","buildRecipe","error","Error","code","SetError","LoadPipeline","paths","String","split","map","part","trim","filter","length","array","CjsTexturePipelineStepArray","Tr2TexturePipeline","steps","CjsTexturePipelineStepConvert","CjsTexturePipelineStepResize","Tr2TexturePipelineStepGenerateMips","RegisterTextureArray","RegisterResourceConstructor"],"mappings":";;;;;;;;AAAA;AACA;;AASA;AACO,MAAMA,kBAAkB,GAAG;;AAElC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,0BAA0B,SAASC,+BAA+B,CAC/E;AAEE;AACF;AACA;EACEC,WAAWA,CAACC,eAAe,EAC3B;AACE,IAAA,KAAK,EAAE;IACP,IAAI,CAACC,gBAAgB,GAAGD,eAAe;AACzC,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEE,EAAAA,WAAWA,GACX;AACE,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;EACEC,WAAWA,CAACC,KAAK,EACjB;AACE,IAAA,MAAMC,OAAO,GAAG,IAAIC,aAAa,EAAE;IACnCD,OAAO,CAACE,UAAU,CAACX,kBAAkB,GAAGQ,KAAK,EAAE,EAAE,CAAC;AAElD,IAAA,MAAMI,QAAQ,GAAGX,0BAA0B,CAACY,WAAW,CAACL,KAAK,CAAC;IAE9D,IAAI,CAACI,QAAQ,EACb;MACE,MAAME,KAAK,GAAG,IAAIC,KAAK,CAAC,mBAAmBf,kBAAkB,CAAA,EAAGQ,KAAK,CAAA,aAAA,CAAe,CAAC;MACrFM,KAAK,CAACE,IAAI,GAAG,qCAAqC;AAClDP,MAAAA,OAAO,CAACQ,QAAQ,CAACH,KAAK,CAAC;AACvB,MAAA,OAAOL,OAAO;AAChB,IAAA;IAEAA,OAAO,CAACS,YAAY,CAACN,QAAQ,EAAE,IAAI,CAACP,gBAAgB,CAAC;AACrD,IAAA,OAAOI,OAAO;AAChB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;EACE,OAAOI,WAAWA,CAACL,KAAK,EACxB;AACE,IAAA,MAAMW,KAAK,GAAGC,MAAM,CAACZ,KAAK,CAAC,CAACa,KAAK,CAAC,GAAG,CAAC,CAACC,GAAG,CAACC,IAAI,IAAIA,IAAI,CAACC,IAAI,EAAE,CAAC,CAACC,MAAM,CAACF,IAAI,IAAIA,IAAI,CAAC;AAEpF,IAAA,IAAIJ,KAAK,CAACO,MAAM,KAAK,CAAC,EAAE,OAAO,IAAI;AAEnC,IAAA,MAAMC,KAAK,GAAG,IAAIC,2BAA2B,EAAE;IAC/CD,KAAK,CAACR,KAAK,GAAGA,KAAK;AAEnB,IAAA,MAAMP,QAAQ,GAAG,IAAIiB,kBAAkB,EAAE;IACzCjB,QAAQ,CAACkB,KAAK,GAAG,CACf,IAAIC,6BAA6B,EAAE,EACnC,IAAIC,4BAA4B,EAAE,EAClCL,KAAK,EACL,IAAIM,kCAAkC,EAAE,CACzC;AACD,IAAA,OAAOrB,QAAQ;AACjB,EAAA;AAEF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASsB,oBAAoBA,CAAC9B,eAAe,EACpD;EACEA,eAAe,CAAC+B,2BAA2B,CAAC,cAAc,EAAE,IAAIlC,0BAA0B,CAACG,eAAe,CAAC,CAAC;AAC5G,EAAA,OAAOA,eAAe;AACxB;;;;"}