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

package/dist/resource/texture/TriTextureRes.js

@@ -1,5 +1,6 @@
-import { CjsSchema, carbon, impl, type, io } from '#schema';
+import { CjsSchema, carbon, impl, type, edit } from '#schema';
 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 { resourcePayloadError, validateResourcePayload, resourceFormatRequiredError, resourceBoundaryError } from '../resourceBoundary.js';
@@ -42,12 +43,54 @@ class TriTextureRes extends CjsResource {
   constructor(values = null) {
     super();
     this.SetValues(values || {}, {
-      markDirty: false,
       skipUpdate: true,
       skipEvents: true
     });
   }
 
+  /**
+   * Carbon's Initialize, with its procedural branch (TriTextureRes.cpp:223-236):
+   * a `dynamic:/color/` path is rasterized here rather than loaded from source.
+   * The `dynamic:/gradient_1d/` branch Carbon checks first is rasterized by
+   * trinity's GradientTextureConstructor instead: a gradient needs Tr2CurveScalar,
+   * which this layer may not import.
+   *
+   * @param {string} path Resource path.
+   * @param {string|null} [ext] Extension override.
+   * @param {string} [requirement] Semantic requirement.
+   * @returns {TriTextureRes} This resource.
+   */
+  Initialize(path, ext = null, requirement = "") {
+    super.Initialize(path, ext, requirement);
+    if (IsSolidColorTexturePath(this.path)) this.#RasterizeProceduralTexture(RasterizeSolidColor);
+    return this;
+  }
+
+  /**
+   * `RasterizeProceduralTexture` (TriTextureRes.cpp:181-212). Carbon creates the
+   * GPU texture from the bitmap here; this layer cannot reach a render context,
+   * 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`.
+   * @returns {void}
+   */
+  #RasterizeProceduralTexture(rasterize) {
+    this.MarkLoading();
+    const payload = rasterize(this.path);
+    if (!payload) {
+      // 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`);
+      error.code = "CJS_TEXTURE_PROCEDURAL_PATH_INVALID";
+      error.path = this.path;
+      this.SetError(error);
+      return;
+    }
+    this.SetPayload(payload);
+    this.MarkPrepared();
+  }
+
   /**
    * m_texture: the live `Tr2TextureAL`, or null until an engine makes one.
    *
@@ -384,27 +427,28 @@ CjsSchema.define(TriTextureRes, {
   className: "TriTextureRes",
   family: "resources",
   fields: {
-    format: [type.unknown, io.read],
-    type: [type.unknown, io.persist],
-    averageColor: [type.color, io.read],
-    depth: [type.uint32, io.read],
-    cutoutHeight: [type.float32, io.readwrite],
-    height: [type.uint32, io.read],
-    lodEnabled: [type.boolean, io.read],
-    hadLodRequests: [type.boolean, io.read],
-    cpuMip: [type.uint32, io.read],
-    gpuMip: [type.uint32, io.read],
-    wrappedRenderTarget: [type.unknown, io.read],
-    originalResolution: [type.uint32, io.read],
-    originalMemoryUsage: [type.uint64, io.read],
-    name: [type.string, io.readwrite],
-    arraySize: [type.uint32, io.read],
-    cutoutWidth: [type.float32, io.readwrite],
-    width: [type.uint32, io.read],
-    cutoutX: [type.float32, io.readwrite],
-    cutoutY: [type.float32, io.readwrite]
+    format: [type.unknown, edit.read],
+    type: [type.unknown, edit.persist],
+    averageColor: [type.color, edit.read],
+    depth: [type.uint32, edit.read],
+    cutoutHeight: [type.float32, edit.readwrite],
+    height: [type.uint32, edit.read],
+    lodEnabled: [type.boolean, edit.read],
+    hadLodRequests: [type.boolean, edit.read],
+    cpuMip: [type.uint32, edit.read],
+    gpuMip: [type.uint32, edit.read],
+    wrappedRenderTarget: [type.unknown, edit.read],
+    originalResolution: [type.uint32, edit.read],
+    originalMemoryUsage: [type.uint64, edit.read],
+    name: [type.string, edit.readwrite],
+    arraySize: [type.uint32, edit.read],
+    cutoutWidth: [type.float32, edit.readwrite],
+    width: [type.uint32, edit.read],
+    cutoutX: [type.float32, edit.readwrite],
+    cutoutY: [type.float32, edit.readwrite]
   },
   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],

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, io, type } from \"#schema\";\nimport { CjsResource } from \"../CjsResource.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      markDirty: false,\n      skipUpdate: true,\n      skipEvents: true\n    });\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, io.read ],\n    type: [ type.unknown, io.persist ],\n    averageColor: [ type.color, io.read ],\n    depth: [ type.uint32, io.read ],\n    cutoutHeight: [ type.float32, io.readwrite ],\n    height: [ type.uint32, io.read ],\n    lodEnabled: [ type.boolean, io.read ],\n    hadLodRequests: [ type.boolean, io.read ],\n    cpuMip: [ type.uint32, io.read ],\n    gpuMip: [ type.uint32, io.read ],\n    wrappedRenderTarget: [ type.unknown, io.read ],\n    originalResolution: [ type.uint32, io.read ],\n    originalMemoryUsage: [ type.uint64, io.read ],\n    name: [ type.string, io.readwrite ],\n    arraySize: [ type.uint32, io.read ],\n    cutoutWidth: [ type.float32, io.readwrite ],\n    width: [ type.uint32, io.read ],\n    cutoutX: [ type.float32, io.readwrite ],\n    cutoutY: [ type.float32, io.readwrite ]\n  },\n  methods: {\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","markDirty","skipUpdate","skipEvents","texture","GetTexture","IsValid","SetTexture","Destroy","SetPayload","payload","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","ext","Read","GetMipCount","GetPayload","GetMsaaType","multiSampleType","msaaType","samples","GetMsaaQuality","multiSampleQuality","msaaQuality","HadLodRequests","GetSrvIndexInHeap","resourceBoundaryError","SaveAsync","path","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","io","persist","color","uint32","float32","readwrite","boolean","uint64","string","methods","carbon","method","impl","adapted","notSupported","implemented","reason","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 { 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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"}

package/dist/resource/texture/index.js

@@ -1,5 +1,6 @@
 export { CjsTextureArrayRes } from './CjsTextureArrayRes.js';
 export { CjsTextureArrayResParameterProxy } from './CjsTextureArrayResParameterProxy.js';
+export { RegisterSolidColorTexture, SolidColorTextureConstructor } from './SolidColorTextureConstructor.js';
 export { Tr2ImageRes } from './Tr2ImageRes.js';
 export { Tr2TextureLodManager } from './Tr2TextureLodManager.js';
 export { Tr2TextureLodUpdateRequest } from './Tr2TextureLodUpdateRequest.js';
@@ -12,4 +13,5 @@ export { Tr2TexturePipelineStepLimitSize } from './Tr2TexturePipelineStepLimitSi
 export { Tr2TexturePipelineStepLoad } from './Tr2TexturePipelineStepLoad.js';
 export { Tr2TexturePipelineStepPack } from './Tr2TexturePipelineStepPack.js';
 export { TriTextureRes } from './TriTextureRes.js';
+export { ColorPrefix, IsSolidColorTexturePath, ParseColor, RasterizeSolidColor } from './solidColorTexture.js';
 //# sourceMappingURL=index.js.map

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/solidColorTexture.js

@@ -0,0 +1,111 @@
+import { num } from '#math/num';
+
+// Source: trinity/trinity/Resources/Procedural/SolidColorTexture.h
+// Source: trinity/trinity/Resources/Procedural/SolidColorTexture.cpp
+//
+// The free functions of Carbon's solid colour texture: a `dynamic:/color/r,g,b,a`
+// path names a 1x1 texture of that colour. They live apart from
+// SolidColorTextureConstructor because TriTextureRes.Initialize calls them, and
+// the constructor builds a TriTextureRes - one module holding both would be an
+// import cycle.
+//
+// Not ported, for want of a consumer: ColorPathToColor and ColorToColorPath.
+
+/** `colorPrefix` (SolidColorTexture.cpp:13). */
+const ColorPrefix = "dynamic:/color/";
+
+// One `stream >> float` extraction under `std::locale( "C" )`: leading
+// whitespace, an optional sign, digits with an optional fraction, and an
+// optional exponent.
+const FLOAT_EXTRACTION = /^\s*[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][+-]?\d+)?/u;
+
+// `stream >> coma` skips whitespace, then reads one character.
+const COMMA_EXTRACTION = /^\s*,/u;
+
+/**
+ * Parses `r,g,b,a` exactly as Carbon's `ParseColor` does
+ * (SolidColorTexture.cpp:34-70), or returns null where Carbon logs and returns
+ * an empty optional.
+ *
+ * quirk: the alpha extraction is followed only by `stream.eof()`. When nothing
+ * but whitespace follows the third comma, `stream >> color.a` fails AT the end
+ * of the stream, which sets eofbit, and C++11 `num_get` stores 0 on failure - so
+ * Carbon accepts `1,1,1,` as alpha 0. Reproduced, not corrected: a port never
+ * silently fixes Carbon.
+ *
+ * @param {string} query Text after `dynamic:/color/`.
+ * @returns {number[]|null} `[r, g, b, a]`, or null when Carbon would reject it.
+ */
+function ParseColor(query) {
+  let rest = String(query);
+  const color = [];
+  for (let index = 0; index < 4; index++) {
+    const extraction = FLOAT_EXTRACTION.exec(rest);
+    if (!extraction) {
+      // Only the last component can fail at the end of the stream and still
+      // pass the eof test; a failed r/g/b leaves the stream in a fail state and
+      // the following comma is never read.
+      if (index === 3 && /^\s*$/u.test(rest)) {
+        color.push(0);
+        return color;
+      }
+      return null;
+    }
+    color.push(Number(extraction[0]));
+    rest = rest.slice(extraction[0].length);
+    if (index < 3) {
+      const comma = COMMA_EXTRACTION.exec(rest);
+      if (!comma) return null;
+      rest = rest.slice(comma[0].length);
+    }
+  }
+  // `stream.eof()`: the alpha extraction must have reached the end of the query.
+  return rest.length === 0 ? color : null;
+}
+
+/**
+ * Whether a path names a solid colour texture (SolidColorTexture.cpp:72-75).
+ *
+ * @param {string} path Resource path.
+ * @returns {boolean}
+ */
+function IsSolidColorTexturePath(path) {
+  return String(path).startsWith(ColorPrefix);
+}
+
+/**
+ * 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.
+ *
+ * @param {string} path `dynamic:/color/...` path.
+ * @returns {object|null} An `rgba` payload.
+ */
+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);
+  for (let index = 0; index < 4; index++) {
+    data[index] = num.fromHalfFloat(num.toHalfFloat(color[index]));
+  }
+  return {
+    payloadType: "rgba",
+    sourceFormat: "dynamic-color",
+    width: 1,
+    height: 1,
+    pixelFormat: "rgba32float",
+    data,
+    strideBytes: 16,
+    origin: "top-left",
+    colorSpace: "linear",
+    alphaMode: "straight"
+  };
+}
+
+export { ColorPrefix, IsSolidColorTexturePath, ParseColor, RasterizeSolidColor };
+//# sourceMappingURL=solidColorTexture.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"solidColorTexture.js","sources":["../../../../src/resource/texture/solidColorTexture.js"],"sourcesContent":["// Source: trinity/trinity/Resources/Procedural/SolidColorTexture.h\n// Source: trinity/trinity/Resources/Procedural/SolidColorTexture.cpp\n//\n// The free functions of Carbon's solid colour texture: a `dynamic:/color/r,g,b,a`\n// path names a 1x1 texture of that colour. They live apart from\n// SolidColorTextureConstructor because TriTextureRes.Initialize calls them, and\n// the constructor builds a TriTextureRes - one module holding both would be an\n// import cycle.\n//\n// Not ported, for want of a consumer: ColorPathToColor and ColorToColorPath.\nimport { num } from \"#math/num\";\n\n/** `colorPrefix` (SolidColorTexture.cpp:13). */\nexport const ColorPrefix = \"dynamic:/color/\";\n\n// One `stream >> float` extraction under `std::locale( \"C\" )`: leading\n// whitespace, an optional sign, digits with an optional fraction, and an\n// optional exponent.\nconst FLOAT_EXTRACTION = /^\\s*[+-]?(?:\\d+(?:\\.\\d*)?|\\.\\d+)(?:[eE][+-]?\\d+)?/u;\n\n// `stream >> coma` skips whitespace, then reads one character.\nconst COMMA_EXTRACTION = /^\\s*,/u;\n\n/**\n * Parses `r,g,b,a` exactly as Carbon's `ParseColor` does\n * (SolidColorTexture.cpp:34-70), or returns null where Carbon logs and returns\n * an empty optional.\n *\n * quirk: the alpha extraction is followed only by `stream.eof()`. When nothing\n * but whitespace follows the third comma, `stream >> color.a` fails AT the end\n * of the stream, which sets eofbit, and C++11 `num_get` stores 0 on failure - so\n * Carbon accepts `1,1,1,` as alpha 0. Reproduced, not corrected: a port never\n * silently fixes Carbon.\n *\n * @param {string} query Text after `dynamic:/color/`.\n * @returns {number[]|null} `[r, g, b, a]`, or null when Carbon would reject it.\n */\nexport function ParseColor(query)\n{\n  let rest = String(query);\n  const color = [];\n  for (let index = 0; index < 4; index++)\n  {\n    const extraction = FLOAT_EXTRACTION.exec(rest);\n    if (!extraction)\n    {\n      // Only the last component can fail at the end of the stream and still\n      // pass the eof test; a failed r/g/b leaves the stream in a fail state and\n      // the following comma is never read.\n      if (index === 3 && /^\\s*$/u.test(rest))\n      {\n        color.push(0);\n        return color;\n      }\n      return null;\n    }\n    color.push(Number(extraction[0]));\n    rest = rest.slice(extraction[0].length);\n    if (index < 3)\n    {\n      const comma = COMMA_EXTRACTION.exec(rest);\n      if (!comma) return null;\n      rest = rest.slice(comma[0].length);\n    }\n  }\n  // `stream.eof()`: the alpha extraction must have reached the end of the query.\n  return rest.length === 0 ? color : null;\n}\n\n/**\n * Whether a path names a solid colour texture (SolidColorTexture.cpp:72-75).\n *\n * @param {string} path Resource path.\n * @returns {boolean}\n */\nexport function IsSolidColorTexturePath(path)\n{\n  return String(path).startsWith(ColorPrefix);\n}\n\n/**\n * Carbon's `RasterizeSolidColor` (SolidColorTexture.cpp:104-126): a 1x1 bitmap of\n * the parsed colour, or null where Carbon leaves the bitmap invalid.\n *\n * Carbon writes `PIXEL_FORMAT_R16G16B16A16_FLOAT`. The resource payload contract\n * carries float colour as `rgba32float` only, so each component is quantized\n * through the half-float codec first - the stored values are Carbon's, in a\n * wider container.\n *\n * @param {string} path `dynamic:/color/...` path.\n * @returns {object|null} An `rgba` payload.\n */\nexport function RasterizeSolidColor(path)\n{\n  if (!IsSolidColorTexturePath(path)) return null;\n  const color = ParseColor(String(path).slice(ColorPrefix.length));\n  if (!color) return null;\n\n  const data = new Float32Array(4);\n  for (let index = 0; index < 4; index++)\n  {\n    data[index] = num.fromHalfFloat(num.toHalfFloat(color[index]));\n  }\n  return {\n    payloadType: \"rgba\",\n    sourceFormat: \"dynamic-color\",\n    width: 1,\n    height: 1,\n    pixelFormat: \"rgba32float\",\n    data,\n    strideBytes: 16,\n    origin: \"top-left\",\n    colorSpace: \"linear\",\n    alphaMode: \"straight\"\n  };\n}\n"],"names":["ColorPrefix","FLOAT_EXTRACTION","COMMA_EXTRACTION","ParseColor","query","rest","String","color","index","extraction","exec","test","push","Number","slice","length","comma","IsSolidColorTexturePath","path","startsWith","RasterizeSolidColor","data","Float32Array","num","fromHalfFloat","toHalfFloat","payloadType","sourceFormat","width","height","pixelFormat","strideBytes","origin","colorSpace","alphaMode"],"mappings":"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"}

