@carbonenginejs/runtime 0.1.0-alpha.0 → 0.1.0-alpha.1

package/dist/trinity/core/{Tr2GpuResourcePool.js → Tr2GpuResourcePool/Tr2GpuResourcePool.js}

@@ -1,12 +1,28 @@
-import { Tr2BitmapDimensions } from '../../trinityal/Tr2BitmapDimensions.js';
-import '../../trinityal/Tr2DrawUPHelper.js';
-import '../../global/consts/renderContext/formats.js';
-import '../../global/consts/renderContext/pipeline.js';
-import '../../trinityal/Tr2ResourceSetAL.js';
-import { Tr2BufferALStub } from '../../trinityal/stub/Tr2BufferALStub.js';
-import '../../trinityal/stub/Tr2RenderContextALStub.js';
-import '#consts/render-context';
-import { Tr2TextureALStub } from '../../trinityal/stub/Tr2TextureALStub.js';
+import { Tr2BitmapDimensions } from '../../../trinityal/Tr2BitmapDimensions.js';
+import '../../../global/consts/renderContext/formats.js';
+import '../../../global/consts/renderContext/pipeline.js';
+import '../../../trinityal/Tr2DeviceResourceAL/Tr2BaseDeviceResourceAL.js';
+import '../../../trinityal/Tr2DrawUPHelper.js';
+import '../../../trinityal/Tr2ResourceSetAL/Tr2RegisterMapAL.js';
+import '../../../trinityal/Tr2ResourceSetAL/Tr2ResourceSetDescriptionAL.js';
+import '../../../trinityal/Tr2ResourceSetAL/Tr2ResourceSetAL.js';
+import '../../../trinityal/Tr2ResourceSetAL/Tr2ResourceSetALStub.js';
+import '../../../trinityal/stub/Tr2BufferALStub.js';
+import '../../../trinityal/stub/Tr2CapsALStub.js';
+import '../../../trinityal/stub/Tr2ConstantBufferALStub.js';
+import '../../../trinityal/stub/Tr2FenceALStub.js';
+import '../../../trinityal/stub/Tr2OcclusionQueryALStub.js';
+import '../../../trinityal/stub/Tr2GpuTimerALStub.js';
+import '../../../trinityal/stub/Tr2PipelineStatsQueryALStub/Tr2PipelineStatsQueryALStub.js';
+import '../../../trinityal/stub/Tr2RenderContextALStub/Tr2RenderContextALStub.js';
+import '../../../trinityal/stub/Tr2SamplerStateALStub.js';
+import '../../../trinityal/stub/Tr2ShaderALStub.js';
+import '../../../trinityal/stub/Tr2ShaderProgramALStub.js';
+import '../../../trinityal/stub/Tr2SwapChainALStub.js';
+import '../../../trinityal/stub/Tr2TextureALStub.js';
+import '../../../trinityal/stub/Tr2VertexLayoutALStub.js';
+import '../../../trinityal/stub/Tr2VideoAdapterInfoStub.js';
+import { GpuResourceHandle } from './GpuResourceHandle.js';
 
 // Source: trinity/trinity/Tr2GpuResourcePool.h
 // Source: trinity/trinity/Tr2GpuResourcePool.cpp
@@ -36,140 +52,14 @@ import { Tr2TextureALStub } from '../../trinityal/stub/Tr2TextureALStub.js';
 // walks outward. That is how a scene-local pool shares the global one's
 // resources without owning them.
 
+
+/** Throws a resource-pool error with the supplied diagnostic. */
 function fail(message) {
   const error = new Error(`Tr2GpuResourcePool: ${message}`);
   error.code = "CJS_GPU_POOL_INVALID";
   throw error;
 }
 
