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

package/dist/resource/texture/Tr2ImageRes.js

@@ -1,21 +1,28 @@
 import { CjsSchema, carbon, impl, type, edit } from '#schema';
 import { CjsResource } from '../CjsResource.js';
-import { validateRgbaPayload } from '../format/payloadContract.js';
-import { validateResourcePayload } from '../resourceBoundary.js';
+import { HostBitmap } from '#imageio';
+import { PixelFormat } from '#consts/render-context';
+import { resourcePayloadError } from '../resourceBoundary.js';
 import { ResourceRequirement } from '../ResourceRequirement.js';
 
 // Source: trinity/trinity/Resources/Tr2ImageRes.h
 // Source: trinity/trinity/Resources/Tr2ImageRes.cpp
 // Source: trinity/trinity/Resources/Tr2ImageRes_Blue.cpp
 
-/**
- * Tr2ImageRes resource record.
- *
- * Carbon treats this as image payload data. Engine-gpu decides whether it ever
- * becomes device texture state.
+/**
+ * Tr2ImageRes resource record.
+ *
+ * Carbon treats this as image payload data. Engine-gpu decides whether it ever
+ * becomes device texture state.
  */
 class Tr2ImageRes extends CjsResource {
+  /** m_bitmap: the decoded image (Tr2ImageRes.h:38). */
+  bitmap = new HostBitmap();
+
+  /** Mirrors the bitmap's width, so the schema and tools can read it. */
   width = 0;
+
+  /** Mirrors the bitmap's height. */
   height = 0;
 
   /** Creates a Tr2ImageRes with caller-provided initial state. */
@@ -27,103 +34,128 @@ class Tr2ImageRes extends CjsResource {
     });
   }
 
-  /**
-   * Attach a plain canonical RGBA payload and mirror Carbon-exposed metadata.
-   *
-   * @param {object|null} payload
-   * @param {object|null} options
-   * @returns {Tr2ImageRes}
+  /**
+   * Attach a plain canonical RGBA payload and mirror Carbon-exposed metadata.
+   *
+   * @param {object|null} payload
+   * @param {object|null} options
+   * @returns {Tr2ImageRes}
    */
   SetPayload(payload = null, options = null) {
     if (payload === null) {
+      this.bitmap.Destroy();
       super.SetPayload(null);
       return this;
     }
-    validateResourcePayload("Tr2ImageRes", payload, validateRgbaPayload);
-    const values = {
-      ...(options || {})
-    };
-    values.width = payload.width;
-    values.height = payload.height;
-    super.SetPayload(payload);
-    this.SetValues(values);
+
+    // Carbon's DoLoad reads straight into m_bitmap (Tr2ImageRes.cpp:39-52),
+    // so a HostBitmap is what this resource is made of.
+    const bitmap = CjsSchema.cast(payload, HostBitmap);
+    if (!bitmap) {
+      throw resourcePayloadError("Tr2ImageRes", "Expected an ImageIO::HostBitmap.", "payload");
+    }
+    this.bitmap = bitmap;
+    super.SetPayload(bitmap);
+    this.SetValues({
+      ...(options || {}),
+      width: bitmap.GetWidth(),
+      height: bitmap.GetHeight()
+    });
     return this;
   }
 
-  /**
-   * Return image width in pixels.
-   *
-   * @returns {number}
+  /**
+   * Return image width in pixels.
+   *
+   * @returns {number}
    */
   GetWidth() {
-    return this.width || 0;
+    return this.bitmap.IsValid() ? this.bitmap.GetWidth() : this.width || 0;
   }
 
-  /**
-   * Return image height in pixels.
-   *
-   * @returns {number}
+  /**
+   * Return image height in pixels.
+   *
+   * @returns {number}
    */
   GetHeight() {
-    return this.height || 0;
+    return this.bitmap.IsValid() ? this.bitmap.GetHeight() : this.height || 0;
   }
 
-  /**
-   * Read pixel color from payload metadata when a simple pixel accessor exists.
-   *
-   * @param {number} x
-   * @param {number} y
-   * @returns {*}
+  /**
+   * Carbon GetPixelColor (Tr2ImageRes.cpp:72-108): the pixel as a colour,
+   * BGRA or BGRX only. A BGRX pixel reports alpha 1.
+   *
+   * adapted: Carbon returns a `Color`; this returns `{r, g, b, a}` in 0..1,
+   * the shape `HostBitmap.GetPixel` already answers in.
+   *
+   * @param {number} x Pixel column.
+   * @param {number} y Pixel row.
+   * @returns {{r: number, g: number, b: number, a: number}} The colour.
    */
   GetPixelColor(x = 0, y = 0) {
-    const payload = this.GetPayload();
-    if (!payload || !Number.isInteger(x) || !Number.isInteger(y) || x < 0 || y < 0 || x >= payload.width || y >= payload.height) return null;
-    const elementsPerRow = payload.strideBytes / payload.data.BYTES_PER_ELEMENT;
-    const offset = y * elementsPerRow + x * 4;
-    return Array.from(payload.data.subarray(offset, offset + 4));
+    const transparent = {
+      r: 0,
+      g: 0,
+      b: 0,
+      a: 0
+    };
+    if (!this.bitmap.IsValid()) return transparent;
+    const format = this.bitmap.GetFormat();
+
+    // Carbon: CCP_LOGERR("Tr2ImageRes::GetPixelColor currently only supports ...")
+    if (format !== PixelFormat.PIXEL_FORMAT_B8G8R8A8_UNORM && format !== PixelFormat.PIXEL_FORMAT_B8G8R8X8_UNORM) return transparent;
+    const color = this.bitmap.GetPixel(x, y);
+    if (!color) return transparent;
+    return format === PixelFormat.PIXEL_FORMAT_B8G8R8X8_UNORM ? {
+      ...color,
+      a: 1
+    } : color;
   }
 
-  /**
-   * Return true when a pixel alpha channel is absent or non-zero.
-   *
-   * @param {number} x
-   * @param {number} y
-   * @returns {boolean}
+  /**
+   * Carbon IsPixelOpaque (Tr2ImageRes.cpp:54-70): BGRA only, and "opaque"
+   * means an alpha byte above 0x7f.
+   *
+   * @param {number} x Pixel column.
+   * @param {number} y Pixel row.
+   * @returns {boolean} Whether the pixel is opaque.
    */
   IsPixelOpaque(x = 0, y = 0) {
-    const color = this.GetPixelColor(x, y);
-    if (!Array.isArray(color)) return false;
-    return color.length < 4 || color[3] > 0;
+    // Carbon: CCP_LOGERR("Tr2ImageRes::IsPixelOpaque currently only supports PIXEL_FORMAT_B8G8R8A8_UNORM")
+    if (!this.bitmap.IsValid() || this.bitmap.GetFormat() !== PixelFormat.PIXEL_FORMAT_B8G8R8A8_UNORM) return false;
+    const color = this.bitmap.GetPixel(x, y);
+    return !!color && color.a > 0x7f / 255;
   }
 
-  /**
-   * Carbon GetBitmap (Tr2ImageRes.cpp:138): the host bitmap DoLoad decoded.
-   * The canonical RGBA payload IS that bitmap here.
-   *
-   * @returns {object|null}
+  /**
+   * Carbon GetBitmap (Tr2ImageRes.cpp:110-113): the bitmap DoLoad decoded.
+   *
+   * @returns {HostBitmap} The bitmap, valid once the image has loaded.
    */
   GetBitmap() {
-    return this.GetPayload();
+    return this.bitmap;
   }
 