package/dist/resource/video/AudioMetadata.js

@@ -0,0 +1,41 @@
+// Source: videoplayer/Metadata.h:31-120
+//
+// Audio stream metadata. Carbon's nested `CodecInitializationData` is a buffer
+// holder that copies its bytes on every copy, because it owns a raw
+// `uint8_t[]`. A typed array already owns its bytes, so the record is flattened
+// to one field here and the copying is the caller's business - the same
+// flattening `MetalRenderPassHint` records in the abstraction layer.
+
+/** `AudioMetadata` - what a container parser reports about the audio track. */
+class AudioMetadata {
+  /** `AudioMetadata::Codec` (Metadata.h:33-37). */
+  static Codec = Object.freeze({
+    OTHER: 0,
+    VORBIS: 1
+  });
+  codec = AudioMetadata.Codec.OTHER;
+  channels = 0;
+  bps = 0;
+  rate = 0;
+
+  /** `CodecInitializationData`: the codec's setup bytes, or null when it needs none. */
+  codecInitializationData = null;
+
+  /**
+   * @param {number} [codec] An `AudioMetadata.Codec` member.
+   * @param {number} [channels] Channel count.
+   * @param {number} [bps] Bits per sample.
+   * @param {number} [rate] Sample rate in hertz.
+   * @param {Uint8Array|null} [codecInitializationData] Codec setup bytes.
+   */
+  constructor(codec = AudioMetadata.Codec.OTHER, channels = 0, bps = 0, rate = 0, codecInitializationData = null) {
+    this.codec = codec;
+    this.channels = channels;
+    this.bps = bps;
+    this.rate = rate;
+    this.codecInitializationData = codecInitializationData;
+  }
+}
+
+export { AudioMetadata };
+//# sourceMappingURL=AudioMetadata.js.map

