@carbonenginejs/runtime-trinity 0.6.0 → 0.8.0

package/dist/shader/parameter/Tr2GeometryBufferParameter.js

@@ -32,6 +32,8 @@ class Tr2GeometryBufferParameter extends CjsParameter {
   /** m_name (BlueSharedString) [READWRITE, NOTIFY, PERSIST] */
   name = (_init_extra_meshIndex(this), _init_name(this, ""));
   cachedEffect = (_init_extra_name(this), null);
+
+  /** The shader resource name this buffer binds to. */
   GetParameterName() {
     return this.name;
   }
@@ -43,9 +45,19 @@ class Tr2GeometryBufferParameter extends CjsParameter {
     }
     return CjsParameter.hashFnv1String(this.name, startingHash);
   }
+
+  /**
+   * Nothing to do in this GPU-free package - a resource path is never resolved
+   * to a buffer here; returns true.
+   */
   Initialize() {
     return true;
   }
+
+  /**
+   * Consumes the `resource` dirty flag by re-initializing and re-resolving
+   * handles against the cached shader.
+   */
   OnModified(_options = {}) {
     if (this.__state.flags.delete("resource")) {
       this.Initialize();
@@ -53,23 +65,50 @@ class Tr2GeometryBufferParameter extends CjsParameter {
     }
     return true;
   }
+
+  /**
+   * Caches the shader and records whether it reflects a resource of this name;
+   * no GPU buffer is bound.
+   */
   RebuildEffectHandles(effectRes) {
     this.cachedEffect = effectRes;
     this.usedByCurrentEffect = !!this.name && !!CjsParameter.getEffectResource(effectRes, this.name);
   }
+
+  /**
+   * Always false - populating a resource set is device work this package does
+   * not do.
+   */
   CopyToResourceSet() {
     return false;
   }
+
+  /** Always false - UAV binding is left to the engine adapter. */
   ApplyUav() {
     return false;
   }
+
+  /**
+   * Whether a buffer object has actually been attached; an authored resourcePath
+   * alone does not make the parameter valid.
+   */
   IsValid() {
     return !!this.gpuBuffer;
   }
+
+  /**
+   * Attaches a buffer object directly and clears the authored resource path, so
+   * the path can no longer override it.
+   */
   SetGpuBuffer(buffer) {
     this.resourcePath = "";
     this.gpuBuffer = buffer;
   }
+
+  /**
+   * The attached buffer object, or null; held by reference and never created
+   * here.
+   */
   GetGpuBuffer() {
     return this.gpuBuffer;
   }

package/dist/shader/parameter/Tr2GeometryBufferParameter.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2GeometryBufferParameter.js","sources":["../../../../src/shader/parameter/Tr2GeometryBufferParameter.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\r\n//   trinity/trinity/Shader/Parameter/Tr2GeometryBufferParameter.h\r\n// Generated by format-carbon carbon-class --emit. Verify against shader/Tr2GeometryBufferParameter.json.\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { CjsParameter } from \"./CjsParameter.js\";\r\n\r\n/** Tr2GeometryBufferParameter (shader) - generated from schema shapeHash bc9ed4c6.... */\r\n@type.define({ className: \"Tr2GeometryBufferParameter\", family: \"shader\" })\r\nexport class Tr2GeometryBufferParameter extends CjsParameter\r\n{\r\n\r\n  /** m_resourcePath (std::wstring) [READWRITE, NOTIFY, PERSIST] */\r\n  @io.flag(\"resource\")\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  resourcePath = \"\";\r\n\r\n  /** m_gpuBuffer (ITr2GpuBufferPtr) [READWRITE, PERSIST, NOTIFY] */\r\n  @io.notify\r\n  @io.persist\r\n  @type.objectRef(\"ITr2GpuBuffer\")\r\n  gpuBuffer = null;\r\n\r\n  /** m_isUsedByEffect (bool) [READ] */\r\n  @io.read\r\n  @type.boolean\r\n  usedByCurrentEffect = false;\r\n\r\n  /** m_meshIndex (int32_t) [READWRITE, NOTIFY, PERSIST] */\r\n  @io.notify\r\n  @io.persist\r\n  @type.int32\r\n  meshIndex = 0;\r\n\r\n  /** m_name (BlueSharedString) [READWRITE, NOTIFY, PERSIST] */\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  cachedEffect = null;\r\n\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: resource path (when set) then name. */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetHashValue(startingHash = CjsParameter.FNV1_INITIAL)\r\n  {\r\n    if (this.resourcePath)\r\n    {\r\n      startingHash = CjsParameter.hashFnv1String(this.resourcePath, startingHash);\r\n    }\r\n    return CjsParameter.hashFnv1String(this.name, startingHash);\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.adapted\r\n  Initialize()\r\n  {\r\n    return true;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    if (this.__state.flags.delete(\"resource\"))\r\n    {\r\n      this.Initialize();\r\n      this.RebuildEffectHandles(this.cachedEffect);\r\n    }\r\n    return true;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.adapted\r\n  RebuildEffectHandles(effectRes)\r\n  {\r\n    this.cachedEffect = effectRes;\r\n    this.usedByCurrentEffect = !!this.name && !!CjsParameter.getEffectResource(effectRes, this.name);\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.adapted\r\n  CopyToResourceSet()\r\n  {\r\n    return false;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.adapted\r\n  ApplyUav()\r\n  {\r\n    return false;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.implemented\r\n  IsValid()\r\n  {\r\n    return !!this.gpuBuffer;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetGpuBuffer(buffer)\r\n  {\r\n    this.resourcePath = \"\";\r\n    this.gpuBuffer = buffer;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetGpuBuffer()\r\n  {\r\n    return this.gpuBuffer;\r\n  }\r\n\r\n}\r\n"],"names":["_Tr2GeometryBufferPar","Tr2GeometryBufferParameter","CjsParameter","e","_init_resourcePath","_init_extra_resourcePath","_init_gpuBuffer","_init_extra_gpuBuffer","_init_usedByCurrentEffect","_init_extra_usedByCurrentEffect","_init_meshIndex","_init_extra_meshIndex","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","flag","notify","persist","string","objectRef","read","boolean","int32","carbon","method","impl","implemented","adapted","resourcePath","gpuBuffer","usedByCurrentEffect","meshIndex","name","cachedEffect","GetParameterName","GetHashValue","startingHash","FNV1_INITIAL","hashFnv1String","Initialize","OnModified","_options","__state","flags","delete","RebuildEffectHandles","effectRes","getEffectResource","CopyToResourceSet","ApplyUav","IsValid","SetGpuBuffer","buffer","GetGpuBuffer"],"mappings":"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"}
+{"version":3,"file":"Tr2GeometryBufferParameter.js","sources":["../../../../src/shader/parameter/Tr2GeometryBufferParameter.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\r\n//   trinity/trinity/Shader/Parameter/Tr2GeometryBufferParameter.h\r\n// Generated by format-carbon carbon-class --emit. Verify against shader/Tr2GeometryBufferParameter.json.\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { CjsParameter } from \"./CjsParameter.js\";\r\n\r\n/** Tr2GeometryBufferParameter (shader) - generated from schema shapeHash bc9ed4c6.... */\r\n@type.define({ className: \"Tr2GeometryBufferParameter\", family: \"shader\" })\r\nexport class Tr2GeometryBufferParameter extends CjsParameter\r\n{\r\n\r\n  /** m_resourcePath (std::wstring) [READWRITE, NOTIFY, PERSIST] */\r\n  @io.flag(\"resource\")\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  resourcePath = \"\";\r\n\r\n  /** m_gpuBuffer (ITr2GpuBufferPtr) [READWRITE, PERSIST, NOTIFY] */\r\n  @io.notify\r\n  @io.persist\r\n  @type.objectRef(\"ITr2GpuBuffer\")\r\n  gpuBuffer = null;\r\n\r\n  /** m_isUsedByEffect (bool) [READ] */\r\n  @io.read\r\n  @type.boolean\r\n  usedByCurrentEffect = false;\r\n\r\n  /** m_meshIndex (int32_t) [READWRITE, NOTIFY, PERSIST] */\r\n  @io.notify\r\n  @io.persist\r\n  @type.int32\r\n  meshIndex = 0;\r\n\r\n  /** m_name (BlueSharedString) [READWRITE, NOTIFY, PERSIST] */\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  cachedEffect = null;\r\n\r\n  /** The shader resource name this buffer 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: resource path (when set) then name. */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetHashValue(startingHash = CjsParameter.FNV1_INITIAL)\r\n  {\r\n    if (this.resourcePath)\r\n    {\r\n      startingHash = CjsParameter.hashFnv1String(this.resourcePath, startingHash);\r\n    }\r\n    return CjsParameter.hashFnv1String(this.name, startingHash);\r\n  }\r\n\r\n  /**\r\n   * Nothing to do in this GPU-free package - a resource path is never resolved\r\n   * to a buffer here; returns true.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  Initialize()\r\n  {\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Consumes the `resource` dirty flag by re-initializing and re-resolving\r\n   * handles against the cached shader.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    if (this.__state.flags.delete(\"resource\"))\r\n    {\r\n      this.Initialize();\r\n      this.RebuildEffectHandles(this.cachedEffect);\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Caches the shader and records whether it reflects a resource of this name;\r\n   * no GPU buffer is bound.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  RebuildEffectHandles(effectRes)\r\n  {\r\n    this.cachedEffect = effectRes;\r\n    this.usedByCurrentEffect = !!this.name && !!CjsParameter.getEffectResource(effectRes, this.name);\r\n  }\r\n\r\n  /**\r\n   * Always false - populating a resource set is device work this package does\r\n   * not do.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  CopyToResourceSet()\r\n  {\r\n    return false;\r\n  }\r\n\r\n  /** Always false - UAV binding is left to the engine adapter. */\r\n  @carbon.method\r\n  @impl.adapted\r\n  ApplyUav()\r\n  {\r\n    return false;\r\n  }\r\n\r\n  /**\r\n   * Whether a buffer object has actually been attached; an authored resourcePath\r\n   * alone does not make the parameter valid.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  IsValid()\r\n  {\r\n    return !!this.gpuBuffer;\r\n  }\r\n\r\n  /**\r\n   * Attaches a buffer object directly and clears the authored resource path, so\r\n   * the path can no longer override it.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetGpuBuffer(buffer)\r\n  {\r\n    this.resourcePath = \"\";\r\n    this.gpuBuffer = buffer;\r\n  }\r\n\r\n  /**\r\n   * The attached buffer object, or null; held by reference and never created\r\n   * here.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetGpuBuffer()\r\n  {\r\n    return this.gpuBuffer;\r\n  }\r\n\r\n}\r\n"],"names":["_Tr2GeometryBufferPar","Tr2GeometryBufferParameter","CjsParameter","e","_init_resourcePath","_init_extra_resourcePath","_init_gpuBuffer","_init_extra_gpuBuffer","_init_usedByCurrentEffect","_init_extra_usedByCurrentEffect","_init_meshIndex","_init_extra_meshIndex","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","flag","notify","persist","string","objectRef","read","boolean","int32","carbon","method","impl","implemented","adapted","resourcePath","gpuBuffer","usedByCurrentEffect","meshIndex","name","cachedEffect","GetParameterName","GetHashValue","startingHash","FNV1_INITIAL","hashFnv1String","Initialize","OnModified","_options","__state","flags","delete","RebuildEffectHandles","effectRes","getEffectResource","CopyToResourceSet","ApplyUav","IsValid","SetGpuBuffer","buffer","GetGpuBuffer"],"mappings":"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"}

package/dist/shader/parameter/Tr2Matrix4Parameter.js

@@ -4,6 +4,11 @@ import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { CjsVectorParameter } from './CjsVectorParameter.js';
 
 let _initProto, _initClass, _init_value, _init_extra_value, _init_usedByCurrentTechnique, _init_extra_usedByCurrentTechnique, _init_usedByCurrentEffect, _init_extra_usedByCurrentEffect, _init_name, _init_extra_name;
+
+/**
+ * 4x4 matrix value for a named shader constant, with optional rerouting into an
+ * external 64-byte destination.
+ */
 let _Tr2Matrix4Parameter;
 class Tr2Matrix4Parameter extends CjsVectorParameter {
   static {
@@ -21,6 +26,8 @@ class Tr2Matrix4Parameter extends CjsVectorParameter {
   name = (_init_extra_usedByCurrentEffect(this), _init_name(this, ""));
   #bindings = (_init_extra_name(this), []);
   #reroutedValue = null;
+
+  /** The shader constant name this matrix binds to; empty until authored. */
   GetParameterName() {
     return this.name;
   }
@@ -29,21 +36,38 @@ class Tr2Matrix4Parameter extends CjsVectorParameter {
   GetHashValue(startingHash = CjsVectorParameter.FNV1_INITIAL) {
     return CjsVectorParameter.hashFnv1String(this.name, CjsVectorParameter.hashFnv1Floats(this.value, startingHash));
   }
+
+  /**
+   * Refreshes from the reroute destination when one is set, then copies 16 components out.
+   * @param out defaults to a freshly allocated matrix the caller owns
+   */
   GetValue(out = mat4.create()) {
     if (this.#reroutedValue) {
       CjsVectorParameter.readVectorDestination(this.#reroutedValue, this.value, 16);
     }
     return CjsVectorParameter.copyNumberArray(out, this.value, 16);
   }
+
+  /**
+   * Copies 16 components in and writes through to the reroute destination when
+   * one is set.
+   */
   SetValue(value) {
     CjsVectorParameter.copyNumberArray(this.value, value, 16);
     if (this.#reroutedValue) {
       CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 16);
     }
   }
+
+  /** Whether reads and writes currently go through an external destination. */
   IsRerouted() {
     return this.#reroutedValue !== null;
   }
+
+  /**
+   * Points the parameter at an external destination and seeds it with the current matrix; a target under 64 bytes or not writable as 16 components clears the reroute instead. Bindings are notified of the effective destination either way.
+   * @param size destination capacity in bytes, not components
+   */
   SetDestination(dest, size = 64) {
     if (size >= 64 && CjsVectorParameter.isVectorDestination(dest, 16)) {
       this.#reroutedValue = dest;
@@ -53,18 +77,37 @@ class Tr2Matrix4Parameter extends CjsVectorParameter {
     }
     CjsVectorParameter.notifyBindings(this.#bindings, this.GetDestination().dest);
   }
+
+  /**
+   * The array an upload should read - the reroute target when set, otherwise the
+   * parameter's own matrix - paired with its 64-byte size. The array is
+   * borrowed, not copied.
+   */
   GetDestination() {
     return {
       dest: this.#reroutedValue ?? this.value,
       size: 64
     };
   }
+
+  /**
+   * Adds a binding to be notified whenever the destination is repointed;
+   * duplicates are ignored.
+   */
   RegisterBinding(binding) {
     CjsVectorParameter.registerBinding(this.#bindings, binding);
   }
+
+  /** Stops notifying a binding; unknown bindings are ignored. */
   UnregisterBinding(binding) {
     CjsVectorParameter.unregisterBinding(this.#bindings, binding);
   }
+
+  /**
+   * Records whether the shader reflects a constant of this name and drops a
+   * stale reroute when the shader is gone; reflection metadata only, no GPU
+   * handle.
+   */
   RebuildEffectHandles(effectRes) {
     if (!effectRes && this.#reroutedValue) {
       this.SetDestination(null, 0);
@@ -73,12 +116,23 @@ class Tr2Matrix4Parameter extends CjsVectorParameter {
     this.usedByCurrentEffect = used;
     this.usedByCurrentTechnique = used;
   }
+
+  /**
+   * Seeds an existing reroute destination with the current matrix; always
+   * returns true.
+   */
   Initialize() {
     if (this.#reroutedValue) {
       CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 16);
     }
     return true;
   }
+
+  /**
+   * Writes the 16 components an upload should use into the caller's destination,
+   * reading back through the reroute first; the stored element order is copied
+   * as-is, with no transpose.
+   */
   CopyValueToEffect(_inputType, out) {
     CjsVectorParameter.writeVectorDestination(out, this.GetValue(), 16);
   }

package/dist/shader/parameter/Tr2Matrix4Parameter.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2Matrix4Parameter.js","sources":["../../../../src/shader/parameter/Tr2Matrix4Parameter.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2Matrix4Parameter.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2Matrix4Parameter.cpp\nimport { mat4 } from \"@carbonenginejs/runtime-utils/mat4\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsVectorParameter } from \"./CjsVectorParameter.js\";\n\n\n@type.define({\n  className: \"Tr2Matrix4Parameter\",\n  family: \"shader\"\n})\nexport class Tr2Matrix4Parameter extends CjsVectorParameter\n{\n  @io.persistOnly\n  @type.mat4\n  value = mat4.create();\n\n  @io.read\n  @type.boolean\n  usedByCurrentTechnique = false;\n\n  @io.read\n  @type.boolean\n  usedByCurrentEffect = false;\n\n  @io.notify\n  @io.persist\n  @type.string\n  name = \"\";\n\n  #bindings = [];\n\n  #reroutedValue = null;\n\n  @carbon.method\n  @impl.implemented\n  GetParameterName()\n  {\n    return this.name;\n  }\n\n  /** Content hash: matrix bytes then name. */\n  @carbon.method\n  @impl.adapted\n  GetHashValue(startingHash = CjsVectorParameter.FNV1_INITIAL)\n  {\n    return CjsVectorParameter.hashFnv1String(this.name, CjsVectorParameter.hashFnv1Floats(this.value, startingHash));\n  }\n\n  @carbon.method\n  @impl.implemented\n  GetValue(out = mat4.create())\n  {\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.readVectorDestination(this.#reroutedValue, this.value, 16);\n    }\n    return CjsVectorParameter.copyNumberArray(out, this.value, 16);\n  }\n  @carbon.method\n  @impl.implemented\n  SetValue(value)\n  {\n    CjsVectorParameter.copyNumberArray(this.value, value, 16);\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 16);\n    }\n  }\n  @carbon.method\n  @impl.implemented\n  IsRerouted()\n  {\n    return this.#reroutedValue !== null;\n  }\n  @carbon.method\n  @impl.adapted\n  SetDestination(dest, size = 64)\n  {\n    if (size >= 64 && CjsVectorParameter.isVectorDestination(dest, 16))\n    {\n      this.#reroutedValue = dest;\n      CjsVectorParameter.writeVectorDestination(dest, this.value, 16);\n    }\n    else\n    {\n      this.#reroutedValue = null;\n    }\n    CjsVectorParameter.notifyBindings(this.#bindings, this.GetDestination().dest);\n  }\n  @carbon.method\n  @impl.adapted\n  GetDestination()\n  {\n    return {\n      dest: this.#reroutedValue ?? this.value,\n      size: 64\n    };\n  }\n  @carbon.method\n  @impl.adapted\n  RegisterBinding(binding)\n  {\n    CjsVectorParameter.registerBinding(this.#bindings, binding);\n  }\n  @carbon.method\n  @impl.adapted\n  UnregisterBinding(binding)\n  {\n    CjsVectorParameter.unregisterBinding(this.#bindings, binding);\n  }\n  @carbon.method\n  @impl.adapted\n  RebuildEffectHandles(effectRes)\n  {\n    if (!effectRes && this.#reroutedValue)\n    {\n      this.SetDestination(null, 0);\n    }\n    const used = !!this.name && CjsVectorParameter.hasEffectConstant(effectRes, this.name);\n    this.usedByCurrentEffect = used;\n    this.usedByCurrentTechnique = used;\n  }\n  @carbon.method\n  @impl.implemented\n  Initialize()\n  {\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 16);\n    }\n    return true;\n  }\n  @carbon.method\n  @impl.adapted\n  CopyValueToEffect(_inputType, out)\n  {\n    CjsVectorParameter.writeVectorDestination(out, this.GetValue(), 16);\n  }\n\n  /** JS convenience: raw values this parameter class claims for map-form inference. */\n  static isValue(value)\n  {\n    return CjsVectorParameter.isNumberArrayValue(value, 16);\n  }\n\n}\n"],"names":["_Tr2Matrix4Parameter","Tr2Matrix4Parameter","CjsVectorParameter","e","_init_value","_init_extra_value","_init_usedByCurrentTechnique","_init_extra_usedByCurrentTechnique","_init_usedByCurrentEffect","_init_extra_usedByCurrentEffect","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persistOnly","mat4","read","boolean","notify","persist","string","carbon","method","impl","implemented","adapted","value","create","usedByCurrentTechnique","usedByCurrentEffect","name","GetParameterName","GetHashValue","startingHash","FNV1_INITIAL","hashFnv1String","hashFnv1Floats","GetValue","out","readVectorDestination","copyNumberArray","SetValue","writeVectorDestination","IsRerouted","SetDestination","dest","size","isVectorDestination","notifyBindings","GetDestination","RegisterBinding","binding","registerBinding","UnregisterBinding","unregisterBinding","RebuildEffectHandles","effectRes","used","hasEffectConstant","Initialize","CopyValueToEffect","_inputType","isValue","isNumberArrayValue"],"mappings":"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"}
+{"version":3,"file":"Tr2Matrix4Parameter.js","sources":["../../../../src/shader/parameter/Tr2Matrix4Parameter.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2Matrix4Parameter.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2Matrix4Parameter.cpp\nimport { mat4 } from \"@carbonenginejs/runtime-utils/mat4\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsVectorParameter } from \"./CjsVectorParameter.js\";\n\n\n/**\n * 4x4 matrix value for a named shader constant, with optional rerouting into an\n * external 64-byte destination.\n */\n@type.define({\n  className: \"Tr2Matrix4Parameter\",\n  family: \"shader\"\n})\nexport class Tr2Matrix4Parameter extends CjsVectorParameter\n{\n  @io.persistOnly\n  @type.mat4\n  value = mat4.create();\n\n  @io.read\n  @type.boolean\n  usedByCurrentTechnique = false;\n\n  @io.read\n  @type.boolean\n  usedByCurrentEffect = false;\n\n  @io.notify\n  @io.persist\n  @type.string\n  name = \"\";\n\n  #bindings = [];\n\n  #reroutedValue = null;\n\n  /** The shader constant name this matrix binds to; empty until authored. */\n  @carbon.method\n  @impl.implemented\n  GetParameterName()\n  {\n    return this.name;\n  }\n\n  /** Content hash: matrix bytes then name. */\n  @carbon.method\n  @impl.adapted\n  GetHashValue(startingHash = CjsVectorParameter.FNV1_INITIAL)\n  {\n    return CjsVectorParameter.hashFnv1String(this.name, CjsVectorParameter.hashFnv1Floats(this.value, startingHash));\n  }\n\n  /**\n   * Refreshes from the reroute destination when one is set, then copies 16 components out.\n   * @param out defaults to a freshly allocated matrix the caller owns\n   */\n  @carbon.method\n  @impl.implemented\n  GetValue(out = mat4.create())\n  {\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.readVectorDestination(this.#reroutedValue, this.value, 16);\n    }\n    return CjsVectorParameter.copyNumberArray(out, this.value, 16);\n  }\n\n  /**\n   * Copies 16 components in and writes through to the reroute destination when\n   * one is set.\n   */\n  @carbon.method\n  @impl.implemented\n  SetValue(value)\n  {\n    CjsVectorParameter.copyNumberArray(this.value, value, 16);\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 16);\n    }\n  }\n\n  /** Whether reads and writes currently go through an external destination. */\n  @carbon.method\n  @impl.implemented\n  IsRerouted()\n  {\n    return this.#reroutedValue !== null;\n  }\n\n  /**\n   * Points the parameter at an external destination and seeds it with the current matrix; a target under 64 bytes or not writable as 16 components clears the reroute instead. Bindings are notified of the effective destination either way.\n   * @param size destination capacity in bytes, not components\n   */\n  @carbon.method\n  @impl.adapted\n  SetDestination(dest, size = 64)\n  {\n    if (size >= 64 && CjsVectorParameter.isVectorDestination(dest, 16))\n    {\n      this.#reroutedValue = dest;\n      CjsVectorParameter.writeVectorDestination(dest, this.value, 16);\n    }\n    else\n    {\n      this.#reroutedValue = null;\n    }\n    CjsVectorParameter.notifyBindings(this.#bindings, this.GetDestination().dest);\n  }\n\n  /**\n   * The array an upload should read - the reroute target when set, otherwise the\n   * parameter's own matrix - paired with its 64-byte size. The array is\n   * borrowed, not copied.\n   */\n  @carbon.method\n  @impl.adapted\n  GetDestination()\n  {\n    return {\n      dest: this.#reroutedValue ?? this.value,\n      size: 64\n    };\n  }\n\n  /**\n   * Adds a binding to be notified whenever the destination is repointed;\n   * duplicates are ignored.\n   */\n  @carbon.method\n  @impl.adapted\n  RegisterBinding(binding)\n  {\n    CjsVectorParameter.registerBinding(this.#bindings, binding);\n  }\n\n  /** Stops notifying a binding; unknown bindings are ignored. */\n  @carbon.method\n  @impl.adapted\n  UnregisterBinding(binding)\n  {\n    CjsVectorParameter.unregisterBinding(this.#bindings, binding);\n  }\n\n  /**\n   * Records whether the shader reflects a constant of this name and drops a\n   * stale reroute when the shader is gone; reflection metadata only, no GPU\n   * handle.\n   */\n  @carbon.method\n  @impl.adapted\n  RebuildEffectHandles(effectRes)\n  {\n    if (!effectRes && this.#reroutedValue)\n    {\n      this.SetDestination(null, 0);\n    }\n    const used = !!this.name && CjsVectorParameter.hasEffectConstant(effectRes, this.name);\n    this.usedByCurrentEffect = used;\n    this.usedByCurrentTechnique = used;\n  }\n\n  /**\n   * Seeds an existing reroute destination with the current matrix; always\n   * returns true.\n   */\n  @carbon.method\n  @impl.implemented\n  Initialize()\n  {\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 16);\n    }\n    return true;\n  }\n\n  /**\n   * Writes the 16 components an upload should use into the caller's destination,\n   * reading back through the reroute first; the stored element order is copied\n   * as-is, with no transpose.\n   */\n  @carbon.method\n  @impl.adapted\n  CopyValueToEffect(_inputType, out)\n  {\n    CjsVectorParameter.writeVectorDestination(out, this.GetValue(), 16);\n  }\n\n  /** JS convenience: raw values this parameter class claims for map-form inference. */\n  static isValue(value)\n  {\n    return CjsVectorParameter.isNumberArrayValue(value, 16);\n  }\n\n}\n"],"names":["_Tr2Matrix4Parameter","Tr2Matrix4Parameter","CjsVectorParameter","e","_init_value","_init_extra_value","_init_usedByCurrentTechnique","_init_extra_usedByCurrentTechnique","_init_usedByCurrentEffect","_init_extra_usedByCurrentEffect","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persistOnly","mat4","read","boolean","notify","persist","string","carbon","method","impl","implemented","adapted","value","create","usedByCurrentTechnique","usedByCurrentEffect","name","GetParameterName","GetHashValue","startingHash","FNV1_INITIAL","hashFnv1String","hashFnv1Floats","GetValue","out","readVectorDestination","copyNumberArray","SetValue","writeVectorDestination","IsRerouted","SetDestination","dest","size","isVectorDestination","notifyBindings","GetDestination","RegisterBinding","binding","registerBinding","UnregisterBinding","unregisterBinding","RebuildEffectHandles","effectRes","used","hasEffectConstant","Initialize","CopyValueToEffect","_inputType","isValue","isNumberArrayValue"],"mappings":"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"}

package/dist/shader/parameter/Tr2RuntimeTextureParameter.js

@@ -3,6 +3,11 @@ import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { CjsParameter } from './CjsParameter.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.
+ */
 let _Tr2RuntimeTexturePar;
 class Tr2RuntimeTextureParameter extends CjsParameter {
   static {
@@ -18,9 +23,19 @@ class Tr2RuntimeTextureParameter extends CjsParameter {
   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.
+   */
   __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.
+   */
   Create(name, texture, uavMipLevel = 0) {
     const nextName = String(name);
     const nextMipLevel = uavMipLevel >>> 0;
@@ -37,6 +52,8 @@ class Tr2RuntimeTextureParameter extends CjsParameter {
     });
     return true;
   }
+
+  /** The shader resource name this texture binds to. */
   GetParameterName() {
     return this.name;
   }
@@ -45,15 +62,30 @@ class Tr2RuntimeTextureParameter extends CjsParameter {
   GetHashValue(startingHash = CjsParameter.FNV1_INITIAL) {
     return CjsParameter.hashFnv1Identity(this.texture, startingHash);
   }
+
+  /**
+   * Invalidates the resource sets of every material this parameter is attached
+   * to.
+   */
   OnModified(_options = {}) {
     this.#invalidateResourceSets();
     return true;
   }
+
+  /**
+   * Deliberately does nothing: Carbon caches the effect resource type here for
+   * later resource-set binding, which runtime-trinity leaves to engine adapters.
+   */
   RebuildEffectHandles(_effectRes) {
 
     // Carbon caches the effect resource type here for later resource-set
     // binding. Runtime-trinity leaves that realization to engine adapters.
   }
+
+  /**
+   * Swaps the texture provider and notifies owners; returns false when it is
+   * already the same object.
+   */
   SetTextureProvider(texture) {
     if (this.texture === texture) {
       return false;
@@ -65,23 +97,45 @@ class Tr2RuntimeTextureParameter extends CjsParameter {
     });
     return true;
   }
+
+  /**
+   * 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.
+   */
   SetUavMipLevel(mipLevel) {
     this.uavMipLevel = mipLevel >>> 0;
   }
+
+  /**
+   * Registers a material to be invalidated when this parameter changes;
+   * duplicates are ignored.
+   */
   OnAddedToMaterial(material) {
     if (!this.#materials.includes(material)) {
       this.#materials.push(material);
     }
   }
+
+  /**
+   * 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);
     if (index >= 0) {
       this.#materials.splice(index, 1);
     }
   }
+
+  /** Invalidates the resource sets of every attached material. */
   #invalidateResourceSets() {
     for (const material of this.#materials) {
       material?.InvalidateResourceSets?.();

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

@@ -1 +1 @@
-{"version":3,"file":"Tr2RuntimeTextureParameter.js","sources":["../../../../src/shader/parameter/Tr2RuntimeTextureParameter.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2RuntimeTextureParameter.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2RuntimeTextureParameter.cpp\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2RuntimeTextureParameter_Blue.cpp\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { CjsParameter } from \"./CjsParameter.js\";\r\n\r\n\r\n@type.define({\r\n  className: \"Tr2RuntimeTextureParameter\",\r\n  family: \"shader\"\r\n})\r\nexport class Tr2RuntimeTextureParameter extends CjsParameter\r\n{\r\n  @io.notify\r\n  @io.persist\r\n  @type.objectRef(\"ITr2TextureProvider\")\r\n  texture = null;\r\n\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  @io.persist\r\n  @type.uint32\r\n  uavMipLevel = 0;\r\n\r\n  #materials = [];\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  @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  @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  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    this.#invalidateResourceSets();\r\n    return true;\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. Runtime-trinity leaves that realization to engine adapters.\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  @carbon.method\r\n  @impl.implemented\r\n  GetTextureProvider()\r\n  {\r\n    return this.texture;\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  @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  @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  #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","io","notify","persist","objectRef","string","uint32","carbon","method","impl","adapted","implemented","texture","name","uavMipLevel","__init__","Create","nextName","String","nextMipLevel","changed","UpdateValues","property","source","GetParameterName","GetHashValue","startingHash","FNV1_INITIAL","hashFnv1Identity","OnModified","_options","RebuildEffectHandles","_effectRes","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/shader/parameter/Tr2RuntimeTextureParameter.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2RuntimeTextureParameter.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2RuntimeTextureParameter.cpp\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2RuntimeTextureParameter_Blue.cpp\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { CjsParameter } from \"./CjsParameter.js\";\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\nexport class Tr2RuntimeTextureParameter extends CjsParameter\r\n{\r\n  @io.notify\r\n  @io.persist\r\n  @type.objectRef(\"ITr2TextureProvider\")\r\n  texture = null;\r\n\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  @io.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  OnModified(_options = {})\r\n  {\r\n    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 runtime-trinity 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. Runtime-trinity leaves that realization to engine adapters.\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","io","notify","persist","objectRef","string","uint32","carbon","method","impl","adapted","implemented","texture","name","uavMipLevel","__init__","Create","nextName","String","nextMipLevel","changed","UpdateValues","property","source","GetParameterName","GetHashValue","startingHash","FNV1_INITIAL","hashFnv1Identity","OnModified","_options","RebuildEffectHandles","_effectRes","SetTextureProvider","GetTextureProvider","SetUavMipLevel","mipLevel","OnAddedToMaterial","material","includes","push","OnRemovedFromMaterial","index","indexOf","splice","#invalidateResourceSets","InvalidateResourceSets"],"mappings":"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"}

package/dist/shader/parameter/Tr2TextureAnimationParameter.js

@@ -26,6 +26,8 @@ class Tr2TextureAnimationParameter extends CjsParameter {
   name = (_init_extra_channel(this), _init_name(this, ""));
   resourceType = (_init_extra_name(this), 0);
   #materials = [];
+
+  /** The shader resource name the animated texture binds to. */
   GetParameterName() {
     return this.name;
   }
@@ -34,35 +36,68 @@ class Tr2TextureAnimationParameter extends CjsParameter {
   GetHashValue(startingHash = CjsParameter.FNV1_INITIAL) {
     return CjsParameter.hashFnv1Identity(this.animation, startingHash);
   }
+
+  /**
+   * Marks every attached material's resource sets and constant buffers dirty
+   * after the animation reference changed.
+   */
   OnModified(_options = {}) {
     for (const material of this.#materials) {
       CjsParameter.markMaterialResourcesDirty(material);
     }
     return true;
   }
+
+  /**
+   * Caches the reflected resource type for this name when the shader exposes
+   * one, and leaves the previous type in place otherwise; no GPU binding is
+   * created.
+   */
   RebuildEffectHandles(effectRes) {
     const resource = this.name ? CjsParameter.getEffectResource(effectRes, this.name) : null;
     if (resource) {
       this.resourceType = resource.type ?? this.resourceType;
     }
   }
+
+  /**
+   * Always false - populating a resource set is device work this package does
+   * not do.
+   */
   CopyToResourceSet() {
     return false;
   }
+
+  /** Always false - UAV binding is left to the engine adapter. */
   ApplyUav() {
     return false;
   }
+
+  /**
+   * Registers a material to be dirtied when the animation changes; duplicates
+   * are ignored.
+   */
   OnAddedToMaterial(material) {
     if (!this.#materials.includes(material)) {
       this.#materials.push(material);
     }
   }
+
+  /**
+   * Drops a material from the tracked list, so later frame advances no longer
+   * mark it dirty.
+   */
   OnRemovedFromMaterial(material) {
     const index = this.#materials.indexOf(material);
     if (index >= 0) {
       this.#materials.splice(index, 1);
     }
   }
+
+  /**
+   * The animation's texture for this parameter's channel, or null when no
+   * animation is attached.
+   */
   GetTexture() {
     return this.animation?.GetTexture?.(this.channel) ?? this.animation?.getTexture?.(this.channel) ?? null;
   }

package/dist/shader/parameter/Tr2TextureAnimationParameter.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2TextureAnimationParameter.js","sources":["../../../../src/shader/parameter/Tr2TextureAnimationParameter.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\r\n//   trinity/trinity/Shader/Parameter/Tr2TextureAnimationParameter.h\r\n// Generated by format-carbon carbon-class --emit. Verify against shader/Tr2TextureAnimationParameter.json.\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { CjsParameter } from \"./CjsParameter.js\";\r\n\r\n/** Tr2TextureAnimationParameter (shader) - generated from schema shapeHash 609a4065.... */\r\n@type.define({ className: \"Tr2TextureAnimationParameter\", family: \"shader\" })\r\nexport class Tr2TextureAnimationParameter extends CjsParameter\r\n{\r\n\r\n  /** m_animation (Tr2TextureAnimationPtr) [READWRITE, PERSIST, NOTIFY] */\r\n  @io.notify\r\n  @io.persist\r\n  @type.objectRef(\"Tr2TextureAnimation\")\r\n  animation = null;\r\n\r\n  /** m_channel (BlueSharedString) [READWRITE, PERSIST] */\r\n  @io.persist\r\n  @type.string\r\n  channel = \"\";\r\n\r\n  /** m_name (BlueSharedString) [READWRITE, PERSIST] */\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  resourceType = 0;\r\n\r\n  #materials = [];\r\n\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 animation object'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.animation, startingHash);\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    for (const material of this.#materials)\r\n    {\r\n      CjsParameter.markMaterialResourcesDirty(material);\r\n    }\r\n    return true;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.adapted\r\n  RebuildEffectHandles(effectRes)\r\n  {\r\n    const resource = this.name ? CjsParameter.getEffectResource(effectRes, this.name) : null;\r\n    if (resource)\r\n    {\r\n      this.resourceType = resource.type ?? this.resourceType;\r\n    }\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.adapted\r\n  CopyToResourceSet()\r\n  {\r\n    return false;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.implemented\r\n  ApplyUav()\r\n  {\r\n    return false;\r\n  }\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  @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  @carbon.method\r\n  @impl.adapted\r\n  GetTexture()\r\n  {\r\n    return this.animation?.GetTexture?.(this.channel) ?? this.animation?.getTexture?.(this.channel) ?? null;\r\n  }\r\n\r\n}\r\n"],"names":["_Tr2TextureAnimationP","Tr2TextureAnimationParameter","CjsParameter","e","_init_animation","_init_extra_animation","_init_channel","_init_extra_channel","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","notify","persist","objectRef","string","carbon","method","impl","implemented","adapted","animation","channel","name","resourceType","GetParameterName","GetHashValue","startingHash","FNV1_INITIAL","hashFnv1Identity","OnModified","_options","material","markMaterialResourcesDirty","RebuildEffectHandles","effectRes","resource","getEffectResource","CopyToResourceSet","ApplyUav","OnAddedToMaterial","includes","push","OnRemovedFromMaterial","index","indexOf","splice","GetTexture","getTexture"],"mappings":"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"}
+{"version":3,"file":"Tr2TextureAnimationParameter.js","sources":["../../../../src/shader/parameter/Tr2TextureAnimationParameter.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\r\n//   trinity/trinity/Shader/Parameter/Tr2TextureAnimationParameter.h\r\n// Generated by format-carbon carbon-class --emit. Verify against shader/Tr2TextureAnimationParameter.json.\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { CjsParameter } from \"./CjsParameter.js\";\r\n\r\n/** Tr2TextureAnimationParameter (shader) - generated from schema shapeHash 609a4065.... */\r\n@type.define({ className: \"Tr2TextureAnimationParameter\", family: \"shader\" })\r\nexport class Tr2TextureAnimationParameter extends CjsParameter\r\n{\r\n\r\n  /** m_animation (Tr2TextureAnimationPtr) [READWRITE, PERSIST, NOTIFY] */\r\n  @io.notify\r\n  @io.persist\r\n  @type.objectRef(\"Tr2TextureAnimation\")\r\n  animation = null;\r\n\r\n  /** m_channel (BlueSharedString) [READWRITE, PERSIST] */\r\n  @io.persist\r\n  @type.string\r\n  channel = \"\";\r\n\r\n  /** m_name (BlueSharedString) [READWRITE, PERSIST] */\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  resourceType = 0;\r\n\r\n  #materials = [];\r\n\r\n  /** The shader resource name the animated 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 animation object'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.animation, startingHash);\r\n  }\r\n\r\n  /**\r\n   * Marks every attached material's resource sets and constant buffers dirty\r\n   * after the animation reference changed.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    for (const material of this.#materials)\r\n    {\r\n      CjsParameter.markMaterialResourcesDirty(material);\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Caches the reflected resource type for this name when the shader exposes\r\n   * one, and leaves the previous type in place otherwise; no GPU binding is\r\n   * created.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  RebuildEffectHandles(effectRes)\r\n  {\r\n    const resource = this.name ? CjsParameter.getEffectResource(effectRes, this.name) : null;\r\n    if (resource)\r\n    {\r\n      this.resourceType = resource.type ?? this.resourceType;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Always false - populating a resource set is device work this package does\r\n   * not do.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  CopyToResourceSet()\r\n  {\r\n    return false;\r\n  }\r\n\r\n  /** Always false - UAV binding is left to the engine adapter. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  ApplyUav()\r\n  {\r\n    return false;\r\n  }\r\n\r\n  /**\r\n   * Registers a material to be dirtied when the animation changes; duplicates\r\n   * 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 frame advances no longer\r\n   * mark it dirty.\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  /**\r\n   * The animation's texture for this parameter's channel, or null when no\r\n   * animation is attached.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetTexture()\r\n  {\r\n    return this.animation?.GetTexture?.(this.channel) ?? this.animation?.getTexture?.(this.channel) ?? null;\r\n  }\r\n\r\n}\r\n"],"names":["_Tr2TextureAnimationP","Tr2TextureAnimationParameter","CjsParameter","e","_init_animation","_init_extra_animation","_init_channel","_init_extra_channel","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","notify","persist","objectRef","string","carbon","method","impl","implemented","adapted","animation","channel","name","resourceType","GetParameterName","GetHashValue","startingHash","FNV1_INITIAL","hashFnv1Identity","OnModified","_options","material","markMaterialResourcesDirty","RebuildEffectHandles","effectRes","resource","getEffectResource","CopyToResourceSet","ApplyUav","OnAddedToMaterial","includes","push","OnRemovedFromMaterial","index","indexOf","splice","GetTexture","getTexture"],"mappings":"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"}