-  /**
-   * Carbon IsMemoryUsageKnown (cpp:14): usage is only trustworthy once the
-   * async load has settled.
-   *
-   * @returns {boolean}
+  /**
+   * Carbon IsMemoryUsageKnown (cpp:14): usage is only trustworthy once the
+   * async load has settled.
+   *
+   * @returns {boolean}
    */
   IsMemoryUsageKnown() {
     return !this.IsLoading();
   }
 
-  /**
-   * Carbon GetMemoryUsage (cpp:19): the bitmap's raw byte size, or a
-   * 1024-byte placeholder so an unloaded resource still has nonzero
-   * accounted cost.
-   *
-   * @returns {number}
+  /**
+   * Carbon GetMemoryUsage (cpp:19): the bitmap's raw byte size, or a
+   * 1024-byte placeholder so an unloaded resource still has nonzero
+   * accounted cost.
+   *
+   * @returns {number}
    */
   GetMemoryUsage() {
+    if (this.bitmap.IsValid()) return this.bitmap.GetRawDataSize();
     const payload = this.GetPayload();
     return payload?.data?.byteLength ? payload.data.byteLength : 1024;
   }

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

@@ -1 +1 @@
-{"version":3,"file":"Tr2ImageRes.js","sources":["../../../../src/resource/texture/Tr2ImageRes.js"],"sourcesContent":["// Source: trinity/trinity/Resources/Tr2ImageRes.h\r\n// Source: trinity/trinity/Resources/Tr2ImageRes.cpp\r\n// Source: trinity/trinity/Resources/Tr2ImageRes_Blue.cpp\r\nimport { CjsSchema, carbon, impl, edit, type } from \"#schema\";\r\nimport { CjsResource } from \"../CjsResource.js\";\r\nimport { validateRgbaPayload } from \"../format/payloadContract.js\";\r\nimport { validateResourcePayload } from \"../resourceBoundary.js\";\r\nimport { ResourceRequirement } from \"../ResourceRequirement.js\";\r\n\r\n/**\r\n * Tr2ImageRes resource record.\r\n *\r\n * Carbon treats this as image payload data. Engine-gpu decides whether it ever\r\n * becomes device texture state.\r\n */\r\nexport class Tr2ImageRes extends CjsResource\r\n{\r\n\r\n  width = 0;\r\n\r\n  height = 0;\r\n\r\n  /** Creates a Tr2ImageRes with caller-provided initial state. */\r\n  constructor(values = null) {\r\n    super();\r\n    this.SetValues(values || {}, {\r\n      skipUpdate: true,\r\n      skipEvents: true\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Attach a plain canonical RGBA payload and mirror Carbon-exposed metadata.\r\n   *\r\n   * @param {object|null} payload\r\n   * @param {object|null} options\r\n   * @returns {Tr2ImageRes}\r\n   */\r\n  SetPayload(payload = null, options = null)\r\n  {\r\n    if (payload === null)\r\n    {\r\n      super.SetPayload(null);\r\n      return this;\r\n    }\r\n    validateResourcePayload(\"Tr2ImageRes\", payload, validateRgbaPayload);\r\n    const values = { ...(options || {}) };\r\n    values.width = payload.width;\r\n    values.height = payload.height;\r\n    super.SetPayload(payload);\r\n    this.SetValues(values);\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Return image width in pixels.\r\n   *\r\n   * @returns {number}\r\n   */\r\n  GetWidth()\r\n  {\r\n    return this.width || 0;\r\n  }\r\n\r\n  /**\r\n   * Return image height in pixels.\r\n   *\r\n   * @returns {number}\r\n   */\r\n  GetHeight()\r\n  {\r\n    return this.height || 0;\r\n  }\r\n\r\n  /**\r\n   * Read pixel color from payload metadata when a simple pixel accessor exists.\r\n   *\r\n   * @param {number} x\r\n   * @param {number} y\r\n   * @returns {*}\r\n   */\r\n  GetPixelColor(x = 0, y = 0)\r\n  {\r\n    const payload = this.GetPayload();\r\n    if (!payload || !Number.isInteger(x) || !Number.isInteger(y)\r\n      || x < 0 || y < 0 || x >= payload.width || y >= payload.height) return null;\r\n\r\n    const elementsPerRow = payload.strideBytes / payload.data.BYTES_PER_ELEMENT;\r\n    const offset = y * elementsPerRow + x * 4;\r\n    return Array.from(payload.data.subarray(offset, offset + 4));\r\n  }\r\n\r\n  /**\r\n   * Return true when a pixel alpha channel is absent or non-zero.\r\n   *\r\n   * @param {number} x\r\n   * @param {number} y\r\n   * @returns {boolean}\r\n   */\r\n  IsPixelOpaque(x = 0, y = 0)\r\n  {\r\n    const color = this.GetPixelColor(x, y);\r\n    if (!Array.isArray(color)) return false;\r\n    return color.length < 4 || color[3] > 0;\r\n  }\r\n\r\n  /**\r\n   * Carbon GetBitmap (Tr2ImageRes.cpp:138): the host bitmap DoLoad decoded.\r\n   * The canonical RGBA payload IS that bitmap here.\r\n   *\r\n   * @returns {object|null}\r\n   */\r\n  GetBitmap()\r\n  {\r\n    return this.GetPayload();\r\n  }\r\n\r\n  /**\r\n   * Carbon IsMemoryUsageKnown (cpp:14): usage is only trustworthy once the\r\n   * async load has settled.\r\n   *\r\n   * @returns {boolean}\r\n   */\r\n  IsMemoryUsageKnown()\r\n  {\r\n    return !this.IsLoading();\r\n  }\r\n\r\n  /**\r\n   * Carbon GetMemoryUsage (cpp:19): the bitmap's raw byte size, or a\r\n   * 1024-byte placeholder so an unloaded resource still has nonzero\r\n   * accounted cost.\r\n   *\r\n   * @returns {number}\r\n   */\r\n  GetMemoryUsage()\r\n  {\r\n    const payload = this.GetPayload();\r\n    return payload?.data?.byteLength ? payload.data.byteLength : 1024;\r\n  }\r\n\r\n  static payload = ResourceRequirement.IMAGE;\r\n}\r\n\r\n// Declared as data rather than with decorators, so the resource tree loads from\r\n// source without a transform. Field order is key order, and GetValues() exports\r\n// in that order.\r\nCjsSchema.define(Tr2ImageRes, {\r\n  className: \"Tr2ImageRes\",\r\n  family: \"resources\",\r\n  fields: {\r\n    width: [ type.uint32, edit.persist ],\r\n    height: [ type.uint32, edit.persist ]\r\n  },\r\n  methods: {\r\n    GetWidth: [ carbon.method, impl.adapted ],\r\n    GetHeight: [ carbon.method, impl.adapted ],\r\n    GetPixelColor: [ carbon.method, impl.adapted ],\r\n    IsPixelOpaque: [ carbon.method, impl.adapted ],\r\n    GetBitmap: [ carbon.method, impl.adapted ],\r\n    IsMemoryUsageKnown: [ carbon.method, impl.implemented ],\r\n    GetMemoryUsage: [ carbon.method, impl.adapted ]\r\n  }\r\n});\r\n"],"names":["Tr2ImageRes","CjsResource","width","height","constructor","values","SetValues","skipUpdate","skipEvents","SetPayload","payload","options","validateResourcePayload","validateRgbaPayload","GetWidth","GetHeight","GetPixelColor","x","y","GetPayload","Number","isInteger","elementsPerRow","strideBytes","data","BYTES_PER_ELEMENT","offset","Array","from","subarray","IsPixelOpaque","color","isArray","length","GetBitmap","IsMemoryUsageKnown","IsLoading","GetMemoryUsage","byteLength","ResourceRequirement","IMAGE","CjsSchema","define","className","family","fields","type","uint32","edit","persist","methods","carbon","method","impl","adapted","implemented"],"mappings":"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"}
+{"version":3,"file":"Tr2ImageRes.js","sources":["../../../../src/resource/texture/Tr2ImageRes.js"],"sourcesContent":["// Source: trinity/trinity/Resources/Tr2ImageRes.h\n// Source: trinity/trinity/Resources/Tr2ImageRes.cpp\n// Source: trinity/trinity/Resources/Tr2ImageRes_Blue.cpp\nimport { CjsSchema, carbon, impl, edit, type } from \"#schema\";\nimport { CjsResource } from \"../CjsResource.js\";\nimport { HostBitmap } from \"#imageio\";\nimport { PixelFormat } from \"#consts/render-context\";\nimport { resourcePayloadError, validateResourcePayload } from \"../resourceBoundary.js\";\nimport { ResourceRequirement } from \"../ResourceRequirement.js\";\n\n/**\n * Tr2ImageRes resource record.\n *\n * Carbon treats this as image payload data. Engine-gpu decides whether it ever\n * becomes device texture state.\n */\nexport class Tr2ImageRes extends CjsResource\n{\n\n  /** m_bitmap: the decoded image (Tr2ImageRes.h:38). */\n  bitmap = new HostBitmap();\n\n  /** Mirrors the bitmap's width, so the schema and tools can read it. */\n  width = 0;\n\n  /** Mirrors the bitmap's height. */\n  height = 0;\n\n  /** Creates a Tr2ImageRes with caller-provided initial state. */\n  constructor(values = null) {\n    super();\n    this.SetValues(values || {}, {\n      skipUpdate: true,\n      skipEvents: true\n    });\n  }\n\n  /**\n   * Attach a plain canonical RGBA payload and mirror Carbon-exposed metadata.\n   *\n   * @param {object|null} payload\n   * @param {object|null} options\n   * @returns {Tr2ImageRes}\n   */\n  SetPayload(payload = null, options = null)\n  {\n    if (payload === null)\n    {\n      this.bitmap.Destroy();\n      super.SetPayload(null);\n      return this;\n    }\n\n    // Carbon's DoLoad reads straight into m_bitmap (Tr2ImageRes.cpp:39-52),\n    // so a HostBitmap is what this resource is made of.\n    const bitmap = CjsSchema.cast(payload, HostBitmap);\n\n    if (!bitmap)\n    {\n      throw resourcePayloadError(\"Tr2ImageRes\", \"Expected an ImageIO::HostBitmap.\", \"payload\");\n    }\n\n    this.bitmap = bitmap;\n    super.SetPayload(bitmap);\n    this.SetValues({ ...(options || {}), width: bitmap.GetWidth(), height: bitmap.GetHeight() });\n    return this;\n  }\n\n  /**\n   * Return image width in pixels.\n   *\n   * @returns {number}\n   */\n  GetWidth()\n  {\n    return this.bitmap.IsValid() ? this.bitmap.GetWidth() : (this.width || 0);\n  }\n\n  /**\n   * Return image height in pixels.\n   *\n   * @returns {number}\n   */\n  GetHeight()\n  {\n    return this.bitmap.IsValid() ? this.bitmap.GetHeight() : (this.height || 0);\n  }\n\n  /**\n   * Carbon GetPixelColor (Tr2ImageRes.cpp:72-108): the pixel as a colour,\n   * BGRA or BGRX only. A BGRX pixel reports alpha 1.\n   *\n   * adapted: Carbon returns a `Color`; this returns `{r, g, b, a}` in 0..1,\n   * the shape `HostBitmap.GetPixel` already answers in.\n   *\n   * @param {number} x Pixel column.\n   * @param {number} y Pixel row.\n   * @returns {{r: number, g: number, b: number, a: number}} The colour.\n   */\n  GetPixelColor(x = 0, y = 0)\n  {\n    const transparent = { r: 0, g: 0, b: 0, a: 0 };\n\n    if (!this.bitmap.IsValid()) return transparent;\n\n    const format = this.bitmap.GetFormat();\n\n    // Carbon: CCP_LOGERR(\"Tr2ImageRes::GetPixelColor currently only supports ...\")\n    if (format !== PixelFormat.PIXEL_FORMAT_B8G8R8A8_UNORM && format !== PixelFormat.PIXEL_FORMAT_B8G8R8X8_UNORM) return transparent;\n\n    const color = this.bitmap.GetPixel(x, y);\n\n    if (!color) return transparent;\n\n    return format === PixelFormat.PIXEL_FORMAT_B8G8R8X8_UNORM ? { ...color, a: 1 } : color;\n  }\n\n  /**\n   * Carbon IsPixelOpaque (Tr2ImageRes.cpp:54-70): BGRA only, and \"opaque\"\n   * means an alpha byte above 0x7f.\n   *\n   * @param {number} x Pixel column.\n   * @param {number} y Pixel row.\n   * @returns {boolean} Whether the pixel is opaque.\n   */\n  IsPixelOpaque(x = 0, y = 0)\n  {\n    // Carbon: CCP_LOGERR(\"Tr2ImageRes::IsPixelOpaque currently only supports PIXEL_FORMAT_B8G8R8A8_UNORM\")\n    if (!this.bitmap.IsValid() || this.bitmap.GetFormat() !== PixelFormat.PIXEL_FORMAT_B8G8R8A8_UNORM) return false;\n\n    const color = this.bitmap.GetPixel(x, y);\n\n    return !!color && color.a > 0x7f / 255;\n  }\n\n  /**\n   * Carbon GetBitmap (Tr2ImageRes.cpp:110-113): the bitmap DoLoad decoded.\n   *\n   * @returns {HostBitmap} The bitmap, valid once the image has loaded.\n   */\n  GetBitmap()\n  {\n    return this.bitmap;\n  }\n\n  /**\n   * Carbon IsMemoryUsageKnown (cpp:14): usage is only trustworthy once the\n   * async load has settled.\n   *\n   * @returns {boolean}\n   */\n  IsMemoryUsageKnown()\n  {\n    return !this.IsLoading();\n  }\n\n  /**\n   * Carbon GetMemoryUsage (cpp:19): the bitmap's raw byte size, or a\n   * 1024-byte placeholder so an unloaded resource still has nonzero\n   * accounted cost.\n   *\n   * @returns {number}\n   */\n  GetMemoryUsage()\n  {\n    if (this.bitmap.IsValid()) return this.bitmap.GetRawDataSize();\n\n    const payload = this.GetPayload();\n\n    return payload?.data?.byteLength ? payload.data.byteLength : 1024;\n  }\n\n  static payload = ResourceRequirement.IMAGE;\n}\n\n// Declared as data rather than with decorators, so the resource tree loads from\n// source without a transform. Field order is key order, and GetValues() exports\n// in that order.\nCjsSchema.define(Tr2ImageRes, {\n  className: \"Tr2ImageRes\",\n  family: \"resources\",\n  fields: {\n    width: [ type.uint32, edit.persist ],\n    height: [ type.uint32, edit.persist ]\n  },\n  methods: {\n    GetWidth: [ carbon.method, impl.adapted ],\n    GetHeight: [ carbon.method, impl.adapted ],\n    GetPixelColor: [ carbon.method, impl.adapted ],\n    IsPixelOpaque: [ carbon.method, impl.adapted ],\n    GetBitmap: [ carbon.method, impl.adapted ],\n    IsMemoryUsageKnown: [ carbon.method, impl.implemented ],\n    GetMemoryUsage: [ carbon.method, impl.adapted ]\n  }\n});\n"],"names":["Tr2ImageRes","CjsResource","bitmap","HostBitmap","width","height","constructor","values","SetValues","skipUpdate","skipEvents","SetPayload","payload","options","Destroy","CjsSchema","cast","resourcePayloadError","GetWidth","GetHeight","IsValid","GetPixelColor","x","y","transparent","r","g","b","a","format","GetFormat","PixelFormat","PIXEL_FORMAT_B8G8R8A8_UNORM","PIXEL_FORMAT_B8G8R8X8_UNORM","color","GetPixel","IsPixelOpaque","GetBitmap","IsMemoryUsageKnown","IsLoading","GetMemoryUsage","GetRawDataSize","GetPayload","data","byteLength","ResourceRequirement","IMAGE","define","className","family","fields","type","uint32","edit","persist","methods","carbon","method","impl","adapted","implemented"],"mappings":"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"}