package/dist/resource/video/AudioMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioMetadata.js","sources":["../../../../src/resource/video/AudioMetadata.js"],"sourcesContent":["// Source: videoplayer/Metadata.h:31-120\n//\n// Audio stream metadata. Carbon's nested `CodecInitializationData` is a buffer\n// holder that copies its bytes on every copy, because it owns a raw\n// `uint8_t[]`. A typed array already owns its bytes, so the record is flattened\n// to one field here and the copying is the caller's business - the same\n// flattening `MetalRenderPassHint` records in the abstraction layer.\n\n/** `AudioMetadata` - what a container parser reports about the audio track. */\nexport class AudioMetadata\n{\n  /** `AudioMetadata::Codec` (Metadata.h:33-37). */\n  static Codec = Object.freeze({\n    OTHER: 0,\n    VORBIS: 1\n  });\n\n  codec = AudioMetadata.Codec.OTHER;\n\n  channels = 0;\n\n  bps = 0;\n\n  rate = 0;\n\n  /** `CodecInitializationData`: the codec's setup bytes, or null when it needs none. */\n  codecInitializationData = null;\n\n  /**\n   * @param {number} [codec] An `AudioMetadata.Codec` member.\n   * @param {number} [channels] Channel count.\n   * @param {number} [bps] Bits per sample.\n   * @param {number} [rate] Sample rate in hertz.\n   * @param {Uint8Array|null} [codecInitializationData] Codec setup bytes.\n   */\n  constructor(codec = AudioMetadata.Codec.OTHER, channels = 0, bps = 0, rate = 0, codecInitializationData = null)\n  {\n    this.codec = codec;\n    this.channels = channels;\n    this.bps = bps;\n    this.rate = rate;\n    this.codecInitializationData = codecInitializationData;\n  }\n}\n"],"names":["AudioMetadata","Codec","Object","freeze","OTHER","VORBIS","codec","channels","bps","rate","codecInitializationData","constructor"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACO,MAAMA,aAAa,CAC1B;AACE;AACA,EAAA,OAAOC,KAAK,GAAGC,MAAM,CAACC,MAAM,CAAC;AAC3BC,IAAAA,KAAK,EAAE,CAAC;AACRC,IAAAA,MAAM,EAAE;AACV,GAAC,CAAC;AAEFC,EAAAA,KAAK,GAAGN,aAAa,CAACC,KAAK,CAACG,KAAK;AAEjCG,EAAAA,QAAQ,GAAG,CAAC;AAEZC,EAAAA,GAAG,GAAG,CAAC;AAEPC,EAAAA,IAAI,GAAG,CAAC;;AAER;AACAC,EAAAA,uBAAuB,GAAG,IAAI;;AAE9B;AACF;AACA;AACA;AACA;AACA;AACA;EACEC,WAAWA,CAACL,KAAK,GAAGN,aAAa,CAACC,KAAK,CAACG,KAAK,EAAEG,QAAQ,GAAG,CAAC,EAAEC,GAAG,GAAG,CAAC,EAAEC,IAAI,GAAG,CAAC,EAAEC,uBAAuB,GAAG,IAAI,EAC9G;IACE,IAAI,CAACJ,KAAK,GAAGA,KAAK;IAClB,IAAI,CAACC,QAAQ,GAAGA,QAAQ;IACxB,IAAI,CAACC,GAAG,GAAGA,GAAG;IACd,IAAI,CAACC,IAAI,GAAGA,IAAI;IAChB,IAAI,CAACC,uBAAuB,GAAGA,uBAAuB;AACxD,EAAA;AACF;;;;"}

