@carbonenginejs/runtime-trinity 0.6.0 → 0.8.0

package/dist/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatAdd.js

@@ -3,6 +3,11 @@ import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { EveVirtualCameraBehaviourFloatBase as _EveVirtualCameraBeha$1 } from './EveVirtualCameraBehaviourFloatBase.js';
 
 let _initProto, _initClass, _init_scaleCurve, _init_extra_scaleCurve, _init_value, _init_extra_value;
+
+/**
+ * Float behaviour that adds an authored constant, optionally shaped across the
+ * timeline by a scale curve.
+ */
 let _EveVirtualCameraBeha;
 class EveVirtualCameraBehaviourFloatAdd extends _EveVirtualCameraBeha$1 {
   static {
@@ -16,14 +21,26 @@ class EveVirtualCameraBehaviourFloatAdd extends _EveVirtualCameraBeha$1 {
   }
   scaleCurve = (_initProto(this), _init_scaleCurve(this, null));
   value = (_init_extra_scaleCurve(this), _init_value(this, 0));
+
+  /**
+   * Names the behaviour "Add"; no scale curve is created, so the constant is
+   * unshaped until one is authored.
+   */
   constructor() {
     super(), _init_extra_value(this);
     this.name = "Add";
   }
+
+  /** Sets the behaviour name and renames the owned scale curve to match. */
   SetName(name) {
     super.SetName(name);
     this.scaleCurve?.SetName?.(`${this.name} - Scale Curve`);
   }
+
+  /**
+   * Returns the authored value, scaled by the scale curve at normalized timeline
+   * time when one is set, and returned as-is when it is not.
+   */
   Update(camera, _current, _deltaTime, localElapsedTime) {
     if (!this.scaleCurve) {
       return this.value;

package/dist/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatAdd.js.map

@@ -1 +1 @@
-{"version":3,"file":"EveVirtualCameraBehaviourFloatAdd.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatAdd.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { EveVirtualCameraBehaviourFloatBase } from \"./EveVirtualCameraBehaviourFloatBase.js\";\n\n\n@type.define({\n  className: \"EveVirtualCameraBehaviourFloatAdd\",\n  family: \"eve/virtualCamera/behaviour\"\n})\nexport class EveVirtualCameraBehaviourFloatAdd extends EveVirtualCameraBehaviourFloatBase\n{\n  @io.persist\n  @type.objectRef(\"Tr2CurveScalar\")\n  scaleCurve = null;\n\n  @io.persist\n  @type.float32\n  value = 0;\n\n  constructor()\n  {\n    super();\n    this.name = \"Add\";\n  }\n\n  @carbon.method\n  @impl.implemented\n  SetName(name)\n  {\n    super.SetName(name);\n    this.scaleCurve?.SetName?.(`${this.name} - Scale Curve`);\n  }\n\n  @carbon.method\n  @impl.adapted\n  Update(camera, _current, _deltaTime, localElapsedTime)\n  {\n    if (!this.scaleCurve)\n    {\n      return this.value;\n    }\n    const duration = Number(camera?.GetAnimationTimelineLength?.() ?? 0);\n    const time = duration !== 0 ? localElapsedTime / duration : 0;\n    return this.value * Number(this.scaleCurve.GetValue?.(time) ?? 1);\n  }\n}\n"],"names":["_EveVirtualCameraBeha","EveVirtualCameraBehaviourFloatAdd","EveVirtualCameraBehaviourFloatBase","e","_init_scaleCurve","_init_extra_scaleCurve","_init_value","_init_extra_value","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","objectRef","float32","carbon","method","impl","implemented","adapted","scaleCurve","value","constructor","name","SetName","Update","camera","_current","_deltaTime","localElapsedTime","duration","Number","GetAnimationTimelineLength","time","GetValue"],"mappings":";;;;;AAG6F,IAAAA;AAG7F,MAAAC,iCAAA,SAIuDC,uBAAkC,CACzF;AAAA,EAAA;AAAA,IAAA,CAAA;MAAAC,CAAA,EAAA,CAAAC,gBAAA,EAAAC,sBAAA,EAAAC,WAAA,EAAAC,iBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAT,qBAAA,EAAAU,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,mCAAmC;AAC9CC,MAAAA,MAAM,EAAE;KACT,CAAC,MAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EAAA,MAAA,EACVL,IAAI,CAACM,SAAS,CAAC,gBAAgB,CAAC,CAAA,EAAA,EAAA,EAAA,YAAA,CAAA,EAAA,CAAA,CAGhCF,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACO,OAAO,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,EAAA,CAAA,CASZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,SAAA,CAAA,EAAA,CAAA,CAOhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,CAAA,EAAA,EAAA,EAAA,QAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EAzBwCtB,uBAAkC,CAAA;AAAA;AAIvFuB,EAAAA,UAAU,IAAAjB,UAAA,CAAA,IAAA,CAAA,EAAAJ,gBAAA,OAAG,IAAI,CAAA;AAIjBsB,EAAAA,KAAK,IAAArB,sBAAA,CAAA,IAAA,CAAA,EAAAC,WAAA,OAAG,CAAC,CAAA;AAETqB,EAAAA,WAAWA,GACX;IACE,KAAK,EAAE,EAAApB,iBAAA,CAAA,IAAA,CAAA;IACP,IAAI,CAACqB,IAAI,GAAG,KAAK;AACnB,EAAA;EAIAC,OAAOA,CAACD,IAAI,EACZ;AACE,IAAA,KAAK,CAACC,OAAO,CAACD,IAAI,CAAC;IACnB,IAAI,CAACH,UAAU,EAAEI,OAAO,GAAG,GAAG,IAAI,CAACD,IAAI,CAAA,cAAA,CAAgB,CAAC;AAC1D,EAAA;EAIAE,MAAMA,CAACC,MAAM,EAAEC,QAAQ,EAAEC,UAAU,EAAEC,gBAAgB,EACrD;AACE,IAAA,IAAI,CAAC,IAAI,CAACT,UAAU,EACpB;MACE,OAAO,IAAI,CAACC,KAAK;AACnB,IAAA;IACA,MAAMS,QAAQ,GAAGC,MAAM,CAACL,MAAM,EAAEM,0BAA0B,IAAI,IAAI,CAAC,CAAC;IACpE,MAAMC,IAAI,GAAGH,QAAQ,KAAK,CAAC,GAAGD,gBAAgB,GAAGC,QAAQ,GAAG,CAAC;AAC7D,IAAA,OAAO,IAAI,CAACT,KAAK,GAAGU,MAAM,CAAC,IAAI,CAACX,UAAU,CAACc,QAAQ,GAAGD,IAAI,CAAC,IAAI,CAAC,CAAC;AACnE,EAAA;AAAC,EAAA;IAAA5B,UAAA,EAAA;AAAA;AACH;;;;"}
+{"version":3,"file":"EveVirtualCameraBehaviourFloatAdd.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatAdd.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { EveVirtualCameraBehaviourFloatBase } from \"./EveVirtualCameraBehaviourFloatBase.js\";\n\n\n/**\n * Float behaviour that adds an authored constant, optionally shaped across the\n * timeline by a scale curve.\n */\n@type.define({\n  className: \"EveVirtualCameraBehaviourFloatAdd\",\n  family: \"eve/virtualCamera/behaviour\"\n})\nexport class EveVirtualCameraBehaviourFloatAdd extends EveVirtualCameraBehaviourFloatBase\n{\n  @io.persist\n  @type.objectRef(\"Tr2CurveScalar\")\n  scaleCurve = null;\n\n  @io.persist\n  @type.float32\n  value = 0;\n\n  /**\n   * Names the behaviour \"Add\"; no scale curve is created, so the constant is\n   * unshaped until one is authored.\n   */\n  constructor()\n  {\n    super();\n    this.name = \"Add\";\n  }\n\n  /** Sets the behaviour name and renames the owned scale curve to match. */\n  @carbon.method\n  @impl.implemented\n  SetName(name)\n  {\n    super.SetName(name);\n    this.scaleCurve?.SetName?.(`${this.name} - Scale Curve`);\n  }\n\n  /**\n   * Returns the authored value, scaled by the scale curve at normalized timeline\n   * time when one is set, and returned as-is when it is not.\n   */\n  @carbon.method\n  @impl.adapted\n  Update(camera, _current, _deltaTime, localElapsedTime)\n  {\n    if (!this.scaleCurve)\n    {\n      return this.value;\n    }\n    const duration = Number(camera?.GetAnimationTimelineLength?.() ?? 0);\n    const time = duration !== 0 ? localElapsedTime / duration : 0;\n    return this.value * Number(this.scaleCurve.GetValue?.(time) ?? 1);\n  }\n}\n"],"names":["_EveVirtualCameraBeha","EveVirtualCameraBehaviourFloatAdd","EveVirtualCameraBehaviourFloatBase","e","_init_scaleCurve","_init_extra_scaleCurve","_init_value","_init_extra_value","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","objectRef","float32","carbon","method","impl","implemented","adapted","scaleCurve","value","constructor","name","SetName","Update","camera","_current","_deltaTime","localElapsedTime","duration","Number","GetAnimationTimelineLength","time","GetValue"],"mappings":";;;;;;AAMA;AACA;AACA;AACA;AAHA,IAAAA;AAIA,MAAAC,iCAAA,SAIuDC,uBAAkC,CACzF;AAAA,EAAA;AAAA,IAAA,CAAA;MAAAC,CAAA,EAAA,CAAAC,gBAAA,EAAAC,sBAAA,EAAAC,WAAA,EAAAC,iBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAT,qBAAA,EAAAU,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,mCAAmC;AAC9CC,MAAAA,MAAM,EAAE;KACT,CAAC,MAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EAAA,MAAA,EACVL,IAAI,CAACM,SAAS,CAAC,gBAAgB,CAAC,CAAA,EAAA,EAAA,EAAA,YAAA,CAAA,EAAA,CAAA,CAGhCF,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACO,OAAO,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,EAAA,CAAA,CAcZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,SAAA,CAAA,EAAA,CAAA,CAWhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,CAAA,EAAA,EAAA,EAAA,QAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EAlCwCtB,uBAAkC,CAAA;AAAA;AAIvFuB,EAAAA,UAAU,IAAAjB,UAAA,CAAA,IAAA,CAAA,EAAAJ,gBAAA,OAAG,IAAI,CAAA;AAIjBsB,EAAAA,KAAK,IAAArB,sBAAA,CAAA,IAAA,CAAA,EAAAC,WAAA,OAAG,CAAC,CAAA;;AAET;AACF;AACA;AACA;AACEqB,EAAAA,WAAWA,GACX;IACE,KAAK,EAAE,EAAApB,iBAAA,CAAA,IAAA,CAAA;IACP,IAAI,CAACqB,IAAI,GAAG,KAAK;AACnB,EAAA;;AAEA;EAGAC,OAAOA,CAACD,IAAI,EACZ;AACE,IAAA,KAAK,CAACC,OAAO,CAACD,IAAI,CAAC;IACnB,IAAI,CAACH,UAAU,EAAEI,OAAO,GAAG,GAAG,IAAI,CAACD,IAAI,CAAA,cAAA,CAAgB,CAAC;AAC1D,EAAA;;AAEA;AACF;AACA;AACA;EAGEE,MAAMA,CAACC,MAAM,EAAEC,QAAQ,EAAEC,UAAU,EAAEC,gBAAgB,EACrD;AACE,IAAA,IAAI,CAAC,IAAI,CAACT,UAAU,EACpB;MACE,OAAO,IAAI,CAACC,KAAK;AACnB,IAAA;IACA,MAAMS,QAAQ,GAAGC,MAAM,CAACL,MAAM,EAAEM,0BAA0B,IAAI,IAAI,CAAC,CAAC;IACpE,MAAMC,IAAI,GAAGH,QAAQ,KAAK,CAAC,GAAGD,gBAAgB,GAAGC,QAAQ,GAAG,CAAC;AAC7D,IAAA,OAAO,IAAI,CAACT,KAAK,GAAGU,MAAM,CAAC,IAAI,CAACX,UAAU,CAACc,QAAQ,GAAGD,IAAI,CAAC,IAAI,CAAC,CAAC;AACnE,EAAA;AAAC,EAAA;IAAA5B,UAAA,EAAA;AAAA;AACH;;;;"}

package/dist/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatBase.js

@@ -3,6 +3,11 @@ import { CjsModel } from '@carbonenginejs/runtime-utils/model';
 import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 
 let _initProto, _initClass, _init_active, _init_extra_active, _init_name, _init_extra_name;
+
+/**
+ * Base for the virtual camera behaviours that contribute a scalar delta to a
+ * camera's field of view or roll each update.
+ */
 let _EveVirtualCameraBeha;
 class EveVirtualCameraBehaviourFloatBase extends CjsModel {
   static {
@@ -20,16 +25,30 @@ class EveVirtualCameraBehaviourFloatBase extends CjsModel {
   }
   active = (_initProto(this), _init_active(this, true));
   name = (_init_extra_active(this), _init_name(this, ""));
+
+  /** Returns the authored behaviour name shown in tooling. */
   GetName() {
     return this.name;
   }
+
+  /**
+   * Sets the behaviour name, coercing to a string; subclasses override this to
+   * rename the curves they own alongside it.
+   */
   SetName(name) {
     this.name = String(name);
   }
+
+  /**
+   * Re-applies the current name after a field change, which propagates it to any
+   * owned curves through the subclass SetName override.
+   */
   OnModified(_options = {}) {
     this.SetName(this.name);
     return true;
   }
+
+  /** Reports whether the camera should evaluate this behaviour this update. */
   IsActive() {
     return this.active;
   }

package/dist/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatBase.js.map

@@ -1 +1 @@
-{"version":3,"file":"EveVirtualCameraBehaviourFloatBase.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatBase.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\n\r\n\r\n@type.define({\r\n  className: \"EveVirtualCameraBehaviourFloatBase\",\r\n  family: \"eve/virtualCamera/behaviour\"\r\n})\r\nexport class EveVirtualCameraBehaviourFloatBase extends CjsModel\r\n{\r\n  @io.persist\r\n  @type.boolean\r\n  active = true;\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetName()\r\n  {\r\n    return this.name;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetName(name)\r\n  {\r\n    this.name = String(name);\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    this.SetName(this.name);\r\n    return true;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.implemented\r\n  IsActive()\r\n  {\r\n    return this.active;\r\n  }\r\n}\r\n"],"names":["_EveVirtualCameraBeha","EveVirtualCameraBehaviourFloatBase","CjsModel","e","_init_active","_init_extra_active","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","boolean","notify","string","carbon","method","impl","implemented","adapted","constructor","args","active","name","GetName","SetName","String","OnModified","_options","IsActive"],"mappings":";;;;;AAG8E,IAAAA;AAG9E,MAAAC,kCAAA,SAIwDC,QAAQ,CAChE;AAAA,EAAA;AAAA,IAAA,CAAA;MAAAC,CAAA,EAAA,CAAAC,YAAA,EAAAC,kBAAA,EAAAC,UAAA,EAAAC,gBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAT,qBAAA,EAAAU,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,oCAAoC;AAC/CC,MAAAA,MAAM,EAAE;AACV,KAAC,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,OAAO,oBAGZF,EAAE,EAAFA,EAAE,CAACG,MAAM,EACTH,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACQ,MAAM,kBAGXC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,SAAA,CAAA,EAAA,CAAA,CAMhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,qBAMhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,CAAA,EAAA,EAAA,EAAA,YAAA,CAAA,EAAA,CAAA,CAOZJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,gCAlCqCtB,QAAQ,CAAA;AAAA;AAAAwB,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAApB,gBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAI9DqB,EAAAA,MAAM,IAAApB,UAAA,CAAA,IAAA,CAAA,EAAAJ,YAAA,OAAG,IAAI,CAAA;AAKbyB,EAAAA,IAAI,IAAAxB,kBAAA,CAAA,IAAA,CAAA,EAAAC,UAAA,OAAG,EAAE,CAAA;AAITwB,EAAAA,OAAOA,GACP;IACE,OAAO,IAAI,CAACD,IAAI;AAClB,EAAA;EAIAE,OAAOA,CAACF,IAAI,EACZ;AACE,IAAA,IAAI,CAACA,IAAI,GAAGG,MAAM,CAACH,IAAI,CAAC;AAC1B,EAAA;AAIAI,EAAAA,UAAUA,CAACC,QAAQ,GAAG,EAAE,EACxB;AACE,IAAA,IAAI,CAACH,OAAO,CAAC,IAAI,CAACF,IAAI,CAAC;AACvB,IAAA,OAAO,IAAI;AACb,EAAA;AAIAM,EAAAA,QAAQA,GACR;IACE,OAAO,IAAI,CAACP,MAAM;AACpB,EAAA;AAAC,EAAA;IAAAlB,UAAA,EAAA;AAAA;AACH;;;;"}
+{"version":3,"file":"EveVirtualCameraBehaviourFloatBase.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatBase.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\n\r\n\r\n/**\r\n * Base for the virtual camera behaviours that contribute a scalar delta to a\r\n * camera's field of view or roll each update.\r\n */\r\n@type.define({\r\n  className: \"EveVirtualCameraBehaviourFloatBase\",\r\n  family: \"eve/virtualCamera/behaviour\"\r\n})\r\nexport class EveVirtualCameraBehaviourFloatBase extends CjsModel\r\n{\r\n  @io.persist\r\n  @type.boolean\r\n  active = true;\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  /** Returns the authored behaviour name shown in tooling. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetName()\r\n  {\r\n    return this.name;\r\n  }\r\n\r\n  /**\r\n   * Sets the behaviour name, coercing to a string; subclasses override this to\r\n   * rename the curves they own alongside it.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetName(name)\r\n  {\r\n    this.name = String(name);\r\n  }\r\n\r\n  /**\r\n   * Re-applies the current name after a field change, which propagates it to any\r\n   * owned curves through the subclass SetName override.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    this.SetName(this.name);\r\n    return true;\r\n  }\r\n\r\n  /** Reports whether the camera should evaluate this behaviour this update. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  IsActive()\r\n  {\r\n    return this.active;\r\n  }\r\n}\r\n"],"names":["_EveVirtualCameraBeha","EveVirtualCameraBehaviourFloatBase","CjsModel","e","_init_active","_init_extra_active","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","boolean","notify","string","carbon","method","impl","implemented","adapted","constructor","args","active","name","GetName","SetName","String","OnModified","_options","IsActive"],"mappings":";;;;;;AAMA;AACA;AACA;AACA;AAHA,IAAAA;AAIA,MAAAC,kCAAA,SAIwDC,QAAQ,CAChE;AAAA,EAAA;AAAA,IAAA,CAAA;MAAAC,CAAA,EAAA,CAAAC,YAAA,EAAAC,kBAAA,EAAAC,UAAA,EAAAC,gBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAT,qBAAA,EAAAU,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,oCAAoC;AAC/CC,MAAAA,MAAM,EAAE;AACV,KAAC,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,OAAO,oBAGZF,EAAE,EAAFA,EAAE,CAACG,MAAM,EACTH,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACQ,MAAM,kBAIXC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,SAAA,CAAA,EAAA,CAAA,CAUhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,qBAUhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,CAAA,EAAA,EAAA,EAAA,YAAA,CAAA,EAAA,CAAA,CAQZJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,gCA5CqCtB,QAAQ,CAAA;AAAA;AAAAwB,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAApB,gBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAI9DqB,EAAAA,MAAM,IAAApB,UAAA,CAAA,IAAA,CAAA,EAAAJ,YAAA,OAAG,IAAI,CAAA;AAKbyB,EAAAA,IAAI,IAAAxB,kBAAA,CAAA,IAAA,CAAA,EAAAC,UAAA,OAAG,EAAE,CAAA;;AAET;AAGAwB,EAAAA,OAAOA,GACP;IACE,OAAO,IAAI,CAACD,IAAI;AAClB,EAAA;;AAEA;AACF;AACA;AACA;EAGEE,OAAOA,CAACF,IAAI,EACZ;AACE,IAAA,IAAI,CAACA,IAAI,GAAGG,MAAM,CAACH,IAAI,CAAC;AAC1B,EAAA;;AAEA;AACF;AACA;AACA;AAGEI,EAAAA,UAAUA,CAACC,QAAQ,GAAG,EAAE,EACxB;AACE,IAAA,IAAI,CAACH,OAAO,CAAC,IAAI,CAACF,IAAI,CAAC;AACvB,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AAGAM,EAAAA,QAAQA,GACR;IACE,OAAO,IAAI,CAACP,MAAM;AACpB,EAAA;AAAC,EAAA;IAAAlB,UAAA,EAAA;AAAA;AACH;;;;"}

package/dist/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatDamping.js

@@ -3,6 +3,11 @@ import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { EveVirtualCameraBehaviourFloatBase as _EveVirtualCameraBeha$1 } from './EveVirtualCameraBehaviourFloatBase.js';
 
 let _initProto, _initClass, _init_dampingFactor, _init_extra_dampingFactor;
+
+/**
+ * Float behaviour that lags a scalar camera value behind the value the other
+ * behaviours produced, smoothing sudden changes.
+ */
 let _EveVirtualCameraBeha;
 class EveVirtualCameraBehaviourFloatDamping extends _EveVirtualCameraBeha$1 {
   static {
@@ -16,10 +21,22 @@ class EveVirtualCameraBehaviourFloatDamping extends _EveVirtualCameraBeha$1 {
   }
   dampingFactor = (_initProto(this), _init_dampingFactor(this, 1));
   #lastValue = (_init_extra_dampingFactor(this), 0);
+
+  /**
+   * Names the behaviour "Damping"; the default damping factor of 1 follows the
+   * input exactly.
+   */
   constructor() {
     super();
     this.name = "Damping";
   }
+
+  /**
+   * Moves the retained value a dampingFactor fraction of the way towards the
+   * incoming value and returns the difference, so the accumulated result lands
+   * on the smoothed value; the first update (local time at or below zero) only
+   * seeds the retained value and contributes nothing.
+   */
   Update(_camera, current, _deltaTime, localElapsedTime) {
     if (localElapsedTime <= 0) {
       this.#lastValue = current;

package/dist/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatDamping.js.map

@@ -1 +1 @@
-{"version":3,"file":"EveVirtualCameraBehaviourFloatDamping.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatDamping.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { EveVirtualCameraBehaviourFloatBase } from \"./EveVirtualCameraBehaviourFloatBase.js\";\n\n\n@type.define({\n  className: \"EveVirtualCameraBehaviourFloatDamping\",\n  family: \"eve/virtualCamera/behaviour\"\n})\nexport class EveVirtualCameraBehaviourFloatDamping extends EveVirtualCameraBehaviourFloatBase\n{\n  @io.persist\n  @type.float32\n  dampingFactor = 1;\n\n  #lastValue = 0;\n\n  constructor()\n  {\n    super();\n    this.name = \"Damping\";\n  }\n\n  @carbon.method\n  @impl.implemented\n  Update(_camera, current, _deltaTime, localElapsedTime)\n  {\n    if (localElapsedTime <= 0)\n    {\n      this.#lastValue = current;\n      return 0;\n    }\n    this.#lastValue += (current - this.#lastValue) * this.dampingFactor;\n    return this.#lastValue - current;\n  }\n}\n"],"names":["_EveVirtualCameraBeha","EveVirtualCameraBehaviourFloatDamping","EveVirtualCameraBehaviourFloatBase","e","_init_dampingFactor","_init_extra_dampingFactor","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","float32","carbon","method","impl","implemented","dampingFactor","constructor","name","Update","_camera","current","_deltaTime","localElapsedTime"],"mappings":";;;;;AAG6F,IAAAA;AAG7F,MAAAC,qCAAA,SAI2DC,uBAAkC,CAC7F;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,mBAAA,EAAAC,yBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAP,qBAAA,EAAAQ,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,uCAAuC;AAClDC,MAAAA,MAAM,EAAE;KACT,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,OAAO,2BAWZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,QAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EAfwClB,uBAAkC,CAAA;AAAA;AAI3FmB,EAAAA,aAAa,IAAAf,UAAA,CAAA,IAAA,CAAA,EAAAF,mBAAA,OAAG,CAAC,CAAA;AAEjB,EAAA,UAAU,IAAAC,yBAAA,CAAA,IAAA,CAAA,EAAG,CAAC;AAEdiB,EAAAA,WAAWA,GACX;AACE,IAAA,KAAK,EAAE;IACP,IAAI,CAACC,IAAI,GAAG,SAAS;AACvB,EAAA;EAIAC,MAAMA,CAACC,OAAO,EAAEC,OAAO,EAAEC,UAAU,EAAEC,gBAAgB,EACrD;IACE,IAAIA,gBAAgB,IAAI,CAAC,EACzB;AACE,MAAA,IAAI,CAAC,UAAU,GAAGF,OAAO;AACzB,MAAA,OAAO,CAAC;AACV,IAAA;AACA,IAAA,IAAI,CAAC,UAAU,IAAI,CAACA,OAAO,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAACL,aAAa;AACnE,IAAA,OAAO,IAAI,CAAC,UAAU,GAAGK,OAAO;AAClC,EAAA;AAAC,EAAA;IAAAlB,UAAA,EAAA;AAAA;AACH;;;;"}
+{"version":3,"file":"EveVirtualCameraBehaviourFloatDamping.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatDamping.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { EveVirtualCameraBehaviourFloatBase } from \"./EveVirtualCameraBehaviourFloatBase.js\";\n\n\n/**\n * Float behaviour that lags a scalar camera value behind the value the other\n * behaviours produced, smoothing sudden changes.\n */\n@type.define({\n  className: \"EveVirtualCameraBehaviourFloatDamping\",\n  family: \"eve/virtualCamera/behaviour\"\n})\nexport class EveVirtualCameraBehaviourFloatDamping extends EveVirtualCameraBehaviourFloatBase\n{\n  @io.persist\n  @type.float32\n  dampingFactor = 1;\n\n  #lastValue = 0;\n\n  /**\n   * Names the behaviour \"Damping\"; the default damping factor of 1 follows the\n   * input exactly.\n   */\n  constructor()\n  {\n    super();\n    this.name = \"Damping\";\n  }\n\n  /**\n   * Moves the retained value a dampingFactor fraction of the way towards the\n   * incoming value and returns the difference, so the accumulated result lands\n   * on the smoothed value; the first update (local time at or below zero) only\n   * seeds the retained value and contributes nothing.\n   */\n  @carbon.method\n  @impl.implemented\n  Update(_camera, current, _deltaTime, localElapsedTime)\n  {\n    if (localElapsedTime <= 0)\n    {\n      this.#lastValue = current;\n      return 0;\n    }\n    this.#lastValue += (current - this.#lastValue) * this.dampingFactor;\n    return this.#lastValue - current;\n  }\n}\n"],"names":["_EveVirtualCameraBeha","EveVirtualCameraBehaviourFloatDamping","EveVirtualCameraBehaviourFloatBase","e","_init_dampingFactor","_init_extra_dampingFactor","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","float32","carbon","method","impl","implemented","dampingFactor","constructor","name","Update","_camera","current","_deltaTime","localElapsedTime"],"mappings":";;;;;;AAMA;AACA;AACA;AACA;AAHA,IAAAA;AAIA,MAAAC,qCAAA,SAI2DC,uBAAkC,CAC7F;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,mBAAA,EAAAC,yBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAP,qBAAA,EAAAQ,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,uCAAuC;AAClDC,MAAAA,MAAM,EAAE;KACT,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,OAAO,2BAqBZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,QAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EAzBwClB,uBAAkC,CAAA;AAAA;AAI3FmB,EAAAA,aAAa,IAAAf,UAAA,CAAA,IAAA,CAAA,EAAAF,mBAAA,OAAG,CAAC,CAAA;AAEjB,EAAA,UAAU,IAAAC,yBAAA,CAAA,IAAA,CAAA,EAAG,CAAC;;AAEd;AACF;AACA;AACA;AACEiB,EAAAA,WAAWA,GACX;AACE,IAAA,KAAK,EAAE;IACP,IAAI,CAACC,IAAI,GAAG,SAAS;AACvB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;EAGEC,MAAMA,CAACC,OAAO,EAAEC,OAAO,EAAEC,UAAU,EAAEC,gBAAgB,EACrD;IACE,IAAIA,gBAAgB,IAAI,CAAC,EACzB;AACE,MAAA,IAAI,CAAC,UAAU,GAAGF,OAAO;AACzB,MAAA,OAAO,CAAC;AACV,IAAA;AACA,IAAA,IAAI,CAAC,UAAU,IAAI,CAACA,OAAO,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAACL,aAAa;AACnE,IAAA,OAAO,IAAI,CAAC,UAAU,GAAGK,OAAO;AAClC,EAAA;AAAC,EAAA;IAAAlB,UAAA,EAAA;AAAA;AACH;;;;"}

package/dist/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatNoise.js

@@ -6,6 +6,11 @@ import { TriPerlinCurve as _TriPerlinCurve } from '../../../curves/TriPerlinCurv
 import { EveVirtualCameraBehaviourFloatBase as _EveVirtualCameraBeha$1 } from './EveVirtualCameraBehaviourFloatBase.js';
 
 let _initProto, _initClass, _init_octaves, _init_extra_octaves, _init_magnitudeCurve, _init_extra_magnitudeCurve, _init_magnitude, _init_extra_magnitude, _init_perlineScale, _init_extra_perlineScale;
+
+/**
+ * Float behaviour that adds a Perlin-noise wobble to a scalar camera value such
+ * as field of view or roll.
+ */
 let _EveVirtualCameraBeha;
 new class extends _identity {
   static [class EveVirtualCameraBehaviourFloatNoise extends _EveVirtualCameraBeha$1 {
@@ -23,15 +28,28 @@ new class extends _identity {
     magnitude = (_init_extra_magnitudeCurve(this), _init_magnitude(this, 1));
     perlineScale = (_init_extra_magnitude(this), _init_perlineScale(this, 1));
     #phase = (_init_extra_perlineScale(this), _EveVirtualCameraBeha.#allocatePhase());
+
+    /**
+     * Creates the default magnitude envelope curve and names the behaviour
+     * "Shake".
+     */
     constructor() {
       super();
       this.magnitudeCurve = _EveVirtualCameraBeha.#createMagnitudeCurve();
       this.SetName("Shake");
     }
+
+    /** Sets the behaviour name and renames the owned magnitude curve to match. */
     SetName(name) {
       super.SetName(name);
       this.magnitudeCurve?.SetName?.(`${this.name} - Magnitude Curve`);
     }
+
+    /**
+     * Returns the authored magnitude scaled by a 1D Perlin sample of the
+     * phase-offset local time (rate set by perlineScale, detail by octaves) and by
+     * the magnitude envelope at normalized timeline time.
+     */
     Update(camera, _current, _deltaTime, localElapsedTime) {
       let offset = this.magnitude * _TriPerlinCurve.PerlinNoise1D((localElapsedTime + this.#phase) * this.perlineScale, 2, 2, this.octaves);
       if (this.magnitudeCurve) {
@@ -41,6 +59,17 @@ new class extends _identity {
       }
       return offset;
     }
+
+    /**
+     * Builds the default envelope over normalized time: a near-instant ramp to
+     * full magnitude by 0.1, then a linear fade to zero at the end of the
+     * timeline.
+     */
+
+    /**
+     * Hands each new instance a distinct noise phase from a rolling 12-bit
+     * counter, keeping simultaneous noise behaviours from moving in lockstep.
+     */
   }];
   #nextPhase = 0;
   #createMagnitudeCurve() {

package/dist/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatNoise.js.map

@@ -1 +1 @@
-{"version":3,"file":"EveVirtualCameraBehaviourFloatNoise.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatNoise.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { Tr2CurveScalar } from \"../../../curves/Tr2CurveScalar.js\";\nimport { Tr2CurveExtrapolation } from \"../../../curves/enums.js\";\nimport { TriPerlinCurve } from \"../../../curves/TriPerlinCurve.js\";\nimport { EveVirtualCameraBehaviourFloatBase } from \"./EveVirtualCameraBehaviourFloatBase.js\";\n\n\n@type.define({\n  className: \"EveVirtualCameraBehaviourFloatNoise\",\n  family: \"eve/virtualCamera/behaviour\"\n})\nexport class EveVirtualCameraBehaviourFloatNoise extends EveVirtualCameraBehaviourFloatBase\n{\n  static #nextPhase = 0;\n\n  @io.persist\n  @type.int32\n  octaves = 8;\n\n  @io.persist\n  @type.objectRef(\"Tr2CurveScalar\")\n  magnitudeCurve = null;\n\n  @io.persist\n  @type.float32\n  magnitude = 1;\n\n  @io.persist\n  @type.float32\n  perlineScale = 1;\n\n  #phase = EveVirtualCameraBehaviourFloatNoise.#allocatePhase();\n\n  constructor()\n  {\n    super();\n    this.magnitudeCurve = EveVirtualCameraBehaviourFloatNoise.#createMagnitudeCurve();\n    this.SetName(\"Shake\");\n  }\n\n  @carbon.method\n  @impl.implemented\n  SetName(name)\n  {\n    super.SetName(name);\n    this.magnitudeCurve?.SetName?.(`${this.name} - Magnitude Curve`);\n  }\n\n  @carbon.method\n  @impl.adapted\n  Update(camera, _current, _deltaTime, localElapsedTime)\n  {\n    let offset = this.magnitude * TriPerlinCurve.PerlinNoise1D(\n      (localElapsedTime + this.#phase) * this.perlineScale,\n      2,\n      2,\n      this.octaves\n    );\n    if (this.magnitudeCurve)\n    {\n      const duration = Number(camera?.GetAnimationTimelineLength?.() ?? 0);\n      const time = duration !== 0 ? localElapsedTime / duration : 0;\n      offset *= Number(this.magnitudeCurve.GetValue?.(time) ?? 1);\n    }\n    return offset;\n  }\n\n  static #createMagnitudeCurve()\n  {\n    const curve = new Tr2CurveScalar();\n    curve.SetExtrapolation(Tr2CurveExtrapolation.LINEAR);\n    curve.AddKey(0, 0);\n    curve.AddKey(0.001, 0.8);\n    curve.AddKey(0.1, 1);\n    curve.AddKey(1, 0);\n    return curve;\n  }\n\n  static #allocatePhase()\n  {\n    const phase = EveVirtualCameraBehaviourFloatNoise.#nextPhase & 0xfff;\n    EveVirtualCameraBehaviourFloatNoise.#nextPhase++;\n    return phase;\n  }\n}\n"],"names":["_EveVirtualCameraBeha","_identity","EveVirtualCameraBehaviourFloatNoise","EveVirtualCameraBehaviourFloatBase","e","_init_octaves","_init_extra_octaves","_init_magnitudeCurve","_init_extra_magnitudeCurve","_init_magnitude","_init_extra_magnitude","_init_perlineScale","_init_extra_perlineScale","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","int32","objectRef","float32","carbon","method","impl","implemented","adapted","octaves","magnitudeCurve","magnitude","perlineScale","constructor","SetName","name","Update","camera","_current","_deltaTime","localElapsedTime","offset","TriPerlinCurve","PerlinNoise1D","duration","Number","GetAnimationTimelineLength","time","GetValue","#createMagnitudeCurve","curve","Tr2CurveScalar","SetExtrapolation","Tr2CurveExtrapolation","LINEAR","AddKey","#allocatePhase","phase"],"mappings":"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"}
+{"version":3,"file":"EveVirtualCameraBehaviourFloatNoise.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatNoise.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { Tr2CurveScalar } from \"../../../curves/Tr2CurveScalar.js\";\nimport { Tr2CurveExtrapolation } from \"../../../curves/enums.js\";\nimport { TriPerlinCurve } from \"../../../curves/TriPerlinCurve.js\";\nimport { EveVirtualCameraBehaviourFloatBase } from \"./EveVirtualCameraBehaviourFloatBase.js\";\n\n\n/**\n * Float behaviour that adds a Perlin-noise wobble to a scalar camera value such\n * as field of view or roll.\n */\n@type.define({\n  className: \"EveVirtualCameraBehaviourFloatNoise\",\n  family: \"eve/virtualCamera/behaviour\"\n})\nexport class EveVirtualCameraBehaviourFloatNoise extends EveVirtualCameraBehaviourFloatBase\n{\n  static #nextPhase = 0;\n\n  @io.persist\n  @type.int32\n  octaves = 8;\n\n  @io.persist\n  @type.objectRef(\"Tr2CurveScalar\")\n  magnitudeCurve = null;\n\n  @io.persist\n  @type.float32\n  magnitude = 1;\n\n  @io.persist\n  @type.float32\n  perlineScale = 1;\n\n  #phase = EveVirtualCameraBehaviourFloatNoise.#allocatePhase();\n\n  /**\n   * Creates the default magnitude envelope curve and names the behaviour\n   * \"Shake\".\n   */\n  constructor()\n  {\n    super();\n    this.magnitudeCurve = EveVirtualCameraBehaviourFloatNoise.#createMagnitudeCurve();\n    this.SetName(\"Shake\");\n  }\n\n  /** Sets the behaviour name and renames the owned magnitude curve to match. */\n  @carbon.method\n  @impl.implemented\n  SetName(name)\n  {\n    super.SetName(name);\n    this.magnitudeCurve?.SetName?.(`${this.name} - Magnitude Curve`);\n  }\n\n  /**\n   * Returns the authored magnitude scaled by a 1D Perlin sample of the\n   * phase-offset local time (rate set by perlineScale, detail by octaves) and by\n   * the magnitude envelope at normalized timeline time.\n   */\n  @carbon.method\n  @impl.adapted\n  Update(camera, _current, _deltaTime, localElapsedTime)\n  {\n    let offset = this.magnitude * TriPerlinCurve.PerlinNoise1D(\n      (localElapsedTime + this.#phase) * this.perlineScale,\n      2,\n      2,\n      this.octaves\n    );\n    if (this.magnitudeCurve)\n    {\n      const duration = Number(camera?.GetAnimationTimelineLength?.() ?? 0);\n      const time = duration !== 0 ? localElapsedTime / duration : 0;\n      offset *= Number(this.magnitudeCurve.GetValue?.(time) ?? 1);\n    }\n    return offset;\n  }\n\n  /**\n   * Builds the default envelope over normalized time: a near-instant ramp to\n   * full magnitude by 0.1, then a linear fade to zero at the end of the\n   * timeline.\n   */\n  static #createMagnitudeCurve()\n  {\n    const curve = new Tr2CurveScalar();\n    curve.SetExtrapolation(Tr2CurveExtrapolation.LINEAR);\n    curve.AddKey(0, 0);\n    curve.AddKey(0.001, 0.8);\n    curve.AddKey(0.1, 1);\n    curve.AddKey(1, 0);\n    return curve;\n  }\n\n  /**\n   * Hands each new instance a distinct noise phase from a rolling 12-bit\n   * counter, keeping simultaneous noise behaviours from moving in lockstep.\n   */\n  static #allocatePhase()\n  {\n    const phase = EveVirtualCameraBehaviourFloatNoise.#nextPhase & 0xfff;\n    EveVirtualCameraBehaviourFloatNoise.#nextPhase++;\n    return phase;\n  }\n}\n"],"names":["_EveVirtualCameraBeha","_identity","EveVirtualCameraBehaviourFloatNoise","EveVirtualCameraBehaviourFloatBase","e","_init_octaves","_init_extra_octaves","_init_magnitudeCurve","_init_extra_magnitudeCurve","_init_magnitude","_init_extra_magnitude","_init_perlineScale","_init_extra_perlineScale","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","int32","objectRef","float32","carbon","method","impl","implemented","adapted","octaves","magnitudeCurve","magnitude","perlineScale","constructor","SetName","name","Update","camera","_current","_deltaTime","localElapsedTime","offset","TriPerlinCurve","PerlinNoise1D","duration","Number","GetAnimationTimelineLength","time","GetValue","#createMagnitudeCurve","curve","Tr2CurveScalar","SetExtrapolation","Tr2CurveExtrapolation","LINEAR","AddKey","#allocatePhase","phase"],"mappings":"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"}

package/dist/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatSet.js

@@ -3,6 +3,11 @@ import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { EveVirtualCameraBehaviourFloatBase as _EveVirtualCameraBeha$1 } from './EveVirtualCameraBehaviourFloatBase.js';
 
 let _initProto, _initClass, _init_value, _init_extra_value;
+
+/**
+ * Float behaviour that overrides whatever the earlier behaviours accumulated
+ * with an authored constant.
+ */
 let _EveVirtualCameraBeha;
 class EveVirtualCameraBehaviourFloatSet extends _EveVirtualCameraBeha$1 {
   static {
@@ -15,10 +20,20 @@ class EveVirtualCameraBehaviourFloatSet extends _EveVirtualCameraBeha$1 {
     })], [[[io, io.persist, type, type.float32], 16, "value"], [[carbon, carbon.method, impl, impl.implemented], 18, "Update"]], 0, void 0, _EveVirtualCameraBeha$1));
   }
   value = (_initProto(this), _init_value(this, 0));
+
+  /**
+   * Stamps the authored behaviour name that identifies this entry in a camera
+   * behaviour list.
+   */
   constructor() {
     super(), _init_extra_value(this);
     this.name = "Set";
   }
+
+  /**
+   * Returns the delta that replaces the incoming value with the authored one,
+   * since the camera accumulates behaviour results additively.
+   */
   Update(_camera, current) {
     return this.value - current;
   }

package/dist/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatSet.js.map

@@ -1 +1 @@
-{"version":3,"file":"EveVirtualCameraBehaviourFloatSet.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatSet.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { EveVirtualCameraBehaviourFloatBase } from \"./EveVirtualCameraBehaviourFloatBase.js\";\n\n\n@type.define({\n  className: \"EveVirtualCameraBehaviourFloatSet\",\n  family: \"eve/virtualCamera/behaviour\"\n})\nexport class EveVirtualCameraBehaviourFloatSet extends EveVirtualCameraBehaviourFloatBase\n{\n  @io.persist\n  @type.float32\n  value = 0;\n\n  constructor()\n  {\n    super();\n    this.name = \"Set\";\n  }\n\n  @carbon.method\n  @impl.implemented\n  Update(_camera, current)\n  {\n    return this.value - current;\n  }\n}\n"],"names":["_EveVirtualCameraBeha","EveVirtualCameraBehaviourFloatSet","EveVirtualCameraBehaviourFloatBase","e","_init_value","_init_extra_value","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","float32","carbon","method","impl","implemented","value","constructor","name","Update","_camera","current"],"mappings":";;;;;AAG6F,IAAAA;AAG7F,MAAAC,iCAAA,SAIuDC,uBAAkC,CACzF;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,WAAA,EAAAC,iBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAP,qBAAA,EAAAQ,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,mCAAmC;AAC9CC,MAAAA,MAAM,EAAE;KACT,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,OAAO,mBASZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,QAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EAboClB,uBAAkC,CAAA;AAAA;AAIvFmB,EAAAA,KAAK,IAAAf,UAAA,CAAA,IAAA,CAAA,EAAAF,WAAA,OAAG,CAAC,CAAA;AAETkB,EAAAA,WAAWA,GACX;IACE,KAAK,EAAE,EAAAjB,iBAAA,CAAA,IAAA,CAAA;IACP,IAAI,CAACkB,IAAI,GAAG,KAAK;AACnB,EAAA;AAIAC,EAAAA,MAAMA,CAACC,OAAO,EAAEC,OAAO,EACvB;AACE,IAAA,OAAO,IAAI,CAACL,KAAK,GAAGK,OAAO;AAC7B,EAAA;AAAC,EAAA;IAAAlB,UAAA,EAAA;AAAA;AACH;;;;"}
+{"version":3,"file":"EveVirtualCameraBehaviourFloatSet.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourFloatSet.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { EveVirtualCameraBehaviourFloatBase } from \"./EveVirtualCameraBehaviourFloatBase.js\";\n\n\n/**\n * Float behaviour that overrides whatever the earlier behaviours accumulated\n * with an authored constant.\n */\n@type.define({\n  className: \"EveVirtualCameraBehaviourFloatSet\",\n  family: \"eve/virtualCamera/behaviour\"\n})\nexport class EveVirtualCameraBehaviourFloatSet extends EveVirtualCameraBehaviourFloatBase\n{\n  @io.persist\n  @type.float32\n  value = 0;\n\n  /**\n   * Stamps the authored behaviour name that identifies this entry in a camera\n   * behaviour list.\n   */\n  constructor()\n  {\n    super();\n    this.name = \"Set\";\n  }\n\n  /**\n   * Returns the delta that replaces the incoming value with the authored one,\n   * since the camera accumulates behaviour results additively.\n   */\n  @carbon.method\n  @impl.implemented\n  Update(_camera, current)\n  {\n    return this.value - current;\n  }\n}\n"],"names":["_EveVirtualCameraBeha","EveVirtualCameraBehaviourFloatSet","EveVirtualCameraBehaviourFloatBase","e","_init_value","_init_extra_value","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","float32","carbon","method","impl","implemented","value","constructor","name","Update","_camera","current"],"mappings":";;;;;;AAMA;AACA;AACA;AACA;AAHA,IAAAA;AAIA,MAAAC,iCAAA,SAIuDC,uBAAkC,CACzF;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,WAAA,EAAAC,iBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAP,qBAAA,EAAAQ,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,mCAAmC;AAC9CC,MAAAA,MAAM,EAAE;KACT,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,OAAO,mBAiBZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,QAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EArBoClB,uBAAkC,CAAA;AAAA;AAIvFmB,EAAAA,KAAK,IAAAf,UAAA,CAAA,IAAA,CAAA,EAAAF,WAAA,OAAG,CAAC,CAAA;;AAET;AACF;AACA;AACA;AACEkB,EAAAA,WAAWA,GACX;IACE,KAAK,EAAE,EAAAjB,iBAAA,CAAA,IAAA,CAAA;IACP,IAAI,CAACkB,IAAI,GAAG,KAAK;AACnB,EAAA;;AAEA;AACF;AACA;AACA;AAGEC,EAAAA,MAAMA,CAACC,OAAO,EAAEC,OAAO,EACvB;AACE,IAAA,OAAO,IAAI,CAACL,KAAK,GAAGK,OAAO;AAC7B,EAAA;AAAC,EAAA;IAAAlB,UAAA,EAAA;AAAA;AACH;;;;"}

package/dist/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourVector3Base.js

@@ -7,6 +7,11 @@ import { Tr2CurveScalar as _Tr2CurveScalar } from '../../../curves/Tr2CurveScala
 import { Tr2CurveExtrapolation } from '../../../curves/enums.js';
 
 let _initProto, _initClass, _init_active, _init_extra_active, _init_name, _init_extra_name;
+
+/**
+ * Base for the virtual camera behaviours that contribute a world-space vector3
+ * offset to a camera's position or point of interest each update.
+ */
 let _EveVirtualCameraBeha;
 class EveVirtualCameraBehaviourVector3Base extends CjsModel {
   static {
@@ -24,19 +29,39 @@ class EveVirtualCameraBehaviourVector3Base extends CjsModel {
   }
   active = (_initProto(this), _init_active(this, true));
   name = (_init_extra_active(this), _init_name(this, ""));
+
+  /** Returns the authored behaviour name shown in tooling. */
   GetName() {
     return this.name;
   }
+
+  /**
+   * Sets the behaviour name, coercing to a string; subclasses override this to
+   * rename the curves they own alongside it.
+   */
   SetName(name) {
     this.name = String(name);
   }
+
+  /**
+   * Re-applies the current name after a field change, which propagates it to any
+   * owned curves through the subclass SetName override.
+   */
   OnModified(_options = {}) {
     this.SetName(this.name);
     return true;
   }
+
+  /** Reports whether the camera should evaluate this behaviour this update. */
   IsActive() {
     return this.active;
   }
+
+  /**
+   * Builds the default scalar curve that holds a single value across normalized
+   * time 0 to 1, used where a subclass wants an unshaped multiplier the author
+   * can later edit.
+   */
   static createConstantCurve(value = 1) {
     const curve = new _Tr2CurveScalar();
     curve.SetExtrapolation(Tr2CurveExtrapolation.LINEAR);
@@ -44,6 +69,12 @@ class EveVirtualCameraBehaviourVector3Base extends CjsModel {
     curve.AddKey(1, value);
     return curve;
   }
+
+  /**
+   * Builds the default scalar curve ramping linearly from 0 to 1 across
+   * normalized time, used as the starting interpolation shape for behaviours
+   * that sweep between two values.
+   */
   static createEaseCurve() {
     const curve = new _Tr2CurveScalar();
     curve.SetExtrapolation(Tr2CurveExtrapolation.LINEAR);
@@ -51,6 +82,13 @@ class EveVirtualCameraBehaviourVector3Base extends CjsModel {
     curve.AddKey(1, 1);
     return curve;
   }
+
+  /**
+   * Rotates a vector about world up by the yaw of the anchor's forward
+   * direction, turning an anchor-relative offset into a world-space one that
+   * follows the anchored object's heading; the vector is returned unchanged when
+   * the forward direction has no horizontal component.
+   */
   static rotateVectorWithAnchor(out, value, anchorForwardDirection) {
     const horizontal = vec3.fromValues(anchorForwardDirection[0], 0, anchorForwardDirection[2]);
     if (vec3.squaredLength(horizontal) === 0) {

package/dist/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourVector3Base.js.map

@@ -1 +1 @@
-{"version":3,"file":"EveVirtualCameraBehaviourVector3Base.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourVector3Base.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\r\nimport { quat } from \"@carbonenginejs/runtime-utils/quat\";\r\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { Tr2CurveScalar } from \"../../../curves/Tr2CurveScalar.js\";\r\nimport { Tr2CurveExtrapolation } from \"../../../curves/enums.js\";\r\n\r\n\r\n@type.define({\r\n  className: \"EveVirtualCameraBehaviourVector3Base\",\r\n  family: \"eve/virtualCamera/behaviour\"\r\n})\r\nexport class EveVirtualCameraBehaviourVector3Base extends CjsModel\r\n{\r\n  @io.persist\r\n  @type.boolean\r\n  active = true;\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetName()\r\n  {\r\n    return this.name;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetName(name)\r\n  {\r\n    this.name = String(name);\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    this.SetName(this.name);\r\n    return true;\r\n  }\r\n\r\n  @carbon.method\r\n  @impl.implemented\r\n  IsActive()\r\n  {\r\n    return this.active;\r\n  }\r\n\r\n  static createConstantCurve(value = 1)\r\n  {\r\n    const curve = new Tr2CurveScalar();\r\n    curve.SetExtrapolation(Tr2CurveExtrapolation.LINEAR);\r\n    curve.AddKey(0, value);\r\n    curve.AddKey(1, value);\r\n    return curve;\r\n  }\r\n\r\n  static createEaseCurve()\r\n  {\r\n    const curve = new Tr2CurveScalar();\r\n    curve.SetExtrapolation(Tr2CurveExtrapolation.LINEAR);\r\n    curve.AddKey(0, 0);\r\n    curve.AddKey(1, 1);\r\n    return curve;\r\n  }\r\n\r\n  static rotateVectorWithAnchor(out, value, anchorForwardDirection)\r\n  {\r\n    const horizontal = vec3.fromValues(anchorForwardDirection[0], 0, anchorForwardDirection[2]);\r\n    if (vec3.squaredLength(horizontal) === 0)\r\n    {\r\n      return vec3.copy(out, value);\r\n    }\r\n    vec3.normalize(horizontal, horizontal);\r\n    const yaw = Math.atan2(horizontal[0], horizontal[2]);\r\n    const rotation = quat.setAxisAngle(quat.create(), vec3.fromValues(0, 1, 0), yaw);\r\n    return vec3.transformQuat(out, value, rotation);\r\n  }\r\n}\r\n"],"names":["_EveVirtualCameraBeha","EveVirtualCameraBehaviourVector3Base","CjsModel","e","_init_active","_init_extra_active","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","boolean","notify","string","carbon","method","impl","implemented","adapted","constructor","args","active","name","GetName","SetName","String","OnModified","_options","IsActive","createConstantCurve","value","curve","Tr2CurveScalar","SetExtrapolation","Tr2CurveExtrapolation","LINEAR","AddKey","createEaseCurve","rotateVectorWithAnchor","out","anchorForwardDirection","horizontal","vec3","fromValues","squaredLength","copy","normalize","yaw","Math","atan2","rotation","quat","setAxisAngle","create","transformQuat"],"mappings":"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"}
+{"version":3,"file":"EveVirtualCameraBehaviourVector3Base.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourVector3Base.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\r\nimport { quat } from \"@carbonenginejs/runtime-utils/quat\";\r\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { Tr2CurveScalar } from \"../../../curves/Tr2CurveScalar.js\";\r\nimport { Tr2CurveExtrapolation } from \"../../../curves/enums.js\";\r\n\r\n\r\n/**\r\n * Base for the virtual camera behaviours that contribute a world-space vector3\r\n * offset to a camera's position or point of interest each update.\r\n */\r\n@type.define({\r\n  className: \"EveVirtualCameraBehaviourVector3Base\",\r\n  family: \"eve/virtualCamera/behaviour\"\r\n})\r\nexport class EveVirtualCameraBehaviourVector3Base extends CjsModel\r\n{\r\n  @io.persist\r\n  @type.boolean\r\n  active = true;\r\n\r\n  @io.notify\r\n  @io.persist\r\n  @type.string\r\n  name = \"\";\r\n\r\n  /** Returns the authored behaviour name shown in tooling. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetName()\r\n  {\r\n    return this.name;\r\n  }\r\n\r\n  /**\r\n   * Sets the behaviour name, coercing to a string; subclasses override this to\r\n   * rename the curves they own alongside it.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetName(name)\r\n  {\r\n    this.name = String(name);\r\n  }\r\n\r\n  /**\r\n   * Re-applies the current name after a field change, which propagates it to any\r\n   * owned curves through the subclass SetName override.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  OnModified(_options = {})\r\n  {\r\n    this.SetName(this.name);\r\n    return true;\r\n  }\r\n\r\n  /** Reports whether the camera should evaluate this behaviour this update. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  IsActive()\r\n  {\r\n    return this.active;\r\n  }\r\n\r\n  /**\r\n   * Builds the default scalar curve that holds a single value across normalized\r\n   * time 0 to 1, used where a subclass wants an unshaped multiplier the author\r\n   * can later edit.\r\n   */\r\n  static createConstantCurve(value = 1)\r\n  {\r\n    const curve = new Tr2CurveScalar();\r\n    curve.SetExtrapolation(Tr2CurveExtrapolation.LINEAR);\r\n    curve.AddKey(0, value);\r\n    curve.AddKey(1, value);\r\n    return curve;\r\n  }\r\n\r\n  /**\r\n   * Builds the default scalar curve ramping linearly from 0 to 1 across\r\n   * normalized time, used as the starting interpolation shape for behaviours\r\n   * that sweep between two values.\r\n   */\r\n  static createEaseCurve()\r\n  {\r\n    const curve = new Tr2CurveScalar();\r\n    curve.SetExtrapolation(Tr2CurveExtrapolation.LINEAR);\r\n    curve.AddKey(0, 0);\r\n    curve.AddKey(1, 1);\r\n    return curve;\r\n  }\r\n\r\n  /**\r\n   * Rotates a vector about world up by the yaw of the anchor's forward\r\n   * direction, turning an anchor-relative offset into a world-space one that\r\n   * follows the anchored object's heading; the vector is returned unchanged when\r\n   * the forward direction has no horizontal component.\r\n   */\r\n  static rotateVectorWithAnchor(out, value, anchorForwardDirection)\r\n  {\r\n    const horizontal = vec3.fromValues(anchorForwardDirection[0], 0, anchorForwardDirection[2]);\r\n    if (vec3.squaredLength(horizontal) === 0)\r\n    {\r\n      return vec3.copy(out, value);\r\n    }\r\n    vec3.normalize(horizontal, horizontal);\r\n    const yaw = Math.atan2(horizontal[0], horizontal[2]);\r\n    const rotation = quat.setAxisAngle(quat.create(), vec3.fromValues(0, 1, 0), yaw);\r\n    return vec3.transformQuat(out, value, rotation);\r\n  }\r\n}\r\n"],"names":["_EveVirtualCameraBeha","EveVirtualCameraBehaviourVector3Base","CjsModel","e","_init_active","_init_extra_active","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","boolean","notify","string","carbon","method","impl","implemented","adapted","constructor","args","active","name","GetName","SetName","String","OnModified","_options","IsActive","createConstantCurve","value","curve","Tr2CurveScalar","SetExtrapolation","Tr2CurveExtrapolation","LINEAR","AddKey","createEaseCurve","rotateVectorWithAnchor","out","anchorForwardDirection","horizontal","vec3","fromValues","squaredLength","copy","normalize","yaw","Math","atan2","rotation","quat","setAxisAngle","create","transformQuat"],"mappings":"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"}

package/dist/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourVector3Damping.js

@@ -4,6 +4,11 @@ import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { EveVirtualCameraBehaviourVector3Base as _EveVirtualCameraBeha$1 } from './EveVirtualCameraBehaviourVector3Base.js';
 
 let _initProto, _initClass, _init_m_dampingRatio, _init_extra_m_dampingRatio;
+
+/**
+ * Vector3 behaviour that lags the camera position or point of interest behind
+ * its target, giving a smooth follow with no overshoot.
+ */
 let _EveVirtualCameraBeha;
 class EveVirtualCameraBehaviourVector3Damping extends _EveVirtualCameraBeha$1 {
   static {
@@ -17,10 +22,22 @@ class EveVirtualCameraBehaviourVector3Damping extends _EveVirtualCameraBeha$1 {
   }
   m_dampingRatio = (_initProto(this), _init_m_dampingRatio(this, 1));
   #lastPosition = (_init_extra_m_dampingRatio(this), vec3.create());
+
+  /**
+   * Names the behaviour "Damping"; the default ratio of 1 follows the input
+   * exactly.
+   */
   constructor() {
     super();
     this.name = "Damping";
   }
+
+  /**
+   * Lerps the retained position towards the incoming one by m_dampingRatio and
+   * returns the offset from the incoming position to that smoothed one; the
+   * first update (local time at or below zero) seeds the retained position and
+   * returns zero.
+   */
   Update(_camera, current, _deltaTime, localElapsedTime, _anchorPosition, _anchorRadius, _anchorForwardDirection, out = vec3.create()) {
     if (localElapsedTime <= 0) {
       vec3.copy(this.#lastPosition, current);

package/dist/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourVector3Damping.js.map

@@ -1 +1 @@
-{"version":3,"file":"EveVirtualCameraBehaviourVector3Damping.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourVector3Damping.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { EveVirtualCameraBehaviourVector3Base } from \"./EveVirtualCameraBehaviourVector3Base.js\";\n\n\n@type.define({\n  className: \"EveVirtualCameraBehaviourVector3Damping\",\n  family: \"eve/virtualCamera/behaviour\"\n})\nexport class EveVirtualCameraBehaviourVector3Damping extends EveVirtualCameraBehaviourVector3Base\n{\n  @io.persist\n  @type.float32\n  m_dampingRatio = 1;\n\n  #lastPosition = vec3.create();\n\n  constructor()\n  {\n    super();\n    this.name = \"Damping\";\n  }\n\n  @carbon.method\n  @impl.adapted\n  Update(_camera, current, _deltaTime, localElapsedTime, _anchorPosition, _anchorRadius, _anchorForwardDirection, out = vec3.create())\n  {\n    if (localElapsedTime <= 0)\n    {\n      vec3.copy(this.#lastPosition, current);\n      return vec3.zero(out);\n    }\n    vec3.lerp(this.#lastPosition, this.#lastPosition, current, this.m_dampingRatio);\n    return vec3.subtract(out, this.#lastPosition, current);\n  }\n}\n"],"names":["_EveVirtualCameraBeha","EveVirtualCameraBehaviourVector3Damping","EveVirtualCameraBehaviourVector3Base","e","_init_m_dampingRatio","_init_extra_m_dampingRatio","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","float32","carbon","method","impl","adapted","m_dampingRatio","vec3","create","constructor","name","Update","_camera","current","_deltaTime","localElapsedTime","_anchorPosition","_anchorRadius","_anchorForwardDirection","out","copy","zero","lerp","subtract"],"mappings":";;;;;;AAIiG,IAAAA;AAGjG,MAAAC,uCAAA,SAI6DC,uBAAoC,CACjG;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,oBAAA,EAAAC,0BAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAP,qBAAA,EAAAQ,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,yCAAyC;AACpDC,MAAAA,MAAM,EAAE;KACT,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,OAAO,4BAWZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,QAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EAf8ClB,uBAAoC,CAAA;AAAA;AAI/FmB,EAAAA,cAAc,IAAAf,UAAA,CAAA,IAAA,CAAA,EAAAF,oBAAA,OAAG,CAAC,CAAA;EAElB,aAAa,IAAAC,0BAAA,CAAA,IAAA,CAAA,EAAGiB,IAAI,CAACC,MAAM,EAAE;AAE7BC,EAAAA,WAAWA,GACX;AACE,IAAA,KAAK,EAAE;IACP,IAAI,CAACC,IAAI,GAAG,SAAS;AACvB,EAAA;EAIAC,MAAMA,CAACC,OAAO,EAAEC,OAAO,EAAEC,UAAU,EAAEC,gBAAgB,EAAEC,eAAe,EAAEC,aAAa,EAAEC,uBAAuB,EAAEC,GAAG,GAAGZ,IAAI,CAACC,MAAM,EAAE,EACnI;IACE,IAAIO,gBAAgB,IAAI,CAAC,EACzB;MACER,IAAI,CAACa,IAAI,CAAC,IAAI,CAAC,aAAa,EAAEP,OAAO,CAAC;AACtC,MAAA,OAAON,IAAI,CAACc,IAAI,CAACF,GAAG,CAAC;AACvB,IAAA;AACAZ,IAAAA,IAAI,CAACe,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,EAAET,OAAO,EAAE,IAAI,CAACP,cAAc,CAAC;AAC/E,IAAA,OAAOC,IAAI,CAACgB,QAAQ,CAACJ,GAAG,EAAE,IAAI,CAAC,aAAa,EAAEN,OAAO,CAAC;AACxD,EAAA;AAAC,EAAA;IAAApB,UAAA,EAAA;AAAA;AACH;;;;"}
+{"version":3,"file":"EveVirtualCameraBehaviourVector3Damping.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourVector3Damping.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { EveVirtualCameraBehaviourVector3Base } from \"./EveVirtualCameraBehaviourVector3Base.js\";\n\n\n/**\n * Vector3 behaviour that lags the camera position or point of interest behind\n * its target, giving a smooth follow with no overshoot.\n */\n@type.define({\n  className: \"EveVirtualCameraBehaviourVector3Damping\",\n  family: \"eve/virtualCamera/behaviour\"\n})\nexport class EveVirtualCameraBehaviourVector3Damping extends EveVirtualCameraBehaviourVector3Base\n{\n  @io.persist\n  @type.float32\n  m_dampingRatio = 1;\n\n  #lastPosition = vec3.create();\n\n  /**\n   * Names the behaviour \"Damping\"; the default ratio of 1 follows the input\n   * exactly.\n   */\n  constructor()\n  {\n    super();\n    this.name = \"Damping\";\n  }\n\n  /**\n   * Lerps the retained position towards the incoming one by m_dampingRatio and\n   * returns the offset from the incoming position to that smoothed one; the\n   * first update (local time at or below zero) seeds the retained position and\n   * returns zero.\n   */\n  @carbon.method\n  @impl.adapted\n  Update(_camera, current, _deltaTime, localElapsedTime, _anchorPosition, _anchorRadius, _anchorForwardDirection, out = vec3.create())\n  {\n    if (localElapsedTime <= 0)\n    {\n      vec3.copy(this.#lastPosition, current);\n      return vec3.zero(out);\n    }\n    vec3.lerp(this.#lastPosition, this.#lastPosition, current, this.m_dampingRatio);\n    return vec3.subtract(out, this.#lastPosition, current);\n  }\n}\n"],"names":["_EveVirtualCameraBeha","EveVirtualCameraBehaviourVector3Damping","EveVirtualCameraBehaviourVector3Base","e","_init_m_dampingRatio","_init_extra_m_dampingRatio","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","float32","carbon","method","impl","adapted","m_dampingRatio","vec3","create","constructor","name","Update","_camera","current","_deltaTime","localElapsedTime","_anchorPosition","_anchorRadius","_anchorForwardDirection","out","copy","zero","lerp","subtract"],"mappings":";;;;;;;AAOA;AACA;AACA;AACA;AAHA,IAAAA;AAIA,MAAAC,uCAAA,SAI6DC,uBAAoC,CACjG;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,oBAAA,EAAAC,0BAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAP,qBAAA,EAAAQ,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,yCAAyC;AACpDC,MAAAA,MAAM,EAAE;KACT,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,OAAO,4BAqBZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,QAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EAzB8ClB,uBAAoC,CAAA;AAAA;AAI/FmB,EAAAA,cAAc,IAAAf,UAAA,CAAA,IAAA,CAAA,EAAAF,oBAAA,OAAG,CAAC,CAAA;EAElB,aAAa,IAAAC,0BAAA,CAAA,IAAA,CAAA,EAAGiB,IAAI,CAACC,MAAM,EAAE;;AAE7B;AACF;AACA;AACA;AACEC,EAAAA,WAAWA,GACX;AACE,IAAA,KAAK,EAAE;IACP,IAAI,CAACC,IAAI,GAAG,SAAS;AACvB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;EAGEC,MAAMA,CAACC,OAAO,EAAEC,OAAO,EAAEC,UAAU,EAAEC,gBAAgB,EAAEC,eAAe,EAAEC,aAAa,EAAEC,uBAAuB,EAAEC,GAAG,GAAGZ,IAAI,CAACC,MAAM,EAAE,EACnI;IACE,IAAIO,gBAAgB,IAAI,CAAC,EACzB;MACER,IAAI,CAACa,IAAI,CAAC,IAAI,CAAC,aAAa,EAAEP,OAAO,CAAC;AACtC,MAAA,OAAON,IAAI,CAACc,IAAI,CAACF,GAAG,CAAC;AACvB,IAAA;AACAZ,IAAAA,IAAI,CAACe,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,EAAET,OAAO,EAAE,IAAI,CAACP,cAAc,CAAC;AAC/E,IAAA,OAAOC,IAAI,CAACgB,QAAQ,CAACJ,GAAG,EAAE,IAAI,CAAC,aAAa,EAAEN,OAAO,CAAC;AACxD,EAAA;AAAC,EAAA;IAAApB,UAAA,EAAA;AAAA;AACH;;;;"}

package/dist/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourVector3Inertia.js

@@ -4,6 +4,11 @@ import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { EveVirtualCameraBehaviourVector3Base as _EveVirtualCameraBeha$1 } from './EveVirtualCameraBehaviourVector3Base.js';
 
 let _initProto, _initClass, _init_inertiaFactor, _init_extra_inertiaFactor;
+
+/**
+ * Vector3 behaviour that gives the camera value momentum, so it accelerates
+ * towards its target and coasts rather than tracking it exactly.
+ */
 let _EveVirtualCameraBeha;
 class EveVirtualCameraBehaviourVector3Inertia extends _EveVirtualCameraBeha$1 {
   static {
@@ -18,10 +23,23 @@ class EveVirtualCameraBehaviourVector3Inertia extends _EveVirtualCameraBeha$1 {
   inertiaFactor = (_initProto(this), _init_inertiaFactor(this, 1));
   #lastPosition = (_init_extra_inertiaFactor(this), vec3.create());
   #lastVelocity = vec3.create();
+
+  /**
+   * Names the behaviour "Inertia"; the default factor of 1 applies the full
+   * correction each update.
+   */
   constructor() {
     super();
     this.name = "Inertia";
   }
+
+  /**
+   * Accelerates a retained velocity towards the incoming position by the
+   * position error less the current velocity, divided by inertiaFactor (larger
+   * values are heavier and slower to respond), advances the retained position by
+   * it and returns the offset from the incoming position; the first update seeds
+   * position and velocity and returns zero.
+   */
   Update(_camera, current, deltaTime, localElapsedTime, _anchorPosition, _anchorRadius, _anchorForwardDirection, out = vec3.create()) {
     if (localElapsedTime <= 0) {
       vec3.zero(this.#lastVelocity);

package/dist/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourVector3Inertia.js.map

@@ -1 +1 @@
-{"version":3,"file":"EveVirtualCameraBehaviourVector3Inertia.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourVector3Inertia.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { EveVirtualCameraBehaviourVector3Base } from \"./EveVirtualCameraBehaviourVector3Base.js\";\n\n\n@type.define({\n  className: \"EveVirtualCameraBehaviourVector3Inertia\",\n  family: \"eve/virtualCamera/behaviour\"\n})\nexport class EveVirtualCameraBehaviourVector3Inertia extends EveVirtualCameraBehaviourVector3Base\n{\n  @io.persist\n  @type.float32\n  inertiaFactor = 1;\n\n  #lastPosition = vec3.create();\n\n  #lastVelocity = vec3.create();\n\n  constructor()\n  {\n    super();\n    this.name = \"Inertia\";\n  }\n\n  @carbon.method\n  @impl.adapted\n  Update(_camera, current, deltaTime, localElapsedTime, _anchorPosition, _anchorRadius, _anchorForwardDirection, out = vec3.create())\n  {\n    if (localElapsedTime <= 0)\n    {\n      vec3.zero(this.#lastVelocity);\n      vec3.copy(this.#lastPosition, current);\n      return vec3.zero(out);\n    }\n    const delta = vec3.subtract(vec3.create(), current, this.#lastPosition);\n    vec3.subtract(delta, delta, this.#lastVelocity);\n    vec3.scaleAndAdd(this.#lastVelocity, this.#lastVelocity, delta, 1 / this.inertiaFactor);\n    vec3.add(this.#lastPosition, this.#lastPosition, this.#lastVelocity);\n    vec3.scale(this.#lastVelocity, this.#lastVelocity, deltaTime);\n    return vec3.subtract(out, this.#lastPosition, current);\n  }\n}\n"],"names":["_EveVirtualCameraBeha","EveVirtualCameraBehaviourVector3Inertia","EveVirtualCameraBehaviourVector3Base","e","_init_inertiaFactor","_init_extra_inertiaFactor","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","float32","carbon","method","impl","adapted","inertiaFactor","vec3","create","constructor","name","Update","_camera","current","deltaTime","localElapsedTime","_anchorPosition","_anchorRadius","_anchorForwardDirection","out","zero","copy","delta","subtract","scaleAndAdd","add","scale"],"mappings":";;;;;;AAIiG,IAAAA;AAGjG,MAAAC,uCAAA,SAI6DC,uBAAoC,CACjG;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,mBAAA,EAAAC,yBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAP,qBAAA,EAAAQ,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,yCAAyC;AACpDC,MAAAA,MAAM,EAAE;KACT,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,OAAO,2BAaZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,QAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EAjB8ClB,uBAAoC,CAAA;AAAA;AAI/FmB,EAAAA,aAAa,IAAAf,UAAA,CAAA,IAAA,CAAA,EAAAF,mBAAA,OAAG,CAAC,CAAA;EAEjB,aAAa,IAAAC,yBAAA,CAAA,IAAA,CAAA,EAAGiB,IAAI,CAACC,MAAM,EAAE;AAE7B,EAAA,aAAa,GAAGD,IAAI,CAACC,MAAM,EAAE;AAE7BC,EAAAA,WAAWA,GACX;AACE,IAAA,KAAK,EAAE;IACP,IAAI,CAACC,IAAI,GAAG,SAAS;AACvB,EAAA;EAIAC,MAAMA,CAACC,OAAO,EAAEC,OAAO,EAAEC,SAAS,EAAEC,gBAAgB,EAAEC,eAAe,EAAEC,aAAa,EAAEC,uBAAuB,EAAEC,GAAG,GAAGZ,IAAI,CAACC,MAAM,EAAE,EAClI;IACE,IAAIO,gBAAgB,IAAI,CAAC,EACzB;AACER,MAAAA,IAAI,CAACa,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC;MAC7Bb,IAAI,CAACc,IAAI,CAAC,IAAI,CAAC,aAAa,EAAER,OAAO,CAAC;AACtC,MAAA,OAAON,IAAI,CAACa,IAAI,CAACD,GAAG,CAAC;AACvB,IAAA;AACA,IAAA,MAAMG,KAAK,GAAGf,IAAI,CAACgB,QAAQ,CAAChB,IAAI,CAACC,MAAM,EAAE,EAAEK,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC;IACvEN,IAAI,CAACgB,QAAQ,CAACD,KAAK,EAAEA,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC;IAC/Cf,IAAI,CAACiB,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,EAAEF,KAAK,EAAE,CAAC,GAAG,IAAI,CAAChB,aAAa,CAAC;AACvFC,IAAAA,IAAI,CAACkB,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC;AACpElB,IAAAA,IAAI,CAACmB,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,EAAEZ,SAAS,CAAC;AAC7D,IAAA,OAAOP,IAAI,CAACgB,QAAQ,CAACJ,GAAG,EAAE,IAAI,CAAC,aAAa,EAAEN,OAAO,CAAC;AACxD,EAAA;AAAC,EAAA;IAAApB,UAAA,EAAA;AAAA;AACH;;;;"}
+{"version":3,"file":"EveVirtualCameraBehaviourVector3Inertia.js","sources":["../../../../../src/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourVector3Inertia.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\VirtualCamera\\EveVirtualCameraBehaviour.cpp\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { EveVirtualCameraBehaviourVector3Base } from \"./EveVirtualCameraBehaviourVector3Base.js\";\n\n\n/**\n * Vector3 behaviour that gives the camera value momentum, so it accelerates\n * towards its target and coasts rather than tracking it exactly.\n */\n@type.define({\n  className: \"EveVirtualCameraBehaviourVector3Inertia\",\n  family: \"eve/virtualCamera/behaviour\"\n})\nexport class EveVirtualCameraBehaviourVector3Inertia extends EveVirtualCameraBehaviourVector3Base\n{\n  @io.persist\n  @type.float32\n  inertiaFactor = 1;\n\n  #lastPosition = vec3.create();\n\n  #lastVelocity = vec3.create();\n\n  /**\n   * Names the behaviour \"Inertia\"; the default factor of 1 applies the full\n   * correction each update.\n   */\n  constructor()\n  {\n    super();\n    this.name = \"Inertia\";\n  }\n\n  /**\n   * Accelerates a retained velocity towards the incoming position by the\n   * position error less the current velocity, divided by inertiaFactor (larger\n   * values are heavier and slower to respond), advances the retained position by\n   * it and returns the offset from the incoming position; the first update seeds\n   * position and velocity and returns zero.\n   */\n  @carbon.method\n  @impl.adapted\n  Update(_camera, current, deltaTime, localElapsedTime, _anchorPosition, _anchorRadius, _anchorForwardDirection, out = vec3.create())\n  {\n    if (localElapsedTime <= 0)\n    {\n      vec3.zero(this.#lastVelocity);\n      vec3.copy(this.#lastPosition, current);\n      return vec3.zero(out);\n    }\n    const delta = vec3.subtract(vec3.create(), current, this.#lastPosition);\n    vec3.subtract(delta, delta, this.#lastVelocity);\n    vec3.scaleAndAdd(this.#lastVelocity, this.#lastVelocity, delta, 1 / this.inertiaFactor);\n    vec3.add(this.#lastPosition, this.#lastPosition, this.#lastVelocity);\n    vec3.scale(this.#lastVelocity, this.#lastVelocity, deltaTime);\n    return vec3.subtract(out, this.#lastPosition, current);\n  }\n}\n"],"names":["_EveVirtualCameraBeha","EveVirtualCameraBehaviourVector3Inertia","EveVirtualCameraBehaviourVector3Base","e","_init_inertiaFactor","_init_extra_inertiaFactor","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","float32","carbon","method","impl","adapted","inertiaFactor","vec3","create","constructor","name","Update","_camera","current","deltaTime","localElapsedTime","_anchorPosition","_anchorRadius","_anchorForwardDirection","out","zero","copy","delta","subtract","scaleAndAdd","add","scale"],"mappings":";;;;;;;AAOA;AACA;AACA;AACA;AAHA,IAAAA;AAIA,MAAAC,uCAAA,SAI6DC,uBAAoC,CACjG;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,mBAAA,EAAAC,yBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAP,qBAAA,EAAAQ,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,yCAAyC;AACpDC,MAAAA,MAAM,EAAE;KACT,CAAC,CAAA,EAAA,CAAA,CAAA,CAGCC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,OAAO,2BAwBZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,QAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EA5B8ClB,uBAAoC,CAAA;AAAA;AAI/FmB,EAAAA,aAAa,IAAAf,UAAA,CAAA,IAAA,CAAA,EAAAF,mBAAA,OAAG,CAAC,CAAA;EAEjB,aAAa,IAAAC,yBAAA,CAAA,IAAA,CAAA,EAAGiB,IAAI,CAACC,MAAM,EAAE;AAE7B,EAAA,aAAa,GAAGD,IAAI,CAACC,MAAM,EAAE;;AAE7B;AACF;AACA;AACA;AACEC,EAAAA,WAAWA,GACX;AACE,IAAA,KAAK,EAAE;IACP,IAAI,CAACC,IAAI,GAAG,SAAS;AACvB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;EAGEC,MAAMA,CAACC,OAAO,EAAEC,OAAO,EAAEC,SAAS,EAAEC,gBAAgB,EAAEC,eAAe,EAAEC,aAAa,EAAEC,uBAAuB,EAAEC,GAAG,GAAGZ,IAAI,CAACC,MAAM,EAAE,EAClI;IACE,IAAIO,gBAAgB,IAAI,CAAC,EACzB;AACER,MAAAA,IAAI,CAACa,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC;MAC7Bb,IAAI,CAACc,IAAI,CAAC,IAAI,CAAC,aAAa,EAAER,OAAO,CAAC;AACtC,MAAA,OAAON,IAAI,CAACa,IAAI,CAACD,GAAG,CAAC;AACvB,IAAA;AACA,IAAA,MAAMG,KAAK,GAAGf,IAAI,CAACgB,QAAQ,CAAChB,IAAI,CAACC,MAAM,EAAE,EAAEK,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC;IACvEN,IAAI,CAACgB,QAAQ,CAACD,KAAK,EAAEA,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC;IAC/Cf,IAAI,CAACiB,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,EAAEF,KAAK,EAAE,CAAC,GAAG,IAAI,CAAChB,aAAa,CAAC;AACvFC,IAAAA,IAAI,CAACkB,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC;AACpElB,IAAAA,IAAI,CAACmB,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,EAAEZ,SAAS,CAAC;AAC7D,IAAA,OAAOP,IAAI,CAACgB,QAAQ,CAACJ,GAAG,EAAE,IAAI,CAAC,aAAa,EAAEN,OAAO,CAAC;AACxD,EAAA;AAAC,EAAA;IAAApB,UAAA,EAAA;AAAA;AACH;;;;"}

package/dist/eve/virtualCamera/behaviour/EveVirtualCameraBehaviourVector3MoveBetween.js

@@ -4,6 +4,11 @@ import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { EveVirtualCameraBehaviourVector3Base as _EveVirtualCameraBeha$1 } from './EveVirtualCameraBehaviourVector3Base.js';
 
 let _initProto, _initClass, _init_end, _init_extra_end, _init_proportional, _init_extra_proportional, _init_world, _init_extra_world, _init_interpolationCurve, _init_extra_interpolationCurve, _init_start, _init_extra_start;
+
+/**
+ * Vector3 behaviour that sweeps the camera value from one authored endpoint to
+ * another across the animation timeline.
+ */
 let _EveVirtualCameraBeha;
 class EveVirtualCameraBehaviourVector3MoveBetween extends _EveVirtualCameraBeha$1 {
   static {
@@ -20,15 +25,30 @@ class EveVirtualCameraBehaviourVector3MoveBetween extends _EveVirtualCameraBeha$
   world = (_init_extra_proportional(this), _init_world(this, true));
   interpolationCurve = (_init_extra_world(this), _init_interpolationCurve(this, null));
   start = (_init_extra_interpolationCurve(this), _init_start(this, vec3.create()));
+
+  /**
+   * Creates the default linear 0-to-1 interpolation curve and names the
+   * behaviour "Move Between".
+   */
   constructor() {
     super(), _init_extra_start(this);
     this.interpolationCurve = _EveVirtualCameraBeha$1.createEaseCurve();
     this.SetName("Move Between");
   }
+
+  /** Sets the behaviour name and renames the owned interpolation curve to match. */
   SetName(name) {
     super.SetName(name);
     this.interpolationCurve?.SetName?.(`${this.name} - Interpolation Curve`);
   }
+
+  /**
+   * Returns the point interpolated from start to end by the interpolation curve
+   * at normalized timeline time; both endpoints are multiplied by the anchor
+   * radius when proportional is set and yawed into the anchor's heading when
+   * world is false, and end is returned directly when the timeline has zero
+   * length.
+   */
   Update(camera, _current, _deltaTime, localElapsedTime, _anchorPosition, anchorRadius, anchorForwardDirection, out = vec3.create()) {
     const duration = Number(camera?.GetAnimationTimelineLength?.() ?? 0);
     if (duration === 0) {