@needle-tools/engine 2.65.1-pre → 2.65.2-pre

package/src/engine-components/Animator.ts

@@ -50,55 +50,82 @@ export class Animator extends Behaviour {
         return this._animatorController;
     }
 
-    Play(name: string | number, layer: number = -1, normalizedTime: number = Number.NEGATIVE_INFINITY, transitionDurationInSec: number = 0) {
-        this.runtimeAnimatorController?.Play(name, layer, normalizedTime, transitionDurationInSec);
-    }
+    // NOTE: the uppercase events have been deprecated because UnityEvent methods are all exported with lowercase first letter
 
-    Reset() {
-        this._animatorController?.Reset();
+    /**@deprecated use play */
+    Play(name: string | number, layer: number = -1, normalizedTime: number = Number.NEGATIVE_INFINITY, transitionDurationInSec: number = 0) { this.play(name, layer, normalizedTime, transitionDurationInSec); }
+    play(name: string | number, layer: number = -1, normalizedTime: number = Number.NEGATIVE_INFINITY, transitionDurationInSec: number = 0) {
+        this.runtimeAnimatorController?.play(name, layer, normalizedTime, transitionDurationInSec);
     }
 
-    SetBool(name: string | number, value: boolean) {
-        this.runtimeAnimatorController?.SetBool(name, value);
+    /**@deprecated use reset */
+    Reset() { this.reset(); }
+    reset() {
+        this._animatorController?.reset();
     }
 
-    GetBool(name: string | number): boolean {
-        return this.runtimeAnimatorController?.GetBool(name) ?? false;
+    /**@deprecated use setBool */
+    SetBool(name: string | number, val: boolean) { this.setBool(name, val); }
+    setBool(name: string | number, value: boolean) {
+        this.runtimeAnimatorController?.setBool(name, value);
     }
 
-    SetFloat(name: string | number, val: number) {
-        this.runtimeAnimatorController?.SetFloat(name, val);
+    /**@deprecated use getBool */
+    GetBool(name: string | number) { return this.getBool(name); }
+    getBool(name: string | number): boolean {
+        console.log("name", name);
+        return this.runtimeAnimatorController?.getBool(name) ?? false;
     }
 
-    GetFloat(name: string | number): number {
-        return this.runtimeAnimatorController?.GetFloat(name) ?? -1;
+    /**@deprecated use setFloat */
+    SetFloat(name: string | number, val: number) { this.setFloat(name, val); }
+    setFloat(name: string | number, val: number) {
+        this.runtimeAnimatorController?.setFloat(name, val);
     }
 
-    SetInteger(name: string | number, val: number) {
-        this.runtimeAnimatorController?.SetInteger(name, val);
+    /**@deprecated use getFloat */
+    GetFloat(name: string | number) { return this.getFloat(name); }
+    getFloat(name: string | number): number {
+        return this.runtimeAnimatorController?.getFloat(name) ?? -1;
     }
 
-    GetInteger(name: string | number): number {
-        return this.runtimeAnimatorController?.GetInteger(name) ?? -1;
+    /**@deprecated use setInteger */
+    SetInteger(name: string | number, val: number) { this.setInteger(name, val); }
+    setInteger(name: string | number, val: number) {
+        this.runtimeAnimatorController?.setInteger(name, val);
     }
 
-    SetTrigger(name: string | number) {
-        this.runtimeAnimatorController?.SetTrigger(name);
+    /**@deprecated use getInteger */
+    GetInteger(name: string | number) { return this.getInteger(name); }
+    getInteger(name: string | number): number {
+        return this.runtimeAnimatorController?.getInteger(name) ?? -1;
     }
 
-    ResetTrigger(name: string | number) {
-        this.runtimeAnimatorController?.ResetTrigger(name);
+    /**@deprecated use setTrigger */
+    SetTrigger(name: string | number) { this.setTrigger(name); }
+    setTrigger(name: string | number) {
+        console.log("name", name);
+        this.runtimeAnimatorController?.setTrigger(name);
     }
 
-    IsInTransition(): boolean {
-        return this.runtimeAnimatorController?.IsInTransition() ?? false;
+    /**@deprecated use resetTrigger */
+    ResetTrigger(name: string | number) { this.resetTrigger(name); }
+    resetTrigger(name: string | number) {
+        this.runtimeAnimatorController?.resetTrigger(name);
     }
 
+    /**@deprecated use isInTransition */
+    IsInTransition() { return this.isInTransition(); }
+    isInTransition(): boolean {
+        return this.runtimeAnimatorController?.isInTransition() ?? false;
+    }
 
-    SetSpeed(speed: number) {
+    /**@deprecated use setSpeed */
+    SetSpeed(speed: number) { return this.setSpeed(speed); }
+    setSpeed(speed: number) {
         if (speed === this.speed) return;
         this.speed = speed;
-        this._animatorController?.SetSpeed(speed);
+        this._animatorController?.setSpeed(speed);
     }
 
     set minMaxSpeed(minMax: { x: number, y: number }) {
@@ -130,7 +157,7 @@ export class Animator extends Behaviour {
                 this.runtimeAnimatorController = clone;
                 console.assert(this.runtimeAnimatorController === clone);
                 this.runtimeAnimatorController.bind(this);
-                this.runtimeAnimatorController.SetSpeed(this.speed);
+                this.runtimeAnimatorController.setSpeed(this.speed);
                 this.runtimeAnimatorController.normalizedStartOffset = this.normalizedStartOffset;
             }
             else console.warn("Could not clone animator controller", this.runtimeAnimatorController);
@@ -139,7 +166,7 @@ export class Animator extends Behaviour {
 
     onDisable() {
         if (!this.keepAnimatorControllerStateOnDisable)
-            this._animatorController?.Reset();
+            this._animatorController?.reset();
     }
 
     onBeforeRender() {

package/src/engine-components/AnimatorController.ts

@@ -14,7 +14,7 @@ const debugRootMotion = getParam("debugrootmotion");
 
 export class AnimatorController {
 
-    Play(name: string | number, layerIndex: number = -1, normalizedTime: number = Number.NEGATIVE_INFINITY, durationInSec: number = 0) {
+    play(name: string | number, layerIndex: number = -1, normalizedTime: number = Number.NEGATIVE_INFINITY, durationInSec: number = 0) {
         if (layerIndex < 0) layerIndex = 0;
         else if (layerIndex >= this.model.layers.length) {
             console.warn("invalid layer");
@@ -33,61 +33,63 @@ export class AnimatorController {
         console.warn("Could not find " + name + " to play");
     }
 
-    Reset() {
+    reset() {
         this.setStartTransition();
     }
 
-    SetBool(name: string | number, value: boolean) {
+    setBool(name: string | number, value: boolean) {
         const key = typeof name === "string" ? "name" : "hash";
         return this.model?.parameters?.filter(p => p[key] === name).forEach(p => p.value = value);
     }
 
-    GetBool(name: string | number): boolean {
+    getBool(name: string | number): boolean {
         const key = typeof name === "string" ? "name" : "hash";
         return this.model?.parameters?.find(p => p[key] === name)?.value as boolean ?? false;
     }
 
-    SetFloat(name: string | number, val: number) {
+    setFloat(name: string | number, val: number) {
         const key = typeof name === "string" ? "name" : "hash";
         return this.model?.parameters?.filter(p => p[key] === name).forEach(p => p.value = val);
     }
 
-    GetFloat(name: string | number): number {
+    getFloat(name: string | number): number {
         const key = typeof name === "string" ? "name" : "hash";
         return this.model?.parameters?.find(p => p[key] === name)?.value as number ?? 0;
     }
 
-    SetInteger(name: string | number, val: number) {
+    setInteger(name: string | number, val: number) {
         const key = typeof name === "string" ? "name" : "hash";
         return this.model?.parameters?.filter(p => p[key] === name).forEach(p => p.value = val);
     }
 
-    GetInteger(name: string | number): number {
+    getInteger(name: string | number): number {
         const key = typeof name === "string" ? "name" : "hash";
         return this.model?.parameters?.find(p => p[key] === name)?.value as number ?? 0;
     }
 
-    SetTrigger(name: string | number) {
+    setTrigger(name: string | number) {
         if (debug)
             console.log("SET TRIGGER", name);
         const key = typeof name === "string" ? "name" : "hash";
         return this.model?.parameters?.filter(p => p[key] === name).forEach(p => p.value = true);
     }
 
-    ResetTrigger(name: string | number) {
+    resetTrigger(name: string | number) {
         const key = typeof name === "string" ? "name" : "hash";
         return this.model?.parameters?.filter(p => p[key] === name).forEach(p => p.value = false);
     }
 
-    IsInTransition(): boolean {
+    isInTransition(): boolean {
         return this._activeStates.length > 1;
     }
 
-    SetSpeed(speed: number) {
+    setSpeed(speed: number) {
         this._speed = speed;
     }
 
-    FindState(name: string | undefined | null): State | null {
+    /**@deprecated use findState */
+    FindState(name: string | undefined | null): State | null { return this.findState(name); }
+    findState(name: string | undefined | null): State | null {
         if (!name) return null;
         if (Array.isArray(this.model.layers)) {
             for (const layer of this.model.layers) {