package/dist/resource/video/IAudioSink.js

@@ -0,0 +1,51 @@
+// Source: videoplayer/IAudioSink.h
+//
+// Where decoded PCM goes. The sink also carries the clock: when one is present
+// the controller reads media time from it rather than from its own timer, so
+// video follows audio (VideoController.h:82-85).
+//
+// Carbon ships two: WaveOutAudioSink and WwiseAudioSink. Neither is portable -
+// one is a Windows API, the other the Wwise SDK - and a browser sink is the
+// audio runtime's business, not this module's.
+
+/** `IAudioSink` - consumes decoded PCM frames and reports playback time. */
+class IAudioSink {
+  /**
+   * `Open` - begin consuming from a queue for a described track.
+   *
+   * @param {object} _audioMetadata An `AudioMetadata`.
+   * @param {object} _frameQueue The `PcmFrame` queue to drain.
+   * @returns {void}
+   */
+  Open(_audioMetadata, _frameQueue) {
+    throw new Error("IAudioSink.Open must be implemented.");
+  }
+
+  /** `Close` - stop consuming and release the sink's resources. */
+  Close() {
+    throw new Error("IAudioSink.Close must be implemented.");
+  }
+
+  /** `Pause` - hold playback and the clock. */
+  Pause() {
+    throw new Error("IAudioSink.Pause must be implemented.");
+  }
+
+  /** `Resume` - continue playback and the clock. */
+  Resume() {
+    throw new Error("IAudioSink.Resume must be implemented.");
+  }
+
+  /** `GetTime` - the sink's playback clock, which drives media time. */
+  GetTime() {
+    throw new Error("IAudioSink.GetTime must be implemented.");
+  }
+
+  /** `IsDone` - whether everything queued has been played. */
+  IsDone() {
+    throw new Error("IAudioSink.IsDone must be implemented.");
+  }
+}
+
+export { IAudioSink };
+//# sourceMappingURL=IAudioSink.js.map

