@carbonenginejs/runtime 0.1.0-alpha.6 → 0.1.0-alpha.7

package/dist/trinity/shader/parameter/Tr2RuntimeTextureParameter.js

@@ -4,12 +4,13 @@ import { CjsParameter as _CjsParameter } from './CjsParameter.js';
 import { ITriEffectResourceParameter } from './ITriEffectResourceParameter.js';
 import { ResourceFlags } from './ITr2EffectValue.js';
 import { Tr2ColorSpace } from '#consts/render-context';
+import { RealizeTexture } from '../../core/Tr2ImageIOHelpers.js';
 
 let _initProto, _initClass, _init_texture, _init_extra_texture, _init_name, _init_extra_name, _init_uavMipLevel, _init_extra_uavMipLevel;
 
-/**
- * A named texture slot fed by a runtime-supplied texture provider rather than an
- * authored res path.
+/**
+ * A named texture slot fed by a runtime-supplied texture provider rather than an
+ * authored res path.
  */
 let _Tr2RuntimeTexturePar;
 class Tr2RuntimeTextureParameter extends _CjsParameter {
@@ -20,24 +21,24 @@ class Tr2RuntimeTextureParameter extends _CjsParameter {
     } = _applyDecs2311(this, [type.define({
       className: "Tr2RuntimeTextureParameter",
       family: "shader"
-    }), carbon.inherit(ITriEffectResourceParameter)], [[[edit, edit.notify, edit, edit.readwrite, edit, edit.persist, void 0, type.objectRef("ITr2TextureProvider")], 16, "texture"], [[edit, edit.readwrite, edit, edit.persist, type, type.string], 16, "name"], [[edit, edit.readwrite, edit, edit.persist, type, type.uint32], 16, "uavMipLevel"], [[carbon, carbon.method, impl, impl.adapted], 18, "__init__"], [[carbon, carbon.method, impl, impl.implemented], 18, "Create"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetParameterName"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetHashValue"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("JS dispatches the native hook using the exposed member name; existing class-owned rendering/resource adaptations remain unchanged.")], 18, "OnModified"], [[carbon, carbon.method, impl, impl.adapted], 18, "RebuildEffectHandles"], [[carbon, carbon.method, impl, impl.implemented], 18, "CopyToResourceSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "ApplyUav"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetTextureProvider"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetTextureProvider"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetUavMipLevel"], [[carbon, carbon.method, impl, impl.implemented], 18, "OnAddedToMaterial"], [[carbon, carbon.method, impl, impl.implemented], 18, "OnRemovedFromMaterial"]], 0, void 0, _CjsParameter));
+    }), carbon.inherit(ITriEffectResourceParameter)], [[[edit, edit.notify, edit, edit.readwrite, edit, edit.persist, void 0, type.objectRef("ITr2TextureProvider")], 16, "texture"], [[edit, edit.readwrite, edit, edit.persist, type, type.string], 16, "name"], [[edit, edit.readwrite, edit, edit.persist, type, type.uint32], 16, "uavMipLevel"], [[carbon, carbon.method, impl, impl.adapted], 18, "__init__"], [[carbon, carbon.method, impl, impl.implemented], 18, "Create"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetParameterName"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetHashValue"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("JS dispatches the native hook using the exposed member name; existing class-owned rendering/resource adaptations remain unchanged.")], 18, "OnModified"], [[carbon, carbon.method, impl, impl.adapted], 18, "RebuildEffectHandles"], [[carbon, carbon.method, impl, impl.adapted], 18, "CopyToResourceSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "ApplyUav"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetTextureProvider"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetTextureProvider"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetUavMipLevel"], [[carbon, carbon.method, impl, impl.implemented], 18, "OnAddedToMaterial"], [[carbon, carbon.method, impl, impl.implemented], 18, "OnRemovedFromMaterial"]], 0, void 0, _CjsParameter));
   }
   texture = (_initProto(this), _init_texture(this, null));
   name = (_init_extra_texture(this), _init_name(this, ""));
   uavMipLevel = (_init_extra_name(this), _init_uavMipLevel(this, 0));
   #materials = (_init_extra_uavMipLevel(this), []);
 
-  /**
-   * Blue construction form: forwards the name, provider and UAV mip level to
-   * Create.
+  /**
+   * Blue construction form: forwards the name, provider and UAV mip level to
+   * Create.
    */
   __init__(name = "", texture = null, uavMipLevel = 0) {
     this.Create(name, texture, uavMipLevel);
   }
 
