@carbonenginejs/runtime-trinity 0.6.0 → 0.8.0

package/dist/shader/parameter/Tr2Vector4Parameter.js

@@ -5,6 +5,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_isSrgb, _init_extra_isSrgb, _init_usedByCurrentTechnique, _init_extra_usedByCurrentTechnique, _init_usedByCurrentEffect, _init_extra_usedByCurrentEffect, _init_name, _init_extra_name;
+
+/**
+ * Four-component float value for a named shader constant, with sRGB gamma
+ * handling and optional rerouting into an external destination.
+ */
 let _Tr2Vector4Parameter;
 class Tr2Vector4Parameter extends CjsVectorParameter {
   static {
@@ -30,6 +35,11 @@ class Tr2Vector4Parameter extends CjsVectorParameter {
     this.GetValue();
     return this.value[0];
   }
+
+  /**
+   * Writes component 0 and marks the parameter dirty, so the next apply carries
+   * the new value.
+   */
   set x(component) {
     this.#setComponent(0, component);
   }
@@ -39,6 +49,11 @@ class Tr2Vector4Parameter extends CjsVectorParameter {
     this.GetValue();
     return this.value[1];
   }
+
+  /**
+   * Writes component 1 and marks the parameter dirty, so the next apply carries
+   * the new value.
+   */
   set y(component) {
     this.#setComponent(1, component);
   }
@@ -48,6 +63,11 @@ class Tr2Vector4Parameter extends CjsVectorParameter {
     this.GetValue();
     return this.value[2];
   }
+
+  /**
+   * Writes component 2 and marks the parameter dirty, so the next apply carries
+   * the new value.
+   */
   set z(component) {
     this.#setComponent(2, component);
   }
@@ -57,33 +77,56 @@ class Tr2Vector4Parameter extends CjsVectorParameter {
     this.GetValue();
     return this.value[3];
   }
+
+  /**
+   * Writes component 3 and marks the parameter dirty, so the next apply carries
+   * the new value.
+   */
   set w(component) {
     this.#setComponent(3, component);
   }
+
+  /** Blue MAP_PROPERTY alias reading `x`. */
   get v1() {
     return this.x;
   }
+
+  /** Blue MAP_PROPERTY alias writing `x`. */
   set v1(component) {
     this.x = component;
   }
+
+  /** Blue MAP_PROPERTY alias reading `y`. */
   get v2() {
     return this.y;
   }
+
+  /** Blue MAP_PROPERTY alias writing `y`. */
   set v2(component) {
     this.y = component;
   }
+
+  /** Blue MAP_PROPERTY alias reading `z`. */
   get v3() {
     return this.z;
   }
+
+  /** Blue MAP_PROPERTY alias writing `z`. */
   set v3(component) {
     this.z = component;
   }
+
+  /** Blue MAP_PROPERTY alias reading `w`. */
   get v4() {
     return this.w;
   }
+
+  /** Blue MAP_PROPERTY alias writing `w`. */
   set v4(component) {
     this.w = component;
   }
+
+  /** The shader constant name this value binds to; empty until authored. */
   GetParameterName() {
     return this.name;
   }
@@ -92,12 +135,22 @@ class Tr2Vector4Parameter 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 four components out.
+   * @param out defaults to the parameter's own value array, so a caller passing nothing gets a live reference rather than a copy
+   */
   GetValue(out = this.value) {
     if (this.#reroutedValue) {
       CjsVectorParameter.readVectorDestination(this.#reroutedValue, this.value, 4);
     }
     return CjsVectorParameter.copyNumberArray(out, this.value, 4);
   }
+
+  /**
+   * Copies four components in, refreshes the linear mirror and writes through to
+   * the reroute destination when one is set.
+   */
   SetValue(value) {
     CjsVectorParameter.copyNumberArray(this.value, value, 4);
     this.#updateLinearValue();
@@ -105,9 +158,20 @@ class Tr2Vector4Parameter extends CjsVectorParameter {
       CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 4);
     }
   }
+
+  /**
+   * Whether reads and writes go through an external destination; an sRGB
+   * constant is never rerouted, because its value must be gamma-converted before
+   * upload.
+   */
   IsRerouted() {
     return !this.isSrgb && this.#reroutedValue !== null;
   }
+
+  /**
+   * Points the parameter at an external destination and seeds it with the current value; a target smaller than 16 bytes, not writable as four components, or belonging to an sRGB constant clears the reroute instead. Registered bindings are notified of the effective destination either way.
+   * @param size destination capacity in bytes, not components
+   */
   SetDestination(dest, size = 16) {
     if (size >= 16 && !this.isSrgb && CjsVectorParameter.isVectorDestination(dest, 4)) {
       this.#reroutedValue = dest;
@@ -118,18 +182,37 @@ class Tr2Vector4Parameter 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 value - paired with its 16-byte size. The array is borrowed,
+   * not copied.
+   */
   GetDestination() {
     return {
       dest: this.#reroutedValue ?? this.value,
       size: 16
     };
   }
+
+  /**
+   * 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);
   }
+
+  /**
+   * Re-resolves usage and the sRGB flag from the shader's reflected constant,
+   * dropping the reroute when the shader is gone or the constant turns out to be
+   * sRGB. Reads reflection metadata only; no GPU handle is bound.
+   */
   RebuildEffectHandles(effectRes) {
     this.isSrgb = false;
     if (!effectRes && this.#reroutedValue) {
@@ -145,6 +228,11 @@ class Tr2Vector4Parameter extends CjsVectorParameter {
     }
     this.#updateLinearValue();
   }
+
+  /**
+   * Seeds an existing reroute destination with the current value and refreshes
+   * the linear mirror; always returns true.
+   */
   Initialize() {
     if (this.#reroutedValue) {
       CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 4);
@@ -152,10 +240,22 @@ class Tr2Vector4Parameter extends CjsVectorParameter {
     this.#updateLinearValue();
     return true;
   }
+
+  /**
+   * Writes the four components an upload should use - the rerouted value, or the
+   * gamma-converted linear mirror for an sRGB constant - into the caller's
+   * destination.
+   */
   CopyValueToEffect(_inputType, out) {
     const source = this.#reroutedValue ?? (this.isSrgb ? this.linearValue : this.value);
     CjsVectorParameter.writeVectorDestination(out, source, 4);
   }
+
+  /**
+   * Refreshes the linear mirror: a plain copy when not sRGB, otherwise
+   * gamma-to-linear on the first three components with alpha passed through
+   * unchanged.
+   */
   #updateLinearValue() {
     if (!this.isSrgb) {
       CjsVectorParameter.copyNumberArray(this.linearValue, this.value, 4);
@@ -166,6 +266,11 @@ class Tr2Vector4Parameter extends CjsVectorParameter {
     this.linearValue[2] = num.gammaToLinear(this.value[2]);
     this.linearValue[3] = this.value[3];
   }
+
+  /**
+   * Assigns one component in place and re-runs SetValue so the linear mirror and
+   * any reroute stay in sync.
+   */
   #setComponent(index, component) {
     this.value[index] = Number(component);
     this.SetValue(this.value);

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

@@ -1 +1 @@
-{"version":3,"file":"Tr2Vector4Parameter.js","sources":["../../../../src/shader/parameter/Tr2Vector4Parameter.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2Vector4Parameter.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2Vector4Parameter.cpp\nimport { num } from \"@carbonenginejs/runtime-utils/num\";\nimport { vec4 } from \"@carbonenginejs/runtime-utils/vec4\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsVectorParameter } from \"./CjsVectorParameter.js\";\n\n\n@type.define({\n  className: \"Tr2Vector4Parameter\",\n  family: \"shader\"\n})\nexport class Tr2Vector4Parameter extends CjsVectorParameter\n{\n  @io.persistOnly\n  @type.vec4\n  value = vec4.fromValues(1, 1, 1, 1);\n\n  @io.read\n  @type.boolean\n  isSrgb = false;\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  linearValue = vec4.fromValues(1, 1, 1, 1);\n\n  #bindings = [];\n\n  #reroutedValue = null;\n\n  /** Blue MAP_PROPERTY \"x\"/\"v1\" - refreshes from the rerouted value on read. */\n  get x()\n  {\n    this.GetValue();\n    return this.value[0];\n  }\n\n  set x(component)\n  {\n    this.#setComponent(0, component);\n  }\n\n  /** Blue MAP_PROPERTY \"y\"/\"v2\". */\n  get y()\n  {\n    this.GetValue();\n    return this.value[1];\n  }\n\n  set y(component)\n  {\n    this.#setComponent(1, component);\n  }\n\n  /** Blue MAP_PROPERTY \"z\"/\"v3\". */\n  get z()\n  {\n    this.GetValue();\n    return this.value[2];\n  }\n\n  set z(component)\n  {\n    this.#setComponent(2, component);\n  }\n\n  /** Blue MAP_PROPERTY \"w\"/\"v4\". */\n  get w()\n  {\n    this.GetValue();\n    return this.value[3];\n  }\n\n  set w(component)\n  {\n    this.#setComponent(3, component);\n  }\n\n  get v1()\n  {\n    return this.x;\n  }\n\n  set v1(component)\n  {\n    this.x = component;\n  }\n\n  get v2()\n  {\n    return this.y;\n  }\n\n  set v2(component)\n  {\n    this.y = component;\n  }\n\n  get v3()\n  {\n    return this.z;\n  }\n\n  set v3(component)\n  {\n    this.z = component;\n  }\n\n  get v4()\n  {\n    return this.w;\n  }\n\n  set v4(component)\n  {\n    this.w = component;\n  }\n\n  @carbon.method\n  @impl.implemented\n  GetParameterName()\n  {\n    return this.name;\n  }\n\n  /** Content hash: authored value 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 = this.value)\n  {\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.readVectorDestination(this.#reroutedValue, this.value, 4);\n    }\n    return CjsVectorParameter.copyNumberArray(out, this.value, 4);\n  }\n\n  @carbon.method\n  @impl.implemented\n  SetValue(value)\n  {\n    CjsVectorParameter.copyNumberArray(this.value, value, 4);\n    this.#updateLinearValue();\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 4);\n    }\n  }\n\n  @carbon.method\n  @impl.implemented\n  IsRerouted()\n  {\n    return !this.isSrgb && this.#reroutedValue !== null;\n  }\n\n  @carbon.method\n  @impl.adapted\n  SetDestination(dest, size = 16)\n  {\n    if (size >= 16 && !this.isSrgb && CjsVectorParameter.isVectorDestination(dest, 4))\n    {\n      this.#reroutedValue = dest;\n      CjsVectorParameter.writeVectorDestination(dest, this.value, 4);\n    }\n    else\n    {\n      this.#reroutedValue = null;\n      this.#updateLinearValue();\n    }\n    CjsVectorParameter.notifyBindings(this.#bindings, this.GetDestination().dest);\n  }\n\n  @carbon.method\n  @impl.adapted\n  GetDestination()\n  {\n    return {\n      dest: this.#reroutedValue ?? this.value,\n      size: 16\n    };\n  }\n\n  @carbon.method\n  @impl.adapted\n  RegisterBinding(binding)\n  {\n    CjsVectorParameter.registerBinding(this.#bindings, binding);\n  }\n\n  @carbon.method\n  @impl.adapted\n  UnregisterBinding(binding)\n  {\n    CjsVectorParameter.unregisterBinding(this.#bindings, binding);\n  }\n\n  @carbon.method\n  @impl.adapted\n  RebuildEffectHandles(effectRes)\n  {\n    this.isSrgb = false;\n    if (!effectRes && this.#reroutedValue)\n    {\n      this.SetDestination(null, 0);\n    }\n    const constant = this.name ? CjsVectorParameter.getEffectConstant(effectRes, this.name) : null;\n    const used = !!constant;\n    this.usedByCurrentEffect = used;\n    this.usedByCurrentTechnique = used;\n    this.isSrgb = CjsVectorParameter.getConstantIsSrgb(constant);\n    if (this.isSrgb)\n    {\n      this.SetDestination(null, 0);\n    }\n    this.#updateLinearValue();\n  }\n\n  @carbon.method\n  @impl.implemented\n  Initialize()\n  {\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 4);\n    }\n    this.#updateLinearValue();\n    return true;\n  }\n\n  @carbon.method\n  @impl.adapted\n  CopyValueToEffect(_inputType, out)\n  {\n    const source = this.#reroutedValue ?? (this.isSrgb ? this.linearValue : this.value);\n    CjsVectorParameter.writeVectorDestination(out, source, 4);\n  }\n\n  #updateLinearValue()\n  {\n    if (!this.isSrgb)\n    {\n      CjsVectorParameter.copyNumberArray(this.linearValue, this.value, 4);\n      return;\n    }\n    this.linearValue[0] = num.gammaToLinear(this.value[0]);\n    this.linearValue[1] = num.gammaToLinear(this.value[1]);\n    this.linearValue[2] = num.gammaToLinear(this.value[2]);\n    this.linearValue[3] = this.value[3];\n  }\n\n  #setComponent(index, component)\n  {\n    this.value[index] = Number(component);\n    this.SetValue(this.value);\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, 4);\n  }\n\n}\n"],"names":["_Tr2Vector4Parameter","Tr2Vector4Parameter","CjsVectorParameter","e","_init_value","_init_extra_value","_init_isSrgb","_init_extra_isSrgb","_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","vec4","read","boolean","notify","persist","string","carbon","method","impl","implemented","adapted","value","fromValues","isSrgb","usedByCurrentTechnique","usedByCurrentEffect","name","linearValue","x","GetValue","component","y","z","w","v1","v2","v3","v4","GetParameterName","GetHashValue","startingHash","FNV1_INITIAL","hashFnv1String","hashFnv1Floats","out","readVectorDestination","copyNumberArray","SetValue","writeVectorDestination","IsRerouted","SetDestination","dest","size","isVectorDestination","notifyBindings","GetDestination","RegisterBinding","binding","registerBinding","UnregisterBinding","unregisterBinding","RebuildEffectHandles","effectRes","constant","getEffectConstant","used","getConstantIsSrgb","Initialize","CopyValueToEffect","_inputType","source","#updateLinearValue","num","gammaToLinear","#setComponent","index","Number","isValue","isNumberArrayValue"],"mappings":"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"}
+{"version":3,"file":"Tr2Vector4Parameter.js","sources":["../../../../src/shader/parameter/Tr2Vector4Parameter.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2Vector4Parameter.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\Tr2Vector4Parameter.cpp\nimport { num } from \"@carbonenginejs/runtime-utils/num\";\nimport { vec4 } from \"@carbonenginejs/runtime-utils/vec4\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsVectorParameter } from \"./CjsVectorParameter.js\";\n\n\n/**\n * Four-component float value for a named shader constant, with sRGB gamma\n * handling and optional rerouting into an external destination.\n */\n@type.define({\n  className: \"Tr2Vector4Parameter\",\n  family: \"shader\"\n})\nexport class Tr2Vector4Parameter extends CjsVectorParameter\n{\n  @io.persistOnly\n  @type.vec4\n  value = vec4.fromValues(1, 1, 1, 1);\n\n  @io.read\n  @type.boolean\n  isSrgb = false;\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  linearValue = vec4.fromValues(1, 1, 1, 1);\n\n  #bindings = [];\n\n  #reroutedValue = null;\n\n  /** Blue MAP_PROPERTY \"x\"/\"v1\" - refreshes from the rerouted value on read. */\n  get x()\n  {\n    this.GetValue();\n    return this.value[0];\n  }\n\n  /**\n   * Writes component 0 and marks the parameter dirty, so the next apply carries\n   * the new value.\n   */\n  set x(component)\n  {\n    this.#setComponent(0, component);\n  }\n\n  /** Blue MAP_PROPERTY \"y\"/\"v2\". */\n  get y()\n  {\n    this.GetValue();\n    return this.value[1];\n  }\n\n  /**\n   * Writes component 1 and marks the parameter dirty, so the next apply carries\n   * the new value.\n   */\n  set y(component)\n  {\n    this.#setComponent(1, component);\n  }\n\n  /** Blue MAP_PROPERTY \"z\"/\"v3\". */\n  get z()\n  {\n    this.GetValue();\n    return this.value[2];\n  }\n\n  /**\n   * Writes component 2 and marks the parameter dirty, so the next apply carries\n   * the new value.\n   */\n  set z(component)\n  {\n    this.#setComponent(2, component);\n  }\n\n  /** Blue MAP_PROPERTY \"w\"/\"v4\". */\n  get w()\n  {\n    this.GetValue();\n    return this.value[3];\n  }\n\n  /**\n   * Writes component 3 and marks the parameter dirty, so the next apply carries\n   * the new value.\n   */\n  set w(component)\n  {\n    this.#setComponent(3, component);\n  }\n\n  /** Blue MAP_PROPERTY alias reading `x`. */\n  get v1()\n  {\n    return this.x;\n  }\n\n  /** Blue MAP_PROPERTY alias writing `x`. */\n  set v1(component)\n  {\n    this.x = component;\n  }\n\n  /** Blue MAP_PROPERTY alias reading `y`. */\n  get v2()\n  {\n    return this.y;\n  }\n\n  /** Blue MAP_PROPERTY alias writing `y`. */\n  set v2(component)\n  {\n    this.y = component;\n  }\n\n  /** Blue MAP_PROPERTY alias reading `z`. */\n  get v3()\n  {\n    return this.z;\n  }\n\n  /** Blue MAP_PROPERTY alias writing `z`. */\n  set v3(component)\n  {\n    this.z = component;\n  }\n\n  /** Blue MAP_PROPERTY alias reading `w`. */\n  get v4()\n  {\n    return this.w;\n  }\n\n  /** Blue MAP_PROPERTY alias writing `w`. */\n  set v4(component)\n  {\n    this.w = component;\n  }\n\n  /** The shader constant name this value binds to; empty until authored. */\n  @carbon.method\n  @impl.implemented\n  GetParameterName()\n  {\n    return this.name;\n  }\n\n  /** Content hash: authored value 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 four components out.\n   * @param out defaults to the parameter's own value array, so a caller passing nothing gets a live reference rather than a copy\n   */\n  @carbon.method\n  @impl.implemented\n  GetValue(out = this.value)\n  {\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.readVectorDestination(this.#reroutedValue, this.value, 4);\n    }\n    return CjsVectorParameter.copyNumberArray(out, this.value, 4);\n  }\n\n  /**\n   * Copies four components in, refreshes the linear mirror and writes through to\n   * the reroute destination when one is set.\n   */\n  @carbon.method\n  @impl.implemented\n  SetValue(value)\n  {\n    CjsVectorParameter.copyNumberArray(this.value, value, 4);\n    this.#updateLinearValue();\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 4);\n    }\n  }\n\n  /**\n   * Whether reads and writes go through an external destination; an sRGB\n   * constant is never rerouted, because its value must be gamma-converted before\n   * upload.\n   */\n  @carbon.method\n  @impl.implemented\n  IsRerouted()\n  {\n    return !this.isSrgb && this.#reroutedValue !== null;\n  }\n\n  /**\n   * Points the parameter at an external destination and seeds it with the current value; a target smaller than 16 bytes, not writable as four components, or belonging to an sRGB constant clears the reroute instead. Registered 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 = 16)\n  {\n    if (size >= 16 && !this.isSrgb && CjsVectorParameter.isVectorDestination(dest, 4))\n    {\n      this.#reroutedValue = dest;\n      CjsVectorParameter.writeVectorDestination(dest, this.value, 4);\n    }\n    else\n    {\n      this.#reroutedValue = null;\n      this.#updateLinearValue();\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 value - paired with its 16-byte size. The array is borrowed,\n   * not copied.\n   */\n  @carbon.method\n  @impl.adapted\n  GetDestination()\n  {\n    return {\n      dest: this.#reroutedValue ?? this.value,\n      size: 16\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   * Re-resolves usage and the sRGB flag from the shader's reflected constant,\n   * dropping the reroute when the shader is gone or the constant turns out to be\n   * sRGB. Reads reflection metadata only; no GPU handle is bound.\n   */\n  @carbon.method\n  @impl.adapted\n  RebuildEffectHandles(effectRes)\n  {\n    this.isSrgb = false;\n    if (!effectRes && this.#reroutedValue)\n    {\n      this.SetDestination(null, 0);\n    }\n    const constant = this.name ? CjsVectorParameter.getEffectConstant(effectRes, this.name) : null;\n    const used = !!constant;\n    this.usedByCurrentEffect = used;\n    this.usedByCurrentTechnique = used;\n    this.isSrgb = CjsVectorParameter.getConstantIsSrgb(constant);\n    if (this.isSrgb)\n    {\n      this.SetDestination(null, 0);\n    }\n    this.#updateLinearValue();\n  }\n\n  /**\n   * Seeds an existing reroute destination with the current value and refreshes\n   * the linear mirror; always returns true.\n   */\n  @carbon.method\n  @impl.implemented\n  Initialize()\n  {\n    if (this.#reroutedValue)\n    {\n      CjsVectorParameter.writeVectorDestination(this.#reroutedValue, this.value, 4);\n    }\n    this.#updateLinearValue();\n    return true;\n  }\n\n  /**\n   * Writes the four components an upload should use - the rerouted value, or the\n   * gamma-converted linear mirror for an sRGB constant - into the caller's\n   * destination.\n   */\n  @carbon.method\n  @impl.adapted\n  CopyValueToEffect(_inputType, out)\n  {\n    const source = this.#reroutedValue ?? (this.isSrgb ? this.linearValue : this.value);\n    CjsVectorParameter.writeVectorDestination(out, source, 4);\n  }\n\n  /**\n   * Refreshes the linear mirror: a plain copy when not sRGB, otherwise\n   * gamma-to-linear on the first three components with alpha passed through\n   * unchanged.\n   */\n  #updateLinearValue()\n  {\n    if (!this.isSrgb)\n    {\n      CjsVectorParameter.copyNumberArray(this.linearValue, this.value, 4);\n      return;\n    }\n    this.linearValue[0] = num.gammaToLinear(this.value[0]);\n    this.linearValue[1] = num.gammaToLinear(this.value[1]);\n    this.linearValue[2] = num.gammaToLinear(this.value[2]);\n    this.linearValue[3] = this.value[3];\n  }\n\n  /**\n   * Assigns one component in place and re-runs SetValue so the linear mirror and\n   * any reroute stay in sync.\n   */\n  #setComponent(index, component)\n  {\n    this.value[index] = Number(component);\n    this.SetValue(this.value);\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, 4);\n  }\n\n}\n"],"names":["_Tr2Vector4Parameter","Tr2Vector4Parameter","CjsVectorParameter","e","_init_value","_init_extra_value","_init_isSrgb","_init_extra_isSrgb","_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","vec4","read","boolean","notify","persist","string","carbon","method","impl","implemented","adapted","value","fromValues","isSrgb","usedByCurrentTechnique","usedByCurrentEffect","name","linearValue","x","GetValue","component","y","z","w","v1","v2","v3","v4","GetParameterName","GetHashValue","startingHash","FNV1_INITIAL","hashFnv1String","hashFnv1Floats","out","readVectorDestination","copyNumberArray","SetValue","writeVectorDestination","IsRerouted","SetDestination","dest","size","isVectorDestination","notifyBindings","GetDestination","RegisterBinding","binding","registerBinding","UnregisterBinding","unregisterBinding","RebuildEffectHandles","effectRes","constant","getEffectConstant","used","getConstantIsSrgb","Initialize","CopyValueToEffect","_inputType","source","#updateLinearValue","num","gammaToLinear","#setComponent","index","Number","isValue","isNumberArrayValue"],"mappings":"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"}

package/dist/shader/parameter/TriFloatArrayParameter.js

@@ -3,6 +3,8 @@ import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { CjsParameter } from './CjsParameter.js';
 
 let _initProto, _initClass, _init_value, _init_extra_value, _init_usedByCurrentTechnique, _init_extra_usedByCurrentTechnique, _init_usedByCurrentEffect, _init_extra_usedByCurrentEffect, _init_name, _init_extra_name;
+
+/** An ordered list of vec4 rows uploaded into one named shader constant array. */
 let _TriFloatArrayParamet;
 class TriFloatArrayParameter extends CjsParameter {
   static {
@@ -19,6 +21,8 @@ class TriFloatArrayParameter extends CjsParameter {
   usedByCurrentEffect = (_init_extra_usedByCurrentTechnique(this), _init_usedByCurrentEffect(this, false));
   name = (_init_extra_usedByCurrentEffect(this), _init_name(this, ""));
   #cachedEffect = (_init_extra_name(this), null);
+
+  /** The shader constant-array name these rows bind to. */
   GetParameterName() {
     return this.name;
   }
@@ -30,19 +34,36 @@ class TriFloatArrayParameter extends CjsParameter {
     }
     return CjsParameter.hashFnv1String(this.name, startingHash);
   }
+
+  /** Nothing to resolve - the rows are authored data; returns true. */
   Initialize() {
     return true;
   }
+
+  /**
+   * Re-resolves effect handles against the cached shader after any notified
+   * field changes.
+   */
   OnModified(_options = {}) {
     this.RebuildEffectHandles(this.#cachedEffect);
     return true;
   }
+
+  /**
+   * Caches the shader and records whether it reflects a constant of this name;
+   * no GPU handle is bound.
+   */
   RebuildEffectHandles(effectRes) {
     this.#cachedEffect = effectRes;
     const used = !!this.name && CjsParameter.hasEffectConstant(effectRes, this.name);
     this.usedByCurrentEffect = used;
     this.usedByCurrentTechnique = used;
   }
+
+  /**
+   * Packs the rows contiguously into the destination, stopping at whichever limit comes first: the last row, the destination length, or the byte budget; a final row may be written partially.
+   * @param size byte budget in the destination, four bytes per float
+   */
   CopyValueToEffect(_inputType, out, size = Number.POSITIVE_INFINITY) {
     const byteLimit = Number.isFinite(size) ? Math.max(0, size) : Infinity;
     const floatLimit = Math.min(Number(out.length), Math.floor(byteLimit / 4));
@@ -56,6 +77,11 @@ class TriFloatArrayParameter extends CjsParameter {
       offset += count;
     }
   }
+
+  /**
+   * Copies `count` components of one row into `out` starting at `offset`,
+   * allowing a truncated tail row.
+   */
   static copyVector4ToDestination(out, value, offset, count) {
     for (let i = 0; i < count; i++) {
       out[offset + i] = value[i];

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

@@ -1 +1 @@
-{"version":3,"file":"TriFloatArrayParameter.js","sources":["../../../../src/shader/parameter/TriFloatArrayParameter.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\TriFloatArrayParameter.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\TriFloatArrayParameter.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: \"TriFloatArrayParameter\",\r\n  family: \"shader\"\r\n})\r\nexport class TriFloatArrayParameter extends CjsParameter\r\n{\r\n  @io.notify\r\n  @io.persist\r\n  @type.list(\"TriVector4\")\r\n  value = [];\r\n\r\n  @io.read\r\n  @type.boolean\r\n  usedByCurrentTechnique = false;\r\n\r\n  @io.read\r\n  @type.boolean\r\n  usedByCurrentEffect = false;\r\n\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: each row's vec4 bytes, then name. */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetHashValue(startingHash = CjsParameter.FNV1_INITIAL)\r\n  {\r\n    for (const row of this.value)\r\n    {\r\n      startingHash = CjsParameter.hashFnv1Floats(row?.data ?? [0, 0, 0, 0], startingHash);\r\n    }\r\n    return CjsParameter.hashFnv1String(this.name, startingHash);\r\n  }\r\n  @carbon.method\r\n  @impl.implemented\r\n  Initialize()\r\n  {\r\n    return true;\r\n  }\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    this.RebuildEffectHandles(this.#cachedEffect);\r\n    return true;\r\n  }\r\n  @carbon.method\r\n  @impl.adapted\r\n  RebuildEffectHandles(effectRes)\r\n  {\r\n    this.#cachedEffect = effectRes;\r\n    const used = !!this.name && CjsParameter.hasEffectConstant(effectRes, this.name);\r\n    this.usedByCurrentEffect = used;\r\n    this.usedByCurrentTechnique = used;\r\n  }\r\n  @carbon.method\r\n  @impl.adapted\r\n  CopyValueToEffect(_inputType, out, size = Number.POSITIVE_INFINITY)\r\n  {\r\n    const byteLimit = Number.isFinite(size) ? Math.max(0, size) : Infinity;\r\n    const floatLimit = Math.min(Number(out.length), Math.floor(byteLimit / 4));\r\n    let offset = 0;\r\n    for (const entry of this.value)\r\n    {\r\n      if (offset >= floatLimit)\r\n      {\r\n        break;\r\n      }\r\n      const count = Math.min(4, floatLimit - offset);\r\n      TriFloatArrayParameter.copyVector4ToDestination(out, entry.data, offset, count);\r\n      offset += count;\r\n    }\r\n  }\r\n\r\n  static copyVector4ToDestination(out, value, offset, count)\r\n  {\r\n    for (let i = 0; i < count; i++)\r\n    {\r\n      out[offset + i] = value[i];\r\n    }\r\n  }\r\n\r\n}\r\n"],"names":["_TriFloatArrayParamet","TriFloatArrayParameter","CjsParameter","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","notify","persist","list","read","boolean","string","carbon","method","impl","implemented","adapted","value","usedByCurrentTechnique","usedByCurrentEffect","name","GetParameterName","GetHashValue","startingHash","FNV1_INITIAL","row","hashFnv1Floats","data","hashFnv1String","Initialize","OnModified","_options","RebuildEffectHandles","effectRes","used","hasEffectConstant","CopyValueToEffect","_inputType","out","size","Number","POSITIVE_INFINITY","byteLimit","isFinite","Math","max","Infinity","floatLimit","min","length","floor","offset","entry","count","copyVector4ToDestination","i"],"mappings":"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"}
+{"version":3,"file":"TriFloatArrayParameter.js","sources":["../../../../src/shader/parameter/TriFloatArrayParameter.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\TriFloatArrayParameter.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Shader\\Parameter\\TriFloatArrayParameter.cpp\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { CjsParameter } from \"./CjsParameter.js\";\r\n\r\n\r\n/** An ordered list of vec4 rows uploaded into one named shader constant array. */\r\n@type.define({\r\n  className: \"TriFloatArrayParameter\",\r\n  family: \"shader\"\r\n})\r\nexport class TriFloatArrayParameter extends CjsParameter\r\n{\r\n  @io.notify\r\n  @io.persist\r\n  @type.list(\"TriVector4\")\r\n  value = [];\r\n\r\n  @io.read\r\n  @type.boolean\r\n  usedByCurrentTechnique = false;\r\n\r\n  @io.read\r\n  @type.boolean\r\n  usedByCurrentEffect = false;\r\n\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 constant-array name these rows bind 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: each row's vec4 bytes, then name. */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetHashValue(startingHash = CjsParameter.FNV1_INITIAL)\r\n  {\r\n    for (const row of this.value)\r\n    {\r\n      startingHash = CjsParameter.hashFnv1Floats(row?.data ?? [0, 0, 0, 0], startingHash);\r\n    }\r\n    return CjsParameter.hashFnv1String(this.name, startingHash);\r\n  }\r\n\r\n  /** Nothing to resolve - the rows are authored data; returns true. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Initialize()\r\n  {\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Re-resolves effect handles against the cached shader after any notified\r\n   * field changes.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    this.RebuildEffectHandles(this.#cachedEffect);\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Caches the shader and records whether it reflects a constant of this name;\r\n   * no GPU handle 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    const used = !!this.name && CjsParameter.hasEffectConstant(effectRes, this.name);\r\n    this.usedByCurrentEffect = used;\r\n    this.usedByCurrentTechnique = used;\r\n  }\r\n\r\n  /**\r\n   * Packs the rows contiguously into the destination, stopping at whichever limit comes first: the last row, the destination length, or the byte budget; a final row may be written partially.\r\n   * @param size byte budget in the destination, four bytes per float\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  CopyValueToEffect(_inputType, out, size = Number.POSITIVE_INFINITY)\r\n  {\r\n    const byteLimit = Number.isFinite(size) ? Math.max(0, size) : Infinity;\r\n    const floatLimit = Math.min(Number(out.length), Math.floor(byteLimit / 4));\r\n    let offset = 0;\r\n    for (const entry of this.value)\r\n    {\r\n      if (offset >= floatLimit)\r\n      {\r\n        break;\r\n      }\r\n      const count = Math.min(4, floatLimit - offset);\r\n      TriFloatArrayParameter.copyVector4ToDestination(out, entry.data, offset, count);\r\n      offset += count;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Copies `count` components of one row into `out` starting at `offset`,\r\n   * allowing a truncated tail row.\r\n   */\r\n  static copyVector4ToDestination(out, value, offset, count)\r\n  {\r\n    for (let i = 0; i < count; i++)\r\n    {\r\n      out[offset + i] = value[i];\r\n    }\r\n  }\r\n\r\n}\r\n"],"names":["_TriFloatArrayParamet","TriFloatArrayParameter","CjsParameter","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","notify","persist","list","read","boolean","string","carbon","method","impl","implemented","adapted","value","usedByCurrentTechnique","usedByCurrentEffect","name","GetParameterName","GetHashValue","startingHash","FNV1_INITIAL","row","hashFnv1Floats","data","hashFnv1String","Initialize","OnModified","_options","RebuildEffectHandles","effectRes","used","hasEffectConstant","CopyValueToEffect","_inputType","out","size","Number","POSITIVE_INFINITY","byteLimit","isFinite","Math","max","Infinity","floatLimit","min","length","floor","offset","entry","count","copyVector4ToDestination","i"],"mappings":"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"}

package/dist/shader/parameter/TriTextureParameter.js

@@ -4,6 +4,11 @@ import '@carbonenginejs/runtime-utils/model';
 import { CjsParameter } from './CjsParameter.js';
 
 let _initProto, _initClass, _init_resourcePath, _init_extra_resourcePath, _init_uavMipLevel, _init_extra_uavMipLevel, _init_positionScale, _init_extra_positionScale, _init_resource, _init_extra_resource, _init_usedByCurrentTechnique, _init_extra_usedByCurrentTechnique, _init_usedByCurrentEffect, _init_extra_usedByCurrentEffect, _init_name, _init_extra_name, _init_uvDensityScale, _init_extra_uvDensityScale, _init_uvDensityScale2, _init_extra_uvDensityScale2, _init_uvDensityScale3, _init_extra_uvDensityScale3, _init_uvDensityScale4, _init_extra_uvDensityScale4;
+
+/**
+ * A named texture slot on an effect, owning the authored res path, the resolved
+ * texture provider and the UV-density scales that drive mip selection.
+ */
 let _TriTextureParameter;
 class TriTextureParameter extends CjsParameter {
   static {
@@ -30,6 +35,8 @@ class TriTextureParameter extends CjsParameter {
   #lowResResource = null;
   #materials = [];
   #textureLodEnabled = false;
+
+  /** The shader resource name this texture binds to. */
   GetParameterName() {
     return this.name;
   }
@@ -41,6 +48,11 @@ class TriTextureParameter extends CjsParameter {
     }
     return CjsParameter.hashFnv1String(this.name, startingHash);
   }
+
+  /**
+   * Sets the name through SetValues so the effectHandles rebuild flag fires;
+   * returns whether it changed.
+   */
   SetParameterName(name) {
     return this.SetValues({
       name: String(name)
@@ -49,10 +61,21 @@ class TriTextureParameter extends CjsParameter {
       returnBoolean: true
     });
   }
+
+  /**
+   * The path of the currently attached texture when it exposes one, falling back
+   * to the authored resourcePath - so after a redirect this can differ from what
+   * was authored.
+   */
   GetResourcePath() {
     const resource = this.GetResource();
     return resource?.GetPath?.() ?? resource?.path ?? resource?.resourcePath ?? this.resourcePath;
   }
+
+  /**
+   * Sets the authored path and raises the resource flag, so the next OnModified
+   * drops the attached texture and asks for it again.
+   */
   SetResourcePath(resourcePath) {
     this.SetValues({
       resourcePath: String(resourcePath)
@@ -60,6 +83,12 @@ class TriTextureParameter extends CjsParameter {
       source: this
     });
   }
+
+  /**
+   * Attaches a resolved texture provider, discards any low-res stand-in,
+   * re-resolves effect handles against the cached shader and notifies owning
+   * materials.
+   */
   SetResource(resource) {
     if (this.resource !== resource) {
       this.resource = resource;
@@ -68,12 +97,24 @@ class TriTextureParameter extends CjsParameter {
     this.RebuildEffectHandles(this.#cachedEffect);
     this.OnTextureChanged();
   }
+
+  /**
+   * The texture actually in use: the low-res stand-in while one is active,
+   * otherwise the resolved resource.
+   */
   GetResource() {
     return this.#lowResResource ?? this.resource;
   }
+
+  /** Always true - a texture swap must dirty the owning materials' resource sets. */
   SupportsDirtyNotification() {
     return true;
   }
+
+  /**
+   * Turns on screen-size-driven mip selection and stores the density scales; Carbon's spelling of the method name is kept.
+   * @param uvDensityScale five scales: the world-position scale first, then the four UV-set scales
+   */
   EnableTextureLoding(uvDensityScale) {
     this.#textureLodEnabled = true;
     this.positionScale = Number(uvDensityScale[0] ?? 0);
@@ -82,9 +123,16 @@ class TriTextureParameter extends CjsParameter {
     this.uvDensityScale2 = Number(uvDensityScale[3] ?? 0);
     this.uvDensityScale3 = Number(uvDensityScale[4] ?? 0);
   }
+
+  /** Turns mip selection off, so UsedWithScreenSize then always requests LOD 0. */
   DisableTextureLoding() {
     this.#textureLodEnabled = false;
   }
+
+  /**
+   * Carbon TriTextureParameter::UsedWithScreenSize (cpp:53-97): takes the largest resolution demanded by the world-position and per-UV-set densities, compares it against the texture's native resolution, and asks the resource for the resulting mip level.
+   * @returns {number} the requested LOD, 0 when LOD is disabled or no density applies
+   */
   UsedWithScreenSize(screenSize, worldRadius, uvDensities = []) {
     if (!this.#textureLodEnabled) {
       this.#requestResourceResolution(0);
@@ -115,6 +163,11 @@ class TriTextureParameter extends CjsParameter {
     this.#requestResourceResolution(requestedLod);
     return requestedLod;
   }
+
+  /**
+   * Consumes the two dirty flags: `resource` drops the attached texture and
+   * re-initializes, `effectHandles` re-resolves against the cached shader.
+   */
   OnModified(_options = {}) {
     const flags = this.__state.flags;
     if (flags.delete("resource")) {
@@ -127,26 +180,52 @@ class TriTextureParameter extends CjsParameter {
     }
     return true;
   }
+
+  /**
+   * Nothing to do in this GPU-free package - res paths are never resolved to
+   * texture bytes here; returns true so callers can treat initialization as
+   * successful.
+   */
   Initialize() {
     return true;
   }
+
+  /**
+   * Caches the shader and records whether it exposes a resource or constant of
+   * this name; no GPU binding is created.
+   */
   RebuildEffectHandles(effectRes) {
     this.#cachedEffect = effectRes;
     const used = !!this.name && (CjsParameter.hasEffectResource(effectRes, this.name) || CjsParameter.hasEffectConstant(effectRes, this.name));
     this.usedByCurrentEffect = used;
     this.usedByCurrentTechnique = used;
   }
+
+  /**
+   * Registers a material to be notified when the texture changes; duplicates are
+   * ignored.
+   */
   OnAddedToMaterial(material) {
     if (!this.#materials.includes(material)) {
       this.#materials.push(material);
     }
   }
+
+  /**
+   * Stops notifying a material; the material reference is dropped, not the
+   * texture.
+   */
   OnRemovedFromMaterial(material) {
     const index = this.#materials.indexOf(material);
     if (index >= 0) {
       this.#materials.splice(index, 1);
     }
   }
+
+  /**
+   * Tells every owning material that its resource sets and constant buffers are
+   * stale.
+   */
   OnTextureChanged() {
     for (const material of this.#materials) {
       const target = material;
@@ -154,6 +233,11 @@ class TriTextureParameter extends CjsParameter {
       target?.MarkConstantBuffersDirty?.();
     }
   }
+
+  /**
+   * Asks the texture currently in use for a mip level, if it supports resolution
+   * requests.
+   */
   #requestResourceResolution(lod) {
     const target = this.GetResource();
     target?.RequestResolution?.(lod);