package/dist/resource/texture/Tr2TexturePipeline.js

@@ -1,6 +1,7 @@
 import { CjsSchema, carbon, impl, edit, type } from '#schema';
 import { CjsModel } from '#model';
-import { executeTexturePipeline, getTexturePipelineDependencies } from './texturePipelineBehavior.js';
+import { Tr2TexturePipelineParams } from './Tr2TexturePipelineParams.js';
+import { Tr2TexturePipelineStepLimitSize } from './Tr2TexturePipelineStepLimitSize.js';
 
 // Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipeline.h
 // Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipeline.cpp
@@ -10,11 +11,12 @@ import { executeTexturePipeline, getTexturePipelineDependencies } from './textur
 // Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepCompress.cpp
 // Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepPack.cpp
 
-/**
- * Carbon texture-specific CPU bitmap transformation pipeline.
- *
- * Inputs are supplied explicitly, through a load callback, or through an
- * injected CjsResMan. The result is a canonical plain RGBA payload.
+/**
+ * Carbon texture-specific CPU bitmap transformation pipeline.
+ *
+ * The steps share one ImageIO::HostBitmap, exactly as Carbon does: each step
+ * reads and rewrites it, and the caller supplies every input bitmap the steps
+ * name, keyed by resource path.
  */
 class Tr2TexturePipeline extends CjsModel {
   /** m_pipelineType (std::string) [READWRITE, PERSIST] */
@@ -32,28 +34,46 @@ class Tr2TexturePipeline extends CjsModel {
     });
   }
 