-  /**
-   * Assigns name, texture provider and UAV mip level together, notifying only
-   * when at least one of them actually changed; returns whether it did.
+  /**
+   * Assigns name, texture provider and UAV mip level together, notifying only
+   * when at least one of them actually changed; returns whether it did.
    */
   Create(name, texture, uavMipLevel = 0) {
     const nextName = String(name);
@@ -66,18 +67,18 @@ class Tr2RuntimeTextureParameter extends _CjsParameter {
     return _CjsParameter.hashFnv1Identity(this.texture, startingHash);
   }
 
-  /**
-   * Invalidates the resource sets of every material this parameter is attached
-   * to.
+  /**
+   * Invalidates the resource sets of every material this parameter is attached
+   * to.
    */
   OnModified(propertyName) {
     if (propertyName === "texture") this.#invalidateResourceSets();
     return true;
   }
 
-  /**
-   * Deliberately does nothing: Carbon caches the effect resource type here for
-   * later resource-set binding, which the Trinity layer leaves to engine adapters.
+  /**
+   * Deliberately does nothing: Carbon caches the effect resource type here for
+   * later resource-set binding, which the Trinity layer leaves to engine adapters.
    */
   RebuildEffectHandles(_effectRes) {
 
@@ -85,39 +86,56 @@ class Tr2RuntimeTextureParameter extends _CjsParameter {
     // binding. Not ported yet.
   }
 
-  /**
-   * Carbon `CopyToResourceSet` (`Tr2RuntimeTextureParameter.cpp:30-46`): the
-   * provider's texture as a shader resource. With none, a null binding, which
-   * a backend fills with its placeholder as Carbon's fallback texture.
-   *
-   * @param {object} resourceDesc A `Tr2ResourceSetDescriptionAL`.
-   * @param {number} stage A `ShaderType`.
-   * @param {number} registerIndex The register.
-   * @param {number} [flags] A `ResourceFlags` word; bit 0 is sRGB.
-   * @returns {boolean} Whether the slot took the binding.
+  /**
+   * Carbon `CopyToResourceSet` (`Tr2RuntimeTextureParameter.cpp:30-46`): the
+   * provider's texture as a shader resource. With none, a null binding, which
+   * a backend fills with its placeholder as Carbon's fallback texture.
+   *
+   * Adapted: a provider that is a loaded texture resource has its texture
+   * made here, on first bind, through the trailing `renderContext`
+   * (`RealizeTexture`), as `TriTextureParameter` and `TriVariable` do; Carbon
+   * made it at load. Without this, a `TriTextureRes` handed to
+   * `Tr2Effect.SetParameter` (CORTAO's lookup table) bound the placeholder
+   * forever.
+   *
+   * @param {object} resourceDesc A `Tr2ResourceSetDescriptionAL`.
+   * @param {number} stage A `ShaderType`.
+   * @param {number} registerIndex The register.
+   * @param {number} [flags] A `ResourceFlags` word; bit 0 is sRGB.
+   * @param {object} [renderContext] The context a resource's texture is made through.
+   * @returns {boolean} Whether the slot took the binding.
    */
-  CopyToResourceSet(resourceDesc, stage, registerIndex, flags = 0) {
+  CopyToResourceSet(resourceDesc, stage, registerIndex, flags = 0, renderContext = null) {
     const colorSpace = flags & ResourceFlags.RESOURCE_FLAG_SRGB ? Tr2ColorSpace.COLOR_SPACE_SRGB : Tr2ColorSpace.COLOR_SPACE_LINEAR;
-    return resourceDesc.SetSrv(stage, registerIndex, this.texture ? this.texture.GetTexture() : null, colorSpace);
-  }
-
-  /**
-   * Carbon `ApplyUav` (`Tr2RuntimeTextureParameter.cpp:49-60`): the
-   * provider's texture as an unordered-access view at this parameter's mip.
-   *
-   * @param {object} resourceDesc A `Tr2ResourceSetDescriptionAL`.
-   * @param {number} stage A `ShaderType`.
-   * @param {number} registerIndex The register.
-   * @returns {boolean} Whether the slot took the binding.
+    return resourceDesc.SetSrv(stage, registerIndex, this._Texture(renderContext), colorSpace);
+  }
+
+  /** The provider's texture, realized through the context if it is a resource that has loaded but not yet been created; null otherwise. */
+  _Texture(renderContext) {
+    const provider = this.texture;
+    if (!provider) return null;
+    const texture = provider.GetTexture();
+    if (texture || !renderContext || typeof provider.IsPrepared !== "function") return texture;
+    return RealizeTexture(provider, renderContext);
+  }
+
+  /**
+   * Carbon `ApplyUav` (`Tr2RuntimeTextureParameter.cpp:49-60`): the
+   * provider's texture as an unordered-access view at this parameter's mip.
+   *
+   * @param {object} resourceDesc A `Tr2ResourceSetDescriptionAL`.
+   * @param {number} stage A `ShaderType`.
+   * @param {number} registerIndex The register.
+   * @returns {boolean} Whether the slot took the binding.
    */
   ApplyUav(resourceDesc, stage, registerIndex) {
     const texture = this.texture ? this.texture.GetTexture() : null;
     return texture ? resourceDesc.SetUav(stage, registerIndex, texture, this.uavMipLevel) : resourceDesc.SetUav(stage, registerIndex, null);
   }
 
-  /**
-   * Swaps the texture provider and notifies owners; returns false when it is
-   * already the same object.
+  /**
+   * Swaps the texture provider and notifies owners; returns false when it is
+   * already the same object.
    */
   SetTextureProvider(texture) {
     if (this.texture === texture) {
@@ -131,25 +149,25 @@ class Tr2RuntimeTextureParameter extends _CjsParameter {
     return true;
   }
 
-  /**
-   * The attached provider, or null; this package holds the reference but never
-   * resolves or uploads it.
+  /**
+   * The attached provider, or null; this package holds the reference but never
+   * resolves or uploads it.
    */
   GetTextureProvider() {
     return this.texture;
   }
 
-  /**
-   * Sets the mip level to use when this texture is bound as an unordered-access
-   * view, coerced to uint32.
+  /**
+   * Sets the mip level to use when this texture is bound as an unordered-access
+   * view, coerced to uint32.
    */
   SetUavMipLevel(mipLevel) {
     this.uavMipLevel = mipLevel >>> 0;
   }
 
-  /**
-   * Registers a material to be invalidated when this parameter changes;
-   * duplicates are ignored.
+  /**
+   * Registers a material to be invalidated when this parameter changes;
+   * duplicates are ignored.
    */
   OnAddedToMaterial(material) {
     if (!this.#materials.includes(material)) {
@@ -157,9 +175,9 @@ class Tr2RuntimeTextureParameter extends _CjsParameter {
     }
   }
 
-  /**
-   * Drops a material from the tracked list, so later texture swaps no longer
-   * invalidate its resource sets.
+  /**
+   * Drops a material from the tracked list, so later texture swaps no longer
+   * invalidate its resource sets.
    */
   OnRemovedFromMaterial(material) {
     const index = this.#materials.indexOf(material);

package/dist/trinity/shader/parameter/Tr2RuntimeTextureParameter.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2RuntimeTextureParameter.js","sources":["../../../../../src/trinity/shader/parameter/Tr2RuntimeTextureParameter.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Parameter/Tr2RuntimeTextureParameter.h\r\n// Source: trinity/trinity/Shader/Parameter/Tr2RuntimeTextureParameter.cpp\r\n// Source: trinity/trinity/Shader/Parameter/Tr2RuntimeTextureParameter_Blue.cpp\r\nimport { carbon, impl, edit, type } from \"#schema\";\r\nimport { CjsParameter } from \"./CjsParameter.js\";\r\nimport { ITriEffectResourceParameter } from \"./ITriEffectResourceParameter.js\";\r\nimport { ResourceFlags } from \"./ITr2EffectValue.js\";\r\nimport { Tr2ColorSpace } from \"#consts/render-context\";\r\n\r\n\r\n/**\r\n * A named texture slot fed by a runtime-supplied texture provider rather than an\r\n * authored res path.\r\n */\r\n@type.define({\r\n  className: \"Tr2RuntimeTextureParameter\",\r\n  family: \"shader\"\r\n})\r\n@carbon.inherit(ITriEffectResourceParameter)\r\nexport class Tr2RuntimeTextureParameter extends CjsParameter\r\n{\r\n  @edit.notify\r\n  @edit.readwrite\r\n  @edit.persist\r\n  @type.objectRef(\"ITr2TextureProvider\")\r\n  texture = null;\r\n\r\n  @edit.readwrite\r\n  @edit.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  @edit.readwrite\r\n  @edit.persist\r\n  @type.uint32\r\n  uavMipLevel = 0;\r\n\r\n  #materials = [];\r\n\r\n  /**\r\n   * Blue construction form: forwards the name, provider and UAV mip level to\r\n   * Create.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  __init__(name = \"\", texture = null, uavMipLevel = 0)\r\n  {\r\n    this.Create(name, texture, uavMipLevel);\r\n  }\r\n\r\n  /**\r\n   * Assigns name, texture provider and UAV mip level together, notifying only\r\n   * when at least one of them actually changed; returns whether it did.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Create(name, texture, uavMipLevel = 0)\r\n  {\r\n    const nextName = String(name);\r\n    const nextMipLevel = uavMipLevel >>> 0;\r\n    const changed = this.name !== nextName || this.texture !== texture || this.uavMipLevel !== nextMipLevel;\r\n    if (!changed)\r\n    {\r\n      return false;\r\n    }\r\n    this.name = nextName;\r\n    this.texture = texture;\r\n    this.uavMipLevel = nextMipLevel;\r\n    this.UpdateValues({ property: \"texture\", source: this });\r\n    return true;\r\n  }\r\n\r\n  /** The shader resource name this texture binds to. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetParameterName()\r\n  {\r\n    return this.name;\r\n  }\r\n\r\n  /** Content hash: the texture provider's identity (Carbon hashes its pointer). */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetHashValue(startingHash = CjsParameter.FNV1_INITIAL)\r\n  {\r\n    return CjsParameter.hashFnv1Identity(this.texture, startingHash);\r\n  }\r\n\r\n  /**\r\n   * Invalidates the resource sets of every material this parameter is attached\r\n   * to.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  @impl.reason(\"JS dispatches the native hook using the exposed member name; existing class-owned rendering/resource adaptations remain unchanged.\")\r\n  OnModified(propertyName)\r\n  {\r\n    if (propertyName === \"texture\") this.#invalidateResourceSets();\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Deliberately does nothing: Carbon caches the effect resource type here for\r\n   * later resource-set binding, which the Trinity layer leaves to engine adapters.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  RebuildEffectHandles(_effectRes)\r\n  {\r\n\r\n    // Carbon caches the effect resource type here for later resource-set\r\n    // binding. Not ported yet.\r\n  }\r\n\r\n  /**\r\n   * Carbon `CopyToResourceSet` (`Tr2RuntimeTextureParameter.cpp:30-46`): the\r\n   * provider's texture as a shader resource. With none, a null binding, which\r\n   * a backend fills with its placeholder as Carbon's fallback texture.\r\n   *\r\n   * @param {object} resourceDesc A `Tr2ResourceSetDescriptionAL`.\r\n   * @param {number} stage A `ShaderType`.\r\n   * @param {number} registerIndex The register.\r\n   * @param {number} [flags] A `ResourceFlags` word; bit 0 is sRGB.\r\n   * @returns {boolean} Whether the slot took the binding.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  CopyToResourceSet(resourceDesc, stage, registerIndex, flags = 0)\r\n  {\r\n    const colorSpace = (flags & ResourceFlags.RESOURCE_FLAG_SRGB)\r\n      ? Tr2ColorSpace.COLOR_SPACE_SRGB\r\n      : Tr2ColorSpace.COLOR_SPACE_LINEAR;\r\n\r\n    return resourceDesc.SetSrv(stage, registerIndex, this.texture ? this.texture.GetTexture() : null, colorSpace);\r\n  }\r\n\r\n  /**\r\n   * Carbon `ApplyUav` (`Tr2RuntimeTextureParameter.cpp:49-60`): the\r\n   * provider's texture as an unordered-access view at this parameter's mip.\r\n   *\r\n   * @param {object} resourceDesc A `Tr2ResourceSetDescriptionAL`.\r\n   * @param {number} stage A `ShaderType`.\r\n   * @param {number} registerIndex The register.\r\n   * @returns {boolean} Whether the slot took the binding.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  ApplyUav(resourceDesc, stage, registerIndex)\r\n  {\r\n    const texture = this.texture ? this.texture.GetTexture() : null;\r\n\r\n    return texture\r\n      ? resourceDesc.SetUav(stage, registerIndex, texture, this.uavMipLevel)\r\n      : resourceDesc.SetUav(stage, registerIndex, null);\r\n  }\r\n\r\n  /**\r\n   * Swaps the texture provider and notifies owners; returns false when it is\r\n   * already the same object.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetTextureProvider(texture)\r\n  {\r\n    if (this.texture === texture)\r\n    {\r\n      return false;\r\n    }\r\n    this.texture = texture;\r\n    this.UpdateValues({ property: \"texture\", source: this });\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * The attached provider, or null; this package holds the reference but never\r\n   * resolves or uploads it.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetTextureProvider()\r\n  {\r\n    return this.texture;\r\n  }\r\n\r\n  /**\r\n   * Sets the mip level to use when this texture is bound as an unordered-access\r\n   * view, coerced to uint32.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetUavMipLevel(mipLevel)\r\n  {\r\n    this.uavMipLevel = mipLevel >>> 0;\r\n  }\r\n\r\n  /**\r\n   * Registers a material to be invalidated when this parameter changes;\r\n   * duplicates are ignored.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  OnAddedToMaterial(material)\r\n  {\r\n    if (!this.#materials.includes(material))\r\n    {\r\n      this.#materials.push(material);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Drops a material from the tracked list, so later texture swaps no longer\r\n   * invalidate its resource sets.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  OnRemovedFromMaterial(material)\r\n  {\r\n    const index = this.#materials.indexOf(material);\r\n    if (index >= 0)\r\n    {\r\n      this.#materials.splice(index, 1);\r\n    }\r\n  }\r\n\r\n  /** Invalidates the resource sets of every attached material. */\r\n  #invalidateResourceSets()\r\n  {\r\n    for (const material of this.#materials)\r\n    {\r\n      material?.InvalidateResourceSets?.();\r\n    }\r\n  }\r\n}\r\n"],"names":["_Tr2RuntimeTexturePar","Tr2RuntimeTextureParameter","CjsParameter","e","_init_texture","_init_extra_texture","_init_name","_init_extra_name","_init_uavMipLevel","_init_extra_uavMipLevel","_initProto","c","_initClass","_applyDecs","type","define","className","family","carbon","inherit","ITriEffectResourceParameter","edit","notify","readwrite","persist","objectRef","string","uint32","method","impl","adapted","implemented","reason","texture","name","uavMipLevel","__init__","Create","nextName","String","nextMipLevel","changed","UpdateValues","property","source","GetParameterName","GetHashValue","startingHash","FNV1_INITIAL","hashFnv1Identity","OnModified","propertyName","RebuildEffectHandles","_effectRes","CopyToResourceSet","resourceDesc","stage","registerIndex","flags","colorSpace","ResourceFlags","RESOURCE_FLAG_SRGB","Tr2ColorSpace","COLOR_SPACE_SRGB","COLOR_SPACE_LINEAR","SetSrv","GetTexture","ApplyUav","SetUav","SetTextureProvider","GetTextureProvider","SetUavMipLevel","mipLevel","OnAddedToMaterial","material","includes","push","OnRemovedFromMaterial","index","indexOf","splice","#invalidateResourceSets","InvalidateResourceSets"],"mappings":"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"}
+{"version":3,"file":"Tr2RuntimeTextureParameter.js","sources":["../../../../../src/trinity/shader/parameter/Tr2RuntimeTextureParameter.js"],"sourcesContent":["// Source: trinity/trinity/Shader/Parameter/Tr2RuntimeTextureParameter.h\n// Source: trinity/trinity/Shader/Parameter/Tr2RuntimeTextureParameter.cpp\n// Source: trinity/trinity/Shader/Parameter/Tr2RuntimeTextureParameter_Blue.cpp\nimport { carbon, impl, edit, type } from \"#schema\";\nimport { CjsParameter } from \"./CjsParameter.js\";\nimport { ITriEffectResourceParameter } from \"./ITriEffectResourceParameter.js\";\nimport { ResourceFlags } from \"./ITr2EffectValue.js\";\nimport { Tr2ColorSpace } from \"#consts/render-context\";\nimport { RealizeTexture } from \"../../core/Tr2ImageIOHelpers.js\";\n\n\n/**\n * A named texture slot fed by a runtime-supplied texture provider rather than an\n * authored res path.\n */\n@type.define({\n  className: \"Tr2RuntimeTextureParameter\",\n  family: \"shader\"\n})\n@carbon.inherit(ITriEffectResourceParameter)\nexport class Tr2RuntimeTextureParameter extends CjsParameter\n{\n  @edit.notify\n  @edit.readwrite\n  @edit.persist\n  @type.objectRef(\"ITr2TextureProvider\")\n  texture = null;\n\n  @edit.readwrite\n  @edit.persist\n  @type.string\n  name = \"\";\n\n  @edit.readwrite\n  @edit.persist\n  @type.uint32\n  uavMipLevel = 0;\n\n  #materials = [];\n\n  /**\n   * Blue construction form: forwards the name, provider and UAV mip level to\n   * Create.\n   */\n  @carbon.method\n  @impl.adapted\n  __init__(name = \"\", texture = null, uavMipLevel = 0)\n  {\n    this.Create(name, texture, uavMipLevel);\n  }\n\n  /**\n   * Assigns name, texture provider and UAV mip level together, notifying only\n   * when at least one of them actually changed; returns whether it did.\n   */\n  @carbon.method\n  @impl.implemented\n  Create(name, texture, uavMipLevel = 0)\n  {\n    const nextName = String(name);\n    const nextMipLevel = uavMipLevel >>> 0;\n    const changed = this.name !== nextName || this.texture !== texture || this.uavMipLevel !== nextMipLevel;\n    if (!changed)\n    {\n      return false;\n    }\n    this.name = nextName;\n    this.texture = texture;\n    this.uavMipLevel = nextMipLevel;\n    this.UpdateValues({ property: \"texture\", source: this });\n    return true;\n  }\n\n  /** The shader resource name this texture binds to. */\n  @carbon.method\n  @impl.implemented\n  GetParameterName()\n  {\n    return this.name;\n  }\n\n  /** Content hash: the texture provider's identity (Carbon hashes its pointer). */\n  @carbon.method\n  @impl.adapted\n  GetHashValue(startingHash = CjsParameter.FNV1_INITIAL)\n  {\n    return CjsParameter.hashFnv1Identity(this.texture, startingHash);\n  }\n\n  /**\n   * Invalidates the resource sets of every material this parameter is attached\n   * to.\n   */\n  @carbon.method\n  @impl.adapted\n  @impl.reason(\"JS dispatches the native hook using the exposed member name; existing class-owned rendering/resource adaptations remain unchanged.\")\n  OnModified(propertyName)\n  {\n    if (propertyName === \"texture\") this.#invalidateResourceSets();\n    return true;\n  }\n\n  /**\n   * Deliberately does nothing: Carbon caches the effect resource type here for\n   * later resource-set binding, which the Trinity layer leaves to engine adapters.\n   */\n  @carbon.method\n  @impl.adapted\n  RebuildEffectHandles(_effectRes)\n  {\n\n    // Carbon caches the effect resource type here for later resource-set\n    // binding. Not ported yet.\n  }\n\n  /**\n   * Carbon `CopyToResourceSet` (`Tr2RuntimeTextureParameter.cpp:30-46`): the\n   * provider's texture as a shader resource. With none, a null binding, which\n   * a backend fills with its placeholder as Carbon's fallback texture.\n   *\n   * Adapted: a provider that is a loaded texture resource has its texture\n   * made here, on first bind, through the trailing `renderContext`\n   * (`RealizeTexture`), as `TriTextureParameter` and `TriVariable` do; Carbon\n   * made it at load. Without this, a `TriTextureRes` handed to\n   * `Tr2Effect.SetParameter` (CORTAO's lookup table) bound the placeholder\n   * forever.\n   *\n   * @param {object} resourceDesc A `Tr2ResourceSetDescriptionAL`.\n   * @param {number} stage A `ShaderType`.\n   * @param {number} registerIndex The register.\n   * @param {number} [flags] A `ResourceFlags` word; bit 0 is sRGB.\n   * @param {object} [renderContext] The context a resource's texture is made through.\n   * @returns {boolean} Whether the slot took the binding.\n   */\n  @carbon.method\n  @impl.adapted\n  CopyToResourceSet(resourceDesc, stage, registerIndex, flags = 0, renderContext = null)\n  {\n    const colorSpace = (flags & ResourceFlags.RESOURCE_FLAG_SRGB)\n      ? Tr2ColorSpace.COLOR_SPACE_SRGB\n      : Tr2ColorSpace.COLOR_SPACE_LINEAR;\n\n    return resourceDesc.SetSrv(stage, registerIndex, this._Texture(renderContext), colorSpace);\n  }\n\n  /** The provider's texture, realized through the context if it is a resource that has loaded but not yet been created; null otherwise. */\n  _Texture(renderContext)\n  {\n    const provider = this.texture;\n\n    if (!provider) return null;\n\n    const texture = provider.GetTexture();\n\n    if (texture || !renderContext || typeof provider.IsPrepared !== \"function\") return texture;\n\n    return RealizeTexture(provider, renderContext);\n  }\n\n  /**\n   * Carbon `ApplyUav` (`Tr2RuntimeTextureParameter.cpp:49-60`): the\n   * provider's texture as an unordered-access view at this parameter's mip.\n   *\n   * @param {object} resourceDesc A `Tr2ResourceSetDescriptionAL`.\n   * @param {number} stage A `ShaderType`.\n   * @param {number} registerIndex The register.\n   * @returns {boolean} Whether the slot took the binding.\n   */\n  @carbon.method\n  @impl.implemented\n  ApplyUav(resourceDesc, stage, registerIndex)\n  {\n    const texture = this.texture ? this.texture.GetTexture() : null;\n\n    return texture\n      ? resourceDesc.SetUav(stage, registerIndex, texture, this.uavMipLevel)\n      : resourceDesc.SetUav(stage, registerIndex, null);\n  }\n\n  /**\n   * Swaps the texture provider and notifies owners; returns false when it is\n   * already the same object.\n   */\n  @carbon.method\n  @impl.implemented\n  SetTextureProvider(texture)\n  {\n    if (this.texture === texture)\n    {\n      return false;\n    }\n    this.texture = texture;\n    this.UpdateValues({ property: \"texture\", source: this });\n    return true;\n  }\n\n  /**\n   * The attached provider, or null; this package holds the reference but never\n   * resolves or uploads it.\n   */\n  @carbon.method\n  @impl.implemented\n  GetTextureProvider()\n  {\n    return this.texture;\n  }\n\n  /**\n   * Sets the mip level to use when this texture is bound as an unordered-access\n   * view, coerced to uint32.\n   */\n  @carbon.method\n  @impl.implemented\n  SetUavMipLevel(mipLevel)\n  {\n    this.uavMipLevel = mipLevel >>> 0;\n  }\n\n  /**\n   * Registers a material to be invalidated when this parameter changes;\n   * duplicates are ignored.\n   */\n  @carbon.method\n  @impl.implemented\n  OnAddedToMaterial(material)\n  {\n    if (!this.#materials.includes(material))\n    {\n      this.#materials.push(material);\n    }\n  }\n\n  /**\n   * Drops a material from the tracked list, so later texture swaps no longer\n   * invalidate its resource sets.\n   */\n  @carbon.method\n  @impl.implemented\n  OnRemovedFromMaterial(material)\n  {\n    const index = this.#materials.indexOf(material);\n    if (index >= 0)\n    {\n      this.#materials.splice(index, 1);\n    }\n  }\n\n  /** Invalidates the resource sets of every attached material. */\n  #invalidateResourceSets()\n  {\n    for (const material of this.#materials)\n    {\n      material?.InvalidateResourceSets?.();\n    }\n  }\n}\n"],"names":["_Tr2RuntimeTexturePar","Tr2RuntimeTextureParameter","CjsParameter","e","_init_texture","_init_extra_texture","_init_name","_init_extra_name","_init_uavMipLevel","_init_extra_uavMipLevel","_initProto","c","_initClass","_applyDecs","type","define","className","family","carbon","inherit","ITriEffectResourceParameter","edit","notify","readwrite","persist","objectRef","string","uint32","method","impl","adapted","implemented","reason","texture","name","uavMipLevel","__init__","Create","nextName","String","nextMipLevel","changed","UpdateValues","property","source","GetParameterName","GetHashValue","startingHash","FNV1_INITIAL","hashFnv1Identity","OnModified","propertyName","RebuildEffectHandles","_effectRes","CopyToResourceSet","resourceDesc","stage","registerIndex","flags","renderContext","colorSpace","ResourceFlags","RESOURCE_FLAG_SRGB","Tr2ColorSpace","COLOR_SPACE_SRGB","COLOR_SPACE_LINEAR","SetSrv","_Texture","provider","GetTexture","IsPrepared","RealizeTexture","ApplyUav","SetUav","SetTextureProvider","GetTextureProvider","SetUavMipLevel","mipLevel","OnAddedToMaterial","material","includes","push","OnRemovedFromMaterial","index","indexOf","splice","#invalidateResourceSets","InvalidateResourceSets"],"mappings":"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"}

package/dist/trinityal/webgpu/CjsWebgpuRenderContextAL.js

@@ -1,12 +1,13 @@
 import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import { impl, CjsSchema } from '#schema';
 import { Tr2ResourceSetAL } from '../Tr2ResourceSetAL/Tr2ResourceSetAL.js';
-import { Topology, PixelFormat, ShaderType, Tr2LoadAction, Tr2StoreAction, UpscalingResult, UpscalingSetting, UpscalingTechnique } from '#consts/render-context';
+import { Topology, PixelFormat, ShaderType, Tr2LoadAction, Tr2StoreAction, RenderState, UpscalingResult, UpscalingSetting, UpscalingTechnique } from '#consts/render-context';
 import { Tr2DrawUPHelper, Failed, Tr2VertexLayoutALStub, Tr2ConstantUsageAL, ALResult, Tr2ColorAttachment, Tr2DepthAttachment, resolveBindingPlan } from '#trinityal';
 import { CjsWebgpuWorkQueue } from './core/CjsWebgpuWorkQueue.js';
 import { CjsWebgpuMipGenerator } from './core/CjsWebgpuMipGenerator.js';
 import { CjsWebgpuBufferAL } from './CjsWebgpuBufferAL.js';
 import { CjsWebgpuConstantBufferAL } from './CjsWebgpuConstantBufferAL.js';
+import { CARBON_BACKEND_ADDRESS_MODES_SYMBOL } from '#resource/format';
 import { CjsWebgpuSamplerStateAL } from './CjsWebgpuSamplerStateAL.js';
 import { CjsWebgpuResourceSetAL } from './CjsWebgpuResourceSetAL.js';
 import { CjsWebgpuTextureAL } from './CjsWebgpuTextureAL.js';
@@ -834,6 +835,10 @@ class CjsWebgpuRenderContextAL {
     this._viewport = viewport ? {
       ...viewport
     } : null;
+
+    // Metal hands every viewport to its work queue (`Tr2RenderContextMetal.mm:1180-1186`).
+    // A viewport without depth bounds has Tr2Viewport's defaults, 0 and 1.
+    if (viewport) this._workQueue.SetViewport(viewport.x, viewport.y, viewport.width, viewport.height, viewport.minZ ?? 0, viewport.maxZ ?? 1);
     return true;
   }
 
@@ -848,9 +853,11 @@ class CjsWebgpuRenderContextAL {
    * Clears the bound attachments.
    *
    * A CLEAR IS A LOAD OPERATION, not a command. WebGPU has no mid-pass clear,
-   * so this ends the current pass and declares the next one's load actions -
-   * which is the same thing `RenderPassHint` does, arrived at from the other
-   * direction. Carbon's Metal backend folds a clear the same way.
+   * so this ends the current pass and makes the clear the next one's load
+   * actions, ON THE ATTACHMENTS BOUND NOW: Metal's `ClearAttachment`
+   * (`MetalWorkQueue.mm:2845-2881`). Binding other targets first runs the
+   * clear in a pass of its own, so it never lands on them; a pending hint
+   * wins, and the clear is ignored.
    *
    * CARBON'S FLAGS AND SLOT (`Tr2RenderContextMetal.mm:297-351`): the colour
    * clear names ONE slot, and depth is cleared only when asked. Every other
@@ -877,7 +884,7 @@ class CjsWebgpuRenderContextAL {
       colors.push(clearTarget && index === slot ? new Tr2ColorAttachment(Tr2LoadAction.CLEAR, Tr2StoreAction.STORE, options.color ?? 0) : new Tr2ColorAttachment(Tr2LoadAction.LOAD, Tr2StoreAction.STORE));
     });
     const depth = attachments.depth ? clearDepth ? new Tr2DepthAttachment(Tr2LoadAction.CLEAR, Tr2StoreAction.STORE, Number(options.depth ?? 1)) : new Tr2DepthAttachment(Tr2LoadAction.LOAD, Tr2StoreAction.STORE) : null;
-    this._workQueue.RenderPassHint(colors, depth);
+    this._Record(this._workQueue.ClearAttachment(colors, depth));
     return true;
   }
 
@@ -1151,6 +1158,13 @@ class CjsWebgpuRenderContextAL {
     if (this._renderStates.get(key) === value >>> 0) return true;
     this._renderStates.set(key, value >>> 0);
     this._pipelineDirty = true;
+
+    // Depth clip is honoured where the device can: the shadow cascades draw
+    // with it off, so a caster in front of the light's near plane still
+    // writes depth. Without depth-clip-control it stays on.
+    if (key === RenderState.RS_DEPTH_CLIP_ENABLE) {
+      this._psoDescription.unclippedDepth = value === 0 && this._webgpu.GetDevice().features.has("depth-clip-control");
+    }
     return true;
   }
 
@@ -1451,6 +1465,8 @@ class CjsWebgpuRenderContextAL {
       const keyParts = [program.GetIdentity(), group, setId];
       const resolved = [];
       const dynamicOffsets = [];
+      // Each storage dummy in the group its own (GetDummyStorageTexture).
+      let storageDummies = 0;
       for (const binding of bindings) {
         if (binding.group !== group) continue;
         let resource;
@@ -1463,7 +1479,7 @@ class CjsWebgpuRenderContextAL {
           // drawn through one program share one bind group and differ only in
           // their offsets, which is the whole economy of the arena.
           const size = binding.buffer.minBindingSize ?? 16;
-          const constantBuffer = this._ConstantBufferFor(binding);
+          const constantBuffer = binding.generatedSymbol === CARBON_BACKEND_ADDRESS_MODES_SYMBOL ? this._AddressModesBuffer(entries ? set : null, size) : this._ConstantBufferFor(binding);
           if (constantBuffer) {
             const region = this.UploadConstants(constantBuffer, size);
             resource = {
@@ -1486,7 +1502,7 @@ class CjsWebgpuRenderContextAL {
           }
         } else {
           resource = entries ? entries.get(`${group}:${binding.binding}`) ?? null : null;
-          resource ??= this._DummyFor(binding);
+          resource ??= this._DummyFor(binding, binding.storageTexture ? storageDummies++ : 0);
         }
         resolved.push({
           binding: binding.binding,
@@ -1591,11 +1607,40 @@ class CjsWebgpuRenderContextAL {
     return null;
   }
 
-  /** Metal's dummy for a slot no set filled. */
-  _DummyFor(binding) {
+  /**
+   * The emulated-addressing modes buffer: WebGPU has no border or mirror-once
+   * address mode, so a translated shader tests them from this buffer
+   * (`emulatedAddressing.js`). It is the backend's own, not the effect's, and
+   * is filled here, per draw, from the sampler states the resource set binds,
+   * so an override that rebinds a sampler is what the shader reads.
+   *
+   * @param {object|null} set The draw's `CjsWebgpuResourceSetAL`, or null.
+   * @param {number} size The binding's size in bytes, a vec4 per sampler register.
+   * @returns {object} The constant buffer, filled.
+   */
+  _AddressModesBuffer(set, size) {
+    if (!this._addressModes?.IsValid() || this._addressModes.GetSize() < size) {
+      this._addressModes = new CjsWebgpuConstantBufferAL();
+      this._addressModes.Create(size, Tr2ConstantUsageAL.REUSABLE, null, this);
+    }
+    const {
+      data
+    } = this._addressModes.Lock(this);
+    const modes = set ? set.GetAddressModes(size / 16) : new Float32Array(size / 4);
+    data.fill(0);
+    data.set(new Uint8Array(modes.buffer, modes.byteOffset, modes.byteLength));
+    this._addressModes.Unlock(this);
+    return this._addressModes;
+  }
+
+  /** The emulated-addressing modes buffer, made on first need. */
+  _addressModes = null;
+
+  /** Metal's dummy for a slot no set filled; `storageIndex` picks a storage dummy of its own. */
+  _DummyFor(binding, storageIndex = 0) {
     if (binding.sampler) return this.GetDummySampler();
     if (binding.texture) return this.GetDummyTexture(binding.texture.viewDimension ?? "2d");
-    if (binding.storageTexture) return this.GetDummyStorageTexture(binding.storageTexture.format, binding.storageTexture.viewDimension);
+    if (binding.storageTexture) return this.GetDummyStorageTexture(binding.storageTexture.format, binding.storageTexture.viewDimension, storageIndex);
     return {
       buffer: this.GetNullBuffer(binding.buffer?.minBindingSize ?? 16, "STORAGE")
     };
@@ -1648,14 +1693,17 @@ class CjsWebgpuRenderContextAL {
    *
    * D3D binds a null UAV and drops its writes; WebGPU has no null binding and
    * checks the view's format against the layout, so the stand-in is one per
-   * format and dimension, written to and never read.
+   * format and dimension, written to and never read. And one per `index`:
+   * WebGPU refuses two writable bindings of one texture in a dispatch, so a
+   * set needing several asks for distinct ones.
    *
    * @param {string} format The binding's `storageTexture.format`.
    * @param {string} viewDimension The binding's `storageTexture.viewDimension`.
+   * @param {number} [index] Which of that kind, for a set needing several.
    * @returns {object} A `GPUTextureView`.
    */
-  GetDummyStorageTexture(format, viewDimension) {
-    const key = `${format}:${viewDimension}`;
+  GetDummyStorageTexture(format, viewDimension, index = 0) {
+    const key = `${format}:${viewDimension}:${index}`;
     const existing = this._dummies.storageTextures.get(key);
     if (existing) return existing;
     const usage = this._webgpu.GetTextureUsage();
@@ -1779,7 +1827,10 @@ class CjsWebgpuRenderContextAL {
         fragment: {
           module: fragmentModule,
           entryPoint: WEBGPU_ENTRY_POINT,
-          targets: recipe.fragment.targets
+          targets: recipe.fragment.targets,
+          ...(recipe.fragment.constants ? {
+            constants: recipe.fragment.constants
+          } : {})
         }
       } : {})
     };
@@ -1807,11 +1858,13 @@ class CjsWebgpuRenderContextAL {
     if (this._IsCanvasPass()) {
       if (!this._renderTarget) {
         this._psoDescription.colorFormats = [];
+        this._psoDescription.unormTargets = [];
         this._psoDescription.depthFormat = null;
         this._psoDescription.sampleCount = 1;
         return;
       }
       this._psoDescription.colorFormats = [this._renderTarget.GetFormat()];
+      this._psoDescription.unormTargets = [];
       this._psoDescription.depthFormat = this._renderTarget.GetDepthFormat();
       this._psoDescription.sampleCount = this._renderTarget.GetSampleCount();
       return;
@@ -1819,6 +1872,7 @@ class CjsWebgpuRenderContextAL {
     const formats = this._boundRenderTargets.map(target => target ? target.GetDeviceFormat() : null);
     while (formats.length && !formats[formats.length - 1]) formats.pop();
     this._psoDescription.colorFormats = formats;
+    this._psoDescription.unormTargets = this._boundRenderTargets.map(target => Boolean(target && target.IsUnormSubstitute()));
     this._psoDescription.depthFormat = this._depthStencil ? this._depthStencil.GetDeviceFormat() : null;
     this._psoDescription.sampleCount = 1;
   }
@@ -2148,14 +2202,23 @@ class CjsWebgpuRenderContextAL {
   /**
    * Binds depth read-only, so it can be sampled while still testing.
    *
-   * STORED, NOT YET APPLIED. WebGPU expresses this as `depthReadOnly` on the
-   * render-pass descriptor, which `_Descriptor` builds; wiring it there is a
-   * pass-descriptor change rather than a state one, and the flag has to exist
-   * before it can be read.
+   * TURNING IT ON REFRESHES THE BOUND DEPTH'S FLOAT SHADOW. Carbon enables it
+   * exactly where a pass is about to read the depth it has written with the
+   * depth still bound: SSAO, the light lists, the lens-flare queries
+   * (EveSpaceSceneRenderDriver.cpp:365, 543, 589). Shaders here read the
+   * r32float shadow (`CjsWebgpuTextureAL._depthShadow`), which otherwise
+   * refreshes only when the depth is unbound (`SetDepthStencil`), so without
+   * this they read the previous frame's depth. The copy ends the open pass.
+   *
+   * The flag itself is STORED, NOT YET APPLIED. WebGPU expresses it as
+   * `depthReadOnly` on the render-pass descriptor, which `_Descriptor`
+   * builds; wiring it there is a pass-descriptor change rather than a state
+   * one, and the flag has to exist before it can be read.
    *
    * @param {boolean} enable Whether depth is read-only.
    */
   SetReadOnlyDepth(enable) {
+    if (enable && !this._readOnlyDepth && this._depthStencil) this._Record(this._workQueue.CopyDepthShadow(this._depthStencil));
     this._readOnlyDepth = !!enable;
   }