package/dist/resource/video/IAudioSink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAudioSink.js","sources":["../../../../src/resource/video/IAudioSink.js"],"sourcesContent":["// Source: videoplayer/IAudioSink.h\n//\n// Where decoded PCM goes. The sink also carries the clock: when one is present\n// the controller reads media time from it rather than from its own timer, so\n// video follows audio (VideoController.h:82-85).\n//\n// Carbon ships two: WaveOutAudioSink and WwiseAudioSink. Neither is portable -\n// one is a Windows API, the other the Wwise SDK - and a browser sink is the\n// audio runtime's business, not this module's.\n\n/** `IAudioSink` - consumes decoded PCM frames and reports playback time. */\nexport class IAudioSink\n{\n  /**\n   * `Open` - begin consuming from a queue for a described track.\n   *\n   * @param {object} _audioMetadata An `AudioMetadata`.\n   * @param {object} _frameQueue The `PcmFrame` queue to drain.\n   * @returns {void}\n   */\n  Open(_audioMetadata, _frameQueue)\n  {\n    throw new Error(\"IAudioSink.Open must be implemented.\");\n  }\n\n  /** `Close` - stop consuming and release the sink's resources. */\n  Close()\n  {\n    throw new Error(\"IAudioSink.Close must be implemented.\");\n  }\n\n  /** `Pause` - hold playback and the clock. */\n  Pause()\n  {\n    throw new Error(\"IAudioSink.Pause must be implemented.\");\n  }\n\n  /** `Resume` - continue playback and the clock. */\n  Resume()\n  {\n    throw new Error(\"IAudioSink.Resume must be implemented.\");\n  }\n\n  /** `GetTime` - the sink's playback clock, which drives media time. */\n  GetTime()\n  {\n    throw new Error(\"IAudioSink.GetTime must be implemented.\");\n  }\n\n  /** `IsDone` - whether everything queued has been played. */\n  IsDone()\n  {\n    throw new Error(\"IAudioSink.IsDone must be implemented.\");\n  }\n}\n"],"names":["IAudioSink","Open","_audioMetadata","_frameQueue","Error","Close","Pause","Resume","GetTime","IsDone"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACO,MAAMA,UAAU,CACvB;AACE;AACF;AACA;AACA;AACA;AACA;AACA;AACEC,EAAAA,IAAIA,CAACC,cAAc,EAAEC,WAAW,EAChC;AACE,IAAA,MAAM,IAAIC,KAAK,CAAC,sCAAsC,CAAC;AACzD,EAAA;;AAEA;AACAC,EAAAA,KAAKA,GACL;AACE,IAAA,MAAM,IAAID,KAAK,CAAC,uCAAuC,CAAC;AAC1D,EAAA;;AAEA;AACAE,EAAAA,KAAKA,GACL;AACE,IAAA,MAAM,IAAIF,KAAK,CAAC,uCAAuC,CAAC;AAC1D,EAAA;;AAEA;AACAG,EAAAA,MAAMA,GACN;AACE,IAAA,MAAM,IAAIH,KAAK,CAAC,wCAAwC,CAAC;AAC3D,EAAA;;AAEA;AACAI,EAAAA,OAAOA,GACP;AACE,IAAA,MAAM,IAAIJ,KAAK,CAAC,yCAAyC,CAAC;AAC5D,EAAA;;AAEA;AACAK,EAAAA,MAAMA,GACN;AACE,IAAA,MAAM,IAAIL,KAAK,CAAC,wCAAwC,CAAC;AAC3D,EAAA;AACF;;;;"}