-/**
- * A width and height, with Carbon's scaling and comparison.
- */
-class TextureSize2D {
-  /** Width in pixels. */
-  width = 0;
-
-  /** Height in pixels. */
-  height = 0;
-
-  /**
-   * @param {number|object} [widthOrDimensions] A width, or a `Tr2BitmapDimensions`.
-   * @param {number} [height] The height, when a width was given.
-   */
-  constructor(widthOrDimensions = 0, height = 0) {
-    if (widthOrDimensions && typeof widthOrDimensions === "object") {
-      this.width = widthOrDimensions.GetWidth();
-      this.height = widthOrDimensions.GetHeight();
-      return;
-    }
-    this.width = widthOrDimensions;
-    this.height = height;
-  }
-
-  /**
-   * Whether two sizes match.
-   *
-   * @param {TextureSize2D} other The size to compare with.
-   * @returns {boolean} True when they match.
-   */
-  Equals(other) {
-    return !!other && this.width === other.width && this.height === other.height;
-  }
-
-  /**
-   * This size scaled, never below one pixel in either direction.
-   *
-   * Carbon clamps to one (`h:TextureSize2D::operator*`), because a half-size
-   * chain reaches zero before it reaches one and a zero-sized target is not a
-   * target.
-   *
-   * @param {number} scale The factor.
-   * @returns {TextureSize2D} The scaled size.
-   */
-  Scaled(scale) {
-    return new TextureSize2D(Math.max(1, Math.trunc(this.width * scale)), Math.max(1, Math.trunc(this.height * scale)));
-  }
-}
-
-/**
- * A borrowed pool resource.
- *
- * CARBON RELEASES ON DESTRUCTION AND JAVASCRIPT CANNOT. Its handle decrements a
- * lock count in its destructor, so a resource returns to the pool when the last
- * holder goes out of scope. There is no such moment here, so `Release` is
- * explicit and a handle that is never released pins its resource forever -
- * which is a leak, not a crash, and therefore worth being loud about. The pool
- * reports held resources so a caller can assert.
- *
- * THE VERB IS `Free`, AND THE POOL OWNS IT. Settled 2026-09-05 with
- * `cjs-carbon-verbs`, after two wrong turns worth recording:
- *
- * - `Destroy` is wrong. It means GONE NOW - the pure virtual on
- *   `Tr2BaseDeviceResourceAL` (`trinityal/Tr2DeviceResourceAL.h:30`), used on
- *   35 Carbon classes. A pooled resource is not destroyed; it goes back and is
- *   handed out again. `ClearUnusedResources` below is where `Destroy` is
- *   right, and where it is used.
- * - `Release` is not engine vocabulary. Bare `Release` appears ONLY in
- *   Carbon's mesh viewer and video player, as Vulkan idiom. Trinity uses only
- *   the qualified forms - `ReleaseLater`, `ReleaseDeviceResources`.
- *
- * `Free` is shared engine vocabulary on six Carbon classes - `FreeList`,
- * `Tr2VirtualAllocator`, `Tr2SuballocatedBuffer` and three descriptor-heap
- * allocators - and EVERY ONE IS AN ALLOCATOR OR POOL. The direction is theirs
- * too: `Tr2VirtualAllocator::Free( allocation )` and
- * `Tr2SuballocatedBuffer::Free( allocation& )` put the verb on the allocator,
- * not on the thing lent. So `pool.Free(handle)`, not `handle.Release()`.
- *
- * Carbon's handle has no named method at all - the work is in
- * `~GpuResourceHandle`. That absence is C++ not needing a name, and reading it
- * as a prohibition is how this briefly became a coined `ReleaseToPool`.
- */
-class GpuResourceHandle {
-  #record = null;
-
-  /**
-   * @param {object} [record] The pool record this handle locks.
-   */
-  constructor(record = null) {
-    this.#record = record;
-    if (record) record.lockCount += 1;
-  }
-
-  /**
-   * The resource itself.
-   *
-   * @returns {object|null} The resource, or null once released.
-   */
-  Get() {
-    return this.#record?.resource ?? null;
-  }
-
-  /** @returns {boolean} Whether this handle still holds a resource. */
-  IsValid() {
-    return this.#record !== null;
-  }
-
-  /** @returns {string} The resource's debug name. */
-  GetName() {
-    return this.#record?.name ?? "";
-  }
-
-  /**
-   * Drops this handle's claim. Called by `Tr2GpuResourcePool.Free`.
-   *
-   * Freeing twice is a caller error rather than a silent no-op: it means the
-   * lock count no longer describes who is holding what.
-   *
-   * @returns {boolean} Whether a claim was dropped.
-   */
-  Detach() {
-    if (!this.#record) fail("a handle freed twice");
-    this.#record.lockCount -= 1;
-    this.#record = null;
-    return true;
-  }
-}
-
 /**
  * Pooled scratch textures and buffers.
  */
@@ -232,7 +122,9 @@ class Tr2GpuResourcePool {
    * not.
    *
    * @param {string} name A debug name.
-   * @param {object} description `{ width, height, format, gpuUsage }`.
+   * @param {object} description A `Tr2BitmapDimensions` shape (`type`, `width`,
+   *   `height`, `depth`, `mipCount`, `format`) plus `gpuUsage`, `cpuUsage`,
+   *   `msaa` and `initialData`.
    * @returns {GpuResourceHandle} The borrowed texture.
    */
   GetTempTexture(name, description) {
@@ -243,7 +135,7 @@ class Tr2GpuResourcePool {
    * Borrows a persistent texture, initializing it the first time only.
    *
    * @param {string} name A debug name.
-   * @param {object} description `{ width, height, format, gpuUsage }`.
+   * @param {object} description As `GetTempTexture`.
    * @param {Function} [initialize] Called once, with the new texture.
    * @returns {GpuResourceHandle} The texture.
    */
@@ -348,7 +240,6 @@ class Tr2GpuResourcePool {
   /** Splits the pool's flat description into the AL's two arguments. */
   #CreateTexture(description) {
     if (!this.#renderContext) fail("a pool creates against a render context; none is bound");
-    const texture = new Tr2TextureALStub();
     const {
       gpuUsage,
       cpuUsage,
@@ -356,36 +247,57 @@ class Tr2GpuResourcePool {
       initialData,
       ...dimensions
     } = description;
-    texture.Create(new Tr2BitmapDimensions(dimensions), {
+
+    // THE CONTEXT IS THE FACTORY. This used to be `new Tr2TextureALStub()`,
+    // which named the backend at authoring time: every texture the pool handed
+    // out was a stub no matter which backend was bound, so a WebGPU pass would
+    // have been handed textures that reach no device and drawn nothing, with
+    // no error anywhere. Tr2Blitter's head comment names this exact defect.
+    //
+    // 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), {
       gpuUsage,
       cpuUsage,
       msaa,
       initialData
-    }, this.#renderContext);
-    return texture;
+    });
   }
+
+  /**
+   * Creates a stub buffer from the description against the pool's render
+   * context.
+   */
   #CreateBuffer(description) {
     if (!this.#renderContext) fail("a pool creates against a render context; none is bound");
-    const buffer = new Tr2BufferALStub();
 
-    // THREE arguments. The context went into `initialData` here, leaving
-    // `renderContext` undefined, so the first line of Create that touched it
-    // threw a TypeError - which is why neither buffer accessor had ever run.
-    // The texture path two methods up passes all three correctly.
-    buffer.Create(description, null, this.#renderContext);
-    return buffer;
+    // Through the context for the same reason as the texture above. The
+    // previous form also passed the context as `initialData`, leaving
+    // renderContext undefined and throwing a TypeError on the first line of
+    // Create that touched it - which is why neither buffer accessor had ever
+    // run. Both faults go together.
+    return this.#renderContext.CreateBuffer(description, null);
   }
+
+  /**
+   * Borrows a matching free resource from this pool or its outer pool,
+   * allocating when necessary.
+   */
   #Borrow(list, name, description, create) {
     const free = this.#Find(list, name, description, true);
     if (free) return new GpuResourceHandle(free);
     if (this.#outer) return this.#outer.#Borrow(list === this.#tempTextures ? this.#outer.#tempTextures : this.#outer.#tempBuffers, name, description, create);
     return new GpuResourceHandle(this.#Add(list, name, description, create()));
   }
+
+  /** Finds a matching pool record and updates its last-access frame. */
   #Find(list, name, description, freeOnly) {
     const match = list.find(record => record.name === name && SameDescription(record.description, description) && (!freeOnly || record.lockCount === 0));
     if (match) match.lastAccessFrame = this.#frame;
     return match ?? null;
   }
+
+  /** Adds an unlocked resource record stamped with the current frame. */
   #Add(list, name, description, resource) {
     const record = {
       resource,
@@ -419,5 +331,5 @@ function GetGlobalGpuResourcePool() {
   return globalPool;
 }
 
-export { GetGlobalGpuResourcePool, GpuResourceHandle, TextureSize2D, Tr2GpuResourcePool };
+export { GetGlobalGpuResourcePool, Tr2GpuResourcePool, fail };
 //# sourceMappingURL=Tr2GpuResourcePool.js.map

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

@@ -0,0 +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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"}

package/dist/trinity/core/{Tr2QuadRenderer.js → Tr2QuadRenderer/Tr2QuadRenderer.js}

@@ -1,38 +1,16 @@
-import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
+import { Tr2QuadRendererEffectRecord } from './Tr2QuadRendererEffectRecord.js';
 import { type, carbon, impl } from '#schema';
 import { CjsModel } from '#model';
-import { Tr2RenderBatch } from './batch/Tr2RenderBatch.js';
+import { Tr2RenderBatch } from '../batch/TriRenderBatch/Tr2RenderBatch.js';
+import '../batch/TriRenderBatch/DefaultKeyGenerator.js';
+import '../batch/TriRenderBatch/EffectKeyGenerator.js';
+import '../batch/TriRenderBatch/ITriRenderBatchAccumulator.js';
 import { TriBatchType } from '#consts/graphics';
+import '#consts/render-context';
 
 let _initProto, _initClass, _init_vertexBufferOffset, _init_extra_vertexBufferOffset, _init_lastInstanceDataSize, _init_extra_lastInstanceDataSize, _init_bufferAlignment, _init_extra_bufferAlignment, _init_bufferSize, _init_extra_bufferSize;
 
-/** One registered quad effect (Carbon Tr2QuadRenderer::EffectRecord). */
-class Tr2QuadRendererEffectRecord {
-  effect = null;
-  batchType = 0;
-
-  /** Size of one instance vertex in BYTES. */
-  instanceSize = 0;
-
-  /** Number of quads to render per instance. */
-  quadCount = 0;
-
-  /** Vertex definition (engine resolves the declaration handle from it). */
-  definition = null;
-
-  /** Byte offset of this record's instances in the merged buffer. */
-  bufferOffset = 0;
-
-  /** Number of instances merged this frame. */
-  count = 0;
-
-  /** Per-frame accumulation (Carbon's per-thread TLS collapses to one list). */
-  pending = [];
-
-  /** Bytes accumulated in pending. */
-  addedSize = 0;
-}
-
 /** Collects quads from every registered effect into one merged instance buffer and emits them as batches. */
 let _Tr2QuadRenderer;
 new class extends _identity {
@@ -270,5 +248,5 @@ new class extends _identity {
   }
 }();
 
-export { _Tr2QuadRenderer as Tr2QuadRenderer, Tr2QuadRendererEffectRecord };
+export { _Tr2QuadRenderer as Tr2QuadRenderer };
 //# sourceMappingURL=Tr2QuadRenderer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2QuadRenderer.js","sources":["../../../../../src/trinity/core/Tr2QuadRenderer/Tr2QuadRenderer.js"],"sourcesContent":["// Source: trinity/trinity/Tr2QuadRenderer.h\n//   trinity/trinity/Tr2QuadRenderer.cpp\r\n// Hand-maintained from Carbon source, promoted out of generated intake.\r\n// CPU half implemented 2026-07-23 (batch-plan P5 scene-global quad collector).\r\n// The generator had flattened the internal EffectRecord/PerThreadData members\r\n// onto the class; corrected to Carbon's nested shape. GPU realization (quad\r\n// vertex/index buffers, ring instance buffer upload, vertex-declaration\r\n// handles) is engine-owned and reads the merged CPU state emitted here.\r\nimport { Tr2QuadRendererEffectRecord } from \"./Tr2QuadRendererEffectRecord.js\";\r\nimport { carbon, impl, type } from \"#schema\";\r\nimport { CjsModel } from \"#model\";\r\nimport { Tr2RenderBatch } from \"../batch/TriRenderBatch/index.js\";\r\nimport { TriBatchType } from \"#consts/graphics\";\r\n\r\n\r\n/** Collects quads from every registered effect into one merged instance buffer and emits them as batches. */\r\n@type.define({ className: \"Tr2QuadRenderer\", family: \"trinityCore\" })\r\nexport class Tr2QuadRenderer extends CjsModel\r\n{\r\n\r\n  /** m_vertexBufferOffset (uint32_t) - ring offset; engine stamps the real one. */\r\n  @type.uint32\r\n  vertexBufferOffset = 0;\r\n\r\n  /** m_lastInstanceDataSize (uint32_t) */\r\n  @type.uint32\r\n  lastInstanceDataSize = 0;\r\n\r\n  /** m_bufferAlignment (uint32_t) - lcm of registered instance sizes. */\r\n  @type.uint32\r\n  bufferAlignment = 4;\r\n\r\n  /** m_bufferSize - bytes accumulated this frame across all records. */\r\n  @type.uint32\r\n  bufferSize = 0;\r\n\r\n  /** m_effects - EffectKey -> Tr2QuadRendererEffectRecord. */\r\n  #effects = new Map();\r\n\r\n  /** The merged terminal CPU instance bytes for the frame. */\r\n  #mergedData = null;\r\n\r\n  /** Largest quadCount among records with instances (RecreateQuadBuffers input). */\r\n  #maxQuadCount = 0;\r\n\r\n  /**\r\n   * Registers a quad effect once per key (Carbon Tr2QuadRenderer.cpp:30-53).\r\n   * instanceSize is in bytes; the buffer alignment grows to the lcm of all\r\n   * registered instance sizes.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  RegisterEffect(key, batchType, instanceSize, quadCount, definition, effect)\r\n  {\r\n    if (this.#effects.has(key))\r\n    {\r\n      return;\r\n    }\r\n    const record = new Tr2QuadRendererEffectRecord();\r\n    record.effect = effect ?? null;\r\n    record.batchType = batchType;\r\n    record.instanceSize = instanceSize >>> 0;\r\n    record.quadCount = quadCount >>> 0;\r\n    record.definition = definition ?? null;\r\n    this.#effects.set(key, record);\r\n    this.bufferAlignment = Tr2QuadRenderer.#Lcm(this.bufferAlignment, record.instanceSize || 1);\r\n  }\r\n\r\n  /**\r\n   * Drops a registered effect and the quads accumulated for it.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  UnregisterEffect(key)\r\n  {\r\n    this.#effects.delete(key);\r\n  }\r\n\r\n  /**\r\n   * Accumulates instance data for a registered effect (Carbon cpp:60-79).\r\n   * Accepts terminal byte views or legacy float32-compatible number arrays\r\n   * covering count * instanceSize bytes; unknown keys are ignored like Carbon.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  @impl.reason(\"Single-threaded JS collapses the per-thread TLS buffers to one pending list while preserving Carbon's raw memcpy byte boundary.\")\r\n  AddQuads(effectKey, sprites, count = 1)\r\n  {\r\n    const record = this.#effects.get(effectKey);\r\n    if (!record)\r\n    {\r\n      return;\r\n    }\r\n\r\n    const size = count * record.instanceSize;\r\n    if (!size)\r\n    {\r\n      return;\r\n    }\r\n\r\n    const bytes = Tr2QuadRenderer.#CopyInstanceBytes(sprites, size);\r\n    record.pending.push(bytes);\r\n    record.addedSize += size;\r\n    this.bufferSize += size;\r\n  }\r\n\r\n  /**\r\n   * Concatenates every record's pending instances into one aligned CPU\r\n   * buffer, stamping per-record bufferOffset/count (Carbon cpp:81-115).\r\n   * Returns the largest quadCount among live records.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  MergeBuffers()\r\n  {\r\n    let padded = this.bufferSize;\r\n    for (const record of this.#effects.values())\r\n    {\r\n      padded += record.instanceSize;\r\n    }\r\n    const merged = new Uint8Array(padded);\r\n    let offset = 0;\r\n    let quadCount = 0;\r\n    for (const record of this.#effects.values())\r\n    {\r\n      offset = Tr2QuadRenderer.#Align(offset, record.instanceSize || 1);\r\n      record.bufferOffset = offset;\r\n      for (const chunk of record.pending)\r\n      {\r\n        merged.set(chunk, offset);\r\n        offset += chunk.byteLength;\r\n      }\r\n      record.pending.length = 0;\r\n      record.addedSize = 0;\r\n      record.count = record.instanceSize ? (offset - record.bufferOffset) / record.instanceSize : 0;\r\n      if (record.count)\r\n      {\r\n        quadCount = Math.max(quadCount, record.quadCount);\r\n      }\r\n    }\r\n    this.#mergedData = merged;\r\n    this.#maxQuadCount = quadCount;\r\n    return quadCount;\r\n  }\r\n\r\n  /**\r\n   * Frame-start CPU work (Carbon cpp:160-166): merge the accumulated\r\n   * instances. Buffer upload and quad-buffer creation are engine-owned;\r\n   * the engine reads GetMergedData()/GetMaxQuadCount() and stamps\r\n   * vertexBufferOffset with the ring allocation.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  @impl.reason(\"UpdateInstanceBuffer/RecreateQuadBuffers/PrepareResources are GPU realization; the merged CPU state is exposed for the engine.\")\r\n  BeginRendering(_renderContext = null)\r\n  {\r\n    const quadCount = this.MergeBuffers();\r\n    this.lastInstanceDataSize = this.bufferSize;\r\n    return quadCount;\r\n  }\r\n\r\n  /** Frame-end reset (Carbon cpp:55-58). */\r\n  @carbon.method\r\n  @impl.implemented\r\n  DoneRendering(_renderContext = null)\r\n  {\r\n    this.bufferSize = 0;\r\n  }\r\n\r\n  /**\r\n   * Emits one instanced batch per live record of the requested type\r\n   * (Carbon cpp:188-207). The quad vertex/index buffers are shared engine\r\n   * resources, carried as descriptors on the batch; startInstanceLocation\r\n   * derives from the ring offset + record offset exactly like Carbon.\r\n   * Returns whether any batch was committed (JS convention).\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  @impl.reason(\"Quad and ring buffers become deferred descriptors the engine realizes; Carbon binds live AL buffers here.\")\r\n  GetBatches(batchType, accumulator)\r\n  {\r\n    let committed = false;\r\n    for (const record of this.#effects.values())\r\n    {\r\n      if (!record.count || record.batchType !== batchType)\r\n      {\r\n        continue;\r\n      }\r\n      const batch = accumulator.Allocate(Tr2RenderBatch);\r\n      batch.SetMaterial(record.effect);\r\n      batch.SetGeometry(record.definition, Tr2QuadRenderer.QuadVertexSource, 4, Tr2QuadRenderer.QuadIndexSource, 2);\r\n      batch.SetStreamSource(1, {\r\n        quadInstanceData: this.#mergedData,\r\n        byteOffset: record.bufferOffset,\r\n        instanceSize: record.instanceSize\r\n      }, record.instanceSize);\r\n      batch.SetDrawIndexedInstanced(\r\n        6 * record.quadCount,\r\n        record.count,\r\n        0,\r\n        0,\r\n        record.instanceSize ? (this.vertexBufferOffset + record.bufferOffset) / record.instanceSize : 0\r\n      );\r\n      committed = accumulator.Commit(batch) || committed;\r\n    }\r\n    return committed;\r\n  }\r\n\r\n  /**\r\n   * The per-instance byte size an engine allocates for a registered effect.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetInstanceDataSize()\r\n  {\r\n    return this.lastInstanceDataSize;\r\n  }\r\n\r\n  /** The frame's merged CPU instance buffer for the engine uploader. */\r\n  GetMergedData()\r\n  {\r\n    return this.#mergedData;\r\n  }\r\n\r\n  /** The largest quadCount among live records (quad IB sizing). */\r\n  GetMaxQuadCount()\r\n  {\r\n    return this.#maxQuadCount;\r\n  }\r\n\r\n  /** The registered effect records (engine declaration resolution). */\r\n  GetEffectRecords()\r\n  {\r\n    return this.#effects;\r\n  }\r\n\r\n  /** Carbon Tr2QuadRenderer::Instance - the scene-global singleton. */\r\n  static Instance()\r\n  {\r\n    if (!Tr2QuadRenderer.#instance)\r\n    {\r\n      Tr2QuadRenderer.#instance = new Tr2QuadRenderer();\r\n    }\r\n    return Tr2QuadRenderer.#instance;\r\n  }\r\n\r\n  /**\r\n   * Rounds an offset up to the next multiple of an alignment.\r\n   */\r\n  static #Align(offset, alignment)\r\n  {\r\n    return Math.ceil(offset / alignment) * alignment;\r\n  }\r\n\r\n  /**\r\n   * The lowest common multiple of two sizes, used to align a shared instance stride.\r\n   */\r\n  static #Lcm(a, b)\r\n  {\r\n    const gcd = (x, y) => (y ? gcd(y, x % y) : x);\r\n    return (a * b) / gcd(a, b);\r\n  }\r\n\r\n  /** Copies one AddQuads input as the exact bytes Carbon memcpy would receive. */\r\n  static #CopyInstanceBytes(source, size)\r\n  {\r\n    let bytes;\r\n\r\n    if (ArrayBuffer.isView(source))\r\n    {\r\n      bytes = new Uint8Array(source.buffer, source.byteOffset, source.byteLength);\r\n    }\r\n    else if (source instanceof ArrayBuffer)\r\n    {\r\n      bytes = new Uint8Array(source);\r\n    }\r\n    else if (Array.isArray(source))\r\n    {\r\n      const floats = Float32Array.from(source);\r\n      bytes = new Uint8Array(floats.buffer, floats.byteOffset, floats.byteLength);\r\n    }\r\n    else\r\n    {\r\n      throw new TypeError(\"Tr2QuadRenderer.AddQuads requires terminal bytes or float32-compatible numeric data.\");\r\n    }\r\n\r\n    if (bytes.byteLength < size)\r\n    {\r\n      throw new RangeError(`Tr2QuadRenderer.AddQuads expected ${size} bytes, received ${bytes.byteLength}.`);\r\n    }\r\n\r\n    return bytes.slice(0, size);\r\n  }\r\n\r\n  static #instance = null;\r\n\r\n  /** Deferred descriptor for the engine-owned shared quad vertex buffer. */\r\n  static QuadVertexSource = Object.freeze({ quadRendererBuffer: \"quad-vertices\" });\r\n\r\n  /** Deferred descriptor for the engine-owned shared quad index buffer. */\r\n  static QuadIndexSource = Object.freeze({ quadRendererBuffer: \"quad-indices\" });\r\n\r\n  static TriBatchType = TriBatchType;\r\n\r\n}\r\n"],"names":["_Tr2QuadRenderer","_identity","Tr2QuadRenderer","CjsModel","e","_init_vertexBufferOffset","_init_extra_vertexBufferOffset","_init_lastInstanceDataSize","_init_extra_lastInstanceDataSize","_init_bufferAlignment","_init_extra_bufferAlignment","_init_bufferSize","_init_extra_bufferSize","_initProto","c","_initClass","_applyDecs","type","define","className","family","uint32","carbon","method","impl","implemented","adapted","reason","vertexBufferOffset","lastInstanceDataSize","bufferAlignment","bufferSize","Map","RegisterEffect","key","batchType","instanceSize","quadCount","definition","effect","has","record","Tr2QuadRendererEffectRecord","set","UnregisterEffect","delete","AddQuads","effectKey","sprites","count","get","size","bytes","pending","push","addedSize","MergeBuffers","padded","values","merged","Uint8Array","offset","bufferOffset","chunk","byteLength","length","Math","max","BeginRendering","_renderContext","DoneRendering","GetBatches","accumulator","committed","batch","Allocate","Tr2RenderBatch","SetMaterial","SetGeometry","QuadVertexSource","QuadIndexSource","SetStreamSource","quadInstanceData","byteOffset","SetDrawIndexedInstanced","Commit","GetInstanceDataSize","GetMergedData","GetMaxQuadCount","GetEffectRecords","Instance","#Align","alignment","ceil","#Lcm","a","b","gcd","x","y","#CopyInstanceBytes","source","ArrayBuffer","isView","buffer","Array","isArray","floats","Float32Array","from","TypeError","RangeError","slice","Object","freeze","quadRendererBuffer","TriBatchType","constructor"],"mappings":"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"}

package/dist/trinity/core/Tr2QuadRenderer/Tr2QuadRendererEffectRecord.js

@@ -0,0 +1,38 @@
+// Source: trinity/trinity/Tr2QuadRenderer.h
+//   trinity/trinity/Tr2QuadRenderer.cpp
+// Hand-maintained from Carbon source, promoted out of generated intake.
+// CPU half implemented 2026-07-23 (batch-plan P5 scene-global quad collector).
+// The generator had flattened the internal EffectRecord/PerThreadData members
+// onto the class; corrected to Carbon's nested shape. GPU realization (quad
+// vertex/index buffers, ring instance buffer upload, vertex-declaration
+// handles) is engine-owned and reads the merged CPU state emitted here.
+
+/** One registered quad effect (Carbon Tr2QuadRenderer::EffectRecord). */
+class Tr2QuadRendererEffectRecord {
+  effect = null;
+  batchType = 0;
+
+  /** Size of one instance vertex in BYTES. */
+  instanceSize = 0;
+
+  /** Number of quads to render per instance. */
+  quadCount = 0;
+
+  /** Vertex definition (engine resolves the declaration handle from it). */
+  definition = null;
+
+  /** Byte offset of this record's instances in the merged buffer. */
+  bufferOffset = 0;
+
+  /** Number of instances merged this frame. */
+  count = 0;
+
+  /** Per-frame accumulation (Carbon's per-thread TLS collapses to one list). */
+  pending = [];
+
+  /** Bytes accumulated in pending. */
+  addedSize = 0;
+}
+
+export { Tr2QuadRendererEffectRecord };
+//# sourceMappingURL=Tr2QuadRendererEffectRecord.js.map

package/dist/trinity/core/Tr2QuadRenderer/Tr2QuadRendererEffectRecord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2QuadRendererEffectRecord.js","sources":["../../../../../src/trinity/core/Tr2QuadRenderer/Tr2QuadRendererEffectRecord.js"],"sourcesContent":["// Source: trinity/trinity/Tr2QuadRenderer.h\r\n//   trinity/trinity/Tr2QuadRenderer.cpp\r\n// Hand-maintained from Carbon source, promoted out of generated intake.\r\n// CPU half implemented 2026-07-23 (batch-plan P5 scene-global quad collector).\r\n// The generator had flattened the internal EffectRecord/PerThreadData members\r\n// onto the class; corrected to Carbon's nested shape. GPU realization (quad\r\n// vertex/index buffers, ring instance buffer upload, vertex-declaration\r\n// handles) is engine-owned and reads the merged CPU state emitted here.\r\n\r\n\r\n/** One registered quad effect (Carbon Tr2QuadRenderer::EffectRecord). */\r\nexport class Tr2QuadRendererEffectRecord\r\n{\r\n\r\n  effect = null;\r\n\r\n  batchType = 0;\r\n\r\n  /** Size of one instance vertex in BYTES. */\r\n  instanceSize = 0;\r\n\r\n  /** Number of quads to render per instance. */\r\n  quadCount = 0;\r\n\r\n  /** Vertex definition (engine resolves the declaration handle from it). */\r\n  definition = null;\r\n\r\n  /** Byte offset of this record's instances in the merged buffer. */\r\n  bufferOffset = 0;\r\n\r\n  /** Number of instances merged this frame. */\r\n  count = 0;\r\n\r\n  /** Per-frame accumulation (Carbon's per-thread TLS collapses to one list). */\r\n  pending = [];\r\n\r\n  /** Bytes accumulated in pending. */\r\n  addedSize = 0;\r\n\r\n}\r\n"],"names":["Tr2QuadRendererEffectRecord","effect","batchType","instanceSize","quadCount","definition","bufferOffset","count","pending","addedSize"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACO,MAAMA,2BAA2B,CACxC;AAEEC,EAAAA,MAAM,GAAG,IAAI;AAEbC,EAAAA,SAAS,GAAG,CAAC;;AAEb;AACAC,EAAAA,YAAY,GAAG,CAAC;;AAEhB;AACAC,EAAAA,SAAS,GAAG,CAAC;;AAEb;AACAC,EAAAA,UAAU,GAAG,IAAI;;AAEjB;AACAC,EAAAA,YAAY,GAAG,CAAC;;AAEhB;AACAC,EAAAA,KAAK,GAAG,CAAC;;AAET;AACAC,EAAAA,OAAO,GAAG,EAAE;;AAEZ;AACAC,EAAAA,SAAS,GAAG,CAAC;AAEf;;;;"}

package/dist/trinity/core/Tr2RenderUtils.js

@@ -3,12 +3,29 @@ import { mat4 } from '#math/mat4';
 import { vec3 } from '#math/vec3';
 import { Failed } from '../../trinityal/ALResult.js';
 import '../../trinityal/Tr2BitmapDimensions.js';
-import '../../trinityal/Tr2DrawUPHelper.js';
 import '../../global/consts/renderContext/formats.js';
 import '../../global/consts/renderContext/pipeline.js';
-import '../../trinityal/Tr2ResourceSetAL.js';
+import '../../trinityal/Tr2DeviceResourceAL/Tr2BaseDeviceResourceAL.js';
+import '../../trinityal/Tr2DrawUPHelper.js';
+import '../../trinityal/Tr2ResourceSetAL/Tr2RegisterMapAL.js';
+import '../../trinityal/Tr2ResourceSetAL/Tr2ResourceSetDescriptionAL.js';
+import '../../trinityal/Tr2ResourceSetAL/Tr2ResourceSetAL.js';
+import '../../trinityal/Tr2ResourceSetAL/Tr2ResourceSetALStub.js';
+import '../../trinityal/stub/Tr2BufferALStub.js';
+import '../../trinityal/stub/Tr2CapsALStub.js';
 import { Tr2ConstantUsageAL } from '../../trinityal/stub/Tr2ConstantBufferALStub.js';
-import '../../trinityal/stub/Tr2RenderContextALStub.js';
+import '../../trinityal/stub/Tr2FenceALStub.js';
+import '../../trinityal/stub/Tr2OcclusionQueryALStub.js';
+import '../../trinityal/stub/Tr2GpuTimerALStub.js';
+import '../../trinityal/stub/Tr2PipelineStatsQueryALStub/Tr2PipelineStatsQueryALStub.js';
+import '../../trinityal/stub/Tr2RenderContextALStub/Tr2RenderContextALStub.js';
+import '../../trinityal/stub/Tr2SamplerStateALStub.js';
+import '../../trinityal/stub/Tr2ShaderALStub.js';
+import '../../trinityal/stub/Tr2ShaderProgramALStub.js';
+import '../../trinityal/stub/Tr2SwapChainALStub.js';
+import '../../trinityal/stub/Tr2TextureALStub.js';
+import '../../trinityal/stub/Tr2VertexLayoutALStub.js';
+import '../../trinityal/stub/Tr2VideoAdapterInfoStub.js';
 
 // Source: trinity/trinity/Tr2RenderUtils.h
 // Source: trinity/trinity/Tr2RenderUtils.cpp

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

@@ -1 +1 @@
-{"version":3,"file":"Tr2RenderUtils.js","sources":["../../../../src/trinity/core/Tr2RenderUtils.js"],"sourcesContent":["// Source: trinity/trinity/Tr2RenderUtils.h\n// Source: trinity/trinity/Tr2RenderUtils.cpp\n//\n// Freestanding helpers that need no private state. Carbon's own header explains\n// why the file exists: \"Most of this was TriDevice/Tr2Renderer but works just\n// fine with the public interfaces. So put those guys here to lighten up those\n// classes.\"\n//\n// THESE ARE TRINITY, NOT THE ABSTRACTION LAYER, and that is the whole reason\n// they were missing. `FillAndSetConstants` is the last hop of Carbon's\n// per-object upload - `Tr2PerObjectDataStandard::SetPerObjectDataToDevice`\n// calls it twice and does nothing else - and it lives in a Trinity header. It\n// went unported because \"the engine does device work\" was read as the\n// `trinityal/webgpu` package rather than the abstraction layer, so the upload was\n// reimplemented engine-side and this file never got written. See\n// /docs/research/graphics-path-review-2026-09-05.md.\n//\n// `SetupScreenQuad` and `SetupScreenQuadInCameraSpace` are here too. They feed\n// `Tr2Blitter`'s fullscreen-quad path, which is the single gate in front of\n// every remaining render step: TriStepRenderTexture, TriStepRenderAtlas and\n// `TriStepRenderEffect` all bottom out in `Tr2Renderer::DrawTexture` ->\n// `Tr2Blitter::Draw`.\nimport { ShaderType } from \"#consts/render-context\";\nimport { mat4 } from \"#math/mat4\";\nimport { vec3 } from \"#math/vec3\";\nimport { Tr2ConstantUsageAL } from \"../../trinityal/index.js\";\nimport { Failed } from \"../../trinityal/ALResult.js\";\n\n\n/**\n * Binds one constant buffer to every shader stage a mask names.\n *\n * Carbon `SetConstants` (`Tr2RenderUtils.cpp:126-137`). The loop clears each\n * bit as it goes and stops as soon as the mask is empty, so a single-stage\n * bind costs one iteration rather than six.\n *\n * @param {object} buffer A `Tr2ConstantBufferAL`.\n * @param {number} constantTypeMask A bit per `ShaderType`.\n * @param {number} registerIndex The constant-buffer register.\n * @param {object} renderContext The context to bind against.\n * @returns {number} How many stages were bound.\n */\nexport function SetConstants(buffer, constantTypeMask, registerIndex, renderContext)\n{\n  let mask = constantTypeMask >>> 0;\n  let bound = 0;\n\n  for (let stage = ShaderType.SHADER_TYPE_FIRST; stage !== ShaderType.SHADER_TYPE_COUNT && mask; stage += 1)\n  {\n    if (!(mask & (1 << stage))) continue;\n\n    renderContext.SetConstants(buffer, stage, registerIndex);\n    mask &= ~(1 << stage);\n    bound += 1;\n  }\n\n  return bound;\n}\n\n\n/**\n * Creates or grows a constant buffer, copies data into it, and binds it.\n *\n * Carbon `FillAndSetConstants` (`Tr2RenderUtils.cpp:100-124`), the repeating\n * pattern its own comment describes: create if needed, lock, copy, unlock, set.\n *\n * A ZERO MASK RETURNS SUCCESS AND BINDS NOTHING. That is Carbon's first line\n * and it is not a guard against bad input - it is how a payload declared for\n * stages a technique does not use gets skipped, per batch, without the caller\n * testing anything.\n *\n * THE COPY IS CLAMPED TO THE BUFFER, not to the data. Carbon writes\n * `min( dataSize, buffer.GetSize() )`, so a payload larger than the buffer\n * fills it and the tail is dropped rather than overrunning.\n *\n * @param {object} buffer A `Tr2ConstantBufferAL`, created here if it has to be.\n * @param {ArrayBufferView} data The bytes to upload.\n * @param {number} dataSize How many bytes of `data` to upload.\n * @param {number} constantTypeMask A bit per `ShaderType`.\n * @param {number} registerIndex The constant-buffer register.\n * @param {object} renderContext The context to upload and bind against.\n * @returns {boolean} Whether the data was uploaded and bound.\n */\nexport function FillAndSetConstants(buffer, data, dataSize, constantTypeMask, registerIndex, renderContext)\n{\n  if (!(constantTypeMask >>> 0)) return true;\n\n  if (!buffer.IsValid() || dataSize > buffer.GetSize())\n  {\n    if (Failed(buffer.Create(dataSize, Tr2ConstantUsageAL.REUSABLE, null, renderContext))) return false;\n  }\n\n  const { result, data: mapped } = buffer.Lock(renderContext);\n\n  if (Failed(result) || !mapped) return false;\n\n  const bytes = data instanceof Uint8Array\n    ? data\n    : new Uint8Array(data.buffer, data.byteOffset, data.byteLength);\n\n  mapped.set(bytes.subarray(0, Math.min(dataSize, buffer.GetSize())));\n\n  buffer.Unlock(renderContext);\n\n  SetConstants(buffer, constantTypeMask, registerIndex, renderContext);\n\n  return true;\n}\n\n\n// Carbon `Tr2ScreenVertex` (Tr2RenderUtils.h:13-17): a clip-space position and\n// one texture coordinate. Four of them make the blitter's triangle strip.\nexport const SCREEN_VERTEX_FLOATS = 6;\nexport const SCREEN_VERTEX_BYTES = SCREEN_VERTEX_FLOATS * 4;\nexport const SCREEN_QUAD_FLOATS = SCREEN_VERTEX_FLOATS * 4;\n\n\n/** Writes one Tr2ScreenVertex into a flat float array at vertex index `at`. */\nfunction writeScreenVertex(quad, at, x, y, z, w, u, v)\n{\n  const base = at * SCREEN_VERTEX_FLOATS;\n  quad[base] = x;\n  quad[base + 1] = y;\n  quad[base + 2] = z;\n  quad[base + 3] = w;\n  quad[base + 4] = u;\n  quad[base + 5] = v;\n}\n\n\n/**\n * Carbon's interior-edge flip (`Tr2RenderUtils.cpp:24-33` and `67-76`).\n *\n * The quad is emitted as a triangle strip, so which diagonal splits it decides\n * the winding of both triangles. Carbon swaps the two interior vertices when\n * the cull mode is NOT inverted, which is the ordinary case - so the common\n * path is the swapped one, not the literal 0/1/2/3 order the comments read as.\n *\n * @param {object} renderContext The context whose ESM holds the cull override.\n * @returns {Array<number>} The two interior vertex indices, in emission order.\n */\nfunction interiorEdges(renderContext)\n{\n  const esm = renderContext.GetEffectStateManager();\n\n  return esm.IsCullModeInverted() ? [ 1, 2 ] : [ 2, 1 ];\n}\n\n\n/**\n * Fills a four-vertex screen quad in clip space.\n *\n * Carbon `SetupScreenQuad` (`Tr2RenderUtils.cpp:11-50`). Vertex coordinates\n * arrive in [0,1] with y down, which is why y is negated on the way to clip\n * space; texture coordinates pass through untouched.\n *\n * ADAPTED: Carbon reaches for the main-thread render context through\n * `USE_MAIN_THREAD_RENDER_CONTEXT()` purely to read the cull mode, and its own\n * comment on that line asks for the context to be passed in instead\n * (`cpp:27`). We pass it in.\n *\n * @param {Float32Array} quad Destination, at least SCREEN_QUAD_FLOATS long.\n * @param {object} renderContext The context to read the cull mode from.\n * @param {Array<number>} tlTexCoord Top-left texture coordinate.\n * @param {Array<number>} brTexCoord Bottom-right texture coordinate.\n * @param {Array<number>} [tlVertexCoord] Top-left placement, [0,1], y down.\n * @param {Array<number>} [brVertexCoord] Bottom-right placement, [0,1], y down.\n * @returns {Float32Array} The quad that was written.\n */\nexport function SetupScreenQuad(quad, renderContext, tlTexCoord, brTexCoord, tlVertexCoord = [ 0, 0 ], brVertexCoord = [ 1, 1 ])\n{\n  const tlX = tlVertexCoord[0] * 2 - 1;\n  const tlY = -(tlVertexCoord[1] * 2 - 1);\n  const brX = brVertexCoord[0] * 2 - 1;\n  const brY = -(brVertexCoord[1] * 2 - 1);\n  const z = 1;\n  const w = 1;\n\n  const [ edge1, edge2 ] = interiorEdges(renderContext);\n\n  writeScreenVertex(quad, 0, tlX, tlY, z, w, tlTexCoord[0], tlTexCoord[1]);\n  writeScreenVertex(quad, edge1, brX, tlY, z, w, brTexCoord[0], tlTexCoord[1]);\n  writeScreenVertex(quad, edge2, tlX, brY, z, w, tlTexCoord[0], brTexCoord[1]);\n  writeScreenVertex(quad, 3, brX, brY, z, w, brTexCoord[0], brTexCoord[1]);\n\n  return quad;\n}\n\n\n/**\n * Fills a four-vertex screen quad in VIEW space, by unprojecting the clip-space\n * corners through the inverse of the raw projection.\n *\n * Carbon `SetupScreenQuadInCameraSpace` (`Tr2RenderUtils.cpp:52-95`). The\n * vertex shader is expected to push z into w, so the corners carry the\n * unprojected depth rather than a constant.\n *\n * ADAPTED, same reason as SetupScreenQuad: Carbon takes the projection from the\n * `Tr2Renderer` global and the cull mode from the main-thread context; both\n * come from the passed context here.\n *\n * @param {Float32Array} quad Destination, at least SCREEN_QUAD_FLOATS long.\n * @param {object} renderContext The context holding projection and cull mode.\n * @returns {Float32Array|null} The quad, or null with no projection set.\n */\nexport function SetupScreenQuadInCameraSpace(quad, renderContext)\n{\n  const projection = renderContext.GetProjection();\n  if (!projection) return null;\n\n  const proj2view = mat4.invert(mat4.create(), projection);\n  if (!proj2view) return null;\n\n  const tl = vec3.transformMat4(vec3.create(), [ -1, 1, 1 ], proj2view);\n  const br = vec3.transformMat4(vec3.create(), [ 1, -1, 1 ], proj2view);\n\n  const [ edge1, edge2 ] = interiorEdges(renderContext);\n\n  writeScreenVertex(quad, 0, tl[0], tl[1], tl[2], 1, 0, 0);\n  writeScreenVertex(quad, edge1, br[0], tl[1], tl[2], 1, 1, 0);\n  writeScreenVertex(quad, edge2, tl[0], br[1], tl[2], 1, 0, 1);\n  // tl[2] on all four, including this one (cpp:97). The unprojected corners\n  // share a depth, so br's own z is deliberately unused.\n  writeScreenVertex(quad, 3, br[0], br[1], tl[2], 1, 1, 1);\n\n  return quad;\n}\n\n\n/**\n * Corrects texture coordinates when the device viewport differs from the\n * authored one.\n *\n * Carbon `AdjustTextureCoordsToViewport` (`Tr2Renderer.cpp:267-290`), a\n * file-scope free function there and a free function here for the same reason:\n * it needs nothing but the two viewports.\n *\n * WHY IT EXISTS. The authored viewport is what the scene asked for; the device\n * viewport is that clipped to the render target. When they differ - a\n * sub-rectangle render, a target smaller than the request - a blit sampling\n * [0,1] would read the whole source rather than the part actually covered. The\n * correction shifts and scales the coordinates by the difference.\n *\n * ONLY THE `DrawTexture` FAMILY APPLIES THIS. Carbon's `DrawScreenQuad` calls\n * the blitter with unadjusted coordinates (`Tr2Renderer.cpp:1014-1020`), so\n * folding the correction into `Tr2Blitter` itself would silently change every\n * screen-quad draw.\n *\n * @param {object} renderContext The context whose ESM holds both viewports.\n * @param {Array<number>} tlTexCoord Top-left texture coordinate.\n * @param {Array<number>} brTexCoord Bottom-right texture coordinate.\n * @returns {{tlTexCoord: Array<number>, brTexCoord: Array<number>}} Corrected\n *   coordinates; the inputs are not modified, unlike Carbon's in-out reference\n *   parameters.\n */\nexport function AdjustTextureCoordsToViewport(renderContext, tlTexCoord, brTexCoord)\n{\n  const esm = renderContext.GetEffectStateManager();\n  const viewport = esm.GetViewport();\n  const deviceViewport = esm.GetDeviceViewport();\n\n  // Carbon dereferences both unconditionally. Before either is set there is no\n  // correction to make, and guessing one would move a blit that was correct.\n  if (!viewport || !deviceViewport) return { tlTexCoord, brTexCoord };\n\n  const deltaX = Math.trunc(deviceViewport.x) - viewport.x;\n  const deltaY = Math.trunc(deviceViewport.y) - viewport.y;\n\n  const xOffset = deltaX / viewport.width;\n  const yOffset = deltaY / viewport.height;\n\n  return {\n    tlTexCoord: [\n      tlTexCoord[0] + xOffset * brTexCoord[0],\n      tlTexCoord[1] + yOffset * brTexCoord[1]\n    ],\n    brTexCoord: [\n      brTexCoord[0] * ((deviceViewport.width + deltaX) / viewport.width),\n      brTexCoord[1] * ((deviceViewport.height + deltaY) / viewport.height)\n    ]\n  };\n}\n"],"names":["SetConstants","buffer","constantTypeMask","registerIndex","renderContext","mask","bound","stage","ShaderType","SHADER_TYPE_FIRST","SHADER_TYPE_COUNT","FillAndSetConstants","data","dataSize","IsValid","GetSize","Failed","Create","Tr2ConstantUsageAL","REUSABLE","result","mapped","Lock","bytes","Uint8Array","byteOffset","byteLength","set","subarray","Math","min","Unlock","SCREEN_VERTEX_FLOATS","SCREEN_VERTEX_BYTES","SCREEN_QUAD_FLOATS","writeScreenVertex","quad","at","x","y","z","w","u","v","base","interiorEdges","esm","GetEffectStateManager","IsCullModeInverted","SetupScreenQuad","tlTexCoord","brTexCoord","tlVertexCoord","brVertexCoord","tlX","tlY","brX","brY","edge1","edge2","SetupScreenQuadInCameraSpace","projection","GetProjection","proj2view","mat4","invert","create","tl","vec3","transformMat4","br","AdjustTextureCoordsToViewport","viewport","GetViewport","deviceViewport","GetDeviceViewport","deltaX","trunc","deltaY","xOffset","width","yOffset","height"],"mappings":"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"}
+{"version":3,"file":"Tr2RenderUtils.js","sources":["../../../../src/trinity/core/Tr2RenderUtils.js"],"sourcesContent":["// Source: trinity/trinity/Tr2RenderUtils.h\n// Source: trinity/trinity/Tr2RenderUtils.cpp\n//\n// Freestanding helpers that need no private state. Carbon's own header explains\n// why the file exists: \"Most of this was TriDevice/Tr2Renderer but works just\n// fine with the public interfaces. So put those guys here to lighten up those\n// classes.\"\n//\n// THESE ARE TRINITY, NOT THE ABSTRACTION LAYER, and that is the whole reason\n// they were missing. `FillAndSetConstants` is the last hop of Carbon's\n// per-object upload - `Tr2PerObjectDataStandard::SetPerObjectDataToDevice`\n// calls it twice and does nothing else - and it lives in a Trinity header. It\n// went unported because \"the engine does device work\" was read as the\n// `trinityal/webgpu` package rather than the abstraction layer, so the upload was\n// reimplemented engine-side and this file never got written. See\n// /docs/research/graphics-path-review-2026-09-05.md.\n//\n// `SetupScreenQuad` and `SetupScreenQuadInCameraSpace` are here too. They feed\n// `Tr2Blitter`'s fullscreen-quad path, which is the single gate in front of\n// every remaining render step: TriStepRenderTexture, TriStepRenderAtlas and\n// `TriStepRenderEffect` all bottom out in `Tr2Renderer::DrawTexture` ->\n// `Tr2Blitter::Draw`.\nimport { ShaderType } from \"#consts/render-context\";\nimport { mat4 } from \"#math/mat4\";\nimport { vec3 } from \"#math/vec3\";\nimport { Tr2ConstantUsageAL } from \"../../trinityal/index.js\";\nimport { Failed } from \"../../trinityal/ALResult.js\";\n\n\n/**\n * Binds one constant buffer to every shader stage a mask names.\n *\n * Carbon `SetConstants` (`Tr2RenderUtils.cpp:126-137`). The loop clears each\n * bit as it goes and stops as soon as the mask is empty, so a single-stage\n * bind costs one iteration rather than six.\n *\n * @param {object} buffer A `Tr2ConstantBufferAL`.\n * @param {number} constantTypeMask A bit per `ShaderType`.\n * @param {number} registerIndex The constant-buffer register.\n * @param {object} renderContext The context to bind against.\n * @returns {number} How many stages were bound.\n */\nexport function SetConstants(buffer, constantTypeMask, registerIndex, renderContext)\n{\n  let mask = constantTypeMask >>> 0;\n  let bound = 0;\n\n  for (let stage = ShaderType.SHADER_TYPE_FIRST; stage !== ShaderType.SHADER_TYPE_COUNT && mask; stage += 1)\n  {\n    if (!(mask & (1 << stage))) continue;\n\n    renderContext.SetConstants(buffer, stage, registerIndex);\n    mask &= ~(1 << stage);\n    bound += 1;\n  }\n\n  return bound;\n}\n\n\n/**\n * Creates or grows a constant buffer, copies data into it, and binds it.\n *\n * Carbon `FillAndSetConstants` (`Tr2RenderUtils.cpp:100-124`), the repeating\n * pattern its own comment describes: create if needed, lock, copy, unlock, set.\n *\n * A ZERO MASK RETURNS SUCCESS AND BINDS NOTHING. That is Carbon's first line\n * and it is not a guard against bad input - it is how a payload declared for\n * stages a technique does not use gets skipped, per batch, without the caller\n * testing anything.\n *\n * THE COPY IS CLAMPED TO THE BUFFER, not to the data. Carbon writes\n * `min( dataSize, buffer.GetSize() )`, so a payload larger than the buffer\n * fills it and the tail is dropped rather than overrunning.\n *\n * @param {object} buffer A `Tr2ConstantBufferAL`, created here if it has to be.\n * @param {ArrayBufferView} data The bytes to upload.\n * @param {number} dataSize How many bytes of `data` to upload.\n * @param {number} constantTypeMask A bit per `ShaderType`.\n * @param {number} registerIndex The constant-buffer register.\n * @param {object} renderContext The context to upload and bind against.\n * @returns {boolean} Whether the data was uploaded and bound.\n */\nexport function FillAndSetConstants(buffer, data, dataSize, constantTypeMask, registerIndex, renderContext)\n{\n  if (!(constantTypeMask >>> 0)) return true;\n\n  if (!buffer.IsValid() || dataSize > buffer.GetSize())\n  {\n    if (Failed(buffer.Create(dataSize, Tr2ConstantUsageAL.REUSABLE, null, renderContext))) return false;\n  }\n\n  const { result, data: mapped } = buffer.Lock(renderContext);\n\n  if (Failed(result) || !mapped) return false;\n\n  const bytes = data instanceof Uint8Array\n    ? data\n    : new Uint8Array(data.buffer, data.byteOffset, data.byteLength);\n\n  mapped.set(bytes.subarray(0, Math.min(dataSize, buffer.GetSize())));\n\n  buffer.Unlock(renderContext);\n\n  SetConstants(buffer, constantTypeMask, registerIndex, renderContext);\n\n  return true;\n}\n\n\n// Carbon `Tr2ScreenVertex` (Tr2RenderUtils.h:13-17): a clip-space position and\n// one texture coordinate. Four of them make the blitter's triangle strip.\nexport const SCREEN_VERTEX_FLOATS = 6;\nexport const SCREEN_VERTEX_BYTES = SCREEN_VERTEX_FLOATS * 4;\nexport const SCREEN_QUAD_FLOATS = SCREEN_VERTEX_FLOATS * 4;\n\n\n/** Writes one Tr2ScreenVertex into a flat float array at vertex index `at`. */\nfunction writeScreenVertex(quad, at, x, y, z, w, u, v)\n{\n  const base = at * SCREEN_VERTEX_FLOATS;\n  quad[base] = x;\n  quad[base + 1] = y;\n  quad[base + 2] = z;\n  quad[base + 3] = w;\n  quad[base + 4] = u;\n  quad[base + 5] = v;\n}\n\n\n/**\n * Carbon's interior-edge flip (`Tr2RenderUtils.cpp:24-33` and `67-76`).\n *\n * The quad is emitted as a triangle strip, so which diagonal splits it decides\n * the winding of both triangles. Carbon swaps the two interior vertices when\n * the cull mode is NOT inverted, which is the ordinary case - so the common\n * path is the swapped one, not the literal 0/1/2/3 order the comments read as.\n *\n * @param {object} renderContext The context whose ESM holds the cull override.\n * @returns {Array<number>} The two interior vertex indices, in emission order.\n */\nfunction interiorEdges(renderContext)\n{\n  const esm = renderContext.GetEffectStateManager();\n\n  return esm.IsCullModeInverted() ? [ 1, 2 ] : [ 2, 1 ];\n}\n\n\n/**\n * Fills a four-vertex screen quad in clip space.\n *\n * Carbon `SetupScreenQuad` (`Tr2RenderUtils.cpp:11-50`). Vertex coordinates\n * arrive in [0,1] with y down, which is why y is negated on the way to clip\n * space; texture coordinates pass through untouched.\n *\n * ADAPTED: Carbon reaches for the main-thread render context through\n * `USE_MAIN_THREAD_RENDER_CONTEXT()` purely to read the cull mode, and its own\n * comment on that line asks for the context to be passed in instead\n * (`cpp:27`). We pass it in.\n *\n * @param {Float32Array} quad Destination, at least SCREEN_QUAD_FLOATS long.\n * @param {object} renderContext The context to read the cull mode from.\n * @param {Array<number>} tlTexCoord Top-left texture coordinate.\n * @param {Array<number>} brTexCoord Bottom-right texture coordinate.\n * @param {Array<number>} [tlVertexCoord] Top-left placement, [0,1], y down.\n * @param {Array<number>} [brVertexCoord] Bottom-right placement, [0,1], y down.\n * @returns {Float32Array} The quad that was written.\n */\nexport function SetupScreenQuad(quad, renderContext, tlTexCoord, brTexCoord, tlVertexCoord = [ 0, 0 ], brVertexCoord = [ 1, 1 ])\n{\n  const tlX = tlVertexCoord[0] * 2 - 1;\n  const tlY = -(tlVertexCoord[1] * 2 - 1);\n  const brX = brVertexCoord[0] * 2 - 1;\n  const brY = -(brVertexCoord[1] * 2 - 1);\n  const z = 1;\n  const w = 1;\n\n  const [ edge1, edge2 ] = interiorEdges(renderContext);\n\n  writeScreenVertex(quad, 0, tlX, tlY, z, w, tlTexCoord[0], tlTexCoord[1]);\n  writeScreenVertex(quad, edge1, brX, tlY, z, w, brTexCoord[0], tlTexCoord[1]);\n  writeScreenVertex(quad, edge2, tlX, brY, z, w, tlTexCoord[0], brTexCoord[1]);\n  writeScreenVertex(quad, 3, brX, brY, z, w, brTexCoord[0], brTexCoord[1]);\n\n  return quad;\n}\n\n\n/**\n * Fills a four-vertex screen quad in VIEW space, by unprojecting the clip-space\n * corners through the inverse of the raw projection.\n *\n * Carbon `SetupScreenQuadInCameraSpace` (`Tr2RenderUtils.cpp:52-95`). The\n * vertex shader is expected to push z into w, so the corners carry the\n * unprojected depth rather than a constant.\n *\n * ADAPTED, same reason as SetupScreenQuad: Carbon takes the projection from the\n * `Tr2Renderer` global and the cull mode from the main-thread context; both\n * come from the passed context here.\n *\n * @param {Float32Array} quad Destination, at least SCREEN_QUAD_FLOATS long.\n * @param {object} renderContext The context holding projection and cull mode.\n * @returns {Float32Array|null} The quad, or null with no projection set.\n */\nexport function SetupScreenQuadInCameraSpace(quad, renderContext)\n{\n  const projection = renderContext.GetProjection();\n  if (!projection) return null;\n\n  const proj2view = mat4.invert(mat4.create(), projection);\n  if (!proj2view) return null;\n\n  const tl = vec3.transformMat4(vec3.create(), [ -1, 1, 1 ], proj2view);\n  const br = vec3.transformMat4(vec3.create(), [ 1, -1, 1 ], proj2view);\n\n  const [ edge1, edge2 ] = interiorEdges(renderContext);\n\n  writeScreenVertex(quad, 0, tl[0], tl[1], tl[2], 1, 0, 0);\n  writeScreenVertex(quad, edge1, br[0], tl[1], tl[2], 1, 1, 0);\n  writeScreenVertex(quad, edge2, tl[0], br[1], tl[2], 1, 0, 1);\n  // tl[2] on all four, including this one (cpp:97). The unprojected corners\n  // share a depth, so br's own z is deliberately unused.\n  writeScreenVertex(quad, 3, br[0], br[1], tl[2], 1, 1, 1);\n\n  return quad;\n}\n\n\n/**\n * Corrects texture coordinates when the device viewport differs from the\n * authored one.\n *\n * Carbon `AdjustTextureCoordsToViewport` (`Tr2Renderer.cpp:267-290`), a\n * file-scope free function there and a free function here for the same reason:\n * it needs nothing but the two viewports.\n *\n * WHY IT EXISTS. The authored viewport is what the scene asked for; the device\n * viewport is that clipped to the render target. When they differ - a\n * sub-rectangle render, a target smaller than the request - a blit sampling\n * [0,1] would read the whole source rather than the part actually covered. The\n * correction shifts and scales the coordinates by the difference.\n *\n * ONLY THE `DrawTexture` FAMILY APPLIES THIS. Carbon's `DrawScreenQuad` calls\n * the blitter with unadjusted coordinates (`Tr2Renderer.cpp:1014-1020`), so\n * folding the correction into `Tr2Blitter` itself would silently change every\n * screen-quad draw.\n *\n * @param {object} renderContext The context whose ESM holds both viewports.\n * @param {Array<number>} tlTexCoord Top-left texture coordinate.\n * @param {Array<number>} brTexCoord Bottom-right texture coordinate.\n * @returns {{tlTexCoord: Array<number>, brTexCoord: Array<number>}} Corrected\n *   coordinates; the inputs are not modified, unlike Carbon's in-out reference\n *   parameters.\n */\nexport function AdjustTextureCoordsToViewport(renderContext, tlTexCoord, brTexCoord)\n{\n  const esm = renderContext.GetEffectStateManager();\n  const viewport = esm.GetViewport();\n  const deviceViewport = esm.GetDeviceViewport();\n\n  // Carbon dereferences both unconditionally. Before either is set there is no\n  // correction to make, and guessing one would move a blit that was correct.\n  if (!viewport || !deviceViewport) return { tlTexCoord, brTexCoord };\n\n  const deltaX = Math.trunc(deviceViewport.x) - viewport.x;\n  const deltaY = Math.trunc(deviceViewport.y) - viewport.y;\n\n  const xOffset = deltaX / viewport.width;\n  const yOffset = deltaY / viewport.height;\n\n  return {\n    tlTexCoord: [\n      tlTexCoord[0] + xOffset * brTexCoord[0],\n      tlTexCoord[1] + yOffset * brTexCoord[1]\n    ],\n    brTexCoord: [\n      brTexCoord[0] * ((deviceViewport.width + deltaX) / viewport.width),\n      brTexCoord[1] * ((deviceViewport.height + deltaY) / viewport.height)\n    ]\n  };\n}\n"],"names":["SetConstants","buffer","constantTypeMask","registerIndex","renderContext","mask","bound","stage","ShaderType","SHADER_TYPE_FIRST","SHADER_TYPE_COUNT","FillAndSetConstants","data","dataSize","IsValid","GetSize","Failed","Create","Tr2ConstantUsageAL","REUSABLE","result","mapped","Lock","bytes","Uint8Array","byteOffset","byteLength","set","subarray","Math","min","Unlock","SCREEN_VERTEX_FLOATS","SCREEN_VERTEX_BYTES","SCREEN_QUAD_FLOATS","writeScreenVertex","quad","at","x","y","z","w","u","v","base","interiorEdges","esm","GetEffectStateManager","IsCullModeInverted","SetupScreenQuad","tlTexCoord","brTexCoord","tlVertexCoord","brVertexCoord","tlX","tlY","brX","brY","edge1","edge2","SetupScreenQuadInCameraSpace","projection","GetProjection","proj2view","mat4","invert","create","tl","vec3","transformMat4","br","AdjustTextureCoordsToViewport","viewport","GetViewport","deviceViewport","GetDeviceViewport","deltaX","trunc","deltaY","xOffset","width","yOffset","height"],"mappings":"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"}