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

package/dist/trinity/core/Tr2GpuResourcePool/Tr2GpuResourcePool.js

@@ -1,4 +1,4 @@
-import { Tr2BitmapDimensions } from '../../../trinityal/Tr2BitmapDimensions.js';
+import { BitmapDimensions } from '#imageio';
 import '../../../global/consts/renderContext/formats.js';
 import '../../../global/consts/renderContext/pipeline.js';
 import '../../../trinityal/Tr2DeviceResourceAL/Tr2BaseDeviceResourceAL.js';
@@ -256,7 +256,7 @@ class Tr2GpuResourcePool {
     //
     // The dimensions spread carries type, depth and mipCount, so an array or a
     // 3D texture is expressible here and always was.
-    return this.#renderContext.CreateTexture(new Tr2BitmapDimensions(dimensions), {
+    return this.#renderContext.CreateTexture(new BitmapDimensions(dimensions), {
       gpuUsage,
       cpuUsage,
       msaa,

package/dist/trinity/core/Tr2GpuResourcePool/Tr2GpuResourcePool.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2GpuResourcePool.js","sources":["../../../../../src/trinity/core/Tr2GpuResourcePool/Tr2GpuResourcePool.js"],"sourcesContent":["// Source: trinity/trinity/Tr2GpuResourcePool.h\n// Source: trinity/trinity/Tr2GpuResourcePool.cpp\n//\n// Where a render pass gets a scratch texture or buffer, and how one is kept\n// alive only as long as something holds it.\n//\n// THIS IS THE CLASS FOUR INVENTED ONES WERE STANDING IN FOR. Carbon's\n// `Tr2ShadowMap::PrepareShadowRendering( gpuResourcePool, renderContext )` and\n// the whole `EveSpaceScene` volumetrics family take a pool and do their own\n// work. Ours had the methods but bounced them to an engine-supplied executor,\n// because there was no pool to hand them. So an interface was invented per\n// subsystem rather than porting the one class they all needed.\n//\n// TWO LIFETIMES, and the distinction is the whole design. A TEMP resource is\n// recycled as soon as nothing holds it and it has not been touched for a few\n// frames; a PERSISTENT one is initialized once and kept. Asking for a temp\n// texture with the same shape twice in a frame therefore gets the same texture\n// only if the first handle has been released - which is what makes a pass able\n// to say \"give me a working surface\" without owning one.\n//\n// THE HANDLE IS THE LIFETIME. Carbon's `GpuResourceHandle` counts locks on copy\n// and release, and a record with a live lock is never recycled. JavaScript has\n// no destructor, so `Release()` is explicit here - see the note on the class.\n//\n// NESTING IS CARBON'S: a pool may have an OUTER pool, and a lookup that misses\n// walks outward. That is how a scene-local pool shares the global one's\n// resources without owning them.\n\nimport { Tr2BitmapDimensions } from \"../../../trinityal/index.js\";\nimport { GpuResourceHandle } from \"./GpuResourceHandle.js\";\n\n/** Throws a resource-pool error with the supplied diagnostic. */\nexport function fail(message)\n{\n  const error = new Error(`Tr2GpuResourcePool: ${message}`);\n  error.code = \"CJS_GPU_POOL_INVALID\";\n  throw error;\n}\n\n/**\n * Pooled scratch textures and buffers.\n */\nexport class Tr2GpuResourcePool\n{\n  /** m_outer - the pool a miss falls through to. */\n  #outer = null;\n\n  #tempTextures = [];\n\n  #persistentTextures = [];\n\n  #tempBuffers = [];\n\n  #persistentBuffers = [];\n\n  /** m_debugMode */\n  #debugMode = false;\n\n  /** The frame a lookup counts as \"now\". */\n  #frame = 0;\n\n  /**\n   * The backend resources are created against.\n   *\n   * Carbon's pool is a `Tr2DeviceResource` and reaches its device that way.\n   * This runtime has no process-wide device, so the context is handed in - the\n   * same arrangement `Tr2EffectStateManager` uses.\n   */\n  #renderContext = null;\n\n  /**\n   * @param {Tr2GpuResourcePool} [outer] A pool to fall through to on a miss.\n   */\n  constructor(outer = null)\n  {\n    this.#outer = outer;\n  }\n\n  /**\n   * Binds the backend resources are created against.\n   *\n   * @param {object} renderContext A render-context abstraction layer.\n   * @returns {Tr2GpuResourcePool} This pool, for chaining.\n   */\n  SetRenderContext(renderContext)\n  {\n    this.#renderContext = renderContext;\n\n    return this;\n  }\n\n  /**\n   * Advances the pool's idea of the current frame.\n   *\n   * @param {number} frame The frame number.\n   */\n  SetFrame(frame)\n  {\n    this.#frame = frame;\n  }\n\n  /**\n   * Borrows a scratch texture, creating one only if no free match exists.\n   *\n   * A FREE MATCH IS ONE NOBODY HOLDS. A record with a live lock is never handed\n   * out again, which is what lets two passes ask for \"a 512 square\" and get\n   * different surfaces when both are in flight, and the same one when they are\n   * not.\n   *\n   * @param {string} name A debug name.\n   * @param {object} description A `Tr2BitmapDimensions` shape (`type`, `width`,\n   *   `height`, `depth`, `mipCount`, `format`) plus `gpuUsage`, `cpuUsage`,\n   *   `msaa` and `initialData`.\n   * @returns {GpuResourceHandle} The borrowed texture.\n   */\n  GetTempTexture(name, description)\n  {\n    return this.#Borrow(this.#tempTextures, name, description, () => this.#CreateTexture(description));\n  }\n\n  /**\n   * Borrows a persistent texture, initializing it the first time only.\n   *\n   * @param {string} name A debug name.\n   * @param {object} description As `GetTempTexture`.\n   * @param {Function} [initialize] Called once, with the new texture.\n   * @returns {GpuResourceHandle} The texture.\n   */\n  GetPersistentTexture(name, description, initialize = null)\n  {\n    const existing = this.#Find(this.#persistentTextures, name, description, false);\n\n    if (existing) return new GpuResourceHandle(existing);\n\n    const texture = this.#CreateTexture(description);\n\n    if (initialize) initialize(texture);\n\n    return new GpuResourceHandle(this.#Add(this.#persistentTextures, name, description, texture));\n  }\n\n  /**\n   * Borrows a scratch buffer.\n   *\n   * @param {string} name A debug name.\n   * @param {object} description A `Tr2BufferDescriptionAL`.\n   * @returns {GpuResourceHandle} The borrowed buffer.\n   */\n  GetTempBuffer(name, description)\n  {\n    return this.#Borrow(this.#tempBuffers, name, description, () => this.#CreateBuffer(description));\n  }\n\n  /**\n   * Borrows a persistent buffer, initializing it the first time only.\n   *\n   * @param {string} name A debug name.\n   * @param {object} description A `Tr2BufferDescriptionAL`.\n   * @param {Function} [initialize] Called once, with the new buffer.\n   * @returns {GpuResourceHandle} The buffer.\n   */\n  GetPersistentBuffer(name, description, initialize = null)\n  {\n    const existing = this.#Find(this.#persistentBuffers, name, description, false);\n\n    if (existing) return new GpuResourceHandle(existing);\n\n    const buffer = this.#CreateBuffer(description);\n\n    if (initialize) initialize(buffer);\n\n    return new GpuResourceHandle(this.#Add(this.#persistentBuffers, name, description, buffer));\n  }\n\n  /**\n   * Returns a borrowed resource, as Carbon's allocators do.\n   *\n   * @param {GpuResourceHandle} handle The handle to give back.\n   * @returns {boolean} Whether a claim was dropped.\n   */\n  Free(handle)\n  {\n    if (!handle) fail(\"Free needs a handle\");\n\n    return handle.Detach();\n  }\n\n  /**\n   * Drops temp resources nobody holds and nobody has touched recently.\n   *\n   * @param {number} [frameThreshold] How many frames of disuse to allow.\n   * @returns {number} How many resources were dropped.\n   */\n  ClearUnusedResources(frameThreshold = 3)\n  {\n    let dropped = 0;\n\n    for (const list of [ this.#tempTextures, this.#tempBuffers ])\n    {\n      for (let index = list.length - 1; index >= 0; index -= 1)\n      {\n        const record = list[index];\n\n        if (record.lockCount > 0) continue;\n        if (this.#frame - record.lastAccessFrame < frameThreshold) continue;\n\n        record.resource.Destroy();\n        list.splice(index, 1);\n        dropped += 1;\n      }\n    }\n\n    return dropped;\n  }\n\n  /** @param {boolean} enable Whether to keep debug detail. */\n  SetDebugMode(enable)\n  {\n    this.#debugMode = !!enable;\n  }\n\n  /** @returns {boolean} Whether debug mode is on. */\n  GetDebugMode()\n  {\n    return this.#debugMode;\n  }\n\n  /**\n   * Every temp texture the pool holds, for a caller that must assert.\n   *\n   * @returns {object[]} The textures.\n   */\n  DebugGetAllTempTextures()\n  {\n    return this.#tempTextures.map(record => record.resource);\n  }\n\n  /**\n   * How many resources are currently held by a handle.\n   *\n   * Not Carbon's - JavaScript has no destructor to release on, so a caller\n   * needs a way to prove it released what it borrowed.\n   *\n   * @returns {number} The count.\n   */\n  GetHeldCount()\n  {\n    return [ this.#tempTextures, this.#persistentTextures, this.#tempBuffers, this.#persistentBuffers ]\n      .reduce((total, list) => total + list.filter(record => record.lockCount > 0).length, 0);\n  }\n\n  /** Splits the pool's flat description into the AL's two arguments. */\n  #CreateTexture(description)\n  {\n    if (!this.#renderContext) fail(\"a pool creates against a render context; none is bound\");\n\n    const { gpuUsage, cpuUsage, msaa, initialData, ...dimensions } = description;\n\n    // THE CONTEXT IS THE FACTORY. This used to be `new Tr2TextureALStub()`,\n    // which named the backend at authoring time: every texture the pool handed\n    // out was a stub no matter which backend was bound, so a WebGPU pass would\n    // have been handed textures that reach no device and drawn nothing, with\n    // no error anywhere. Tr2Blitter's head comment names this exact defect.\n    //\n    // The dimensions spread carries type, depth and mipCount, so an array or a\n    // 3D texture is expressible here and always was.\n    return this.#renderContext.CreateTexture(\n      new Tr2BitmapDimensions(dimensions),\n      { gpuUsage, cpuUsage, msaa, initialData }\n    );\n  }\n\n  /**\n   * Creates a stub buffer from the description against the pool's render\n   * context.\n   */\n  #CreateBuffer(description)\n  {\n    if (!this.#renderContext) fail(\"a pool creates against a render context; none is bound\");\n\n    // Through the context for the same reason as the texture above. The\n    // previous form also passed the context as `initialData`, leaving\n    // renderContext undefined and throwing a TypeError on the first line of\n    // Create that touched it - which is why neither buffer accessor had ever\n    // run. Both faults go together.\n    return this.#renderContext.CreateBuffer(description, null);\n  }\n\n  /**\n   * Borrows a matching free resource from this pool or its outer pool,\n   * allocating when necessary.\n   */\n  #Borrow(list, name, description, create)\n  {\n    const free = this.#Find(list, name, description, true);\n\n    if (free) return new GpuResourceHandle(free);\n\n    if (this.#outer) return this.#outer.#Borrow(list === this.#tempTextures\n      ? this.#outer.#tempTextures\n      : this.#outer.#tempBuffers, name, description, create);\n\n    return new GpuResourceHandle(this.#Add(list, name, description, create()));\n  }\n\n  /** Finds a matching pool record and updates its last-access frame. */\n  #Find(list, name, description, freeOnly)\n  {\n    const match = list.find(record =>\n      record.name === name\n      && SameDescription(record.description, description)\n      && (!freeOnly || record.lockCount === 0));\n\n    if (match) match.lastAccessFrame = this.#frame;\n\n    return match ?? null;\n  }\n\n  /** Adds an unlocked resource record stamped with the current frame. */\n  #Add(list, name, description, resource)\n  {\n    const record = { resource, name, description, lockCount: 0, lastAccessFrame: this.#frame };\n\n    list.push(record);\n\n    return record;\n  }\n}\n\nfunction SameDescription(left, right)\n{\n  if (left === right) return true;\n  if (!left || !right) return false;\n\n  const keys = new Set([ ...Object.keys(left), ...Object.keys(right) ]);\n\n  for (const key of keys)\n  {\n    if (left[key] !== right[key]) return false;\n  }\n\n  return true;\n}\n\nlet globalPool = null;\n\n/**\n * Carbon's `GetGlobalGpuResourcePool`.\n *\n * @returns {Tr2GpuResourcePool} The process-wide pool.\n */\nexport function GetGlobalGpuResourcePool()\n{\n  globalPool ??= new Tr2GpuResourcePool();\n\n  return globalPool;\n}\n"],"names":["fail","message","error","Error","code","Tr2GpuResourcePool","constructor","outer","SetRenderContext","renderContext","SetFrame","frame","GetTempTexture","name","description","GetPersistentTexture","initialize","existing","GpuResourceHandle","texture","GetTempBuffer","GetPersistentBuffer","buffer","Free","handle","Detach","ClearUnusedResources","frameThreshold","dropped","list","index","length","record","lockCount","lastAccessFrame","resource","Destroy","splice","SetDebugMode","enable","GetDebugMode","DebugGetAllTempTextures","map","GetHeldCount","reduce","total","filter","#CreateTexture","gpuUsage","cpuUsage","msaa","initialData","dimensions","CreateTexture","Tr2BitmapDimensions","#CreateBuffer","CreateBuffer","#Borrow","create","free","#Find","freeOnly","match","find","SameDescription","#Add","push","left","right","keys","Set","Object","key","globalPool","GetGlobalGpuResourcePool"],"mappings":"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"}
+{"version":3,"file":"Tr2GpuResourcePool.js","sources":["../../../../../src/trinity/core/Tr2GpuResourcePool/Tr2GpuResourcePool.js"],"sourcesContent":["// Source: trinity/trinity/Tr2GpuResourcePool.h\n// Source: trinity/trinity/Tr2GpuResourcePool.cpp\n//\n// Where a render pass gets a scratch texture or buffer, and how one is kept\n// alive only as long as something holds it.\n//\n// THIS IS THE CLASS FOUR INVENTED ONES WERE STANDING IN FOR. Carbon's\n// `Tr2ShadowMap::PrepareShadowRendering( gpuResourcePool, renderContext )` and\n// the whole `EveSpaceScene` volumetrics family take a pool and do their own\n// work. Ours had the methods but bounced them to an engine-supplied executor,\n// because there was no pool to hand them. So an interface was invented per\n// subsystem rather than porting the one class they all needed.\n//\n// TWO LIFETIMES, and the distinction is the whole design. A TEMP resource is\n// recycled as soon as nothing holds it and it has not been touched for a few\n// frames; a PERSISTENT one is initialized once and kept. Asking for a temp\n// texture with the same shape twice in a frame therefore gets the same texture\n// only if the first handle has been released - which is what makes a pass able\n// to say \"give me a working surface\" without owning one.\n//\n// THE HANDLE IS THE LIFETIME. Carbon's `GpuResourceHandle` counts locks on copy\n// and release, and a record with a live lock is never recycled. JavaScript has\n// no destructor, so `Release()` is explicit here - see the note on the class.\n//\n// NESTING IS CARBON'S: a pool may have an OUTER pool, and a lookup that misses\n// walks outward. That is how a scene-local pool shares the global one's\n// resources without owning them.\n\nimport { Tr2BitmapDimensions } from \"../../../trinityal/index.js\";\nimport { GpuResourceHandle } from \"./GpuResourceHandle.js\";\n\n/** Throws a resource-pool error with the supplied diagnostic. */\nexport function fail(message)\n{\n  const error = new Error(`Tr2GpuResourcePool: ${message}`);\n  error.code = \"CJS_GPU_POOL_INVALID\";\n  throw error;\n}\n\n/**\n * Pooled scratch textures and buffers.\n */\nexport class Tr2GpuResourcePool\n{\n  /** m_outer - the pool a miss falls through to. */\n  #outer = null;\n\n  #tempTextures = [];\n\n  #persistentTextures = [];\n\n  #tempBuffers = [];\n\n  #persistentBuffers = [];\n\n  /** m_debugMode */\n  #debugMode = false;\n\n  /** The frame a lookup counts as \"now\". */\n  #frame = 0;\n\n  /**\n   * The backend resources are created against.\n   *\n   * Carbon's pool is a `Tr2DeviceResource` and reaches its device that way.\n   * This runtime has no process-wide device, so the context is handed in - the\n   * same arrangement `Tr2EffectStateManager` uses.\n   */\n  #renderContext = null;\n\n  /**\n   * @param {Tr2GpuResourcePool} [outer] A pool to fall through to on a miss.\n   */\n  constructor(outer = null)\n  {\n    this.#outer = outer;\n  }\n\n  /**\n   * Binds the backend resources are created against.\n   *\n   * @param {object} renderContext A render-context abstraction layer.\n   * @returns {Tr2GpuResourcePool} This pool, for chaining.\n   */\n  SetRenderContext(renderContext)\n  {\n    this.#renderContext = renderContext;\n\n    return this;\n  }\n\n  /**\n   * Advances the pool's idea of the current frame.\n   *\n   * @param {number} frame The frame number.\n   */\n  SetFrame(frame)\n  {\n    this.#frame = frame;\n  }\n\n  /**\n   * Borrows a scratch texture, creating one only if no free match exists.\n   *\n   * A FREE MATCH IS ONE NOBODY HOLDS. A record with a live lock is never handed\n   * out again, which is what lets two passes ask for \"a 512 square\" and get\n   * different surfaces when both are in flight, and the same one when they are\n   * not.\n   *\n   * @param {string} name A debug name.\n   * @param {object} description A `Tr2BitmapDimensions` shape (`type`, `width`,\n   *   `height`, `depth`, `mipCount`, `format`) plus `gpuUsage`, `cpuUsage`,\n   *   `msaa` and `initialData`.\n   * @returns {GpuResourceHandle} The borrowed texture.\n   */\n  GetTempTexture(name, description)\n  {\n    return this.#Borrow(this.#tempTextures, name, description, () => this.#CreateTexture(description));\n  }\n\n  /**\n   * Borrows a persistent texture, initializing it the first time only.\n   *\n   * @param {string} name A debug name.\n   * @param {object} description As `GetTempTexture`.\n   * @param {Function} [initialize] Called once, with the new texture.\n   * @returns {GpuResourceHandle} The texture.\n   */\n  GetPersistentTexture(name, description, initialize = null)\n  {\n    const existing = this.#Find(this.#persistentTextures, name, description, false);\n\n    if (existing) return new GpuResourceHandle(existing);\n\n    const texture = this.#CreateTexture(description);\n\n    if (initialize) initialize(texture);\n\n    return new GpuResourceHandle(this.#Add(this.#persistentTextures, name, description, texture));\n  }\n\n  /**\n   * Borrows a scratch buffer.\n   *\n   * @param {string} name A debug name.\n   * @param {object} description A `Tr2BufferDescriptionAL`.\n   * @returns {GpuResourceHandle} The borrowed buffer.\n   */\n  GetTempBuffer(name, description)\n  {\n    return this.#Borrow(this.#tempBuffers, name, description, () => this.#CreateBuffer(description));\n  }\n\n  /**\n   * Borrows a persistent buffer, initializing it the first time only.\n   *\n   * @param {string} name A debug name.\n   * @param {object} description A `Tr2BufferDescriptionAL`.\n   * @param {Function} [initialize] Called once, with the new buffer.\n   * @returns {GpuResourceHandle} The buffer.\n   */\n  GetPersistentBuffer(name, description, initialize = null)\n  {\n    const existing = this.#Find(this.#persistentBuffers, name, description, false);\n\n    if (existing) return new GpuResourceHandle(existing);\n\n    const buffer = this.#CreateBuffer(description);\n\n    if (initialize) initialize(buffer);\n\n    return new GpuResourceHandle(this.#Add(this.#persistentBuffers, name, description, buffer));\n  }\n\n  /**\n   * Returns a borrowed resource, as Carbon's allocators do.\n   *\n   * @param {GpuResourceHandle} handle The handle to give back.\n   * @returns {boolean} Whether a claim was dropped.\n   */\n  Free(handle)\n  {\n    if (!handle) fail(\"Free needs a handle\");\n\n    return handle.Detach();\n  }\n\n  /**\n   * Drops temp resources nobody holds and nobody has touched recently.\n   *\n   * @param {number} [frameThreshold] How many frames of disuse to allow.\n   * @returns {number} How many resources were dropped.\n   */\n  ClearUnusedResources(frameThreshold = 3)\n  {\n    let dropped = 0;\n\n    for (const list of [ this.#tempTextures, this.#tempBuffers ])\n    {\n      for (let index = list.length - 1; index >= 0; index -= 1)\n      {\n        const record = list[index];\n\n        if (record.lockCount > 0) continue;\n        if (this.#frame - record.lastAccessFrame < frameThreshold) continue;\n\n        record.resource.Destroy();\n        list.splice(index, 1);\n        dropped += 1;\n      }\n    }\n\n    return dropped;\n  }\n\n  /** @param {boolean} enable Whether to keep debug detail. */\n  SetDebugMode(enable)\n  {\n    this.#debugMode = !!enable;\n  }\n\n  /** @returns {boolean} Whether debug mode is on. */\n  GetDebugMode()\n  {\n    return this.#debugMode;\n  }\n\n  /**\n   * Every temp texture the pool holds, for a caller that must assert.\n   *\n   * @returns {object[]} The textures.\n   */\n  DebugGetAllTempTextures()\n  {\n    return this.#tempTextures.map(record => record.resource);\n  }\n\n  /**\n   * How many resources are currently held by a handle.\n   *\n   * Not Carbon's - JavaScript has no destructor to release on, so a caller\n   * needs a way to prove it released what it borrowed.\n   *\n   * @returns {number} The count.\n   */\n  GetHeldCount()\n  {\n    return [ this.#tempTextures, this.#persistentTextures, this.#tempBuffers, this.#persistentBuffers ]\n      .reduce((total, list) => total + list.filter(record => record.lockCount > 0).length, 0);\n  }\n\n  /** Splits the pool's flat description into the AL's two arguments. */\n  #CreateTexture(description)\n  {\n    if (!this.#renderContext) fail(\"a pool creates against a render context; none is bound\");\n\n    const { gpuUsage, cpuUsage, msaa, initialData, ...dimensions } = description;\n\n    // THE CONTEXT IS THE FACTORY. This used to be `new Tr2TextureALStub()`,\n    // which named the backend at authoring time: every texture the pool handed\n    // out was a stub no matter which backend was bound, so a WebGPU pass would\n    // have been handed textures that reach no device and drawn nothing, with\n    // no error anywhere. Tr2Blitter's head comment names this exact defect.\n    //\n    // The dimensions spread carries type, depth and mipCount, so an array or a\n    // 3D texture is expressible here and always was.\n    return this.#renderContext.CreateTexture(\n      new Tr2BitmapDimensions(dimensions),\n      { gpuUsage, cpuUsage, msaa, initialData }\n    );\n  }\n\n  /**\n   * Creates a stub buffer from the description against the pool's render\n   * context.\n   */\n  #CreateBuffer(description)\n  {\n    if (!this.#renderContext) fail(\"a pool creates against a render context; none is bound\");\n\n    // Through the context for the same reason as the texture above. The\n    // previous form also passed the context as `initialData`, leaving\n    // renderContext undefined and throwing a TypeError on the first line of\n    // Create that touched it - which is why neither buffer accessor had ever\n    // run. Both faults go together.\n    return this.#renderContext.CreateBuffer(description, null);\n  }\n\n  /**\n   * Borrows a matching free resource from this pool or its outer pool,\n   * allocating when necessary.\n   */\n  #Borrow(list, name, description, create)\n  {\n    const free = this.#Find(list, name, description, true);\n\n    if (free) return new GpuResourceHandle(free);\n\n    if (this.#outer) return this.#outer.#Borrow(list === this.#tempTextures\n      ? this.#outer.#tempTextures\n      : this.#outer.#tempBuffers, name, description, create);\n\n    return new GpuResourceHandle(this.#Add(list, name, description, create()));\n  }\n\n  /** Finds a matching pool record and updates its last-access frame. */\n  #Find(list, name, description, freeOnly)\n  {\n    const match = list.find(record =>\n      record.name === name\n      && SameDescription(record.description, description)\n      && (!freeOnly || record.lockCount === 0));\n\n    if (match) match.lastAccessFrame = this.#frame;\n\n    return match ?? null;\n  }\n\n  /** Adds an unlocked resource record stamped with the current frame. */\n  #Add(list, name, description, resource)\n  {\n    const record = { resource, name, description, lockCount: 0, lastAccessFrame: this.#frame };\n\n    list.push(record);\n\n    return record;\n  }\n}\n\nfunction SameDescription(left, right)\n{\n  if (left === right) return true;\n  if (!left || !right) return false;\n\n  const keys = new Set([ ...Object.keys(left), ...Object.keys(right) ]);\n\n  for (const key of keys)\n  {\n    if (left[key] !== right[key]) return false;\n  }\n\n  return true;\n}\n\nlet globalPool = null;\n\n/**\n * Carbon's `GetGlobalGpuResourcePool`.\n *\n * @returns {Tr2GpuResourcePool} The process-wide pool.\n */\nexport function GetGlobalGpuResourcePool()\n{\n  globalPool ??= new Tr2GpuResourcePool();\n\n  return globalPool;\n}\n"],"names":["fail","message","error","Error","code","Tr2GpuResourcePool","constructor","outer","SetRenderContext","renderContext","SetFrame","frame","GetTempTexture","name","description","GetPersistentTexture","initialize","existing","GpuResourceHandle","texture","GetTempBuffer","GetPersistentBuffer","buffer","Free","handle","Detach","ClearUnusedResources","frameThreshold","dropped","list","index","length","record","lockCount","lastAccessFrame","resource","Destroy","splice","SetDebugMode","enable","GetDebugMode","DebugGetAllTempTextures","map","GetHeldCount","reduce","total","filter","#CreateTexture","gpuUsage","cpuUsage","msaa","initialData","dimensions","CreateTexture","Tr2BitmapDimensions","#CreateBuffer","CreateBuffer","#Borrow","create","free","#Find","freeOnly","match","find","SameDescription","#Add","push","left","right","keys","Set","Object","key","globalPool","GetGlobalGpuResourcePool"],"mappings":"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"}

package/dist/trinity/core/Tr2ImageIOHelpers.js

@@ -1,4 +1,5 @@
-import { Tr2BitmapDimensions } from '../../trinityal/Tr2BitmapDimensions.js';
+import { BitmapDimensions } from '#imageio';
+import { Tr2SubresourceData } from '#trinityal';
 import { TextureType, Tr2CpuUsage, Tr2GpuUsage, PixelFormat, PixelFormatFromCanonical } from '#consts/render-context';
 
 // Source: trinity/trinity/Tr2ImageIOHelpers.h
@@ -29,6 +30,11 @@ const TYPE_OF_DIMENSION = Object.freeze({
 /**
  * The description and initial data a texture payload describes.
  *
+ * TRANSITIONAL. Carbon uploads from an `ImageIO::HostBitmap`
+ * (`DescribeBitmap`), and the plain payload is ours, not Carbon's. This route
+ * stays only until every texture reader publishes a bitmap
+ * (/docs/projects/hostbitmap-port.md).
+ *
  * @param {object} payload A `"texture"` or `"rgba"` payload.
  * @returns {{desc: Tr2BitmapDimensions, initialData: object[]}|null} What to
  *   create, or null when the payload is not one a texture can be made from.
@@ -39,12 +45,8 @@ function DescribeTexturePayload(payload) {
     if (!(payload.data instanceof Uint8Array) || payload.pixelFormat !== "rgba8unorm") return null;
     const srgb = payload.colorSpace === "srgb";
     return {
-      desc: Tr2BitmapDimensions.Texture2D(payload.width, payload.height, 1, srgb ? PixelFormat.PIXEL_FORMAT_R8G8B8A8_UNORM_SRGB : PixelFormat.PIXEL_FORMAT_R8G8B8A8_UNORM),
-      initialData: [{
-        sysMem: payload.data,
-        sysMemPitch: payload.strideBytes ?? payload.width * 4,
-        sysMemSlicePitch: payload.data.byteLength
-      }]
+      desc: BitmapDimensions.texture2D(payload.width, payload.height, 1, srgb ? PixelFormat.PIXEL_FORMAT_R8G8B8A8_UNORM_SRGB : PixelFormat.PIXEL_FORMAT_R8G8B8A8_UNORM),
+      initialData: [new Tr2SubresourceData(payload.data, payload.strideBytes ?? payload.width * 4, payload.data.byteLength)]
     };
   }
   if (payload.payloadType !== "texture") return null;
@@ -62,7 +64,7 @@ function DescribeTexturePayload(payload) {
   // grey disc on a polished hull, which is a long way from an array count.
   const faces = payload.dimension === "cube" ? Math.max(1, payload.faces | 0) : 1;
   const arraySize = payload.dimension === "3d" ? 1 : Math.max(1, payload.arraySize | 0) * faces;
-  const desc = new Tr2BitmapDimensions({
+  const desc = new BitmapDimensions({
     type,
     format,
     width: payload.width,
@@ -77,11 +79,7 @@ function DescribeTexturePayload(payload) {
   for (const subresource of payload.subresources ?? []) {
     const index = (subresource.mip | 0) + (subresource.layer | 0) * mipCount;
     if (index < 0 || index >= initialData.length) continue;
-    initialData[index] = {
-      sysMem: payload.data.subarray(subresource.offset, subresource.offset + subresource.byteLength),
-      sysMemPitch: subresource.rowPitch,
-      sysMemSlicePitch: subresource.slicePitch
-    };
+    initialData[index] = new Tr2SubresourceData(payload.data.subarray(subresource.offset, subresource.offset + subresource.byteLength), subresource.rowPitch, subresource.slicePitch);
   }
   return {
     desc,
@@ -89,6 +87,70 @@ function DescribeTexturePayload(payload) {
   };
 }
 
+/**
+ * The description and initial data a HostBitmap describes: Carbon's own
+ * `CreateTexture` loop (`Tr2ImageIOHelpers.cpp:104-128`), one
+ * `Tr2SubresourceData` per (mip, layer) indexed `i + j * trueMipCount`.
+ *
+ * @param {import("#imageio").HostBitmap} bitmap A valid bitmap.
+ * @returns {{desc: Tr2BitmapDimensions, initialData: object[], memoryUse: number}|null}
+ *   What to create, or null when the bitmap cannot be uploaded.
+ */
+function DescribeBitmap(bitmap) {
+  if (!bitmap || !bitmap.IsValid()) return null;
+  const mipCount = bitmap.GetTrueMipCount();
+  const arraySize = bitmap.GetArraySize();
+  const initialData = new Array(mipCount * arraySize);
+  let memoryUse = 0;
+  for (let layer = 0; layer < arraySize; ++layer) {
+    for (let mip = 0; mip < mipCount; ++mip) {
+      const sysMem = bitmap.GetMipRawData(mip, layer);
+      if (!sysMem) return null;
+      const sysMemSlicePitch = bitmap.GetMipSize(mip);
+      initialData[mip + layer * mipCount] = new Tr2SubresourceData(sysMem, bitmap.GetMipPitch(mip), sysMemSlicePitch);
+      memoryUse += sysMemSlicePitch;
+    }
+  }
+  return {
+    desc: new BitmapDimensions({
+      type: bitmap.GetType(),
+      format: bitmap.GetFormat(),
+      width: bitmap.GetWidth(),
+      height: bitmap.GetHeight(),
+      depth: bitmap.GetDepth(),
+      mipCount,
+      arraySize
+    }),
+    initialData,
+    memoryUse
+  };
+}
+
+/**
+ * Carbon's `Tr2ImageIOHelpers::CreateTexture( bitmap, out, memoryUse, ctx,
+ * USAGE_IMMUTABLE )` (`Tr2ImageIOHelpers.cpp:93-128`): shader-resource usage,
+ * CPU read, every mip supplied at creation.
+ *
+ * adapted: Carbon fills an out-param texture and an out-param memoryUse and
+ * returns a bool; this returns the texture, or null.
+ *
+ * @param {import("#imageio").HostBitmap} bitmap The decoded bitmap.
+ * @param {object} renderContext The `Tr2RenderContext` to create through.
+ * @param {string} [name] Debug name for the texture.
+ * @returns {object|null} A `Tr2TextureAL`, or null.
+ */
+function CreateTextureFromBitmap(bitmap, renderContext, name = "") {
+  const described = DescribeBitmap(bitmap);
+  if (!described || !renderContext) return null;
+  const texture = renderContext.CreateTexture(described.desc, {
+    gpuUsage: Tr2GpuUsage.SHADER_RESOURCE,
+    cpuUsage: Tr2CpuUsage.READ,
+    initialData: described.initialData
+  });
+  if (texture && name) texture.SetName(name);
+  return texture;
+}
+
 /**
  * Creates the running backend's texture from a prepared texture resource.
  *
@@ -100,6 +162,8 @@ function DescribeTexturePayload(payload) {
  * @returns {object|null} A `Tr2TextureAL`, or null when nothing could be made.
  */
 function CreateTexture(resource, renderContext) {
+  const bitmap = resource.GetBitmap();
+  if (bitmap) return CreateTextureFromBitmap(bitmap, renderContext, resource.GetPath() || resource.name || "TriTextureRes");
   const described = DescribeTexturePayload(resource.GetPayload());
   if (!described) return null;
   const texture = renderContext.CreateTexture(described.desc, {
@@ -117,19 +181,18 @@ function CreateTexture(resource, renderContext) {
  * This is `TriTextureRes::DoPrepare`'s creation step (`TriTextureRes.cpp:690-704`)
  * moved to the first bind, for the reason in the head note.
  *
- * @param {object} resource A `TriTextureRes`, or anything else (which yields null).
+ * @param {object} resource A `TriTextureRes`.
  * @param {object} renderContext The `Tr2RenderContext` to create through.
  * @returns {object|null} The texture, or null while the resource is not ready.
  */
 function RealizeTexture(resource, renderContext) {
-  if (!resource || typeof resource.GetTexture !== "function") return null;
   const existing = resource.GetTexture();
   if (existing) return existing;
-  if (!renderContext || typeof resource.IsPrepared !== "function" || !resource.IsPrepared()) return null;
+  if (!renderContext || !resource.IsPrepared()) return null;
   const texture = CreateTexture(resource, renderContext);
   if (texture) resource.SetTexture(texture);
   return texture;
 }
 
-export { CreateTexture, DescribeTexturePayload, RealizeTexture };
+export { CreateTexture, CreateTextureFromBitmap, DescribeBitmap, DescribeTexturePayload, RealizeTexture };
 //# sourceMappingURL=Tr2ImageIOHelpers.js.map

package/dist/trinity/core/Tr2ImageIOHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ImageIOHelpers.js","sources":["../../../../src/trinity/core/Tr2ImageIOHelpers.js"],"sourcesContent":["// Source: trinity/trinity/Tr2ImageIOHelpers.h\n//   trinity/trinity/Tr2ImageIOHelpers.cpp:47-145\n//   trinity/trinity/Resources/TriTextureRes.cpp:662-705 (DoPrepare)\n//\n// Carbon's bridge from a decoded bitmap to a `Tr2TextureAL`: `CreateTexture`\n// builds one `Tr2SubresourceData` per (mip, layer), indexed\n// `mip + layer * mipCount`, and calls the texture's `Create` with them as\n// initial data (`Tr2ImageIOHelpers.cpp:104-128`). The texture resource calls it\n// from `DoPrepare` on the main thread through `USE_MAIN_THREAD_RENDER_CONTEXT`\n// and stores the result with `SetTexture` (`TriTextureRes.cpp:690-704`).\n//\n// WHERE OURS DIFFERS, AND WHY. The resource layer cannot reach a render\n// context - `layers.json` forbids it - so the texture is made the first time a\n// PREPARED resource is bound, through the context that binds it, and stored on\n// the resource exactly where Carbon stores it. A resource not yet prepared\n// yields null, and the parameter binds Carbon's fallback instead.\nimport { Tr2BitmapDimensions } from \"../../trinityal/Tr2BitmapDimensions.js\";\nimport { PixelFormat, PixelFormatFromCanonical, TextureType, Tr2CpuUsage, Tr2GpuUsage } from \"#consts/render-context\";\n\n\n/** The payload's `dimension` to Carbon's texture type. */\nconst TYPE_OF_DIMENSION = Object.freeze({\n  \"2d\": TextureType.TEX_TYPE_2D,\n  \"array\": TextureType.TEX_TYPE_2D,\n  \"cube\": TextureType.TEX_TYPE_CUBE,\n  \"3d\": TextureType.TEX_TYPE_3D\n});\n\n\n/**\n * The description and initial data a texture payload describes.\n *\n * @param {object} payload A `\"texture\"` or `\"rgba\"` payload.\n * @returns {{desc: Tr2BitmapDimensions, initialData: object[]}|null} What to\n *   create, or null when the payload is not one a texture can be made from.\n */\nexport function DescribeTexturePayload(payload)\n{\n  if (!payload) return null;\n\n  if (payload.payloadType === \"rgba\")\n  {\n    if (!(payload.data instanceof Uint8Array) || payload.pixelFormat !== \"rgba8unorm\") return null;\n\n    const srgb = payload.colorSpace === \"srgb\";\n\n    return {\n      desc: Tr2BitmapDimensions.Texture2D(\n        payload.width,\n        payload.height,\n        1,\n        srgb ? PixelFormat.PIXEL_FORMAT_R8G8B8A8_UNORM_SRGB : PixelFormat.PIXEL_FORMAT_R8G8B8A8_UNORM\n      ),\n      initialData: [ {\n        sysMem: payload.data,\n        sysMemPitch: payload.strideBytes ?? payload.width * 4,\n        sysMemSlicePitch: payload.data.byteLength\n      } ]\n    };\n  }\n\n  if (payload.payloadType !== \"texture\") return null;\n\n  const format = PixelFormatFromCanonical[payload.pixelFormat];\n  const type = TYPE_OF_DIMENSION[payload.dimension];\n\n  if (format === undefined || type === undefined) return null;\n\n  const mipCount = Math.max(1, payload.mipCount | 0);\n\n  // A CUBE'S LAYERS ARE ITS FACES TIMES ITS ARRAY SIZE, and reading `arraySize`\n  // alone loses the six. An image reader reports a cube as `faces: 6` with\n  // `arraySize: 1` - six faces of a single cube - so this described a cube one\n  // layer deep, and the backend refused it: `Tr2TextureAL` checks\n  // `arraySize % 6` and returns E_INVALIDARG. The slot then took the dummy, so\n  // every reflection sampled a black 1x1 cube. A ship's sun came back as a dark\n  // grey disc on a polished hull, which is a long way from an array count.\n  const faces = payload.dimension === \"cube\" ? Math.max(1, payload.faces | 0) : 1;\n  const arraySize = payload.dimension === \"3d\" ? 1 : Math.max(1, payload.arraySize | 0) * faces;\n  const desc = new Tr2BitmapDimensions({\n    type,\n    format,\n    width: payload.width,\n    height: payload.height,\n    depth: payload.dimension === \"3d\" ? Math.max(1, payload.depth | 0) : 1,\n    mipCount,\n    arraySize\n  });\n  const initialData = new Array(mipCount * arraySize).fill(null);\n\n  // Carbon's index: `i + j * trueMipLevelCount` for mip i of layer j.\n  for (const subresource of payload.subresources ?? [])\n  {\n    const index = (subresource.mip | 0) + (subresource.layer | 0) * mipCount;\n\n    if (index < 0 || index >= initialData.length) continue;\n\n    initialData[index] = {\n      sysMem: payload.data.subarray(subresource.offset, subresource.offset + subresource.byteLength),\n      sysMemPitch: subresource.rowPitch,\n      sysMemSlicePitch: subresource.slicePitch\n    };\n  }\n\n  return { desc, initialData };\n}\n\n\n/**\n * Creates the running backend's texture from a prepared texture resource.\n *\n * Carbon's `Tr2ImageIOHelpers::CreateTexture( bitmap, out, memoryUse, ctx,\n * USAGE_IMMUTABLE )`: shader-resource usage, CPU read, all data at creation.\n *\n * @param {object} resource A prepared `TriTextureRes`.\n * @param {object} renderContext The `Tr2RenderContext` to create through.\n * @returns {object|null} A `Tr2TextureAL`, or null when nothing could be made.\n */\nexport function CreateTexture(resource, renderContext)\n{\n  const described = DescribeTexturePayload(resource.GetPayload());\n\n  if (!described) return null;\n\n  const texture = renderContext.CreateTexture(described.desc, {\n    gpuUsage: Tr2GpuUsage.SHADER_RESOURCE,\n    cpuUsage: Tr2CpuUsage.READ,\n    initialData: described.initialData\n  });\n\n  if (texture) texture.SetName(resource.GetPath() || resource.name || \"TriTextureRes\");\n\n  return texture;\n}\n\n\n/**\n * The resource's texture, made on first request once the resource is prepared.\n *\n * This is `TriTextureRes::DoPrepare`'s creation step (`TriTextureRes.cpp:690-704`)\n * moved to the first bind, for the reason in the head note.\n *\n * @param {object} resource A `TriTextureRes`, or anything else (which yields null).\n * @param {object} renderContext The `Tr2RenderContext` to create through.\n * @returns {object|null} The texture, or null while the resource is not ready.\n */\nexport function RealizeTexture(resource, renderContext)\n{\n  if (!resource || typeof resource.GetTexture !== \"function\") return null;\n\n  const existing = resource.GetTexture();\n\n  if (existing) return existing;\n  if (!renderContext || typeof resource.IsPrepared !== \"function\" || !resource.IsPrepared()) return null;\n\n  const texture = CreateTexture(resource, renderContext);\n\n  if (texture) resource.SetTexture(texture);\n\n  return texture;\n}\n"],"names":["TYPE_OF_DIMENSION","Object","freeze","TextureType","TEX_TYPE_2D","TEX_TYPE_CUBE","TEX_TYPE_3D","DescribeTexturePayload","payload","payloadType","data","Uint8Array","pixelFormat","srgb","colorSpace","desc","Tr2BitmapDimensions","Texture2D","width","height","PixelFormat","PIXEL_FORMAT_R8G8B8A8_UNORM_SRGB","PIXEL_FORMAT_R8G8B8A8_UNORM","initialData","sysMem","sysMemPitch","strideBytes","sysMemSlicePitch","byteLength","format","PixelFormatFromCanonical","type","dimension","undefined","mipCount","Math","max","faces","arraySize","depth","Array","fill","subresource","subresources","index","mip","layer","length","subarray","offset","rowPitch","slicePitch","CreateTexture","resource","renderContext","described","GetPayload","texture","gpuUsage","Tr2GpuUsage","SHADER_RESOURCE","cpuUsage","Tr2CpuUsage","READ","SetName","GetPath","name","RealizeTexture","GetTexture","existing","IsPrepared","SetTexture"],"mappings":"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"}
+{"version":3,"file":"Tr2ImageIOHelpers.js","sources":["../../../../src/trinity/core/Tr2ImageIOHelpers.js"],"sourcesContent":["// Source: trinity/trinity/Tr2ImageIOHelpers.h\n//   trinity/trinity/Tr2ImageIOHelpers.cpp:47-145\n//   trinity/trinity/Resources/TriTextureRes.cpp:662-705 (DoPrepare)\n//\n// Carbon's bridge from a decoded bitmap to a `Tr2TextureAL`: `CreateTexture`\n// builds one `Tr2SubresourceData` per (mip, layer), indexed\n// `mip + layer * mipCount`, and calls the texture's `Create` with them as\n// initial data (`Tr2ImageIOHelpers.cpp:104-128`). The texture resource calls it\n// from `DoPrepare` on the main thread through `USE_MAIN_THREAD_RENDER_CONTEXT`\n// and stores the result with `SetTexture` (`TriTextureRes.cpp:690-704`).\n//\n// WHERE OURS DIFFERS, AND WHY. The resource layer cannot reach a render\n// context - `layers.json` forbids it - so the texture is made the first time a\n// PREPARED resource is bound, through the context that binds it, and stored on\n// the resource exactly where Carbon stores it. A resource not yet prepared\n// yields null, and the parameter binds Carbon's fallback instead.\nimport { BitmapDimensions as Tr2BitmapDimensions } from \"#imageio\";\nimport { Tr2SubresourceData } from \"#trinityal\";\nimport { PixelFormat, PixelFormatFromCanonical, TextureType, Tr2CpuUsage, Tr2GpuUsage } from \"#consts/render-context\";\n\n\n/** The payload's `dimension` to Carbon's texture type. */\nconst TYPE_OF_DIMENSION = Object.freeze({\n  \"2d\": TextureType.TEX_TYPE_2D,\n  \"array\": TextureType.TEX_TYPE_2D,\n  \"cube\": TextureType.TEX_TYPE_CUBE,\n  \"3d\": TextureType.TEX_TYPE_3D\n});\n\n\n/**\n * The description and initial data a texture payload describes.\n *\n * TRANSITIONAL. Carbon uploads from an `ImageIO::HostBitmap`\n * (`DescribeBitmap`), and the plain payload is ours, not Carbon's. This route\n * stays only until every texture reader publishes a bitmap\n * (/docs/projects/hostbitmap-port.md).\n *\n * @param {object} payload A `\"texture\"` or `\"rgba\"` payload.\n * @returns {{desc: Tr2BitmapDimensions, initialData: object[]}|null} What to\n *   create, or null when the payload is not one a texture can be made from.\n */\nexport function DescribeTexturePayload(payload)\n{\n  if (!payload) return null;\n\n  if (payload.payloadType === \"rgba\")\n  {\n    if (!(payload.data instanceof Uint8Array) || payload.pixelFormat !== \"rgba8unorm\") return null;\n\n    const srgb = payload.colorSpace === \"srgb\";\n\n    return {\n      desc: Tr2BitmapDimensions.texture2D(\n        payload.width,\n        payload.height,\n        1,\n        srgb ? PixelFormat.PIXEL_FORMAT_R8G8B8A8_UNORM_SRGB : PixelFormat.PIXEL_FORMAT_R8G8B8A8_UNORM\n      ),\n      initialData: [ new Tr2SubresourceData(\n        payload.data,\n        payload.strideBytes ?? payload.width * 4,\n        payload.data.byteLength\n      ) ]\n    };\n  }\n\n  if (payload.payloadType !== \"texture\") return null;\n\n  const format = PixelFormatFromCanonical[payload.pixelFormat];\n  const type = TYPE_OF_DIMENSION[payload.dimension];\n\n  if (format === undefined || type === undefined) return null;\n\n  const mipCount = Math.max(1, payload.mipCount | 0);\n\n  // A CUBE'S LAYERS ARE ITS FACES TIMES ITS ARRAY SIZE, and reading `arraySize`\n  // alone loses the six. An image reader reports a cube as `faces: 6` with\n  // `arraySize: 1` - six faces of a single cube - so this described a cube one\n  // layer deep, and the backend refused it: `Tr2TextureAL` checks\n  // `arraySize % 6` and returns E_INVALIDARG. The slot then took the dummy, so\n  // every reflection sampled a black 1x1 cube. A ship's sun came back as a dark\n  // grey disc on a polished hull, which is a long way from an array count.\n  const faces = payload.dimension === \"cube\" ? Math.max(1, payload.faces | 0) : 1;\n  const arraySize = payload.dimension === \"3d\" ? 1 : Math.max(1, payload.arraySize | 0) * faces;\n  const desc = new Tr2BitmapDimensions({\n    type,\n    format,\n    width: payload.width,\n    height: payload.height,\n    depth: payload.dimension === \"3d\" ? Math.max(1, payload.depth | 0) : 1,\n    mipCount,\n    arraySize\n  });\n  const initialData = new Array(mipCount * arraySize).fill(null);\n\n  // Carbon's index: `i + j * trueMipLevelCount` for mip i of layer j.\n  for (const subresource of payload.subresources ?? [])\n  {\n    const index = (subresource.mip | 0) + (subresource.layer | 0) * mipCount;\n\n    if (index < 0 || index >= initialData.length) continue;\n\n    initialData[index] = new Tr2SubresourceData(\n      payload.data.subarray(subresource.offset, subresource.offset + subresource.byteLength),\n      subresource.rowPitch,\n      subresource.slicePitch\n    );\n  }\n\n  return { desc, initialData };\n}\n\n\n/**\n * The description and initial data a HostBitmap describes: Carbon's own\n * `CreateTexture` loop (`Tr2ImageIOHelpers.cpp:104-128`), one\n * `Tr2SubresourceData` per (mip, layer) indexed `i + j * trueMipCount`.\n *\n * @param {import(\"#imageio\").HostBitmap} bitmap A valid bitmap.\n * @returns {{desc: Tr2BitmapDimensions, initialData: object[], memoryUse: number}|null}\n *   What to create, or null when the bitmap cannot be uploaded.\n */\nexport function DescribeBitmap(bitmap)\n{\n  if (!bitmap || !bitmap.IsValid()) return null;\n\n  const mipCount = bitmap.GetTrueMipCount();\n  const arraySize = bitmap.GetArraySize();\n  const initialData = new Array(mipCount * arraySize);\n  let memoryUse = 0;\n\n  for (let layer = 0; layer < arraySize; ++layer)\n  {\n    for (let mip = 0; mip < mipCount; ++mip)\n    {\n      const sysMem = bitmap.GetMipRawData(mip, layer);\n\n      if (!sysMem) return null;\n\n      const sysMemSlicePitch = bitmap.GetMipSize(mip);\n\n      initialData[mip + layer * mipCount] = new Tr2SubresourceData(sysMem, bitmap.GetMipPitch(mip), sysMemSlicePitch);\n      memoryUse += sysMemSlicePitch;\n    }\n  }\n\n  return {\n    desc: new Tr2BitmapDimensions({\n      type: bitmap.GetType(),\n      format: bitmap.GetFormat(),\n      width: bitmap.GetWidth(),\n      height: bitmap.GetHeight(),\n      depth: bitmap.GetDepth(),\n      mipCount,\n      arraySize\n    }),\n    initialData,\n    memoryUse\n  };\n}\n\n\n/**\n * Carbon's `Tr2ImageIOHelpers::CreateTexture( bitmap, out, memoryUse, ctx,\n * USAGE_IMMUTABLE )` (`Tr2ImageIOHelpers.cpp:93-128`): shader-resource usage,\n * CPU read, every mip supplied at creation.\n *\n * adapted: Carbon fills an out-param texture and an out-param memoryUse and\n * returns a bool; this returns the texture, or null.\n *\n * @param {import(\"#imageio\").HostBitmap} bitmap The decoded bitmap.\n * @param {object} renderContext The `Tr2RenderContext` to create through.\n * @param {string} [name] Debug name for the texture.\n * @returns {object|null} A `Tr2TextureAL`, or null.\n */\nexport function CreateTextureFromBitmap(bitmap, renderContext, name = \"\")\n{\n  const described = DescribeBitmap(bitmap);\n\n  if (!described || !renderContext) return null;\n\n  const texture = renderContext.CreateTexture(described.desc, {\n    gpuUsage: Tr2GpuUsage.SHADER_RESOURCE,\n    cpuUsage: Tr2CpuUsage.READ,\n    initialData: described.initialData\n  });\n\n  if (texture && name) texture.SetName(name);\n\n  return texture;\n}\n\n\n/**\n * Creates the running backend's texture from a prepared texture resource.\n *\n * Carbon's `Tr2ImageIOHelpers::CreateTexture( bitmap, out, memoryUse, ctx,\n * USAGE_IMMUTABLE )`: shader-resource usage, CPU read, all data at creation.\n *\n * @param {object} resource A prepared `TriTextureRes`.\n * @param {object} renderContext The `Tr2RenderContext` to create through.\n * @returns {object|null} A `Tr2TextureAL`, or null when nothing could be made.\n */\nexport function CreateTexture(resource, renderContext)\n{\n  const bitmap = resource.GetBitmap();\n\n  if (bitmap) return CreateTextureFromBitmap(bitmap, renderContext, resource.GetPath() || resource.name || \"TriTextureRes\");\n\n  const described = DescribeTexturePayload(resource.GetPayload());\n\n  if (!described) return null;\n\n  const texture = renderContext.CreateTexture(described.desc, {\n    gpuUsage: Tr2GpuUsage.SHADER_RESOURCE,\n    cpuUsage: Tr2CpuUsage.READ,\n    initialData: described.initialData\n  });\n\n  if (texture) texture.SetName(resource.GetPath() || resource.name || \"TriTextureRes\");\n\n  return texture;\n}\n\n\n/**\n * The resource's texture, made on first request once the resource is prepared.\n *\n * This is `TriTextureRes::DoPrepare`'s creation step (`TriTextureRes.cpp:690-704`)\n * moved to the first bind, for the reason in the head note.\n *\n * @param {object} resource A `TriTextureRes`.\n * @param {object} renderContext The `Tr2RenderContext` to create through.\n * @returns {object|null} The texture, or null while the resource is not ready.\n */\nexport function RealizeTexture(resource, renderContext)\n{\n  const existing = resource.GetTexture();\n\n  if (existing) return existing;\n  if (!renderContext || !resource.IsPrepared()) return null;\n\n  const texture = CreateTexture(resource, renderContext);\n\n  if (texture) resource.SetTexture(texture);\n\n  return texture;\n}\n"],"names":["TYPE_OF_DIMENSION","Object","freeze","TextureType","TEX_TYPE_2D","TEX_TYPE_CUBE","TEX_TYPE_3D","DescribeTexturePayload","payload","payloadType","data","Uint8Array","pixelFormat","srgb","colorSpace","desc","Tr2BitmapDimensions","texture2D","width","height","PixelFormat","PIXEL_FORMAT_R8G8B8A8_UNORM_SRGB","PIXEL_FORMAT_R8G8B8A8_UNORM","initialData","Tr2SubresourceData","strideBytes","byteLength","format","PixelFormatFromCanonical","type","dimension","undefined","mipCount","Math","max","faces","arraySize","depth","Array","fill","subresource","subresources","index","mip","layer","length","subarray","offset","rowPitch","slicePitch","DescribeBitmap","bitmap","IsValid","GetTrueMipCount","GetArraySize","memoryUse","sysMem","GetMipRawData","sysMemSlicePitch","GetMipSize","GetMipPitch","GetType","GetFormat","GetWidth","GetHeight","GetDepth","CreateTextureFromBitmap","renderContext","name","described","texture","CreateTexture","gpuUsage","Tr2GpuUsage","SHADER_RESOURCE","cpuUsage","Tr2CpuUsage","READ","SetName","resource","GetBitmap","GetPath","GetPayload","RealizeTexture","existing","GetTexture","IsPrepared","SetTexture"],"mappings":"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"}

package/dist/trinity/core/Tr2RenderUtils.js

@@ -2,7 +2,7 @@ import { ShaderType } from '#consts/render-context';
 import { mat4 } from '#math/mat4';
 import { vec3 } from '#math/vec3';
 import { Failed } from '../../trinityal/ALResult.js';
-import '../../trinityal/Tr2BitmapDimensions.js';
+import '#imageio';
 import '../../global/consts/renderContext/formats.js';
 import '../../global/consts/renderContext/pipeline.js';
 import '../../trinityal/Tr2DeviceResourceAL/Tr2BaseDeviceResourceAL.js';

package/dist/trinity/core/Tr2TextureArray/Tr2TextureArray.js

@@ -2,6 +2,7 @@ import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../../..
 import { type } from '#schema';
 import { CjsModel } from '#model';
 import { Tr2CpuUsage, Tr2GpuUsage } from '#consts/render-context';
+import { HostBitmap, BitmapDimensions } from '#imageio';
 import { Tr2TextureArrayElement } from './Tr2TextureArrayElement.js';
 
 let _initClass, _init_elements, _init_extra_elements, _init_texture, _init_extra_texture, _init_dimensions, _init_extra_dimensions, _init_onTextureChange, _init_extra_onTextureChange, _init_increment, _init_extra_increment, _init_cpuUsage, _init_extra_cpuUsage, _init_gpuUsage, _init_extra_gpuUsage;
@@ -40,62 +41,63 @@ new class extends _identity {
 
     /** m_gpuUsage (Tr2GpuUsage::Type - enum Tr2GpuUsage) */
     gpuUsage = (_init_extra_cpuUsage(this), _init_gpuUsage(this, 16));
-    #expectedDimensions = (_init_extra_gpuUsage(this), null);
-    #listeners = [];
+    #listeners = (_init_extra_gpuUsage(this), []);
     #revision = 0;
 
     /**
      * Pins the dimension gate before the first element arrives
-     * (Carbon SetExpectedElementDimensions).
+     * (Tr2TextureArray.cpp:9-15): ignored once a texture exists.
      *
-     * @param {object} dimensions Bitmap-shaped dimensions.
+     * @param {BitmapDimensions} dimensions The dimensions every element must have.
      */
     SetExpectedElementDimensions(dimensions) {
-      this.#expectedDimensions = dimensions ? _Tr2TextureArray.describe(dimensions) : null;
-      if (!this.dimensions) this.dimensions = this.#expectedDimensions;
+      if (this.texture) return;
+      this.dimensions = dimensions;
     }
 
     /**
-     * Adds one element (Tr2TextureArray.cpp:18-79), CPU description side.
+     * Adds one element (Tr2TextureArray.cpp:18-79).
      *
-     * Carbon's dimension gate REJECTS any bitmap whose type, format, width,
-     * height, depth or mip count differs from the array's - silently, via an
-     * invalid handle - which is exactly how a wrong-mip-count light profile
-     * fails to register. Slot reuse is first-fit over released elements, the
-     * element data is copied in, and the array size rounds up to a multiple
-     * of `increment` (16). The GPU texture rebuild (cpp:66-72, CreateTexture)
-     * is the abstraction layer's job; this side bumps the revision and
-     * notifies listeners, matching m_onTextureChange.
+     * Carbon's dimension gate REJECTS a bitmap whose type, format, width,
+     * height, depth or true mip count differs from the array's - silently, with
+     * an invalid handle - which is how a wrong-mip-count light profile fails to
+     * register. Slots are reused first-fit over released elements, the bitmap
+     * is copied in, and the array size rounds up to a multiple of `increment`.
      *
-     * @param {object} bitmap Element payload: format, width, height,
-     * mipCount, samples (or data), with optional dimension and depth.
-     * @returns {Tr2TextureArrayElement} A valid handle, or an invalid one
-     * when the payload is missing or incompatible.
+     * adapted: Carbon rebuilds the GPU texture here (`CreateTexture`,
+     * cpp:66-72) and fires m_onTextureChange. Trinity cannot reach a device from
+     * this class, so it bumps the revision and notifies listeners; the backend
+     * rebuilds from the elements.
+     *
+     * @param {HostBitmap} bitmap The element's bitmap.
+     * @returns {Tr2TextureArrayElement} A valid handle, or an invalid one.
      */
     AddElement(bitmap) {
-      const payload = bitmap && (bitmap.samples || bitmap.data);
-      if (!payload) return new Tr2TextureArrayElement();
-      const described = _Tr2TextureArray.describe(bitmap);
-      const gate = this.dimensions || this.#expectedDimensions;
-      if (gate && (gate.dimension !== described.dimension || gate.format !== described.format || gate.width !== described.width || gate.height !== described.height || gate.depth !== described.depth || gate.mipCount !== described.mipCount)) {
+      if (!bitmap || !bitmap.IsValid()) return new Tr2TextureArrayElement();
+      const gate = this.dimensions;
+      if (gate && (gate.GetType() !== bitmap.GetType() || gate.GetFormat() !== bitmap.GetFormat() || gate.GetWidth() !== bitmap.GetWidth() || gate.GetHeight() !== bitmap.GetHeight() || gate.GetDepth() !== bitmap.GetDepth() || gate.GetTrueMipCount() !== bitmap.GetTrueMipCount())) {
         return new Tr2TextureArrayElement();
       }
       let index = this.elements.length;
       for (let i = 0; i < this.elements.length; i++) {
-        if (this.elements[i] === null) {
+        if (!this.elements[i].IsValid()) {
           index = i;
           break;
         }
       }
-      if (index === this.elements.length) this.elements.push(null);
-      this.elements[index] = {
-        ...bitmap,
-        samples: payload.slice()
-      };
-      this.dimensions = {
-        ...described,
+      if (index === this.elements.length) this.elements.push(new HostBitmap());
+      const element = this.elements[index];
+      element.CreateFromBitmapDimensions(bitmap);
+      element.GetRawData().set(bitmap.GetRawData());
+      this.dimensions = new BitmapDimensions({
+        type: bitmap.GetType(),
+        format: bitmap.GetFormat(),
+        width: bitmap.GetWidth(),
+        height: bitmap.GetHeight(),
+        depth: bitmap.GetDepth(),
+        mipCount: bitmap.GetTrueMipCount(),
         arraySize: Math.ceil(this.elements.length / this.increment) * this.increment
-      };
+      });
       this.#revision += 1;
       for (const listener of this.#listeners) listener(this);
       return new Tr2TextureArrayElement(this, index);
@@ -110,7 +112,7 @@ new class extends _identity {
      */
     RemoveElement(index) {
       if (index >= 0 && index < this.elements.length) {
-        this.elements[index] = null;
+        this.elements[index] = new HostBitmap();
         this.#revision += 1;
         for (const listener of this.#listeners) listener(this);
       }
@@ -130,16 +132,18 @@ new class extends _identity {
       };
     }
 
-    /** Element payload at an index, or null for a released slot. */
+    /** An element's bitmap, or null for a released or missing slot. */
     GetElement(index) {
-      return this.elements[index] ?? null;
+      const element = this.elements[index];
+      return element && element.IsValid() ? element : null;
     }
 
-    /** Live (non-released) element count. */
+    /**
+     * Slots in the array, released ones included - Carbon returns
+     * `m_elements.size()` (cpp:91-94).
+     */
     GetElementCount() {
-      let count = 0;
-      for (const element of this.elements) if (element !== null) count += 1;
-      return count;
+      return this.elements.length;
     }
 
     /** Current dimensions, or null before the first element. */
@@ -149,50 +153,33 @@ new class extends _identity {
 
     /** Element width; 0 before the first element (Carbon cpp:101-104). */
     GetWidth() {
-      return this.dimensions ? this.dimensions.width : 0;
+      return this.dimensions ? this.dimensions.GetWidth() : 0;
     }
 
     /** Element height; 0 before the first element. */
     GetHeight() {
-      return this.dimensions ? this.dimensions.height : 0;
+      return this.dimensions ? this.dimensions.GetHeight() : 0;
     }
 
     /** Slice capacity rounded to the increment; 0 before the first element. */
     GetArraySize() {
-      return this.dimensions ? this.dimensions.arraySize ?? 0 : 0;
+      return this.dimensions ? this.dimensions.GetArraySize() : 0;
     }
 
     /** Element pixel format, or null before the first element. */
     GetFormat() {
-      return this.dimensions ? this.dimensions.format : null;
+      return this.dimensions ? this.dimensions.GetFormat() : null;
     }
 
     /** Element mip count; 0 before the first element. */
     GetMipCount() {
-      return this.dimensions ? this.dimensions.mipCount : 0;
+      return this.dimensions ? this.dimensions.GetTrueMipCount() : 0;
     }
 
     /** Monotonic change counter for AL-side re-upload decisions. */
     GetRevision() {
       return this.#revision;
     }
-
-    /**
-     * Normalizes a bitmap-shaped payload to the compared dimension keys.
-     *
-     * @param {object} bitmap Payload or dimensions object.
-     * @returns {object} Comparable dimension description.
-     */
-    static describe(bitmap) {
-      return {
-        dimension: bitmap.dimension ?? "2d",
-        format: bitmap.format ?? null,
-        width: bitmap.width ?? 0,
-        height: bitmap.height ?? 0,
-        depth: bitmap.depth ?? 1,
-        mipCount: bitmap.mipCount ?? 1
-      };
-    }
   }];
   Tr2CpuUsage = Tr2CpuUsage;
   Tr2GpuUsage = Tr2GpuUsage;

package/dist/trinity/core/Tr2TextureArray/Tr2TextureArray.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2TextureArray.js","sources":["../../../../../src/trinity/core/Tr2TextureArray/Tr2TextureArray.js"],"sourcesContent":["// Source: trinity/trinity/Tr2TextureArray.h\n//   trinity/trinity/Tr2TextureArray.cpp\n\nimport { type } from \"#schema\";\nimport { CjsModel } from \"#model\";\nimport { Tr2CpuUsage, Tr2GpuUsage } from \"#consts/render-context\";\nimport { Tr2TextureArrayElement } from \"./Tr2TextureArrayElement.js\";\n\n/** Describes a texture array's elements, dimensions, resource usage, upload increment, backing texture, and change callback. */\n@type.define({ className: \"Tr2TextureArray\", family: \"trinityCore\", purpose: \"Describes a texture array's elements, dimensions, resource usage, upload increment, backing texture, and change callback.\" })\nexport class Tr2TextureArray extends CjsModel\n{\n\n    /** m_elements (std::vector<ImageIO::HostBitmap>) */\n    @type.list(\"ImageIO::HostBitmap\")\n    elements = [];\n\n    /** m_texture (Tr2TextureAL) */\n    @type.rawStruct(\"Tr2TextureAL\")\n    texture = null;\n\n    /** m_dimensions (Tr2BitmapDimensions) */\n    @type.rawStruct(\"Tr2BitmapDimensions\")\n    dimensions = null;\n\n    /** m_onTextureChange (OnTextureChangeEvent) */\n    @type.rawStruct(\"OnTextureChangeEvent\")\n    onTextureChange = null;\n\n    /** m_increment (uint32_t) */\n    @type.uint32\n    increment = 16;\n\n    /** m_cpuUsage (Tr2CpuUsage::Type - enum Tr2CpuUsage) */\n    @type.int32\n    @type.enum(\"Tr2CpuUsage\")\n    cpuUsage = 0;\n\n    /** m_gpuUsage (Tr2GpuUsage::Type - enum Tr2GpuUsage) */\n    @type.int32\n    @type.enum(\"Tr2GpuUsage\")\n    gpuUsage = 16;\n\n    #expectedDimensions = null;\n\n    #listeners = [];\n\n    #revision = 0;\n\n    /**\n     * Pins the dimension gate before the first element arrives\n     * (Carbon SetExpectedElementDimensions).\n     *\n     * @param {object} dimensions Bitmap-shaped dimensions.\n     */\n    SetExpectedElementDimensions(dimensions)\n    {\n        this.#expectedDimensions = dimensions ? Tr2TextureArray.describe(dimensions) : null;\n        if (!this.dimensions) this.dimensions = this.#expectedDimensions;\n    }\n\n    /**\n     * Adds one element (Tr2TextureArray.cpp:18-79), CPU description side.\n     *\n     * Carbon's dimension gate REJECTS any bitmap whose type, format, width,\n     * height, depth or mip count differs from the array's - silently, via an\n     * invalid handle - which is exactly how a wrong-mip-count light profile\n     * fails to register. Slot reuse is first-fit over released elements, the\n     * element data is copied in, and the array size rounds up to a multiple\n     * of `increment` (16). The GPU texture rebuild (cpp:66-72, CreateTexture)\n     * is the abstraction layer's job; this side bumps the revision and\n     * notifies listeners, matching m_onTextureChange.\n     *\n     * @param {object} bitmap Element payload: format, width, height,\n     * mipCount, samples (or data), with optional dimension and depth.\n     * @returns {Tr2TextureArrayElement} A valid handle, or an invalid one\n     * when the payload is missing or incompatible.\n     */\n    AddElement(bitmap)\n    {\n        const payload = bitmap && (bitmap.samples || bitmap.data);\n        if (!payload) return new Tr2TextureArrayElement();\n\n        const described = Tr2TextureArray.describe(bitmap);\n        const gate = this.dimensions || this.#expectedDimensions;\n        if (gate && (\n            gate.dimension !== described.dimension\n            || gate.format !== described.format\n            || gate.width !== described.width\n            || gate.height !== described.height\n            || gate.depth !== described.depth\n            || gate.mipCount !== described.mipCount))\n        {\n            return new Tr2TextureArrayElement();\n        }\n\n        let index = this.elements.length;\n        for (let i = 0; i < this.elements.length; i++)\n        {\n            if (this.elements[i] === null)\n            {\n                index = i;\n                break;\n            }\n        }\n        if (index === this.elements.length) this.elements.push(null);\n\n        this.elements[index] = { ...bitmap, samples: payload.slice() };\n\n        this.dimensions = {\n            ...described,\n            arraySize: Math.ceil(this.elements.length / this.increment) * this.increment\n        };\n        this.#revision += 1;\n        for (const listener of this.#listeners) listener(this);\n\n        return new Tr2TextureArrayElement(this, index);\n    }\n\n    /**\n     * Frees one slice (cpp:127-130): the slot becomes reusable; dimensions\n     * and array size are deliberately untouched, exactly as Carbon leaves\n     * the vector sized and the slot invalid.\n     *\n     * @param {number} index Slice index.\n     */\n    RemoveElement(index)\n    {\n        if (index >= 0 && index < this.elements.length)\n        {\n            this.elements[index] = null;\n            this.#revision += 1;\n            for (const listener of this.#listeners) listener(this);\n        }\n    }\n\n    /**\n     * Registers a texture-change listener (Carbon's OnTextureChange event).\n     *\n     * @param {Function} listener Called with this array after each change.\n     * @returns {Function} Unsubscribe.\n     */\n    OnTextureChange(listener)\n    {\n        this.#listeners.push(listener);\n        return () =>\n        {\n            const at = this.#listeners.indexOf(listener);\n            if (at !== -1) this.#listeners.splice(at, 1);\n        };\n    }\n\n    /** Element payload at an index, or null for a released slot. */\n    GetElement(index)\n    {\n        return this.elements[index] ?? null;\n    }\n\n    /** Live (non-released) element count. */\n    GetElementCount()\n    {\n        let count = 0;\n        for (const element of this.elements) if (element !== null) count += 1;\n        return count;\n    }\n\n    /** Current dimensions, or null before the first element. */\n    GetDimensions()\n    {\n        return this.dimensions;\n    }\n\n    /** Element width; 0 before the first element (Carbon cpp:101-104). */\n    GetWidth()\n    {\n        return this.dimensions ? this.dimensions.width : 0;\n    }\n\n    /** Element height; 0 before the first element. */\n    GetHeight()\n    {\n        return this.dimensions ? this.dimensions.height : 0;\n    }\n\n    /** Slice capacity rounded to the increment; 0 before the first element. */\n    GetArraySize()\n    {\n        return this.dimensions ? this.dimensions.arraySize ?? 0 : 0;\n    }\n\n    /** Element pixel format, or null before the first element. */\n    GetFormat()\n    {\n        return this.dimensions ? this.dimensions.format : null;\n    }\n\n    /** Element mip count; 0 before the first element. */\n    GetMipCount()\n    {\n        return this.dimensions ? this.dimensions.mipCount : 0;\n    }\n\n    /** Monotonic change counter for AL-side re-upload decisions. */\n    GetRevision()\n    {\n        return this.#revision;\n    }\n\n    /**\n     * Normalizes a bitmap-shaped payload to the compared dimension keys.\n     *\n     * @param {object} bitmap Payload or dimensions object.\n     * @returns {object} Comparable dimension description.\n     */\n    static describe(bitmap)\n    {\n        return {\n            dimension: bitmap.dimension ?? \"2d\",\n            format: bitmap.format ?? null,\n            width: bitmap.width ?? 0,\n            height: bitmap.height ?? 0,\n            depth: bitmap.depth ?? 1,\n            mipCount: bitmap.mipCount ?? 1\n        };\n    }\n\n    static Tr2CpuUsage = Tr2CpuUsage;\n\n    static Tr2GpuUsage = Tr2GpuUsage;\n\n}\n"],"names":["_Tr2TextureArray","_identity","Tr2TextureArray","CjsModel","e","_init_elements","_init_extra_elements","_init_texture","_init_extra_texture","_init_dimensions","_init_extra_dimensions","_init_onTextureChange","_init_extra_onTextureChange","_init_increment","_init_extra_increment","_init_cpuUsage","_init_extra_cpuUsage","_init_gpuUsage","_init_extra_gpuUsage","c","_initClass","_applyDecs","type","define","className","family","purpose","list","rawStruct","uint32","int32","enum","elements","texture","dimensions","onTextureChange","increment","cpuUsage","gpuUsage","SetExpectedElementDimensions","describe","AddElement","bitmap","payload","samples","data","Tr2TextureArrayElement","described","gate","dimension","format","width","height","depth","mipCount","index","length","i","push","slice","arraySize","Math","ceil","listener","RemoveElement","OnTextureChange","at","indexOf","splice","GetElement","GetElementCount","count","element","GetDimensions","GetWidth","GetHeight","GetArraySize","GetFormat","GetMipCount","GetRevision","Tr2CpuUsage","Tr2GpuUsage","constructor"],"mappings":"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"}
+{"version":3,"file":"Tr2TextureArray.js","sources":["../../../../../src/trinity/core/Tr2TextureArray/Tr2TextureArray.js"],"sourcesContent":["// Source: trinity/trinity/Tr2TextureArray.h\n//   trinity/trinity/Tr2TextureArray.cpp\n\nimport { type } from \"#schema\";\nimport { CjsModel } from \"#model\";\nimport { Tr2CpuUsage, Tr2GpuUsage } from \"#consts/render-context\";\nimport { BitmapDimensions, HostBitmap } from \"#imageio\";\nimport { Tr2TextureArrayElement } from \"./Tr2TextureArrayElement.js\";\n\n/** Describes a texture array's elements, dimensions, resource usage, upload increment, backing texture, and change callback. */\n@type.define({ className: \"Tr2TextureArray\", family: \"trinityCore\", purpose: \"Describes a texture array's elements, dimensions, resource usage, upload increment, backing texture, and change callback.\" })\nexport class Tr2TextureArray extends CjsModel\n{\n\n    /** m_elements (std::vector<ImageIO::HostBitmap>) */\n    @type.list(\"ImageIO::HostBitmap\")\n    elements = [];\n\n    /** m_texture (Tr2TextureAL) */\n    @type.rawStruct(\"Tr2TextureAL\")\n    texture = null;\n\n    /** m_dimensions (Tr2BitmapDimensions) */\n    @type.rawStruct(\"Tr2BitmapDimensions\")\n    dimensions = null;\n\n    /** m_onTextureChange (OnTextureChangeEvent) */\n    @type.rawStruct(\"OnTextureChangeEvent\")\n    onTextureChange = null;\n\n    /** m_increment (uint32_t) */\n    @type.uint32\n    increment = 16;\n\n    /** m_cpuUsage (Tr2CpuUsage::Type - enum Tr2CpuUsage) */\n    @type.int32\n    @type.enum(\"Tr2CpuUsage\")\n    cpuUsage = 0;\n\n    /** m_gpuUsage (Tr2GpuUsage::Type - enum Tr2GpuUsage) */\n    @type.int32\n    @type.enum(\"Tr2GpuUsage\")\n    gpuUsage = 16;\n\n\n    #listeners = [];\n\n    #revision = 0;\n\n    /**\n     * Pins the dimension gate before the first element arrives\n     * (Tr2TextureArray.cpp:9-15): ignored once a texture exists.\n     *\n     * @param {BitmapDimensions} dimensions The dimensions every element must have.\n     */\n    SetExpectedElementDimensions(dimensions)\n    {\n        if (this.texture) return;\n        this.dimensions = dimensions;\n    }\n\n    /**\n     * Adds one element (Tr2TextureArray.cpp:18-79).\n     *\n     * Carbon's dimension gate REJECTS a bitmap whose type, format, width,\n     * height, depth or true mip count differs from the array's - silently, with\n     * an invalid handle - which is how a wrong-mip-count light profile fails to\n     * register. Slots are reused first-fit over released elements, the bitmap\n     * is copied in, and the array size rounds up to a multiple of `increment`.\n     *\n     * adapted: Carbon rebuilds the GPU texture here (`CreateTexture`,\n     * cpp:66-72) and fires m_onTextureChange. Trinity cannot reach a device from\n     * this class, so it bumps the revision and notifies listeners; the backend\n     * rebuilds from the elements.\n     *\n     * @param {HostBitmap} bitmap The element's bitmap.\n     * @returns {Tr2TextureArrayElement} A valid handle, or an invalid one.\n     */\n    AddElement(bitmap)\n    {\n        if (!bitmap || !bitmap.IsValid()) return new Tr2TextureArrayElement();\n\n        const gate = this.dimensions;\n        if (gate && (\n            gate.GetType() !== bitmap.GetType()\n            || gate.GetFormat() !== bitmap.GetFormat()\n            || gate.GetWidth() !== bitmap.GetWidth()\n            || gate.GetHeight() !== bitmap.GetHeight()\n            || gate.GetDepth() !== bitmap.GetDepth()\n            || gate.GetTrueMipCount() !== bitmap.GetTrueMipCount()))\n        {\n            return new Tr2TextureArrayElement();\n        }\n\n        let index = this.elements.length;\n        for (let i = 0; i < this.elements.length; i++)\n        {\n            if (!this.elements[i].IsValid())\n            {\n                index = i;\n                break;\n            }\n        }\n        if (index === this.elements.length) this.elements.push(new HostBitmap());\n\n        const element = this.elements[index];\n        element.CreateFromBitmapDimensions(bitmap);\n        element.GetRawData().set(bitmap.GetRawData());\n\n        this.dimensions = new BitmapDimensions({\n            type: bitmap.GetType(),\n            format: bitmap.GetFormat(),\n            width: bitmap.GetWidth(),\n            height: bitmap.GetHeight(),\n            depth: bitmap.GetDepth(),\n            mipCount: bitmap.GetTrueMipCount(),\n            arraySize: Math.ceil(this.elements.length / this.increment) * this.increment\n        });\n\n        this.#revision += 1;\n        for (const listener of this.#listeners) listener(this);\n        return new Tr2TextureArrayElement(this, index);\n    }\n\n    /**\n     * Frees one slice (cpp:127-130): the slot becomes reusable; dimensions\n     * and array size are deliberately untouched, exactly as Carbon leaves\n     * the vector sized and the slot invalid.\n     *\n     * @param {number} index Slice index.\n     */\n    RemoveElement(index)\n    {\n        if (index >= 0 && index < this.elements.length)\n        {\n            this.elements[index] = new HostBitmap();\n            this.#revision += 1;\n            for (const listener of this.#listeners) listener(this);\n        }\n    }\n\n    /**\n     * Registers a texture-change listener (Carbon's OnTextureChange event).\n     *\n     * @param {Function} listener Called with this array after each change.\n     * @returns {Function} Unsubscribe.\n     */\n    OnTextureChange(listener)\n    {\n        this.#listeners.push(listener);\n        return () =>\n        {\n            const at = this.#listeners.indexOf(listener);\n            if (at !== -1) this.#listeners.splice(at, 1);\n        };\n    }\n\n    /** An element's bitmap, or null for a released or missing slot. */\n    GetElement(index)\n    {\n        const element = this.elements[index];\n        return element && element.IsValid() ? element : null;\n    }\n\n    /**\n     * Slots in the array, released ones included - Carbon returns\n     * `m_elements.size()` (cpp:91-94).\n     */\n    GetElementCount()\n    {\n        return this.elements.length;\n    }\n\n    /** Current dimensions, or null before the first element. */\n    GetDimensions()\n    {\n        return this.dimensions;\n    }\n\n    /** Element width; 0 before the first element (Carbon cpp:101-104). */\n    GetWidth()\n    {\n        return this.dimensions ? this.dimensions.GetWidth() : 0;\n    }\n\n    /** Element height; 0 before the first element. */\n    GetHeight()\n    {\n        return this.dimensions ? this.dimensions.GetHeight() : 0;\n    }\n\n    /** Slice capacity rounded to the increment; 0 before the first element. */\n    GetArraySize()\n    {\n        return this.dimensions ? this.dimensions.GetArraySize() : 0;\n    }\n\n    /** Element pixel format, or null before the first element. */\n    GetFormat()\n    {\n        return this.dimensions ? this.dimensions.GetFormat() : null;\n    }\n\n    /** Element mip count; 0 before the first element. */\n    GetMipCount()\n    {\n        return this.dimensions ? this.dimensions.GetTrueMipCount() : 0;\n    }\n\n    /** Monotonic change counter for AL-side re-upload decisions. */\n    GetRevision()\n    {\n        return this.#revision;\n    }\n\n    static Tr2CpuUsage = Tr2CpuUsage;\n\n    static Tr2GpuUsage = Tr2GpuUsage;\n\n}\n"],"names":["_Tr2TextureArray","_identity","Tr2TextureArray","CjsModel","e","_init_elements","_init_extra_elements","_init_texture","_init_extra_texture","_init_dimensions","_init_extra_dimensions","_init_onTextureChange","_init_extra_onTextureChange","_init_increment","_init_extra_increment","_init_cpuUsage","_init_extra_cpuUsage","_init_gpuUsage","_init_extra_gpuUsage","c","_initClass","_applyDecs","type","define","className","family","purpose","list","rawStruct","uint32","int32","enum","elements","texture","dimensions","onTextureChange","increment","cpuUsage","gpuUsage","SetExpectedElementDimensions","AddElement","bitmap","IsValid","Tr2TextureArrayElement","gate","GetType","GetFormat","GetWidth","GetHeight","GetDepth","GetTrueMipCount","index","length","i","push","HostBitmap","element","CreateFromBitmapDimensions","GetRawData","set","BitmapDimensions","format","width","height","depth","mipCount","arraySize","Math","ceil","listener","RemoveElement","OnTextureChange","at","indexOf","splice","GetElement","GetElementCount","GetDimensions","GetArraySize","GetMipCount","GetRevision","Tr2CpuUsage","Tr2GpuUsage","constructor"],"mappings":";;;;;;;;;AASA;AAAA,IAAAA;AAAA,IAAA,cAAAC,SAAA,CAAA;AAAA,EAAA,QACA,MAAAC,eAAA,SACqCC,QAAQ,CAC7C;AAAA,IAAA;AAAA,MAAA,CAAA;QAAAC,CAAA,EAAA,CAAAC,cAAA,EAAAC,oBAAA,EAAAC,aAAA,EAAAC,mBAAA,EAAAC,gBAAA,EAAAC,sBAAA,EAAAC,qBAAA,EAAAC,2BAAA,EAAAC,eAAA,EAAAC,qBAAA,EAAAC,cAAA,EAAAC,oBAAA,EAAAC,cAAA,EAAAC,oBAAA,CAAA;QAAAC,CAAA,EAAA,CAAAnB,gBAAA,EAAAoB,UAAA;AAAA,OAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,QAAAA,SAAS,EAAE,iBAAiB;AAAEC,QAAAA,MAAM,EAAE,aAAa;AAAEC,QAAAA,OAAO,EAAE;AAA4H,OAAC,CAAC,CAAA,EAAA,CAAA,CAKtMJ,IAAI,CAACK,IAAI,CAAC,qBAAqB,CAAC,EAAA,CAAA,EAAA,UAAA,CAAA,EAAA,CAIhCL,IAAI,CAACM,SAAS,CAAC,cAAc,CAAC,EAAA,CAAA,EAAA,SAAA,CAAA,EAAA,CAI9BN,IAAI,CAACM,SAAS,CAAC,qBAAqB,CAAC,EAAA,CAAA,EAAA,YAAA,CAAA,EAAA,CAIrCN,IAAI,CAACM,SAAS,CAAC,sBAAsB,CAAC,EAAA,CAAA,EAAA,iBAAA,CAAA,EAAA,CAAA,CAItCN,IAAI,EAAJA,IAAI,CAACO,MAAM,CAAA,EAAA,EAAA,EAAA,WAAA,CAAA,EAAA,CAAA,CAIXP,IAAI,EAAJA,IAAI,CAACQ,KAAK,EAAA,MAAA,EACVR,IAAI,CAACS,IAAI,CAAC,aAAa,CAAC,CAAA,EAAA,EAAA,EAAA,UAAA,CAAA,EAAA,CAAA,CAIxBT,IAAI,EAAJA,IAAI,CAACQ,KAAK,EAAA,MAAA,EACVR,IAAI,CAACS,IAAI,CAAC,aAAa,CAAC,gCA9BQ5B,QAAQ,CAAA;AAAA;AAGzC;IAEA6B,QAAQ,GAAA3B,cAAA,CAAA,IAAA,EAAG,EAAE,CAAA;;AAEb;AAEA4B,IAAAA,OAAO,IAAA3B,oBAAA,CAAA,IAAA,CAAA,EAAAC,aAAA,OAAG,IAAI,CAAA;;AAEd;AAEA2B,IAAAA,UAAU,IAAA1B,mBAAA,CAAA,IAAA,CAAA,EAAAC,gBAAA,OAAG,IAAI,CAAA;;AAEjB;AAEA0B,IAAAA,eAAe,IAAAzB,sBAAA,CAAA,IAAA,CAAA,EAAAC,qBAAA,OAAG,IAAI,CAAA;;AAEtB;AAEAyB,IAAAA,SAAS,IAAAxB,2BAAA,CAAA,IAAA,CAAA,EAAAC,eAAA,OAAG,EAAE,CAAA;;AAEd;AAGAwB,IAAAA,QAAQ,IAAAvB,qBAAA,CAAA,IAAA,CAAA,EAAAC,cAAA,OAAG,CAAC,CAAA;;AAEZ;AAGAuB,IAAAA,QAAQ,IAAAtB,oBAAA,CAAA,IAAA,CAAA,EAAAC,cAAA,OAAG,EAAE,CAAA;AAGb,IAAA,UAAU,IAAAC,oBAAA,CAAA,IAAA,CAAA,EAAG,EAAE;IAEf,SAAS,GAAG,CAAC;;AAEb;AACJ;AACA;AACA;AACA;AACA;IACIqB,4BAA4BA,CAACL,UAAU,EACvC;MACI,IAAI,IAAI,CAACD,OAAO,EAAE;MAClB,IAAI,CAACC,UAAU,GAAGA,UAAU;AAChC,IAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACIM,UAAUA,CAACC,MAAM,EACjB;AACI,MAAA,IAAI,CAACA,MAAM,IAAI,CAACA,MAAM,CAACC,OAAO,EAAE,EAAE,OAAO,IAAIC,sBAAsB,EAAE;AAErE,MAAA,MAAMC,IAAI,GAAG,IAAI,CAACV,UAAU;AAC5B,MAAA,IAAIU,IAAI,KACJA,IAAI,CAACC,OAAO,EAAE,KAAKJ,MAAM,CAACI,OAAO,EAAE,IAChCD,IAAI,CAACE,SAAS,EAAE,KAAKL,MAAM,CAACK,SAAS,EAAE,IACvCF,IAAI,CAACG,QAAQ,EAAE,KAAKN,MAAM,CAACM,QAAQ,EAAE,IACrCH,IAAI,CAACI,SAAS,EAAE,KAAKP,MAAM,CAACO,SAAS,EAAE,IACvCJ,IAAI,CAACK,QAAQ,EAAE,KAAKR,MAAM,CAACQ,QAAQ,EAAE,IACrCL,IAAI,CAACM,eAAe,EAAE,KAAKT,MAAM,CAACS,eAAe,EAAE,CAAC,EAC3D;QACI,OAAO,IAAIP,sBAAsB,EAAE;AACvC,MAAA;AAEA,MAAA,IAAIQ,KAAK,GAAG,IAAI,CAACnB,QAAQ,CAACoB,MAAM;AAChC,MAAA,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAG,IAAI,CAACrB,QAAQ,CAACoB,MAAM,EAAEC,CAAC,EAAE,EAC7C;QACI,IAAI,CAAC,IAAI,CAACrB,QAAQ,CAACqB,CAAC,CAAC,CAACX,OAAO,EAAE,EAC/B;AACIS,UAAAA,KAAK,GAAGE,CAAC;AACT,UAAA;AACJ,QAAA;AACJ,MAAA;AACA,MAAA,IAAIF,KAAK,KAAK,IAAI,CAACnB,QAAQ,CAACoB,MAAM,EAAE,IAAI,CAACpB,QAAQ,CAACsB,IAAI,CAAC,IAAIC,UAAU,EAAE,CAAC;AAExE,MAAA,MAAMC,OAAO,GAAG,IAAI,CAACxB,QAAQ,CAACmB,KAAK,CAAC;AACpCK,MAAAA,OAAO,CAACC,0BAA0B,CAAChB,MAAM,CAAC;AAC1Ce,MAAAA,OAAO,CAACE,UAAU,EAAE,CAACC,GAAG,CAAClB,MAAM,CAACiB,UAAU,EAAE,CAAC;AAE7C,MAAA,IAAI,CAACxB,UAAU,GAAG,IAAI0B,gBAAgB,CAAC;AACnCtC,QAAAA,IAAI,EAAEmB,MAAM,CAACI,OAAO,EAAE;AACtBgB,QAAAA,MAAM,EAAEpB,MAAM,CAACK,SAAS,EAAE;AAC1BgB,QAAAA,KAAK,EAAErB,MAAM,CAACM,QAAQ,EAAE;AACxBgB,QAAAA,MAAM,EAAEtB,MAAM,CAACO,SAAS,EAAE;AAC1BgB,QAAAA,KAAK,EAAEvB,MAAM,CAACQ,QAAQ,EAAE;AACxBgB,QAAAA,QAAQ,EAAExB,MAAM,CAACS,eAAe,EAAE;AAClCgB,QAAAA,SAAS,EAAEC,IAAI,CAACC,IAAI,CAAC,IAAI,CAACpC,QAAQ,CAACoB,MAAM,GAAG,IAAI,CAAChB,SAAS,CAAC,GAAG,IAAI,CAACA;AACvE,OAAC,CAAC;AAEF,MAAA,IAAI,CAAC,SAAS,IAAI,CAAC;MACnB,KAAK,MAAMiC,QAAQ,IAAI,IAAI,CAAC,UAAU,EAAEA,QAAQ,CAAC,IAAI,CAAC;AACtD,MAAA,OAAO,IAAI1B,sBAAsB,CAAC,IAAI,EAAEQ,KAAK,CAAC;AAClD,IAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;IACImB,aAAaA,CAACnB,KAAK,EACnB;MACI,IAAIA,KAAK,IAAI,CAAC,IAAIA,KAAK,GAAG,IAAI,CAACnB,QAAQ,CAACoB,MAAM,EAC9C;QACI,IAAI,CAACpB,QAAQ,CAACmB,KAAK,CAAC,GAAG,IAAII,UAAU,EAAE;AACvC,QAAA,IAAI,CAAC,SAAS,IAAI,CAAC;QACnB,KAAK,MAAMc,QAAQ,IAAI,IAAI,CAAC,UAAU,EAAEA,QAAQ,CAAC,IAAI,CAAC;AAC1D,MAAA;AACJ,IAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;IACIE,eAAeA,CAACF,QAAQ,EACxB;AACI,MAAA,IAAI,CAAC,UAAU,CAACf,IAAI,CAACe,QAAQ,CAAC;AAC9B,MAAA,OAAO,MACP;QACI,MAAMG,EAAE,GAAG,IAAI,CAAC,UAAU,CAACC,OAAO,CAACJ,QAAQ,CAAC;AAC5C,QAAA,IAAIG,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,UAAU,CAACE,MAAM,CAACF,EAAE,EAAE,CAAC,CAAC;MAChD,CAAC;AACL,IAAA;;AAEA;IACAG,UAAUA,CAACxB,KAAK,EAChB;AACI,MAAA,MAAMK,OAAO,GAAG,IAAI,CAACxB,QAAQ,CAACmB,KAAK,CAAC;MACpC,OAAOK,OAAO,IAAIA,OAAO,CAACd,OAAO,EAAE,GAAGc,OAAO,GAAG,IAAI;AACxD,IAAA;;AAEA;AACJ;AACA;AACA;AACIoB,IAAAA,eAAeA,GACf;AACI,MAAA,OAAO,IAAI,CAAC5C,QAAQ,CAACoB,MAAM;AAC/B,IAAA;;AAEA;AACAyB,IAAAA,aAAaA,GACb;MACI,OAAO,IAAI,CAAC3C,UAAU;AAC1B,IAAA;;AAEA;AACAa,IAAAA,QAAQA,GACR;AACI,MAAA,OAAO,IAAI,CAACb,UAAU,GAAG,IAAI,CAACA,UAAU,CAACa,QAAQ,EAAE,GAAG,CAAC;AAC3D,IAAA;;AAEA;AACAC,IAAAA,SAASA,GACT;AACI,MAAA,OAAO,IAAI,CAACd,UAAU,GAAG,IAAI,CAACA,UAAU,CAACc,SAAS,EAAE,GAAG,CAAC;AAC5D,IAAA;;AAEA;AACA8B,IAAAA,YAAYA,GACZ;AACI,MAAA,OAAO,IAAI,CAAC5C,UAAU,GAAG,IAAI,CAACA,UAAU,CAAC4C,YAAY,EAAE,GAAG,CAAC;AAC/D,IAAA;;AAEA;AACAhC,IAAAA,SAASA,GACT;AACI,MAAA,OAAO,IAAI,CAACZ,UAAU,GAAG,IAAI,CAACA,UAAU,CAACY,SAAS,EAAE,GAAG,IAAI;AAC/D,IAAA;;AAEA;AACAiC,IAAAA,WAAWA,GACX;AACI,MAAA,OAAO,IAAI,CAAC7C,UAAU,GAAG,IAAI,CAACA,UAAU,CAACgB,eAAe,EAAE,GAAG,CAAC;AAClE,IAAA;;AAEA;AACA8B,IAAAA,WAAWA,GACX;MACI,OAAO,IAAI,CAAC,SAAS;AACzB,IAAA;GAMH;AAJUC,EAAAA,WAAW,GAAGA,WAAW;AAEzBC,EAAAA,WAAW,GAAGA,WAAW;EAACC,WAAAA,GAAA;IAAA,KAAA,CAAAnF,gBAAA,GAAAoB,UAAA,EAAA;AAAA,EAAA;AAAA,CAAA,EAAA;;;;"}