package/dist/resource/video/IEncodedFrame.js

@@ -0,0 +1,52 @@
+// Source: videoplayer/Metadata.h:223-236
+//
+// The base interface for an encoded frame, audio or video, as a container
+// parser emits it. Carbon's `GetFrame`/`GetAlphaFrame` return their bytes
+// through out-parameters and report success; out-parameters become the return
+// value here, and "no frame" is null.
+
+/** `IEncodedFrame` - one encoded frame from a container parser. */
+class IEncodedFrame {
+  /** `GetFrameCount` - how many sub-frames this packet holds. */
+  GetFrameCount() {
+    throw new Error("IEncodedFrame.GetFrameCount must be implemented.");
+  }
+
+  /** `GetTimeStamp` - presentation time in the media clock's units. */
+  GetTimeStamp() {
+    throw new Error("IEncodedFrame.GetTimeStamp must be implemented.");
+  }
+
+  /** `IsSeekFrame` - whether playback may start at this frame. */
+  IsSeekFrame() {
+    throw new Error("IEncodedFrame.IsSeekFrame must be implemented.");
+  }
+
+  /**
+   * `GetFrame( index, data, length )` - the encoded bytes of one sub-frame.
+   *
+   * @param {number} _index Sub-frame index.
+   * @returns {Uint8Array|null} The bytes, or null when there is no such frame.
+   */
+  GetFrame(_index) {
+    throw new Error("IEncodedFrame.GetFrame must be implemented.");
+  }
+
+  /**
+   * `GetAlphaFrame( data, length )` - the encoded alpha plane, when the track
+   * carries one.
+   *
+   * @returns {Uint8Array|null} The bytes, or null when there is no alpha plane.
+   */
+  GetAlphaFrame() {
+    throw new Error("IEncodedFrame.GetAlphaFrame must be implemented.");
+  }
+
+  /** `IsSkipFrame` - whether this frame is a decode-only frame. */
+  IsSkipFrame() {
+    throw new Error("IEncodedFrame.IsSkipFrame must be implemented.");
+  }
+}
+
+export { IEncodedFrame };
+//# sourceMappingURL=IEncodedFrame.js.map

