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

package/dist/resource/texture/TriTextureRes.js

@@ -1,8 +1,9 @@
 import { CjsSchema, carbon, impl, type, edit } from '#schema';
+import { HostBitmap } from '#imageio';
 import { CjsResource } from '../CjsResource.js';
 import { IsSolidColorTexturePath, RasterizeSolidColor } from './solidColorTexture.js';
 import { ResourceRequirement } from '../ResourceRequirement.js';
-import { validateVideoPayload, validateTexturePayload, validateRgbaPayload, ResourcePayloadType } from '../format/payloadContract.js';
+import { ResourcePayloadType, validateVideoPayload } from '../format/payloadContract.js';
 import { resourcePayloadError, validateResourcePayload, resourceFormatRequiredError, resourceBoundaryError } from '../resourceBoundary.js';
 
 // Source: trinity/trinity/Resources/TriTextureRes.h
@@ -72,13 +73,13 @@ class TriTextureRes extends CjsResource {
    * so it publishes the bitmap as the payload and Trinity makes the texture at
    * first bind, as it does for every other texture.
    *
-   * @param {Function} rasterize `(path) => payload | null`.
+   * @param {Function} rasterize `(path) => HostBitmap | null`.
    * @returns {void}
    */
   #RasterizeProceduralTexture(rasterize) {
     this.MarkLoading();
-    const payload = rasterize(this.path);
-    if (!payload) {
+    const bitmap = rasterize(this.path);
+    if (!bitmap) {
       // Carbon: "Failed to parse dynamic:/color/%s texture path", and the
       // texture is never prepared.
       const error = new Error(`Failed to parse ${this.path} texture path`);
@@ -87,7 +88,7 @@ class TriTextureRes extends CjsResource {
       this.SetError(error);
       return;
     }
-    this.SetPayload(payload);
+    this.SetPayload(bitmap);
     this.MarkPrepared();
   }
 
@@ -101,6 +102,9 @@ class TriTextureRes extends CjsResource {
    */
   texture = null;
 
+  /** m_loadedBitmap: the decoded image the texture is made from, or null. */
+  loadedBitmap = null;
+
   /**
    * The live texture, or null while there is none - Carbon returns nullptr
    * until the load finishes and the parameter substitutes the fallback
@@ -124,6 +128,117 @@ class TriTextureRes extends CjsResource {
     return this;
   }
 
+  /**
+   * Build this texture from a texture pipeline: Carbon's `.ctr` route
+   * (`TriTextureRes.cpp:238-258` then `ResourcePrepFinished`, `:296-340`).
+   *
+   * Every path the pipeline names is loaded as a raw `Tr2ImageRes` (Carbon asks
+   * for the `"raw"` requirement; ours is `ResourceRequirement.IMAGE`), the
+   * pipeline runs once they have all settled, and the result becomes this
+   * texture's bitmap. An input that failed to load reaches the pipeline as
+   * null, exactly as Carbon passes it, so the step that needed it fails.
+   *
+   * adapted: Carbon reads the pipeline from a `.ctr` file with
+   * `BeResMan->LoadObject` and waits on a fence. No shipped build contains a
+   * `.ctr` (checked across 45 resfileindexes, 2026-09-24), so the pipeline is
+   * handed in - built in memory by the `dynamic:/` constructors that use this
+   * route - and the fence is a promise. The manager is passed because the
+   * resource layer has no global `BeResMan`.
+   *
+   * quirk: Carbon marks the resource good even when the pipeline fails
+   * (`m_isGood = true` after the branch, `:337`), so the texture is simply
+   * absent and the parameter binds its fallback. Reproduced: the resource is
+   * prepared either way, with no bitmap when the pipeline failed.
+   *
+   * @param {import("./Tr2TexturePipeline.js").Tr2TexturePipeline} pipeline The recipe.
+   * @param {object} resourceManager The `CjsResMan` that loads its inputs.
+   * @returns {Promise<boolean>} Whether the pipeline produced a bitmap.
+   */
+  async LoadPipeline(pipeline, resourceManager) {
+    this.MarkLoading();
+    const images = new Map();
+    for (const path of pipeline.GetResourceDependencies()) {
+      images.set(path, resourceManager.GetResource(path, {
+        requirement: ResourceRequirement.IMAGE
+      }));
+    }
+
+    // Carbon's m_pipelineFence: wait for every input, whatever became of it.
+    await Promise.allSettled([...images.values()].map(image => image.Ready()));
+
+    // Carbon: it->second && it->second->IsGood() ? &it->second->GetBitmap() : nullptr
+    const inputs = new Map();
+    for (const [path, image] of images) {
+      inputs.set(path, image.IsGood() ? image.GetBitmap() : null);
+    }
+    const result = new HostBitmap();
+    const executed = pipeline.Execute(result, inputs);
+    if (executed) this.SetPayload(result);
+    this.MarkPrepared();
+    return executed;
+  }
+
+  /**
+   * Adopt the cutout an image declared (Carbon reads ImageIO::Metadata's
+   * cutout in DoPrepare and stores it as m_cutoutX/Y/Width/Height).
+   *
+   * @param {{x: number, y: number, width: number, height: number}} cutout The rectangle.
+   * @returns {TriTextureRes} This resource.
+   */
+  SetCutout(cutout) {
+    this.SetValues({
+      cutoutX: cutout.x,
+      cutoutY: cutout.y,
+      cutoutWidth: cutout.width,
+      cutoutHeight: cutout.height
+    });
+    return this;
+  }
+
+  /**
+   * The decoded bitmap this resource was loaded from, or null.
+   *
+   * Carbon's `m_loadedBitmap` (`TriTextureRes.cpp:606`): the CPU-side image
+   * the texture is made from, kept so the texture can be remade - for a device
+   * reset, a LOD change or a save.
+   *
+   * @returns {import("#imageio").HostBitmap|null} The bitmap.
+   */
+  GetBitmap() {
+    return this.loadedBitmap;
+  }
+
+  /**
+   * Adopt a decoded bitmap as this resource's image
+   * (`TriTextureRes::CreateFromHostBitmap`, `TriTextureRes.cpp:960-978`).
+   *
+   * adapted: Carbon creates the texture here, on the main thread's render
+   * context (`USE_MAIN_THREAD_RENDER_CONTEXT`). The resource layer may not
+   * reach a render context (layers.json), so the texture is made on first bind
+   * instead - `Tr2ImageIOHelpers.RealizeTexture` - and this only adopts the
+   * bitmap and drops any texture made from the previous one.
+   *
+   * @param {import("#imageio").HostBitmap|null} bitmap The decoded bitmap.
+   * @returns {boolean} Whether the bitmap was adopted.
+   */
+  CreateFromHostBitmap(bitmap) {
+    this.SetTexture(null);
+    if (!bitmap || !bitmap.IsValid()) {
+      this.loadedBitmap = null;
+      return false;
+    }
+    this.loadedBitmap = bitmap;
+    this.SetValues({
+      format: bitmap.GetFormat(),
+      width: bitmap.GetWidth(),
+      height: bitmap.GetHeight(),
+      depth: bitmap.GetDepth(),
+      arraySize: bitmap.GetArraySize(),
+      cpuMip: bitmap.GetTrueMipCount()
+    });
+    return true;
+  }
+
   /**
    * Attach a plain texture, RGBA, or video payload and mirror Carbon-exposed
    * metadata. Invalid payloads are rejected before replacing the current one.
@@ -136,17 +251,27 @@ class TriTextureRes extends CjsResource {
     if (payload === null) {
       // The bytes are gone; so is the texture made from them.
       this.SetTexture(null);
+      this.loadedBitmap = null;
       super.SetPayload(null);
       return this;
     }
-    const validator = {
-      [ResourcePayloadType.RGBA]: validateRgbaPayload,
-      [ResourcePayloadType.TEXTURE]: validateTexturePayload,
-      [ResourcePayloadType.VIDEO]: validateVideoPayload
-    }[payload?.payloadType];
-    if (!validator) {
-      throw resourcePayloadError("TriTextureRes", 'Expected payloadType "rgba", "texture", or "video".', "payloadType");
+
+    // Carbon's resource IS its bitmap (TriTextureRes.cpp:606, 960-978).
+    const bitmap = CjsSchema.cast(payload, HostBitmap);
+    if (bitmap) {
+      this.CreateFromHostBitmap(bitmap);
+      super.SetPayload(bitmap, options);
+      if (options) this.SetValues(options);
+      if (bitmap.metadata?.cutout) this.SetCutout(bitmap.metadata.cutout);
+      return this;
+    }
+
+    // A video frame source is the one payload left: it is not an image the
+    // CPU decoded, it is a playing element the backend samples.
+    if (payload?.payloadType !== ResourcePayloadType.VIDEO) {
+      throw resourcePayloadError("TriTextureRes", 'Expected an ImageIO::HostBitmap, or payloadType "video".', "payloadType");
     }
+    const validator = validateVideoPayload;
     validateResourcePayload("TriTextureRes", payload, validator);
     const values = {
       ...(options || {})
@@ -217,8 +342,9 @@ class TriTextureRes extends CjsResource {
    * @returns {number}
    */
   GetMsaaType() {
-    const payload = this.GetPayload();
-    return payload?.multiSampleType ?? payload?.msaaType ?? payload?.samples ?? 1;
+    // Carbon: m_texture ? m_texture->GetMsaaDesc().samples : 1 (cpp:1214-1216).
+    const texture = this.GetTexture();
+    return texture ? texture.GetMsaaDesc().samples : 1;
   }
 
   /**
@@ -227,8 +353,9 @@ class TriTextureRes extends CjsResource {
    * @returns {number}
    */
   GetMsaaQuality() {
-    const payload = this.GetPayload();
-    return payload?.multiSampleQuality ?? payload?.msaaQuality ?? 0;
+    // Carbon: m_texture ? m_texture->GetMsaaDesc().quality : 0 (cpp:1219-1222).
+    const texture = this.GetTexture();
+    return texture ? texture.GetMsaaDesc().quality : 0;
   }
 
   /**
@@ -332,15 +459,6 @@ class TriTextureRes extends CjsResource {
     throw resourceBoundaryError("TriTextureRes", "CreateAndCopyFromRenderTarget", "Runtime-resource does not own render targets.");
   }
 
-  /**
-   * Create a device texture from a host bitmap.
-   *
-   * @throws {Error}
-   */
-  CreateFromHostBitmap() {
-    throw resourceBoundaryError("TriTextureRes", "CreateFromHostBitmap", "Use engine-gpu to allocate and upload texture data.");
-  }
-
   /**
    * Create this texture from another texture resource.
    *
@@ -445,13 +563,14 @@ CjsSchema.define(TriTextureRes, {
     cutoutWidth: [type.float32, edit.readwrite],
     width: [type.uint32, edit.read],
     cutoutX: [type.float32, edit.readwrite],
-    cutoutY: [type.float32, edit.readwrite]
+    cutoutY: [type.float32, edit.readwrite],
+    loadedBitmap: [type.unknown, edit.read]
   },
   methods: {
     Initialize: [carbon.method, impl.adapted, impl.reason("Carbon rasterizes a procedural path into a half-float HostBitmap and creates the GPU texture inside Initialize; this resource cannot reach a render context, so it publishes the half-float-quantized colour as an rgba32float payload. The gradient_1d branch is not ported.")],
     GetMipCount: [carbon.method, impl.adapted],
-    GetMsaaType: [carbon.method, impl.adapted],
-    GetMsaaQuality: [carbon.method, impl.adapted],
+    GetMsaaType: [carbon.method, impl.implemented],
+    GetMsaaQuality: [carbon.method, impl.implemented],
     HadLodRequests: [carbon.method, impl.adapted],
     GetSrvIndexInHeap: [carbon.method, impl.notSupported],
     GetTexture: [carbon.method, impl.implemented],
@@ -465,7 +584,10 @@ CjsSchema.define(TriTextureRes, {
     CreateEmptyTexture: [carbon.method, impl.notSupported],
     SetFromRenderTarget: [carbon.method, impl.notSupported],
     CreateAndCopyFromRenderTarget: [carbon.method, impl.notSupported],
-    CreateFromHostBitmap: [carbon.method, impl.notSupported],
+    CreateFromHostBitmap: [carbon.method, impl.adapted, impl.reason("Carbon creates the texture here on the main thread's render context; the resource layer may not reach one, so this adopts the bitmap and the texture is made on first bind (Tr2ImageIOHelpers.RealizeTexture).")],
+    LoadPipeline: [impl.adapted, impl.reason("Carbon's .ctr branch reads the pipeline from a file through the global BeResMan and waits on a fence; no shipped build has a .ctr, so the pipeline is handed in, the manager passed, and the fence is a promise.")],
+    SetCutout: [impl.custom, impl.reason("Carbon reads the cutout from ImageIO::Metadata inside DoPrepare; the read happens in the loader here, so the resource is told.")],
+    GetBitmap: [impl.custom, impl.reason("Carbon keeps m_loadedBitmap private and uploads it inside CreateFromHostBitmap; the upload happens at bind time here, so the bitmap has to be readable.")],
     CreateFromTexture: [carbon.method, impl.notSupported],
     HasALObject: [carbon.method, impl.adapted],
     GetPipeline: [carbon.method, impl.adapted],

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

@@ -1 +1 @@
-{"version":3,"file":"TriTextureRes.js","sources":["../../../../src/resource/texture/TriTextureRes.js"],"sourcesContent":["// Source: trinity/trinity/Resources/TriTextureRes.h\n// Source: trinity/trinity/Resources/TriTextureRes.cpp\n// Source: trinity/trinity/Resources/TriTextureRes_Blue.cpp\nimport { CjsSchema, carbon, impl, edit, type } from \"#schema\";\nimport { CjsResource } from \"../CjsResource.js\";\nimport { IsSolidColorTexturePath, RasterizeSolidColor } from \"./solidColorTexture.js\";\nimport { ResourceRequirement } from \"../ResourceRequirement.js\";\nimport {\n  ResourcePayloadType,\n  validateRgbaPayload,\n  validateTexturePayload,\n  validateVideoPayload\n} from \"../format/payloadContract.js\";\nimport {\n  resourceBoundaryError,\n  resourceFormatRequiredError,\n  resourcePayloadError,\n  validateResourcePayload\n} from \"../resourceBoundary.js\";\n\n/**\n * Resource record that owns Carbon-style texture identity and validated\n * texture, RGBA, or video payload facts with mirrored dimension/format\n * metadata, while engine packages decide what those facts become on a device.\n *\n * The resource never CREATES a backend texture - it cannot reach a render\n * context - but it RETAINS the one Trinity makes for it, as Carbon's does\n * (`m_texture`), so every parameter sharing the resource binds one texture.\n */\nexport class TriTextureRes extends CjsResource\n{\n  format = null;\n  type = null;\n  averageColor = [0, 0, 0, 0];\n  depth = 0;\n  cutoutHeight = 1;\n  height = 0;\n  lodEnabled = false;\n  hadLodRequests = false;\n  cpuMip = 0;\n  gpuMip = 0;\n  wrappedRenderTarget = null;\n  originalResolution = 0;\n  originalMemoryUsage = 0;\n  name = \"\";\n  arraySize = 0;\n  cutoutWidth = 1;\n  width = 0;\n  cutoutX = 0;\n  cutoutY = 0;\n\n  /** Creates a TriTextureRes 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   * Carbon's Initialize, with its procedural branch (TriTextureRes.cpp:223-236):\n   * a `dynamic:/color/` path is rasterized here rather than loaded from source.\n   * The `dynamic:/gradient_1d/` branch Carbon checks first is rasterized by\n   * trinity's GradientTextureConstructor instead: a gradient needs Tr2CurveScalar,\n   * which this layer may not import.\n   *\n   * @param {string} path Resource path.\n   * @param {string|null} [ext] Extension override.\n   * @param {string} [requirement] Semantic requirement.\n   * @returns {TriTextureRes} This resource.\n   */\n  Initialize(path, ext = null, requirement = \"\") {\n    super.Initialize(path, ext, requirement);\n    if (IsSolidColorTexturePath(this.path)) this.#RasterizeProceduralTexture(RasterizeSolidColor);\n    return this;\n  }\n\n  /**\n   * `RasterizeProceduralTexture` (TriTextureRes.cpp:181-212). Carbon creates the\n   * GPU texture from the bitmap here; this layer cannot reach a render context,\n   * so it publishes the bitmap as the payload and Trinity makes the texture at\n   * first bind, as it does for every other texture.\n   *\n   * @param {Function} rasterize `(path) => payload | null`.\n   * @returns {void}\n   */\n  #RasterizeProceduralTexture(rasterize) {\n    this.MarkLoading();\n    const payload = rasterize(this.path);\n    if (!payload) {\n      // Carbon: \"Failed to parse dynamic:/color/%s texture path\", and the\n      // texture is never prepared.\n      const error = new Error(`Failed to parse ${this.path} texture path`);\n      error.code = \"CJS_TEXTURE_PROCEDURAL_PATH_INVALID\";\n      error.path = this.path;\n      this.SetError(error);\n      return;\n    }\n    this.SetPayload(payload);\n    this.MarkPrepared();\n  }\n\n  /**\n   * m_texture: the live `Tr2TextureAL`, or null until an engine makes one.\n   *\n   * Carbon creates it in `DoPrepare` through the main-thread context and\n   * stores it here (`TriTextureRes.cpp:690-704`). This layer cannot reach a\n   * render context, so Trinity creates it at first bind and stores it here,\n   * where every parameter sharing the resource finds the one texture.\n   */\n  texture = null;\n\n  /**\n   * The live texture, or null while there is none - Carbon returns nullptr\n   * until the load finishes and the parameter substitutes the fallback\n   * (`TriTextureRes.cpp:394-405`).\n   *\n   * @returns {object|null} A `Tr2TextureAL`.\n   */\n  GetTexture() {\n    return this.texture && this.texture.IsValid() ? this.texture : null;\n  }\n\n  /**\n   * Adopts a texture as this resource's (`TriTextureRes.cpp:1159-1195`).\n   *\n   * @param {object|null} texture A `Tr2TextureAL`, or null to drop it.\n   * @returns {TriTextureRes} This resource.\n   */\n  SetTexture(texture) {\n    if (this.texture && this.texture !== texture) this.texture.Destroy();\n    this.texture = texture ?? null;\n    return this;\n  }\n\n  /**\n   * Attach a plain texture, RGBA, or video payload and mirror Carbon-exposed\n   * metadata. Invalid payloads are rejected before replacing the current one.\n   *\n   * @param {object|null} payload\n   * @param {object|null} options\n   * @returns {TriTextureRes}\n   */\n  SetPayload(payload = null, options = null) {\n    if (payload === null) {\n      // The bytes are gone; so is the texture made from them.\n      this.SetTexture(null);\n      super.SetPayload(null);\n      return this;\n    }\n\n    const validator = {\n      [ResourcePayloadType.RGBA]: validateRgbaPayload,\n      [ResourcePayloadType.TEXTURE]: validateTexturePayload,\n      [ResourcePayloadType.VIDEO]: validateVideoPayload\n    }[payload?.payloadType];\n    if (!validator) {\n      throw resourcePayloadError(\n        \"TriTextureRes\",\n        'Expected payloadType \"rgba\", \"texture\", or \"video\".',\n        \"payloadType\"\n      );\n    }\n    validateResourcePayload(\"TriTextureRes\", payload, validator);\n\n    const values = { ...(options || {}) };\n    if (payload.pixelFormat !== undefined || payload.format !== undefined) values.format = payload.pixelFormat || payload.format;\n    if (payload.width !== undefined) values.width = payload.width;\n    if (payload.height !== undefined) values.height = payload.height;\n    if (payload.depth !== undefined) values.depth = payload.depth;\n    if (payload.arraySize !== undefined) values.arraySize = payload.arraySize;\n    else if (Array.isArray(payload.faces)) values.arraySize = payload.faces.length;\n    if (payload.mipCount !== undefined) values.cpuMip = payload.mipCount;\n    else if (payload.payloadType === ResourcePayloadType.RGBA) values.cpuMip = 1;\n    if (payload.hadLodRequests !== undefined) values.hadLodRequests = !!payload.hadLodRequests;\n    values.originalMemoryUsage = getPayloadMemoryUsage(payload);\n    values.originalResolution = Math.max(payload.width || 0, payload.height || 0, this.originalResolution || 0);\n\n    super.SetPayload(payload);\n    this.SetValues(values);\n    return this;\n  }\n\n  /**\n   * Turn source bytes into this texture.\n   *\n   * This is the family the route design exists for. One `.dds` is readable as a\n   * compressed `texture` or decoded `rgba`, and six formats — dds, png, jpeg,\n   * tga, gif, webp — populate this same resource. Which reader and which\n   * representation is a registration decision, so neither is written here.\n   *\n   * The resource imports none of them. A texture resource that imported its\n   * formats would drag all six into anything that touches a texture, which is\n   * the whole reason the store exists.\n   *\n   * @param {ArrayBuffer|ArrayBufferView|object} data Source bytes, or a payload already read.\n   * @param {object|null} [options] `{ format, read, output }` plus values applied after the read.\n   * @returns {TriTextureRes} This resource.\n   */\n  DoLoad(data, options = null) {\n    const { format = null, read = null, output = null, ...values } = options || {};\n\n    // Already a payload: the manager read it, and there is nothing to route.\n    if (data?.payloadType !== undefined) return this.SetPayload(data, values);\n\n    const route = this.ResolveFormat(data, format ? { format, read, output } : { output });\n    if (!route) throw resourceFormatRequiredError(\"TriTextureRes\", this.ext, output);\n    return this.SetPayload(route.Read(data), values);\n  }\n\n  /**\n   * Return the number of mip levels known to this texture resource.\n   *\n   * @returns {number}\n   */\n  GetMipCount() {\n    return this.GetPayload()?.mipCount || this.cpuMip || 0;\n  }\n\n  /**\n   * Return the multisample type for this texture.\n   *\n   * @returns {number}\n   */\n  GetMsaaType() {\n    const payload = this.GetPayload();\n    return payload?.multiSampleType ?? payload?.msaaType ?? payload?.samples ?? 1;\n  }\n\n  /**\n   * Return the multisample quality for this texture.\n   *\n   * @returns {number}\n   */\n  GetMsaaQuality() {\n    const payload = this.GetPayload();\n    return payload?.multiSampleQuality ?? payload?.msaaQuality ?? 0;\n  }\n\n  /**\n   * Return true if this texture has received LOD requests.\n   *\n   * @returns {boolean}\n   */\n  HadLodRequests() {\n    return this.hadLodRequests;\n  }\n\n  /**\n   * Return the shader-resource-view heap index when a backend owns one.\n   *\n   * @returns {number}\n   */\n  GetSrvIndexInHeap() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"GetSrvIndexInHeap\", \"Runtime-resource does not own descriptor heaps.\");\n  }\n\n  /**\n   * Save this texture asynchronously.\n   *\n   * @param {string} path\n   * @returns {boolean}\n   */\n  SaveAsync(path = \"\") {\n    throw resourceBoundaryError(\n      \"TriTextureRes\",\n      \"SaveAsync\",\n      `Use a format writer and caller-owned destination to save texture payloads${path ? ` (${path})` : \"\"}.`\n    );\n  }\n\n  /**\n   * Save this texture synchronously.\n   *\n   * @param {string} path\n   * @returns {boolean}\n   */\n  Save(path = \"\") {\n    throw resourceBoundaryError(\n      \"TriTextureRes\",\n      \"Save\",\n      `Use a format writer and caller-owned destination to save texture payloads${path ? ` (${path})` : \"\"}.`\n    );\n  }\n\n  /**\n   * Return true if an asynchronous save is active.\n   *\n   * @returns {boolean}\n   */\n  IsSaving() {\n    return false;\n  }\n\n  /**\n   * Return true if the asynchronous save operation has completed.\n   *\n   * @returns {boolean}\n   */\n  IsSaveCompleted() {\n    return true;\n  }\n\n  /**\n   * Return true if the asynchronous save operation succeeded.\n   *\n   * @returns {boolean}\n   */\n  IsSaveSucceeded() {\n    return false;\n  }\n\n  /**\n   * Wait for an asynchronous save operation.\n   *\n   * @returns {boolean}\n   */\n  WaitForSave() {\n    return this.IsSaveCompleted();\n  }\n\n  /**\n   * Device texture allocation belongs to engine-gpu.\n   *\n   * @throws {Error}\n   */\n  CreateEmptyTexture() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"CreateEmptyTexture\", \"Use engine-gpu to allocate device textures.\");\n  }\n\n  /**\n   * Render-target wrapping belongs to engine-gpu.\n   *\n   * @throws {Error}\n   */\n  SetFromRenderTarget() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"SetFromRenderTarget\", \"Runtime-resource does not own render targets.\");\n  }\n\n  /**\n   * Create a texture copy from a render target.\n   *\n   * @throws {Error}\n   */\n  CreateAndCopyFromRenderTarget() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"CreateAndCopyFromRenderTarget\", \"Runtime-resource does not own render targets.\");\n  }\n\n  /**\n   * Create a device texture from a host bitmap.\n   *\n   * @throws {Error}\n   */\n  CreateFromHostBitmap() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"CreateFromHostBitmap\", \"Use engine-gpu to allocate and upload texture data.\");\n  }\n\n  /**\n   * Create this texture from another texture resource.\n   *\n   * @throws {Error}\n   */\n  CreateFromTexture() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"CreateFromTexture\", \"Use engine-gpu to copy device textures.\");\n  }\n\n  /**\n   * Return true if this texture owns a backend allocation object.\n   *\n   * @param {string|number} type\n   * @param {string|number} object\n   * @returns {boolean}\n   */\n  HasALObject(type, object) {\n    return this.HasAdapterResource(`${type}:${object}`);\n  }\n\n  /**\n   * Return an engine-owned texture pipeline object when attached.\n   *\n   * @returns {*}\n   */\n  GetPipeline() {\n    return this.GetAdapterResource(\"pipeline\");\n  }\n\n  /**\n   * Return memory size for the original non-LODed texture.\n   *\n   * @returns {number}\n   */\n  GetOriginalMemoryUsage() {\n    return this.originalMemoryUsage || getPayloadMemoryUsage(this.GetPayload());\n  }\n\n  /**\n   * Store the average color reported by decoded texture data.\n   *\n   * @param {number} red\n   * @param {number} green\n   * @param {number} blue\n   * @param {number} alpha\n   * @returns {TriTextureRes}\n   */\n  SetAverageColor(red = 0, green = 0, blue = 0, alpha = 0) {\n    this.averageColor = [red, green, blue, alpha];\n    return this;\n  }\n\n  /**\n   * Update a texture subresource.\n   *\n   * @throws {Error}\n   */\n  UpdateSubresource() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"UpdateSubresource\", \"Use engine-gpu to upload texture bytes.\");\n  }\n\n  /**\n   * Resource preparation does not decide device upload policy.\n   *\n   * @returns {boolean}\n   */\n  PrepareResources() {\n    return this.IsPrepared();\n  }\n\n  static payload = ResourceRequirement.TEXTURE;\n}\n\nfunction getPayloadMemoryUsage(payload)\n{\n  if (!payload || typeof payload !== \"object\") return 0;\n  if (Number.isSafeInteger(payload.originalMemoryUsage) && payload.originalMemoryUsage >= 0)\n  {\n    return payload.originalMemoryUsage;\n  }\n  return ArrayBuffer.isView(payload.data) || payload.data instanceof ArrayBuffer\n    ? payload.data.byteLength\n    : 0;\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(TriTextureRes, {\n  className: \"TriTextureRes\",\n  family: \"resources\",\n  fields: {\n    format: [ type.unknown, edit.read ],\n    type: [ type.unknown, edit.persist ],\n    averageColor: [ type.color, edit.read ],\n    depth: [ type.uint32, edit.read ],\n    cutoutHeight: [ type.float32, edit.readwrite ],\n    height: [ type.uint32, edit.read ],\n    lodEnabled: [ type.boolean, edit.read ],\n    hadLodRequests: [ type.boolean, edit.read ],\n    cpuMip: [ type.uint32, edit.read ],\n    gpuMip: [ type.uint32, edit.read ],\n    wrappedRenderTarget: [ type.unknown, edit.read ],\n    originalResolution: [ type.uint32, edit.read ],\n    originalMemoryUsage: [ type.uint64, edit.read ],\n    name: [ type.string, edit.readwrite ],\n    arraySize: [ type.uint32, edit.read ],\n    cutoutWidth: [ type.float32, edit.readwrite ],\n    width: [ type.uint32, edit.read ],\n    cutoutX: [ type.float32, edit.readwrite ],\n    cutoutY: [ type.float32, edit.readwrite ]\n  },\n  methods: {\n    Initialize: [ carbon.method, impl.adapted, impl.reason(\"Carbon rasterizes a procedural path into a half-float HostBitmap and creates the GPU texture inside Initialize; this resource cannot reach a render context, so it publishes the half-float-quantized colour as an rgba32float payload. The gradient_1d branch is not ported.\") ],\n    GetMipCount: [ carbon.method, impl.adapted ],\n    GetMsaaType: [ carbon.method, impl.adapted ],\n    GetMsaaQuality: [ carbon.method, impl.adapted ],\n    HadLodRequests: [ carbon.method, impl.adapted ],\n    GetSrvIndexInHeap: [ carbon.method, impl.notSupported ],\n    GetTexture: [ carbon.method, impl.implemented ],\n    SetTexture: [ carbon.method, impl.adapted, impl.reason(\"Carbon also copies the texture's dimensions onto the resource and fires m_onTextureChange; the payload already carries the dimensions here, and the binding parameter arms the resource's completion instead.\") ],\n    SaveAsync: [ carbon.method, impl.notSupported ],\n    Save: [ carbon.method, impl.notSupported ],\n    IsSaving: [ carbon.method, impl.noop ],\n    IsSaveCompleted: [ carbon.method, impl.noop ],\n    IsSaveSucceeded: [ carbon.method, impl.noop ],\n    WaitForSave: [ carbon.method, impl.noop ],\n    CreateEmptyTexture: [ carbon.method, impl.notSupported ],\n    SetFromRenderTarget: [ carbon.method, impl.notSupported ],\n    CreateAndCopyFromRenderTarget: [ carbon.method, impl.notSupported ],\n    CreateFromHostBitmap: [ carbon.method, impl.notSupported ],\n    CreateFromTexture: [ carbon.method, impl.notSupported ],\n    HasALObject: [ carbon.method, impl.adapted ],\n    GetPipeline: [ carbon.method, impl.adapted ],\n    GetOriginalMemoryUsage: [ carbon.method, impl.adapted ],\n    SetAverageColor: [ carbon.method, impl.adapted ],\n    UpdateSubresource: [ carbon.method, impl.notSupported ],\n    PrepareResources: [ carbon.method, impl.adapted ]\n  }\n});\n"],"names":["TriTextureRes","CjsResource","format","type","averageColor","depth","cutoutHeight","height","lodEnabled","hadLodRequests","cpuMip","gpuMip","wrappedRenderTarget","originalResolution","originalMemoryUsage","name","arraySize","cutoutWidth","width","cutoutX","cutoutY","constructor","values","SetValues","skipUpdate","skipEvents","Initialize","path","ext","requirement","IsSolidColorTexturePath","RasterizeSolidColor","#RasterizeProceduralTexture","rasterize","MarkLoading","payload","error","Error","code","SetError","SetPayload","MarkPrepared","texture","GetTexture","IsValid","SetTexture","Destroy","options","validator","ResourcePayloadType","RGBA","validateRgbaPayload","TEXTURE","validateTexturePayload","VIDEO","validateVideoPayload","payloadType","resourcePayloadError","validateResourcePayload","pixelFormat","undefined","Array","isArray","faces","length","mipCount","getPayloadMemoryUsage","Math","max","DoLoad","data","read","output","route","ResolveFormat","resourceFormatRequiredError","Read","GetMipCount","GetPayload","GetMsaaType","multiSampleType","msaaType","samples","GetMsaaQuality","multiSampleQuality","msaaQuality","HadLodRequests","GetSrvIndexInHeap","resourceBoundaryError","SaveAsync","Save","IsSaving","IsSaveCompleted","IsSaveSucceeded","WaitForSave","CreateEmptyTexture","SetFromRenderTarget","CreateAndCopyFromRenderTarget","CreateFromHostBitmap","CreateFromTexture","HasALObject","object","HasAdapterResource","GetPipeline","GetAdapterResource","GetOriginalMemoryUsage","SetAverageColor","red","green","blue","alpha","UpdateSubresource","PrepareResources","IsPrepared","ResourceRequirement","Number","isSafeInteger","ArrayBuffer","isView","byteLength","CjsSchema","define","className","family","fields","unknown","edit","persist","color","uint32","float32","readwrite","boolean","uint64","string","methods","carbon","method","impl","adapted","reason","notSupported","implemented","noop"],"mappings":"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"}
+{"version":3,"file":"TriTextureRes.js","sources":["../../../../src/resource/texture/TriTextureRes.js"],"sourcesContent":["// Source: trinity/trinity/Resources/TriTextureRes.h\n// Source: trinity/trinity/Resources/TriTextureRes.cpp\n// Source: trinity/trinity/Resources/TriTextureRes_Blue.cpp\nimport { CjsSchema, carbon, impl, edit, type } from \"#schema\";\nimport { HostBitmap } from \"#imageio\";\nimport { CjsResource } from \"../CjsResource.js\";\nimport { IsSolidColorTexturePath, RasterizeSolidColor } from \"./solidColorTexture.js\";\nimport { ResourceRequirement } from \"../ResourceRequirement.js\";\nimport {\n  ResourcePayloadType,\n  validateRgbaPayload,\n  validateTexturePayload,\n  validateVideoPayload\n} from \"../format/payloadContract.js\";\nimport {\n  resourceBoundaryError,\n  resourceFormatRequiredError,\n  resourcePayloadError,\n  validateResourcePayload\n} from \"../resourceBoundary.js\";\n\n/**\n * Resource record that owns Carbon-style texture identity and validated\n * texture, RGBA, or video payload facts with mirrored dimension/format\n * metadata, while engine packages decide what those facts become on a device.\n *\n * The resource never CREATES a backend texture - it cannot reach a render\n * context - but it RETAINS the one Trinity makes for it, as Carbon's does\n * (`m_texture`), so every parameter sharing the resource binds one texture.\n */\nexport class TriTextureRes extends CjsResource\n{\n  format = null;\n  type = null;\n  averageColor = [0, 0, 0, 0];\n  depth = 0;\n  cutoutHeight = 1;\n  height = 0;\n  lodEnabled = false;\n  hadLodRequests = false;\n  cpuMip = 0;\n  gpuMip = 0;\n  wrappedRenderTarget = null;\n  originalResolution = 0;\n  originalMemoryUsage = 0;\n  name = \"\";\n  arraySize = 0;\n  cutoutWidth = 1;\n  width = 0;\n  cutoutX = 0;\n  cutoutY = 0;\n\n  /** Creates a TriTextureRes 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   * Carbon's Initialize, with its procedural branch (TriTextureRes.cpp:223-236):\n   * a `dynamic:/color/` path is rasterized here rather than loaded from source.\n   * The `dynamic:/gradient_1d/` branch Carbon checks first is rasterized by\n   * trinity's GradientTextureConstructor instead: a gradient needs Tr2CurveScalar,\n   * which this layer may not import.\n   *\n   * @param {string} path Resource path.\n   * @param {string|null} [ext] Extension override.\n   * @param {string} [requirement] Semantic requirement.\n   * @returns {TriTextureRes} This resource.\n   */\n  Initialize(path, ext = null, requirement = \"\") {\n    super.Initialize(path, ext, requirement);\n    if (IsSolidColorTexturePath(this.path)) this.#RasterizeProceduralTexture(RasterizeSolidColor);\n    return this;\n  }\n\n  /**\n   * `RasterizeProceduralTexture` (TriTextureRes.cpp:181-212). Carbon creates the\n   * GPU texture from the bitmap here; this layer cannot reach a render context,\n   * so it publishes the bitmap as the payload and Trinity makes the texture at\n   * first bind, as it does for every other texture.\n   *\n   * @param {Function} rasterize `(path) => HostBitmap | null`.\n   * @returns {void}\n   */\n  #RasterizeProceduralTexture(rasterize) {\n    this.MarkLoading();\n    const bitmap = rasterize(this.path);\n    if (!bitmap) {\n      // Carbon: \"Failed to parse dynamic:/color/%s texture path\", and the\n      // texture is never prepared.\n      const error = new Error(`Failed to parse ${this.path} texture path`);\n      error.code = \"CJS_TEXTURE_PROCEDURAL_PATH_INVALID\";\n      error.path = this.path;\n      this.SetError(error);\n      return;\n    }\n    this.SetPayload(bitmap);\n    this.MarkPrepared();\n  }\n\n  /**\n   * m_texture: the live `Tr2TextureAL`, or null until an engine makes one.\n   *\n   * Carbon creates it in `DoPrepare` through the main-thread context and\n   * stores it here (`TriTextureRes.cpp:690-704`). This layer cannot reach a\n   * render context, so Trinity creates it at first bind and stores it here,\n   * where every parameter sharing the resource finds the one texture.\n   */\n  texture = null;\n\n  /** m_loadedBitmap: the decoded image the texture is made from, or null. */\n  loadedBitmap = null;\n\n  /**\n   * The live texture, or null while there is none - Carbon returns nullptr\n   * until the load finishes and the parameter substitutes the fallback\n   * (`TriTextureRes.cpp:394-405`).\n   *\n   * @returns {object|null} A `Tr2TextureAL`.\n   */\n  GetTexture() {\n    return this.texture && this.texture.IsValid() ? this.texture : null;\n  }\n\n  /**\n   * Adopts a texture as this resource's (`TriTextureRes.cpp:1159-1195`).\n   *\n   * @param {object|null} texture A `Tr2TextureAL`, or null to drop it.\n   * @returns {TriTextureRes} This resource.\n   */\n  SetTexture(texture) {\n    if (this.texture && this.texture !== texture) this.texture.Destroy();\n    this.texture = texture ?? null;\n    return this;\n  }\n\n  /**\n   * Build this texture from a texture pipeline: Carbon's `.ctr` route\n   * (`TriTextureRes.cpp:238-258` then `ResourcePrepFinished`, `:296-340`).\n   *\n   * Every path the pipeline names is loaded as a raw `Tr2ImageRes` (Carbon asks\n   * for the `\"raw\"` requirement; ours is `ResourceRequirement.IMAGE`), the\n   * pipeline runs once they have all settled, and the result becomes this\n   * texture's bitmap. An input that failed to load reaches the pipeline as\n   * null, exactly as Carbon passes it, so the step that needed it fails.\n   *\n   * adapted: Carbon reads the pipeline from a `.ctr` file with\n   * `BeResMan->LoadObject` and waits on a fence. No shipped build contains a\n   * `.ctr` (checked across 45 resfileindexes, 2026-09-24), so the pipeline is\n   * handed in - built in memory by the `dynamic:/` constructors that use this\n   * route - and the fence is a promise. The manager is passed because the\n   * resource layer has no global `BeResMan`.\n   *\n   * quirk: Carbon marks the resource good even when the pipeline fails\n   * (`m_isGood = true` after the branch, `:337`), so the texture is simply\n   * absent and the parameter binds its fallback. Reproduced: the resource is\n   * prepared either way, with no bitmap when the pipeline failed.\n   *\n   * @param {import(\"./Tr2TexturePipeline.js\").Tr2TexturePipeline} pipeline The recipe.\n   * @param {object} resourceManager The `CjsResMan` that loads its inputs.\n   * @returns {Promise<boolean>} Whether the pipeline produced a bitmap.\n   */\n  async LoadPipeline(pipeline, resourceManager) {\n    this.MarkLoading();\n\n    const images = new Map();\n\n    for (const path of pipeline.GetResourceDependencies()) {\n      images.set(path, resourceManager.GetResource(path, { requirement: ResourceRequirement.IMAGE }));\n    }\n\n    // Carbon's m_pipelineFence: wait for every input, whatever became of it.\n    await Promise.allSettled([ ...images.values() ].map(image => image.Ready()));\n\n    // Carbon: it->second && it->second->IsGood() ? &it->second->GetBitmap() : nullptr\n    const inputs = new Map();\n\n    for (const [ path, image ] of images) {\n      inputs.set(path, image.IsGood() ? image.GetBitmap() : null);\n    }\n\n    const result = new HostBitmap();\n    const executed = pipeline.Execute(result, inputs);\n\n    if (executed) this.SetPayload(result);\n\n    this.MarkPrepared();\n    return executed;\n  }\n\n  /**\n   * Adopt the cutout an image declared (Carbon reads ImageIO::Metadata's\n   * cutout in DoPrepare and stores it as m_cutoutX/Y/Width/Height).\n   *\n   * @param {{x: number, y: number, width: number, height: number}} cutout The rectangle.\n   * @returns {TriTextureRes} This resource.\n   */\n  SetCutout(cutout) {\n    this.SetValues({\n      cutoutX: cutout.x,\n      cutoutY: cutout.y,\n      cutoutWidth: cutout.width,\n      cutoutHeight: cutout.height\n    });\n    return this;\n  }\n\n  /**\n   * The decoded bitmap this resource was loaded from, or null.\n   *\n   * Carbon's `m_loadedBitmap` (`TriTextureRes.cpp:606`): the CPU-side image\n   * the texture is made from, kept so the texture can be remade - for a device\n   * reset, a LOD change or a save.\n   *\n   * @returns {import(\"#imageio\").HostBitmap|null} The bitmap.\n   */\n  GetBitmap() {\n    return this.loadedBitmap;\n  }\n\n  /**\n   * Adopt a decoded bitmap as this resource's image\n   * (`TriTextureRes::CreateFromHostBitmap`, `TriTextureRes.cpp:960-978`).\n   *\n   * adapted: Carbon creates the texture here, on the main thread's render\n   * context (`USE_MAIN_THREAD_RENDER_CONTEXT`). The resource layer may not\n   * reach a render context (layers.json), so the texture is made on first bind\n   * instead - `Tr2ImageIOHelpers.RealizeTexture` - and this only adopts the\n   * bitmap and drops any texture made from the previous one.\n   *\n   * @param {import(\"#imageio\").HostBitmap|null} bitmap The decoded bitmap.\n   * @returns {boolean} Whether the bitmap was adopted.\n   */\n  CreateFromHostBitmap(bitmap) {\n    this.SetTexture(null);\n\n    if (!bitmap || !bitmap.IsValid()) {\n      this.loadedBitmap = null;\n      return false;\n    }\n\n    this.loadedBitmap = bitmap;\n    this.SetValues({\n      format: bitmap.GetFormat(),\n      width: bitmap.GetWidth(),\n      height: bitmap.GetHeight(),\n      depth: bitmap.GetDepth(),\n      arraySize: bitmap.GetArraySize(),\n      cpuMip: bitmap.GetTrueMipCount()\n    });\n    return true;\n  }\n\n  /**\n   * Attach a plain texture, RGBA, or video payload and mirror Carbon-exposed\n   * metadata. Invalid payloads are rejected before replacing the current one.\n   *\n   * @param {object|null} payload\n   * @param {object|null} options\n   * @returns {TriTextureRes}\n   */\n  SetPayload(payload = null, options = null) {\n    if (payload === null) {\n      // The bytes are gone; so is the texture made from them.\n      this.SetTexture(null);\n      this.loadedBitmap = null;\n      super.SetPayload(null);\n      return this;\n    }\n\n    // Carbon's resource IS its bitmap (TriTextureRes.cpp:606, 960-978).\n    const bitmap = CjsSchema.cast(payload, HostBitmap);\n\n    if (bitmap) {\n      this.CreateFromHostBitmap(bitmap);\n      super.SetPayload(bitmap, options);\n      if (options) this.SetValues(options);\n      if (bitmap.metadata?.cutout) this.SetCutout(bitmap.metadata.cutout);\n      return this;\n    }\n\n    // A video frame source is the one payload left: it is not an image the\n    // CPU decoded, it is a playing element the backend samples.\n    if (payload?.payloadType !== ResourcePayloadType.VIDEO) {\n      throw resourcePayloadError(\n        \"TriTextureRes\",\n        'Expected an ImageIO::HostBitmap, or payloadType \"video\".',\n        \"payloadType\"\n      );\n    }\n    const validator = validateVideoPayload;\n    validateResourcePayload(\"TriTextureRes\", payload, validator);\n\n    const values = { ...(options || {}) };\n    if (payload.pixelFormat !== undefined || payload.format !== undefined) values.format = payload.pixelFormat || payload.format;\n    if (payload.width !== undefined) values.width = payload.width;\n    if (payload.height !== undefined) values.height = payload.height;\n    if (payload.depth !== undefined) values.depth = payload.depth;\n    if (payload.arraySize !== undefined) values.arraySize = payload.arraySize;\n    else if (Array.isArray(payload.faces)) values.arraySize = payload.faces.length;\n    if (payload.mipCount !== undefined) values.cpuMip = payload.mipCount;\n    else if (payload.payloadType === ResourcePayloadType.RGBA) values.cpuMip = 1;\n    if (payload.hadLodRequests !== undefined) values.hadLodRequests = !!payload.hadLodRequests;\n    values.originalMemoryUsage = getPayloadMemoryUsage(payload);\n    values.originalResolution = Math.max(payload.width || 0, payload.height || 0, this.originalResolution || 0);\n\n    super.SetPayload(payload);\n    this.SetValues(values);\n    return this;\n  }\n\n  /**\n   * Turn source bytes into this texture.\n   *\n   * This is the family the route design exists for. One `.dds` is readable as a\n   * compressed `texture` or decoded `rgba`, and six formats — dds, png, jpeg,\n   * tga, gif, webp — populate this same resource. Which reader and which\n   * representation is a registration decision, so neither is written here.\n   *\n   * The resource imports none of them. A texture resource that imported its\n   * formats would drag all six into anything that touches a texture, which is\n   * the whole reason the store exists.\n   *\n   * @param {ArrayBuffer|ArrayBufferView|object} data Source bytes, or a payload already read.\n   * @param {object|null} [options] `{ format, read, output }` plus values applied after the read.\n   * @returns {TriTextureRes} This resource.\n   */\n  DoLoad(data, options = null) {\n    const { format = null, read = null, output = null, ...values } = options || {};\n\n    // Already a payload: the manager read it, and there is nothing to route.\n    if (data?.payloadType !== undefined) return this.SetPayload(data, values);\n\n    const route = this.ResolveFormat(data, format ? { format, read, output } : { output });\n    if (!route) throw resourceFormatRequiredError(\"TriTextureRes\", this.ext, output);\n    return this.SetPayload(route.Read(data), values);\n  }\n\n  /**\n   * Return the number of mip levels known to this texture resource.\n   *\n   * @returns {number}\n   */\n  GetMipCount() {\n    return this.GetPayload()?.mipCount || this.cpuMip || 0;\n  }\n\n  /**\n   * Return the multisample type for this texture.\n   *\n   * @returns {number}\n   */\n  GetMsaaType() {\n    // Carbon: m_texture ? m_texture->GetMsaaDesc().samples : 1 (cpp:1214-1216).\n    const texture = this.GetTexture();\n    return texture ? texture.GetMsaaDesc().samples : 1;\n  }\n\n  /**\n   * Return the multisample quality for this texture.\n   *\n   * @returns {number}\n   */\n  GetMsaaQuality() {\n    // Carbon: m_texture ? m_texture->GetMsaaDesc().quality : 0 (cpp:1219-1222).\n    const texture = this.GetTexture();\n    return texture ? texture.GetMsaaDesc().quality : 0;\n  }\n\n  /**\n   * Return true if this texture has received LOD requests.\n   *\n   * @returns {boolean}\n   */\n  HadLodRequests() {\n    return this.hadLodRequests;\n  }\n\n  /**\n   * Return the shader-resource-view heap index when a backend owns one.\n   *\n   * @returns {number}\n   */\n  GetSrvIndexInHeap() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"GetSrvIndexInHeap\", \"Runtime-resource does not own descriptor heaps.\");\n  }\n\n  /**\n   * Save this texture asynchronously.\n   *\n   * @param {string} path\n   * @returns {boolean}\n   */\n  SaveAsync(path = \"\") {\n    throw resourceBoundaryError(\n      \"TriTextureRes\",\n      \"SaveAsync\",\n      `Use a format writer and caller-owned destination to save texture payloads${path ? ` (${path})` : \"\"}.`\n    );\n  }\n\n  /**\n   * Save this texture synchronously.\n   *\n   * @param {string} path\n   * @returns {boolean}\n   */\n  Save(path = \"\") {\n    throw resourceBoundaryError(\n      \"TriTextureRes\",\n      \"Save\",\n      `Use a format writer and caller-owned destination to save texture payloads${path ? ` (${path})` : \"\"}.`\n    );\n  }\n\n  /**\n   * Return true if an asynchronous save is active.\n   *\n   * @returns {boolean}\n   */\n  IsSaving() {\n    return false;\n  }\n\n  /**\n   * Return true if the asynchronous save operation has completed.\n   *\n   * @returns {boolean}\n   */\n  IsSaveCompleted() {\n    return true;\n  }\n\n  /**\n   * Return true if the asynchronous save operation succeeded.\n   *\n   * @returns {boolean}\n   */\n  IsSaveSucceeded() {\n    return false;\n  }\n\n  /**\n   * Wait for an asynchronous save operation.\n   *\n   * @returns {boolean}\n   */\n  WaitForSave() {\n    return this.IsSaveCompleted();\n  }\n\n  /**\n   * Device texture allocation belongs to engine-gpu.\n   *\n   * @throws {Error}\n   */\n  CreateEmptyTexture() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"CreateEmptyTexture\", \"Use engine-gpu to allocate device textures.\");\n  }\n\n  /**\n   * Render-target wrapping belongs to engine-gpu.\n   *\n   * @throws {Error}\n   */\n  SetFromRenderTarget() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"SetFromRenderTarget\", \"Runtime-resource does not own render targets.\");\n  }\n\n  /**\n   * Create a texture copy from a render target.\n   *\n   * @throws {Error}\n   */\n  CreateAndCopyFromRenderTarget() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"CreateAndCopyFromRenderTarget\", \"Runtime-resource does not own render targets.\");\n  }\n\n  /**\n   * Create this texture from another texture resource.\n   *\n   * @throws {Error}\n   */\n  CreateFromTexture() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"CreateFromTexture\", \"Use engine-gpu to copy device textures.\");\n  }\n\n  /**\n   * Return true if this texture owns a backend allocation object.\n   *\n   * @param {string|number} type\n   * @param {string|number} object\n   * @returns {boolean}\n   */\n  HasALObject(type, object) {\n    return this.HasAdapterResource(`${type}:${object}`);\n  }\n\n  /**\n   * Return an engine-owned texture pipeline object when attached.\n   *\n   * @returns {*}\n   */\n  GetPipeline() {\n    return this.GetAdapterResource(\"pipeline\");\n  }\n\n  /**\n   * Return memory size for the original non-LODed texture.\n   *\n   * @returns {number}\n   */\n  GetOriginalMemoryUsage() {\n    return this.originalMemoryUsage || getPayloadMemoryUsage(this.GetPayload());\n  }\n\n  /**\n   * Store the average color reported by decoded texture data.\n   *\n   * @param {number} red\n   * @param {number} green\n   * @param {number} blue\n   * @param {number} alpha\n   * @returns {TriTextureRes}\n   */\n  SetAverageColor(red = 0, green = 0, blue = 0, alpha = 0) {\n    this.averageColor = [red, green, blue, alpha];\n    return this;\n  }\n\n  /**\n   * Update a texture subresource.\n   *\n   * @throws {Error}\n   */\n  UpdateSubresource() {\n    throw resourceBoundaryError(\"TriTextureRes\", \"UpdateSubresource\", \"Use engine-gpu to upload texture bytes.\");\n  }\n\n  /**\n   * Resource preparation does not decide device upload policy.\n   *\n   * @returns {boolean}\n   */\n  PrepareResources() {\n    return this.IsPrepared();\n  }\n\n  static payload = ResourceRequirement.TEXTURE;\n}\n\nfunction getPayloadMemoryUsage(payload)\n{\n  if (!payload || typeof payload !== \"object\") return 0;\n  if (Number.isSafeInteger(payload.originalMemoryUsage) && payload.originalMemoryUsage >= 0)\n  {\n    return payload.originalMemoryUsage;\n  }\n  return ArrayBuffer.isView(payload.data) || payload.data instanceof ArrayBuffer\n    ? payload.data.byteLength\n    : 0;\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(TriTextureRes, {\n  className: \"TriTextureRes\",\n  family: \"resources\",\n  fields: {\n    format: [ type.unknown, edit.read ],\n    type: [ type.unknown, edit.persist ],\n    averageColor: [ type.color, edit.read ],\n    depth: [ type.uint32, edit.read ],\n    cutoutHeight: [ type.float32, edit.readwrite ],\n    height: [ type.uint32, edit.read ],\n    lodEnabled: [ type.boolean, edit.read ],\n    hadLodRequests: [ type.boolean, edit.read ],\n    cpuMip: [ type.uint32, edit.read ],\n    gpuMip: [ type.uint32, edit.read ],\n    wrappedRenderTarget: [ type.unknown, edit.read ],\n    originalResolution: [ type.uint32, edit.read ],\n    originalMemoryUsage: [ type.uint64, edit.read ],\n    name: [ type.string, edit.readwrite ],\n    arraySize: [ type.uint32, edit.read ],\n    cutoutWidth: [ type.float32, edit.readwrite ],\n    width: [ type.uint32, edit.read ],\n    cutoutX: [ type.float32, edit.readwrite ],\n    cutoutY: [ type.float32, edit.readwrite ],\n    loadedBitmap: [ type.unknown, edit.read ]\n  },\n  methods: {\n    Initialize: [ carbon.method, impl.adapted, impl.reason(\"Carbon rasterizes a procedural path into a half-float HostBitmap and creates the GPU texture inside Initialize; this resource cannot reach a render context, so it publishes the half-float-quantized colour as an rgba32float payload. The gradient_1d branch is not ported.\") ],\n    GetMipCount: [ carbon.method, impl.adapted ],\n    GetMsaaType: [ carbon.method, impl.implemented ],\n    GetMsaaQuality: [ carbon.method, impl.implemented ],\n    HadLodRequests: [ carbon.method, impl.adapted ],\n    GetSrvIndexInHeap: [ carbon.method, impl.notSupported ],\n    GetTexture: [ carbon.method, impl.implemented ],\n    SetTexture: [ carbon.method, impl.adapted, impl.reason(\"Carbon also copies the texture's dimensions onto the resource and fires m_onTextureChange; the payload already carries the dimensions here, and the binding parameter arms the resource's completion instead.\") ],\n    SaveAsync: [ carbon.method, impl.notSupported ],\n    Save: [ carbon.method, impl.notSupported ],\n    IsSaving: [ carbon.method, impl.noop ],\n    IsSaveCompleted: [ carbon.method, impl.noop ],\n    IsSaveSucceeded: [ carbon.method, impl.noop ],\n    WaitForSave: [ carbon.method, impl.noop ],\n    CreateEmptyTexture: [ carbon.method, impl.notSupported ],\n    SetFromRenderTarget: [ carbon.method, impl.notSupported ],\n    CreateAndCopyFromRenderTarget: [ carbon.method, impl.notSupported ],\n    CreateFromHostBitmap: [ carbon.method, impl.adapted, impl.reason(\"Carbon creates the texture here on the main thread's render context; the resource layer may not reach one, so this adopts the bitmap and the texture is made on first bind (Tr2ImageIOHelpers.RealizeTexture).\") ],\n    LoadPipeline: [ impl.adapted, impl.reason(\"Carbon's .ctr branch reads the pipeline from a file through the global BeResMan and waits on a fence; no shipped build has a .ctr, so the pipeline is handed in, the manager passed, and the fence is a promise.\") ],\n    SetCutout: [ impl.custom, impl.reason(\"Carbon reads the cutout from ImageIO::Metadata inside DoPrepare; the read happens in the loader here, so the resource is told.\") ],\n    GetBitmap: [ impl.custom, impl.reason(\"Carbon keeps m_loadedBitmap private and uploads it inside CreateFromHostBitmap; the upload happens at bind time here, so the bitmap has to be readable.\") ],\n    CreateFromTexture: [ carbon.method, impl.notSupported ],\n    HasALObject: [ carbon.method, impl.adapted ],\n    GetPipeline: [ carbon.method, impl.adapted ],\n    GetOriginalMemoryUsage: [ carbon.method, impl.adapted ],\n    SetAverageColor: [ carbon.method, impl.adapted ],\n    UpdateSubresource: [ carbon.method, impl.notSupported ],\n    PrepareResources: [ carbon.method, impl.adapted ]\n  }\n});\n"],"names":["TriTextureRes","CjsResource","format","type","averageColor","depth","cutoutHeight","height","lodEnabled","hadLodRequests","cpuMip","gpuMip","wrappedRenderTarget","originalResolution","originalMemoryUsage","name","arraySize","cutoutWidth","width","cutoutX","cutoutY","constructor","values","SetValues","skipUpdate","skipEvents","Initialize","path","ext","requirement","IsSolidColorTexturePath","RasterizeSolidColor","#RasterizeProceduralTexture","rasterize","MarkLoading","bitmap","error","Error","code","SetError","SetPayload","MarkPrepared","texture","loadedBitmap","GetTexture","IsValid","SetTexture","Destroy","LoadPipeline","pipeline","resourceManager","images","Map","GetResourceDependencies","set","GetResource","ResourceRequirement","IMAGE","Promise","allSettled","map","image","Ready","inputs","IsGood","GetBitmap","result","HostBitmap","executed","Execute","SetCutout","cutout","x","y","CreateFromHostBitmap","GetFormat","GetWidth","GetHeight","GetDepth","GetArraySize","GetTrueMipCount","payload","options","CjsSchema","cast","metadata","payloadType","ResourcePayloadType","VIDEO","resourcePayloadError","validator","validateVideoPayload","validateResourcePayload","pixelFormat","undefined","Array","isArray","faces","length","mipCount","RGBA","getPayloadMemoryUsage","Math","max","DoLoad","data","read","output","route","ResolveFormat","resourceFormatRequiredError","Read","GetMipCount","GetPayload","GetMsaaType","GetMsaaDesc","samples","GetMsaaQuality","quality","HadLodRequests","GetSrvIndexInHeap","resourceBoundaryError","SaveAsync","Save","IsSaving","IsSaveCompleted","IsSaveSucceeded","WaitForSave","CreateEmptyTexture","SetFromRenderTarget","CreateAndCopyFromRenderTarget","CreateFromTexture","HasALObject","object","HasAdapterResource","GetPipeline","GetAdapterResource","GetOriginalMemoryUsage","SetAverageColor","red","green","blue","alpha","UpdateSubresource","PrepareResources","IsPrepared","TEXTURE","Number","isSafeInteger","ArrayBuffer","isView","byteLength","define","className","family","fields","unknown","edit","persist","color","uint32","float32","readwrite","boolean","uint64","string","methods","carbon","method","impl","adapted","reason","implemented","notSupported","noop","custom"],"mappings":"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"}

package/dist/resource/texture/index.js

@@ -1,3 +1,10 @@
+export { CjsTextureArrayConstructor, RegisterTextureArray, TextureArrayPrefix } from './CjsTextureArrayConstructor.js';
+export { CjsTexturePipelineStepArray } from './CjsTexturePipelineStepArray.js';
+export { CjsTexturePipelineStepPack } from './CjsTexturePipelineStepPack.js';
+export { CjsTexturePackConstructor, RegisterTexturePack, TexturePackPrefix } from './CjsTexturePackConstructor.js';
+export { CjsTexturePipelineStepConvert } from './CjsTexturePipelineStepConvert.js';
+export { CjsTexturePipelineStepResize } from './CjsTexturePipelineStepResize.js';
+export { RegisterTextureResources, TextureResourceExtensions } from './registerTextureResources.js';
 export { CjsTextureArrayRes } from './CjsTextureArrayRes.js';
 export { CjsTextureArrayResParameterProxy } from './CjsTextureArrayResParameterProxy.js';
 export { RegisterSolidColorTexture, SolidColorTextureConstructor } from './SolidColorTextureConstructor.js';

package/dist/resource/texture/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/texture/registerTextureResources.js

@@ -0,0 +1,83 @@
+import { HostBitmap, Metadata, LoadParameters } from '#imageio';
+import { ImageIO } from '../imageio/ImageIO.js';
+import { TriTextureRes } from './TriTextureRes.js';
+import { Tr2ImageRes } from './Tr2ImageRes.js';
+import { ResourceRequirement } from '../ResourceRequirement.js';
+
+// Source: trinity/trinity/Resources/TriTextureRes.cpp:39-55
+//   BLUE_REGISTER_RESOURCE_EXTENSION for each image extension -> CreateTextureResource.
+// Source: trinity/trinity/Resources/Tr2ImageRes.cpp:39-52 (DoLoad reads into m_bitmap)
+//
+// Carbon registers at static-initialisation time inside the class's own
+// translation unit, and its resource reads the file with `ImageIO::ReadImage`
+// into its own `HostBitmap`. We do not self-register at module scope - the same
+// reason `RegisterShaderResources` does not - so this is an explicit call made
+// by whoever composes a manager.
+//
+// The read is the loader rather than the resource's own `DoLoad` because one
+// format needs it: PNG decodes through `DecompressionStream`, which is
+// asynchronous, and `SetPayload` is not. The loader therefore does what
+// Carbon's DoLoad does, and hands the resource the finished bitmap.
+
+/**
+ * The image extensions Carbon routes to a texture resource
+ * (`TriTextureRes.cpp:46-55`).
+ *
+ * Carbon lists dds, png, sdd, tga, jpg, jpeg, bmp, ecs, ctr and vta. These are
+ * the ones an image handler is registered for here; `bmp`, `ecs`, `sdd`,
+ * `ctr` and `vta` join their handlers as those land.
+ */
+const TextureResourceExtensions = Object.freeze(["dds", "png", "jpg", "jpeg", "tga", "gif"]);
+
+/**
+ * Read one image into a bitmap, as Carbon's `DoLoad` does.
+ *
+ * @param {Uint8Array|ArrayBuffer} bytes The file's bytes.
+ * @param {object} context The manager's prepare context.
+ * @returns {Promise<HostBitmap>} The decoded bitmap.
+ */
+async function ReadImageResource(bytes, context) {
+  const bitmap = new HostBitmap();
+  const metadata = new Metadata();
+  const path = context.path;
+  const result = await ImageIO.readImageAsync(bytes, new LoadParameters(path), bitmap, metadata);
+
+  // Carbon: CCP_LOGWARN("Tr2ImageRes: error reading '%S' - %s") and LR_FAILED.
+  if (!result.IsOk()) {
+    const error = new Error(`${path || "image"}: ${result.GetErrorMessage()}`);
+    error.code = "CJS_RESOURCE_IMAGE_READ_FAILED";
+    throw error;
+  }
+  bitmap.metadata = metadata;
+  return bitmap;
+}
+
+/**
+ * Routes every image extension to a texture resource on one manager.
+ *
+ * @param {object} resourceManager Manager to register on.
+ * @param {object} [options] `{ Handler }` to route to `Tr2ImageRes` instead.
+ * @returns {object} The same manager, for chaining.
+ */
+function RegisterTextureResources(resourceManager, options = {}) {
+  if (typeof resourceManager?.RegisterExtension !== "function" || typeof resourceManager?.RegisterObjectLoader !== "function") {
+    throw new TypeError("RegisterTextureResources requires a CjsResMan.");
+  }
+  const Handler = options.Handler ?? TriTextureRes;
+  if (Handler !== TriTextureRes && Handler !== Tr2ImageRes) {
+    throw new TypeError("RegisterTextureResources routes to TriTextureRes or Tr2ImageRes.");
+  }
+  for (const extension of TextureResourceExtensions) {
+    resourceManager.RegisterObjectLoader(extension, ReadImageResource);
+    resourceManager.RegisterExtension(extension, Handler);
+  }
+
+  // Carbon asks for the same file as a texture or as a "raw" image; the
+  // requirement picks the class and keeps a separate cache entry for each.
+  resourceManager.RegisterResourceType(ResourceRequirement.TEXTURE, TriTextureRes);
+  resourceManager.RegisterResourceType(ResourceRequirement.IMAGE, Tr2ImageRes);
+  return resourceManager;
+}
+
+export { RegisterTextureResources, TextureResourceExtensions };
+//# sourceMappingURL=registerTextureResources.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registerTextureResources.js","sources":["../../../../src/resource/texture/registerTextureResources.js"],"sourcesContent":["// Source: trinity/trinity/Resources/TriTextureRes.cpp:39-55\n//   BLUE_REGISTER_RESOURCE_EXTENSION for each image extension -> CreateTextureResource.\n// Source: trinity/trinity/Resources/Tr2ImageRes.cpp:39-52 (DoLoad reads into m_bitmap)\n//\n// Carbon registers at static-initialisation time inside the class's own\n// translation unit, and its resource reads the file with `ImageIO::ReadImage`\n// into its own `HostBitmap`. We do not self-register at module scope - the same\n// reason `RegisterShaderResources` does not - so this is an explicit call made\n// by whoever composes a manager.\n//\n// The read is the loader rather than the resource's own `DoLoad` because one\n// format needs it: PNG decodes through `DecompressionStream`, which is\n// asynchronous, and `SetPayload` is not. The loader therefore does what\n// Carbon's DoLoad does, and hands the resource the finished bitmap.\nimport { HostBitmap, LoadParameters, Metadata } from \"#imageio\";\nimport { ImageIO } from \"../imageio/ImageIO.js\";\nimport { TriTextureRes } from \"./TriTextureRes.js\";\nimport { Tr2ImageRes } from \"./Tr2ImageRes.js\";\nimport { ResourceRequirement } from \"../ResourceRequirement.js\";\n\n\n/**\n * The image extensions Carbon routes to a texture resource\n * (`TriTextureRes.cpp:46-55`).\n *\n * Carbon lists dds, png, sdd, tga, jpg, jpeg, bmp, ecs, ctr and vta. These are\n * the ones an image handler is registered for here; `bmp`, `ecs`, `sdd`,\n * `ctr` and `vta` join their handlers as those land.\n */\nexport const TextureResourceExtensions = Object.freeze([\n  \"dds\",\n  \"png\",\n  \"jpg\",\n  \"jpeg\",\n  \"tga\",\n  \"gif\"\n]);\n\n\n/**\n * Read one image into a bitmap, as Carbon's `DoLoad` does.\n *\n * @param {Uint8Array|ArrayBuffer} bytes The file's bytes.\n * @param {object} context The manager's prepare context.\n * @returns {Promise<HostBitmap>} The decoded bitmap.\n */\nasync function ReadImageResource(bytes, context)\n{\n  const bitmap = new HostBitmap();\n  const metadata = new Metadata();\n  const path = context.path;\n  const result = await ImageIO.readImageAsync(bytes, new LoadParameters(path), bitmap, metadata);\n\n  // Carbon: CCP_LOGWARN(\"Tr2ImageRes: error reading '%S' - %s\") and LR_FAILED.\n  if (!result.IsOk())\n  {\n    const error = new Error(`${path || \"image\"}: ${result.GetErrorMessage()}`);\n    error.code = \"CJS_RESOURCE_IMAGE_READ_FAILED\";\n    throw error;\n  }\n\n  bitmap.metadata = metadata;\n  return bitmap;\n}\n\n\n/**\n * Routes every image extension to a texture resource on one manager.\n *\n * @param {object} resourceManager Manager to register on.\n * @param {object} [options] `{ Handler }` to route to `Tr2ImageRes` instead.\n * @returns {object} The same manager, for chaining.\n */\nexport function RegisterTextureResources(resourceManager, options = {})\n{\n  if (typeof resourceManager?.RegisterExtension !== \"function\"\n    || typeof resourceManager?.RegisterObjectLoader !== \"function\")\n  {\n    throw new TypeError(\"RegisterTextureResources requires a CjsResMan.\");\n  }\n\n  const Handler = options.Handler ?? TriTextureRes;\n\n  if (Handler !== TriTextureRes && Handler !== Tr2ImageRes)\n  {\n    throw new TypeError(\"RegisterTextureResources routes to TriTextureRes or Tr2ImageRes.\");\n  }\n\n  for (const extension of TextureResourceExtensions)\n  {\n    resourceManager.RegisterObjectLoader(extension, ReadImageResource);\n    resourceManager.RegisterExtension(extension, Handler);\n  }\n\n  // Carbon asks for the same file as a texture or as a \"raw\" image; the\n  // requirement picks the class and keeps a separate cache entry for each.\n  resourceManager.RegisterResourceType(ResourceRequirement.TEXTURE, TriTextureRes);\n  resourceManager.RegisterResourceType(ResourceRequirement.IMAGE, Tr2ImageRes);\n\n  return resourceManager;\n}\n"],"names":["TextureResourceExtensions","Object","freeze","ReadImageResource","bytes","context","bitmap","HostBitmap","metadata","Metadata","path","result","ImageIO","readImageAsync","LoadParameters","IsOk","error","Error","GetErrorMessage","code","RegisterTextureResources","resourceManager","options","RegisterExtension","RegisterObjectLoader","TypeError","Handler","TriTextureRes","Tr2ImageRes","extension","RegisterResourceType","ResourceRequirement","TEXTURE","IMAGE"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,yBAAyB,GAAGC,MAAM,CAACC,MAAM,CAAC,CACrD,KAAK,EACL,KAAK,EACL,KAAK,EACL,MAAM,EACN,KAAK,EACL,KAAK,CACN;;AAGD;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAeC,iBAAiBA,CAACC,KAAK,EAAEC,OAAO,EAC/C;AACE,EAAA,MAAMC,MAAM,GAAG,IAAIC,UAAU,EAAE;AAC/B,EAAA,MAAMC,QAAQ,GAAG,IAAIC,QAAQ,EAAE;AAC/B,EAAA,MAAMC,IAAI,GAAGL,OAAO,CAACK,IAAI;AACzB,EAAA,MAAMC,MAAM,GAAG,MAAMC,OAAO,CAACC,cAAc,CAACT,KAAK,EAAE,IAAIU,cAAc,CAACJ,IAAI,CAAC,EAAEJ,MAAM,EAAEE,QAAQ,CAAC;;AAE9F;AACA,EAAA,IAAI,CAACG,MAAM,CAACI,IAAI,EAAE,EAClB;AACE,IAAA,MAAMC,KAAK,GAAG,IAAIC,KAAK,CAAC,GAAGP,IAAI,IAAI,OAAO,CAAA,EAAA,EAAKC,MAAM,CAACO,eAAe,EAAE,EAAE,CAAC;IAC1EF,KAAK,CAACG,IAAI,GAAG,gCAAgC;AAC7C,IAAA,MAAMH,KAAK;AACb,EAAA;EAEAV,MAAM,CAACE,QAAQ,GAAGA,QAAQ;AAC1B,EAAA,OAAOF,MAAM;AACf;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASc,wBAAwBA,CAACC,eAAe,EAAEC,OAAO,GAAG,EAAE,EACtE;AACE,EAAA,IAAI,OAAOD,eAAe,EAAEE,iBAAiB,KAAK,UAAU,IACvD,OAAOF,eAAe,EAAEG,oBAAoB,KAAK,UAAU,EAChE;AACE,IAAA,MAAM,IAAIC,SAAS,CAAC,gDAAgD,CAAC;AACvE,EAAA;AAEA,EAAA,MAAMC,OAAO,GAAGJ,OAAO,CAACI,OAAO,IAAIC,aAAa;AAEhD,EAAA,IAAID,OAAO,KAAKC,aAAa,IAAID,OAAO,KAAKE,WAAW,EACxD;AACE,IAAA,MAAM,IAAIH,SAAS,CAAC,kEAAkE,CAAC;AACzF,EAAA;AAEA,EAAA,KAAK,MAAMI,SAAS,IAAI7B,yBAAyB,EACjD;AACEqB,IAAAA,eAAe,CAACG,oBAAoB,CAACK,SAAS,EAAE1B,iBAAiB,CAAC;AAClEkB,IAAAA,eAAe,CAACE,iBAAiB,CAACM,SAAS,EAAEH,OAAO,CAAC;AACvD,EAAA;;AAEA;AACA;EACAL,eAAe,CAACS,oBAAoB,CAACC,mBAAmB,CAACC,OAAO,EAAEL,aAAa,CAAC;EAChFN,eAAe,CAACS,oBAAoB,CAACC,mBAAmB,CAACE,KAAK,EAAEL,WAAW,CAAC;AAE5E,EAAA,OAAOP,eAAe;AACxB;;;;"}

package/dist/resource/texture/solidColorTexture.js

@@ -1,3 +1,5 @@
+import { HostBitmap } from '#imageio';
+import { PixelFormat } from '#consts/render-context';
 import { num } from '#math/num';
 
 // Source: trinity/trinity/Resources/Procedural/SolidColorTexture.h
@@ -77,34 +79,23 @@ function IsSolidColorTexturePath(path) {
  * Carbon's `RasterizeSolidColor` (SolidColorTexture.cpp:104-126): a 1x1 bitmap of
  * the parsed colour, or null where Carbon leaves the bitmap invalid.
  *
- * Carbon writes `PIXEL_FORMAT_R16G16B16A16_FLOAT`. The resource payload contract
- * carries float colour as `rgba32float` only, so each component is quantized
- * through the half-float codec first - the stored values are Carbon's, in a
- * wider container.
+ * Carbon's format exactly: a 1x1 `PIXEL_FORMAT_R16G16B16A16_FLOAT` bitmap.
  *
  * @param {string} path `dynamic:/color/...` path.
- * @returns {object|null} An `rgba` payload.
+ * @returns {HostBitmap|null} The bitmap, or null where Carbon leaves it invalid.
  */
 function RasterizeSolidColor(path) {
   if (!IsSolidColorTexturePath(path)) return null;
   const color = ParseColor(String(path).slice(ColorPrefix.length));
   if (!color) return null;
-  const data = new Float32Array(4);
+  const bitmap = new HostBitmap();
+  if (!bitmap.Create(1, 1, 1, PixelFormat.PIXEL_FORMAT_R16G16B16A16_FLOAT)) return null;
+  const raw = bitmap.GetRawData();
+  const view = new DataView(raw.buffer, raw.byteOffset, raw.byteLength);
   for (let index = 0; index < 4; index++) {
-    data[index] = num.fromHalfFloat(num.toHalfFloat(color[index]));
+    view.setUint16(index * 2, num.toHalfFloat(color[index]), true);
   }
-  return {
-    payloadType: "rgba",
-    sourceFormat: "dynamic-color",
-    width: 1,
-    height: 1,
-    pixelFormat: "rgba32float",
-    data,
-    strideBytes: 16,
-    origin: "top-left",
-    colorSpace: "linear",
-    alphaMode: "straight"
-  };
+  return bitmap;
 }
 
 export { ColorPrefix, IsSolidColorTexturePath, ParseColor, RasterizeSolidColor };