-  /**
-   * Execute the CPU pipeline and return a canonical RGBA payload.
-   *
-   * @param {number} maxWidth Optional caller width limit.
-   * @param {number} maxHeight Optional caller height limit.
-   * @param {object|null} options Input map, load callback, or CjsResMan.
-   * @returns {Promise<object>} Canonical RGBA payload.
+  /**
+   * Carbon Execute (cpp:24-45): run every step against one bitmap, then apply
+   * the caller's size limit.
+   *
+   * diverged: a failed step stops the pipeline. Carbon ignores each step's
+   * result and runs the next one as though it had succeeded, so a failed Load
+   * leaves the following steps working on an empty bitmap (issue 19,
+   * /docs/research/carbon-imageio-issue.md).
+   *
+   * @param {import("#imageio").HostBitmap} result Bitmap to fill; destroyed first.
+   * @param {Map<string, import("#imageio").HostBitmap>} inputs Loaded inputs by path.
+   * @param {Tr2TexturePipelineParams} params Caller size limits.
+   * @returns {boolean} Whether the pipeline succeeded.
    */
-  async Execute(maxWidth = 0, maxHeight = 0, options = null) {
-    return executeTexturePipeline(this.steps, {
-      maxWidth,
-      maxHeight
-    }, options);
+  Execute(result, inputs, params = new Tr2TexturePipelineParams()) {
+    result.Destroy();
+
+    // Carbon: CCP_LOGERR("Tr2TexturePipeline: no steps")
+    if (!this.steps.length) return false;
+    for (const step of this.steps) {
+      if (!step.Execute(result, inputs, params)) return false;
+    }
+    if (params.maxHeight || params.maxWidth) {
+      return Tr2TexturePipelineStepLimitSize.limitSize(result, params.maxWidth, params.maxHeight);
+    }
+    return true;
   }
 
-  /**
-   * Return sorted unique resource paths consumed by load and pack steps.
-   *
-   * @returns {string[]} Resource dependency paths.
+  /**
+   * Carbon GetResourceDependencies (cpp:15-22): every path the steps need.
+   *
+   * adapted: Carbon fills a caller-owned set; this returns the paths sorted,
+   * which the resource layer wants for a stable load order.
+   *
+   * @returns {string[]} Resource dependency paths.
    */
   GetResourceDependencies() {
-    return getTexturePipelineDependencies(this.steps);
+    const resources = new Set();
+    for (const step of this.steps) step.GetResourceDependencies(resources);
+    return [...resources].sort();
   }
 }
 CjsSchema.define(Tr2TexturePipeline, {
@@ -64,8 +84,8 @@ CjsSchema.define(Tr2TexturePipeline, {
     steps: [edit.persist, type.list("ITr2TexturePipelineStep")]
   },
   methods: {
-    Execute: [carbon.method, impl.adapted, impl.reason("Carbon fills an ImageIO::HostBitmap through blocking file reads; JavaScript resolves inputs asynchronously and returns the runtime resource layer's plain CPU payload.")],
-    GetResourceDependencies: [carbon.method, impl.implemented]
+    Execute: [carbon.method, impl.adapted, impl.reason("Carbon ignores each step's result and runs the next one regardless; ours stops on the first failure (issue 19).")],
+    GetResourceDependencies: [carbon.method, impl.adapted, impl.reason("Carbon fills a caller-owned set; ours returns the paths sorted, for a stable load order.")]
   }
 });
 

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

@@ -1 +1 @@
-{"version":3,"file":"Tr2TexturePipeline.js","sources":["../../../../src/resource/texture/Tr2TexturePipeline.js"],"sourcesContent":["// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipeline.h\r\n// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipeline.cpp\r\n// Source: trinity/trinity/Resources/TexturePipeline/ITr2TexturePipelineStep.h\r\n// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepLoad.cpp\r\n// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepLimitSize.cpp\r\n// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepCompress.cpp\r\n// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepPack.cpp\r\nimport { carbon, CjsSchema, impl, edit, type } from \"#schema\";\r\nimport { CjsModel } from \"#model\";\r\nimport {\r\n  executeTexturePipeline,\r\n  getTexturePipelineDependencies\r\n} from \"./texturePipelineBehavior.js\";\r\n\r\n/**\r\n * Carbon texture-specific CPU bitmap transformation pipeline.\r\n *\r\n * Inputs are supplied explicitly, through a load callback, or through an\r\n * injected CjsResMan. The result is a canonical plain RGBA payload.\r\n */\r\nexport class Tr2TexturePipeline extends CjsModel\r\n{\r\n\r\n  /** m_pipelineType (std::string) [READWRITE, PERSIST] */\r\n  pipelineType = \"\";\r\n\r\n  /** m_steps (PITr2TexturePipelineStepVector) [READ, PERSIST] */\r\n  steps = [];\r\n\r\n  /** Creates a Tr2TexturePipeline with caller-provided initial state. */\r\n  constructor(values = null)\r\n  {\r\n    super();\r\n    this.SetValues(values || {}, {\r\n      skipUpdate: true,\r\n      skipEvents: true\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Execute the CPU pipeline and return a canonical RGBA payload.\r\n   *\r\n   * @param {number} maxWidth Optional caller width limit.\r\n   * @param {number} maxHeight Optional caller height limit.\r\n   * @param {object|null} options Input map, load callback, or CjsResMan.\r\n   * @returns {Promise<object>} Canonical RGBA payload.\r\n   */\r\n  async Execute(maxWidth = 0, maxHeight = 0, options = null)\r\n  {\r\n    return executeTexturePipeline(this.steps, { maxWidth, maxHeight }, options);\r\n  }\r\n\r\n  /**\r\n   * Return sorted unique resource paths consumed by load and pack steps.\r\n   *\r\n   * @returns {string[]} Resource dependency paths.\r\n   */\r\n  GetResourceDependencies()\r\n  {\r\n    return getTexturePipelineDependencies(this.steps);\r\n  }\r\n\r\n}\r\n\r\nCjsSchema.define(Tr2TexturePipeline, {\r\n  className: \"Tr2TexturePipeline\", family: \"resources\",\r\n  fields: {\r\n    pipelineType: [ edit.persist, type.string ],\n    steps: [ edit.persist, type.list(\"ITr2TexturePipelineStep\") ]\r\n  },\r\n  methods: {\r\n    Execute: [ carbon.method, impl.adapted, impl.reason(\"Carbon fills an ImageIO::HostBitmap through blocking file reads; JavaScript resolves inputs asynchronously and returns the runtime resource layer's plain CPU payload.\") ],\n    GetResourceDependencies: [ carbon.method, impl.implemented ]\r\n  }\r\n});\r\n"],"names":["Tr2TexturePipeline","CjsModel","pipelineType","steps","constructor","values","SetValues","skipUpdate","skipEvents","Execute","maxWidth","maxHeight","options","executeTexturePipeline","GetResourceDependencies","getTexturePipelineDependencies","CjsSchema","define","className","family","fields","edit","persist","type","string","list","methods","carbon","method","impl","adapted","reason","implemented"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,kBAAkB,SAASC,QAAQ,CAChD;AAEE;AACAC,EAAAA,YAAY,GAAG,EAAE;;AAEjB;AACAC,EAAAA,KAAK,GAAG,EAAE;;AAEV;AACAC,EAAAA,WAAWA,CAACC,MAAM,GAAG,IAAI,EACzB;AACE,IAAA,KAAK,EAAE;AACP,IAAA,IAAI,CAACC,SAAS,CAACD,MAAM,IAAI,EAAE,EAAE;AAC3BE,MAAAA,UAAU,EAAE,IAAI;AAChBC,MAAAA,UAAU,EAAE;AACd,KAAC,CAAC;AACJ,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACE,EAAA,MAAMC,OAAOA,CAACC,QAAQ,GAAG,CAAC,EAAEC,SAAS,GAAG,CAAC,EAAEC,OAAO,GAAG,IAAI,EACzD;AACE,IAAA,OAAOC,sBAAsB,CAAC,IAAI,CAACV,KAAK,EAAE;MAAEO,QAAQ;AAAEC,MAAAA;KAAW,EAAEC,OAAO,CAAC;AAC7E,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEE,EAAAA,uBAAuBA,GACvB;AACE,IAAA,OAAOC,8BAA8B,CAAC,IAAI,CAACZ,KAAK,CAAC;AACnD,EAAA;AAEF;AAEAa,SAAS,CAACC,MAAM,CAACjB,kBAAkB,EAAE;AACnCkB,EAAAA,SAAS,EAAE,oBAAoB;AAAEC,EAAAA,MAAM,EAAE,WAAW;AACpDC,EAAAA,MAAM,EAAE;IACNlB,YAAY,EAAE,CAAEmB,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACC,MAAM,CAAE;IAC3CrB,KAAK,EAAE,CAAEkB,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACE,IAAI,CAAC,yBAAyB,CAAC;GAC5D;AACDC,EAAAA,OAAO,EAAE;AACPjB,IAAAA,OAAO,EAAE,CAAEkB,MAAM,CAACC,MAAM,EAAEC,IAAI,CAACC,OAAO,EAAED,IAAI,CAACE,MAAM,CAAC,wKAAwK,CAAC,CAAE;IAC/NjB,uBAAuB,EAAE,CAAEa,MAAM,CAACC,MAAM,EAAEC,IAAI,CAACG,WAAW;AAC5D;AACF,CAAC,CAAC;;;;"}
+{"version":3,"file":"Tr2TexturePipeline.js","sources":["../../../../src/resource/texture/Tr2TexturePipeline.js"],"sourcesContent":["// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipeline.h\n// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipeline.cpp\n// Source: trinity/trinity/Resources/TexturePipeline/ITr2TexturePipelineStep.h\n// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepLoad.cpp\n// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepLimitSize.cpp\n// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepCompress.cpp\n// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepPack.cpp\nimport { carbon, CjsSchema, impl, edit, type } from \"#schema\";\nimport { CjsModel } from \"#model\";\nimport { Tr2TexturePipelineParams } from \"./Tr2TexturePipelineParams.js\";\nimport { Tr2TexturePipelineStepLimitSize } from \"./Tr2TexturePipelineStepLimitSize.js\";\n\n/**\n * Carbon texture-specific CPU bitmap transformation pipeline.\n *\n * The steps share one ImageIO::HostBitmap, exactly as Carbon does: each step\n * reads and rewrites it, and the caller supplies every input bitmap the steps\n * name, keyed by resource path.\n */\nexport class Tr2TexturePipeline extends CjsModel\n{\n\n  /** m_pipelineType (std::string) [READWRITE, PERSIST] */\n  pipelineType = \"\";\n\n  /** m_steps (PITr2TexturePipelineStepVector) [READ, PERSIST] */\n  steps = [];\n\n  /** Creates a Tr2TexturePipeline with caller-provided initial state. */\n  constructor(values = null)\n  {\n    super();\n    this.SetValues(values || {}, {\n      skipUpdate: true,\n      skipEvents: true\n    });\n  }\n\n  /**\n   * Carbon Execute (cpp:24-45): run every step against one bitmap, then apply\n   * the caller's size limit.\n   *\n   * diverged: a failed step stops the pipeline. Carbon ignores each step's\n   * result and runs the next one as though it had succeeded, so a failed Load\n   * leaves the following steps working on an empty bitmap (issue 19,\n   * /docs/research/carbon-imageio-issue.md).\n   *\n   * @param {import(\"#imageio\").HostBitmap} result Bitmap to fill; destroyed first.\n   * @param {Map<string, import(\"#imageio\").HostBitmap>} inputs Loaded inputs by path.\n   * @param {Tr2TexturePipelineParams} params Caller size limits.\n   * @returns {boolean} Whether the pipeline succeeded.\n   */\n  Execute(result, inputs, params = new Tr2TexturePipelineParams())\n  {\n    result.Destroy();\n\n    // Carbon: CCP_LOGERR(\"Tr2TexturePipeline: no steps\")\n    if (!this.steps.length) return false;\n\n    for (const step of this.steps)\n    {\n      if (!step.Execute(result, inputs, params)) return false;\n    }\n\n    if (params.maxHeight || params.maxWidth)\n    {\n      return Tr2TexturePipelineStepLimitSize.limitSize(result, params.maxWidth, params.maxHeight);\n    }\n\n    return true;\n  }\n\n  /**\n   * Carbon GetResourceDependencies (cpp:15-22): every path the steps need.\n   *\n   * adapted: Carbon fills a caller-owned set; this returns the paths sorted,\n   * which the resource layer wants for a stable load order.\n   *\n   * @returns {string[]} Resource dependency paths.\n   */\n  GetResourceDependencies()\n  {\n    const resources = new Set();\n    for (const step of this.steps) step.GetResourceDependencies(resources);\n    return [ ...resources ].sort();\n  }\n\n}\n\nCjsSchema.define(Tr2TexturePipeline, {\n  className: \"Tr2TexturePipeline\", family: \"resources\",\n  fields: {\n    pipelineType: [ edit.persist, type.string ],\n    steps: [ edit.persist, type.list(\"ITr2TexturePipelineStep\") ]\n  },\n  methods: {\n    Execute: [ carbon.method, impl.adapted, impl.reason(\"Carbon ignores each step's result and runs the next one regardless; ours stops on the first failure (issue 19).\") ],\n    GetResourceDependencies: [ carbon.method, impl.adapted, impl.reason(\"Carbon fills a caller-owned set; ours returns the paths sorted, for a stable load order.\") ]\n  }\n});\n"],"names":["Tr2TexturePipeline","CjsModel","pipelineType","steps","constructor","values","SetValues","skipUpdate","skipEvents","Execute","result","inputs","params","Tr2TexturePipelineParams","Destroy","length","step","maxHeight","maxWidth","Tr2TexturePipelineStepLimitSize","limitSize","GetResourceDependencies","resources","Set","sort","CjsSchema","define","className","family","fields","edit","persist","type","string","list","methods","carbon","method","impl","adapted","reason"],"mappings":";;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,kBAAkB,SAASC,QAAQ,CAChD;AAEE;AACAC,EAAAA,YAAY,GAAG,EAAE;;AAEjB;AACAC,EAAAA,KAAK,GAAG,EAAE;;AAEV;AACAC,EAAAA,WAAWA,CAACC,MAAM,GAAG,IAAI,EACzB;AACE,IAAA,KAAK,EAAE;AACP,IAAA,IAAI,CAACC,SAAS,CAACD,MAAM,IAAI,EAAE,EAAE;AAC3BE,MAAAA,UAAU,EAAE,IAAI;AAChBC,MAAAA,UAAU,EAAE;AACd,KAAC,CAAC;AACJ,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,OAAOA,CAACC,MAAM,EAAEC,MAAM,EAAEC,MAAM,GAAG,IAAIC,wBAAwB,EAAE,EAC/D;IACEH,MAAM,CAACI,OAAO,EAAE;;AAEhB;IACA,IAAI,CAAC,IAAI,CAACX,KAAK,CAACY,MAAM,EAAE,OAAO,KAAK;AAEpC,IAAA,KAAK,MAAMC,IAAI,IAAI,IAAI,CAACb,KAAK,EAC7B;AACE,MAAA,IAAI,CAACa,IAAI,CAACP,OAAO,CAACC,MAAM,EAAEC,MAAM,EAAEC,MAAM,CAAC,EAAE,OAAO,KAAK;AACzD,IAAA;AAEA,IAAA,IAAIA,MAAM,CAACK,SAAS,IAAIL,MAAM,CAACM,QAAQ,EACvC;AACE,MAAA,OAAOC,+BAA+B,CAACC,SAAS,CAACV,MAAM,EAAEE,MAAM,CAACM,QAAQ,EAAEN,MAAM,CAACK,SAAS,CAAC;AAC7F,IAAA;AAEA,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACEI,EAAAA,uBAAuBA,GACvB;AACE,IAAA,MAAMC,SAAS,GAAG,IAAIC,GAAG,EAAE;AAC3B,IAAA,KAAK,MAAMP,IAAI,IAAI,IAAI,CAACb,KAAK,EAAEa,IAAI,CAACK,uBAAuB,CAACC,SAAS,CAAC;AACtE,IAAA,OAAO,CAAE,GAAGA,SAAS,CAAE,CAACE,IAAI,EAAE;AAChC,EAAA;AAEF;AAEAC,SAAS,CAACC,MAAM,CAAC1B,kBAAkB,EAAE;AACnC2B,EAAAA,SAAS,EAAE,oBAAoB;AAAEC,EAAAA,MAAM,EAAE,WAAW;AACpDC,EAAAA,MAAM,EAAE;IACN3B,YAAY,EAAE,CAAE4B,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACC,MAAM,CAAE;IAC3C9B,KAAK,EAAE,CAAE2B,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACE,IAAI,CAAC,yBAAyB,CAAC;GAC5D;AACDC,EAAAA,OAAO,EAAE;AACP1B,IAAAA,OAAO,EAAE,CAAE2B,MAAM,CAACC,MAAM,EAAEC,IAAI,CAACC,OAAO,EAAED,IAAI,CAACE,MAAM,CAAC,iHAAiH,CAAC,CAAE;AACxKnB,IAAAA,uBAAuB,EAAE,CAAEe,MAAM,CAACC,MAAM,EAAEC,IAAI,CAACC,OAAO,EAAED,IAAI,CAACE,MAAM,CAAC,0FAA0F,CAAC;AACjK;AACF,CAAC,CAAC;;;;"}

package/dist/resource/texture/Tr2TexturePipelineStepCompress.js

@@ -1,4 +1,4 @@
-import { CjsSchema, edit, type } from '#schema';
+import { CjsSchema, carbon, impl, edit, type } from '#schema';
 import { CjsModel } from '#model';
 
 // Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepCompress.h
@@ -17,6 +17,35 @@ class Tr2TexturePipelineStepCompress extends CjsModel {
 
   /** m_rWeight (float) [READWRITE, PERSIST] */
   r = 1;
+
+  /**
+   * Carbon's ITr2TexturePipelineStep default (ITr2TexturePipelineStep.h:21):
+   * this step names no resources.
+   *
+   * @param {Set<string>} [resources] Caller-owned; allocated when omitted.
+   * @returns {Set<string>} The set, unchanged.
+   */
+  GetResourceDependencies(resources = new Set()) {
+    return resources;
+  }
+
+  /**
+   * Carbon Execute (cpp:15-21) checks validity and returns true, compressing
+   * nothing, so a pipeline asking for compression silently gets uncompressed
+   * output (issue 20, /docs/research/carbon-imageio-issue.md).
+   *
+   * diverged: this refuses instead of lying. When the bitmap is already in the
+   * requested format there is nothing to do and it succeeds; otherwise it
+   * fails until a block encoder exists, which is the hook this step becomes
+   * (/docs/projects/hostbitmap-port.md).
+   *
+   * @param {import("#imageio").HostBitmap} bitmap The pipeline's bitmap.
+   * @returns {boolean} Whether the step succeeded.
+   */
+  Execute(bitmap) {
+    if (!bitmap.IsValid()) return false;
+    return bitmap.GetFormat() === this.format;
+  }
 }
 CjsSchema.define(Tr2TexturePipelineStepCompress, {
   className: "Tr2TexturePipelineStepCompress",
@@ -26,6 +55,10 @@ CjsSchema.define(Tr2TexturePipelineStepCompress, {
     b: [edit.persist, type.float32],
     g: [edit.persist, type.float32],
     r: [edit.persist, type.float32]
+  },
+  methods: {
+    GetResourceDependencies: [carbon.method, impl.implemented],
+    Execute: [carbon.method, impl.adapted, impl.reason("Carbon's step compresses nothing and returns true; ours refuses rather than pass uncompressed data off as compressed (issue 20).")]
   }
 });
 

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

@@ -1 +1 @@
-{"version":3,"file":"Tr2TexturePipelineStepCompress.js","sources":["../../../../src/resource/texture/Tr2TexturePipelineStepCompress.js"],"sourcesContent":["// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepCompress.h\r\n// Schema: format-carbon resources/Tr2TexturePipelineStepCompress.json; maintained by the runtime resource layer.\r\nimport { CjsSchema, edit, type } from \"#schema\";\r\nimport { CjsModel } from \"#model\";\r\n\r\n/** Tr2TexturePipelineStepCompress (resources) - maintained from schema shapeHash 4d367f1c.... */\r\nexport class Tr2TexturePipelineStepCompress extends CjsModel\r\n{\r\n\r\n  /** m_format (Tr2RenderContextEnum::PixelFormat - enum PixelFormat) [READWRITE, PERSIST, ENUM] */\r\n  format = 71;\r\n\r\n  /** m_bWeight (float) [READWRITE, PERSIST] */\r\n  b = 1;\r\n\r\n  /** m_gWeight (float) [READWRITE, PERSIST] */\r\n  g = 1;\r\n\r\n  /** m_rWeight (float) [READWRITE, PERSIST] */\r\n  r = 1;\r\n\r\n}\r\n\r\nCjsSchema.define(Tr2TexturePipelineStepCompress, {\r\n  className: \"Tr2TexturePipelineStepCompress\", family: \"resources\",\r\n  fields: {\r\n    format: [ edit.persist, type.int32, type.enum(\"PixelFormat\") ],\r\n    b: [ edit.persist, type.float32 ],\r\n    g: [ edit.persist, type.float32 ],\r\n    r: [ edit.persist, type.float32 ]\r\n  }\r\n});\r\n"],"names":["Tr2TexturePipelineStepCompress","CjsModel","format","b","g","r","CjsSchema","define","className","family","fields","edit","persist","type","int32","enum","float32"],"mappings":";;;AAAA;AACA;;AAIA;AACO,MAAMA,8BAA8B,SAASC,QAAQ,CAC5D;AAEE;AACAC,EAAAA,MAAM,GAAG,EAAE;;AAEX;AACAC,EAAAA,CAAC,GAAG,CAAC;;AAEL;AACAC,EAAAA,CAAC,GAAG,CAAC;;AAEL;AACAC,EAAAA,CAAC,GAAG,CAAC;AAEP;AAEAC,SAAS,CAACC,MAAM,CAACP,8BAA8B,EAAE;AAC/CQ,EAAAA,SAAS,EAAE,gCAAgC;AAAEC,EAAAA,MAAM,EAAE,WAAW;AAChEC,EAAAA,MAAM,EAAE;AACNR,IAAAA,MAAM,EAAE,CAAES,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACC,KAAK,EAAED,IAAI,CAACE,IAAI,CAAC,aAAa,CAAC,CAAE;IAC9DZ,CAAC,EAAE,CAAEQ,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACG,OAAO,CAAE;IACjCZ,CAAC,EAAE,CAAEO,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACG,OAAO,CAAE;IACjCX,CAAC,EAAE,CAAEM,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACG,OAAO;AACjC;AACF,CAAC,CAAC;;;;"}
+{"version":3,"file":"Tr2TexturePipelineStepCompress.js","sources":["../../../../src/resource/texture/Tr2TexturePipelineStepCompress.js"],"sourcesContent":["// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepCompress.h\n// Schema: format-carbon resources/Tr2TexturePipelineStepCompress.json; maintained by the runtime resource layer.\nimport { carbon, CjsSchema, edit, impl, type } from \"#schema\";\nimport { CjsModel } from \"#model\";\n\n/** Tr2TexturePipelineStepCompress (resources) - maintained from schema shapeHash 4d367f1c.... */\nexport class Tr2TexturePipelineStepCompress extends CjsModel\n{\n\n  /** m_format (Tr2RenderContextEnum::PixelFormat - enum PixelFormat) [READWRITE, PERSIST, ENUM] */\n  format = 71;\n\n  /** m_bWeight (float) [READWRITE, PERSIST] */\n  b = 1;\n\n  /** m_gWeight (float) [READWRITE, PERSIST] */\n  g = 1;\n\n  /** m_rWeight (float) [READWRITE, PERSIST] */\n  r = 1;\n\n  /**\n   * Carbon's ITr2TexturePipelineStep default (ITr2TexturePipelineStep.h:21):\n   * this step names no resources.\n   *\n   * @param {Set<string>} [resources] Caller-owned; allocated when omitted.\n   * @returns {Set<string>} The set, unchanged.\n   */\n  GetResourceDependencies(resources = new Set())\n  {\n    return resources;\n  }\n\n  /**\n   * Carbon Execute (cpp:15-21) checks validity and returns true, compressing\n   * nothing, so a pipeline asking for compression silently gets uncompressed\n   * output (issue 20, /docs/research/carbon-imageio-issue.md).\n   *\n   * diverged: this refuses instead of lying. When the bitmap is already in the\n   * requested format there is nothing to do and it succeeds; otherwise it\n   * fails until a block encoder exists, which is the hook this step becomes\n   * (/docs/projects/hostbitmap-port.md).\n   *\n   * @param {import(\"#imageio\").HostBitmap} bitmap The pipeline's bitmap.\n   * @returns {boolean} Whether the step succeeded.\n   */\n  Execute(bitmap)\n  {\n    if (!bitmap.IsValid()) return false;\n\n    return bitmap.GetFormat() === this.format;\n  }\n\n}\n\nCjsSchema.define(Tr2TexturePipelineStepCompress, {\n  className: \"Tr2TexturePipelineStepCompress\", family: \"resources\",\n  fields: {\n    format: [ edit.persist, type.int32, type.enum(\"PixelFormat\") ],\n    b: [ edit.persist, type.float32 ],\n    g: [ edit.persist, type.float32 ],\n    r: [ edit.persist, type.float32 ]\n  },\n  methods: {\n    GetResourceDependencies: [ carbon.method, impl.implemented ],\n    Execute: [ carbon.method, impl.adapted, impl.reason(\"Carbon's step compresses nothing and returns true; ours refuses rather than pass uncompressed data off as compressed (issue 20).\") ]\n  }\n});\n"],"names":["Tr2TexturePipelineStepCompress","CjsModel","format","b","g","r","GetResourceDependencies","resources","Set","Execute","bitmap","IsValid","GetFormat","CjsSchema","define","className","family","fields","edit","persist","type","int32","enum","float32","methods","carbon","method","impl","implemented","adapted","reason"],"mappings":";;;AAAA;AACA;;AAIA;AACO,MAAMA,8BAA8B,SAASC,QAAQ,CAC5D;AAEE;AACAC,EAAAA,MAAM,GAAG,EAAE;;AAEX;AACAC,EAAAA,CAAC,GAAG,CAAC;;AAEL;AACAC,EAAAA,CAAC,GAAG,CAAC;;AAEL;AACAC,EAAAA,CAAC,GAAG,CAAC;;AAEL;AACF;AACA;AACA;AACA;AACA;AACA;AACEC,EAAAA,uBAAuBA,CAACC,SAAS,GAAG,IAAIC,GAAG,EAAE,EAC7C;AACE,IAAA,OAAOD,SAAS;AAClB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEE,OAAOA,CAACC,MAAM,EACd;IACE,IAAI,CAACA,MAAM,CAACC,OAAO,EAAE,EAAE,OAAO,KAAK;IAEnC,OAAOD,MAAM,CAACE,SAAS,EAAE,KAAK,IAAI,CAACV,MAAM;AAC3C,EAAA;AAEF;AAEAW,SAAS,CAACC,MAAM,CAACd,8BAA8B,EAAE;AAC/Ce,EAAAA,SAAS,EAAE,gCAAgC;AAAEC,EAAAA,MAAM,EAAE,WAAW;AAChEC,EAAAA,MAAM,EAAE;AACNf,IAAAA,MAAM,EAAE,CAAEgB,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACC,KAAK,EAAED,IAAI,CAACE,IAAI,CAAC,aAAa,CAAC,CAAE;IAC9DnB,CAAC,EAAE,CAAEe,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACG,OAAO,CAAE;IACjCnB,CAAC,EAAE,CAAEc,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACG,OAAO,CAAE;IACjClB,CAAC,EAAE,CAAEa,IAAI,CAACC,OAAO,EAAEC,IAAI,CAACG,OAAO;GAChC;AACDC,EAAAA,OAAO,EAAE;IACPlB,uBAAuB,EAAE,CAAEmB,MAAM,CAACC,MAAM,EAAEC,IAAI,CAACC,WAAW,CAAE;AAC5DnB,IAAAA,OAAO,EAAE,CAAEgB,MAAM,CAACC,MAAM,EAAEC,IAAI,CAACE,OAAO,EAAEF,IAAI,CAACG,MAAM,CAAC,kIAAkI,CAAC;AACzL;AACF,CAAC,CAAC;;;;"}

package/dist/resource/texture/Tr2TexturePipelineStepGenerateMips.js

@@ -1,4 +1,4 @@
-import { CjsSchema } from '#schema';
+import { CjsSchema, carbon, impl } from '#schema';
 import { CjsModel } from '#model';
 
 // Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepGenerateMips.h
@@ -6,11 +6,38 @@ import { CjsModel } from '#model';
 // generation itself happens where the pipeline is executed.
 
 /** Tr2TexturePipelineStepGenerateMips (resources) - attribute-free Blue marker class. */
-class Tr2TexturePipelineStepGenerateMips extends CjsModel {}
+class Tr2TexturePipelineStepGenerateMips extends CjsModel {
+  /**
+   * Carbon's ITr2TexturePipelineStep default (ITr2TexturePipelineStep.h:21):
+   * this step names no resources.
+   *
+   * @param {Set<string>} [resources] Caller-owned; allocated when omitted.
+   * @returns {Set<string>} The set, unchanged.
+   */
+  GetResourceDependencies(resources = new Set()) {
+    return resources;
+  }
+
+  /**
+   * Carbon Execute (cpp:9-15): generate the bitmap's full mip chain.
+   *
+   * @param {import("#imageio").HostBitmap} bitmap The pipeline's bitmap.
+   * @returns {boolean} Whether the step succeeded.
+   */
+  Execute(bitmap) {
+    // Carbon: CCP_LOGERR("Tr2TexturePipelineStepGenerateMips: invalid input bitmap")
+    if (!bitmap.IsValid()) return false;
+    return bitmap.GenerateMipMaps();
+  }
+}
 CjsSchema.define(Tr2TexturePipelineStepGenerateMips, {
   className: "Tr2TexturePipelineStepGenerateMips",
   family: "resources",
-  fields: {}
+  fields: {},
+  methods: {
+    GetResourceDependencies: [carbon.method, impl.implemented],
+    Execute: [carbon.method, impl.implemented]
+  }
 });
 
 export { Tr2TexturePipelineStepGenerateMips };

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

@@ -1 +1 @@
-{"version":3,"file":"Tr2TexturePipelineStepGenerateMips.js","sources":["../../../../src/resource/texture/Tr2TexturePipelineStepGenerateMips.js"],"sourcesContent":["// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepGenerateMips.h\r\n// Marker step: Carbon registers the class with zero attributes; the mip\r\n// generation itself happens where the pipeline is executed.\r\nimport { CjsSchema, type } from \"#schema\";\r\nimport { CjsModel } from \"#model\";\r\n\r\n/** Tr2TexturePipelineStepGenerateMips (resources) - attribute-free Blue marker class. */\r\nexport class Tr2TexturePipelineStepGenerateMips extends CjsModel\r\n{\r\n}\r\n\r\nCjsSchema.define(Tr2TexturePipelineStepGenerateMips, {\r\n  className: \"Tr2TexturePipelineStepGenerateMips\", family: \"resources\",\r\n  fields: {\r\n\r\n  }\r\n});\r\n"],"names":["Tr2TexturePipelineStepGenerateMips","CjsModel","CjsSchema","define","className","family","fields"],"mappings":";;;AAAA;AACA;AACA;;AAIA;AACO,MAAMA,kCAAkC,SAASC,QAAQ,CAChE;AAGAC,SAAS,CAACC,MAAM,CAACH,kCAAkC,EAAE;AACnDI,EAAAA,SAAS,EAAE,oCAAoC;AAAEC,EAAAA,MAAM,EAAE,WAAW;AACpEC,EAAAA,MAAM,EAAE;AAGV,CAAC,CAAC;;;;"}
+{"version":3,"file":"Tr2TexturePipelineStepGenerateMips.js","sources":["../../../../src/resource/texture/Tr2TexturePipelineStepGenerateMips.js"],"sourcesContent":["// Source: trinity/trinity/Resources/TexturePipeline/Tr2TexturePipelineStepGenerateMips.h\n// Marker step: Carbon registers the class with zero attributes; the mip\n// generation itself happens where the pipeline is executed.\nimport { carbon, CjsSchema, impl, type } from \"#schema\";\nimport { CjsModel } from \"#model\";\n\n/** Tr2TexturePipelineStepGenerateMips (resources) - attribute-free Blue marker class. */\nexport class Tr2TexturePipelineStepGenerateMips extends CjsModel\n{\n\n  /**\n   * Carbon's ITr2TexturePipelineStep default (ITr2TexturePipelineStep.h:21):\n   * this step names no resources.\n   *\n   * @param {Set<string>} [resources] Caller-owned; allocated when omitted.\n   * @returns {Set<string>} The set, unchanged.\n   */\n  GetResourceDependencies(resources = new Set())\n  {\n    return resources;\n  }\n\n  /**\n   * Carbon Execute (cpp:9-15): generate the bitmap's full mip chain.\n   *\n   * @param {import(\"#imageio\").HostBitmap} bitmap The pipeline's bitmap.\n   * @returns {boolean} Whether the step succeeded.\n   */\n  Execute(bitmap)\n  {\n    // Carbon: CCP_LOGERR(\"Tr2TexturePipelineStepGenerateMips: invalid input bitmap\")\n    if (!bitmap.IsValid()) return false;\n\n    return bitmap.GenerateMipMaps();\n  }\n\n}\n\nCjsSchema.define(Tr2TexturePipelineStepGenerateMips, {\n  className: \"Tr2TexturePipelineStepGenerateMips\", family: \"resources\",\n  fields: {\n\n  },\n  methods: {\n    GetResourceDependencies: [ carbon.method, impl.implemented ],\n    Execute: [ carbon.method, impl.implemented ]\n  }\n});\n"],"names":["Tr2TexturePipelineStepGenerateMips","CjsModel","GetResourceDependencies","resources","Set","Execute","bitmap","IsValid","GenerateMipMaps","CjsSchema","define","className","family","fields","methods","carbon","method","impl","implemented"],"mappings":";;;AAAA;AACA;AACA;;AAIA;AACO,MAAMA,kCAAkC,SAASC,QAAQ,CAChE;AAEE;AACF;AACA;AACA;AACA;AACA;AACA;AACEC,EAAAA,uBAAuBA,CAACC,SAAS,GAAG,IAAIC,GAAG,EAAE,EAC7C;AACE,IAAA,OAAOD,SAAS;AAClB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;EACEE,OAAOA,CAACC,MAAM,EACd;AACE;IACA,IAAI,CAACA,MAAM,CAACC,OAAO,EAAE,EAAE,OAAO,KAAK;AAEnC,IAAA,OAAOD,MAAM,CAACE,eAAe,EAAE;AACjC,EAAA;AAEF;AAEAC,SAAS,CAACC,MAAM,CAACV,kCAAkC,EAAE;AACnDW,EAAAA,SAAS,EAAE,oCAAoC;AAAEC,EAAAA,MAAM,EAAE,WAAW;EACpEC,MAAM,EAAE,EAEP;AACDC,EAAAA,OAAO,EAAE;IACPZ,uBAAuB,EAAE,CAAEa,MAAM,CAACC,MAAM,EAAEC,IAAI,CAACC,WAAW,CAAE;IAC5Db,OAAO,EAAE,CAAEU,MAAM,CAACC,MAAM,EAAEC,IAAI,CAACC,WAAW;AAC5C;AACF,CAAC,CAAC;;;;"}