package/dist/resource/video/IEncodedFrame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEncodedFrame.js","sources":["../../../../src/resource/video/IEncodedFrame.js"],"sourcesContent":["// Source: videoplayer/Metadata.h:223-236\n//\n// The base interface for an encoded frame, audio or video, as a container\n// parser emits it. Carbon's `GetFrame`/`GetAlphaFrame` return their bytes\n// through out-parameters and report success; out-parameters become the return\n// value here, and \"no frame\" is null.\n\n/** `IEncodedFrame` - one encoded frame from a container parser. */\nexport class IEncodedFrame\n{\n  /** `GetFrameCount` - how many sub-frames this packet holds. */\n  GetFrameCount()\n  {\n    throw new Error(\"IEncodedFrame.GetFrameCount must be implemented.\");\n  }\n\n  /** `GetTimeStamp` - presentation time in the media clock's units. */\n  GetTimeStamp()\n  {\n    throw new Error(\"IEncodedFrame.GetTimeStamp must be implemented.\");\n  }\n\n  /** `IsSeekFrame` - whether playback may start at this frame. */\n  IsSeekFrame()\n  {\n    throw new Error(\"IEncodedFrame.IsSeekFrame must be implemented.\");\n  }\n\n  /**\n   * `GetFrame( index, data, length )` - the encoded bytes of one sub-frame.\n   *\n   * @param {number} _index Sub-frame index.\n   * @returns {Uint8Array|null} The bytes, or null when there is no such frame.\n   */\n  GetFrame(_index)\n  {\n    throw new Error(\"IEncodedFrame.GetFrame must be implemented.\");\n  }\n\n  /**\n   * `GetAlphaFrame( data, length )` - the encoded alpha plane, when the track\n   * carries one.\n   *\n   * @returns {Uint8Array|null} The bytes, or null when there is no alpha plane.\n   */\n  GetAlphaFrame()\n  {\n    throw new Error(\"IEncodedFrame.GetAlphaFrame must be implemented.\");\n  }\n\n  /** `IsSkipFrame` - whether this frame is a decode-only frame. */\n  IsSkipFrame()\n  {\n    throw new Error(\"IEncodedFrame.IsSkipFrame must be implemented.\");\n  }\n}\n"],"names":["IEncodedFrame","GetFrameCount","Error","GetTimeStamp","IsSeekFrame","GetFrame","_index","GetAlphaFrame","IsSkipFrame"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACO,MAAMA,aAAa,CAC1B;AACE;AACAC,EAAAA,aAAaA,GACb;AACE,IAAA,MAAM,IAAIC,KAAK,CAAC,kDAAkD,CAAC;AACrE,EAAA;;AAEA;AACAC,EAAAA,YAAYA,GACZ;AACE,IAAA,MAAM,IAAID,KAAK,CAAC,iDAAiD,CAAC;AACpE,EAAA;;AAEA;AACAE,EAAAA,WAAWA,GACX;AACE,IAAA,MAAM,IAAIF,KAAK,CAAC,gDAAgD,CAAC;AACnE,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;EACEG,QAAQA,CAACC,MAAM,EACf;AACE,IAAA,MAAM,IAAIJ,KAAK,CAAC,6CAA6C,CAAC;AAChE,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACEK,EAAAA,aAAaA,GACb;AACE,IAAA,MAAM,IAAIL,KAAK,CAAC,kDAAkD,CAAC;AACrE,EAAA;;AAEA;AACAM,EAAAA,WAAWA,GACX;AACE,IAAA,MAAM,IAAIN,KAAK,CAAC,gDAAgD,CAAC;AACnE,EAAA;AACF;;;;"}