@needle-tools/engine 2.24.0-pre

package/lib/engine-components/AnimationCurve.js

@@ -0,0 +1,62 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Mathf } from "../engine/engine_math";
+import { serializeable } from "../engine/engine_serialization_decorator";
+class Keyframe {
+    time;
+    value;
+    inTangent;
+    inWeight;
+    outTangent;
+    outWeight;
+    weightedMode;
+}
+__decorate([
+    serializeable()
+], Keyframe.prototype, "time", void 0);
+__decorate([
+    serializeable()
+], Keyframe.prototype, "value", void 0);
+__decorate([
+    serializeable()
+], Keyframe.prototype, "inTangent", void 0);
+__decorate([
+    serializeable()
+], Keyframe.prototype, "inWeight", void 0);
+__decorate([
+    serializeable()
+], Keyframe.prototype, "outTangent", void 0);
+__decorate([
+    serializeable()
+], Keyframe.prototype, "outWeight", void 0);
+__decorate([
+    serializeable()
+], Keyframe.prototype, "weightedMode", void 0);
+export class AnimationCurve {
+    keys;
+    get duration() {
+        if (!this.keys || this.keys.length == 0)
+            return 0;
+        return this.keys[this.keys.length - 1].time;
+    }
+    evaluate(time) {
+        if (!this.keys || this.keys.length == 0)
+            return 0;
+        let lastKeyframe = null;
+        for (const kf of this.keys) {
+            if (lastKeyframe && kf.time > time && time > lastKeyframe.time) {
+                return Mathf.lerp(lastKeyframe.value, kf.value, (time - lastKeyframe.time) / (kf.time - lastKeyframe.time));
+            }
+            lastKeyframe = kf;
+        }
+        return this.keys[this.keys.length - 1].value;
+    }
+}
+__decorate([
+    serializeable(Keyframe)
+], AnimationCurve.prototype, "keys", void 0);
+//# sourceMappingURL=AnimationCurve.js.map

package/lib/engine-components/AnimationCurve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationCurve.js","sourceRoot":"","sources":["../../../engine-components/AnimationCurve.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAEzE,MAAM,QAAQ;IAEV,IAAI,CAAU;IAEd,KAAK,CAAU;IAEf,SAAS,CAAU;IAEnB,QAAQ,CAAU;IAElB,UAAU,CAAU;IAEpB,SAAS,CAAU;IAEnB,YAAY,CAAU;CACzB;AAbG;IADC,aAAa,EAAE;sCACF;AAEd;IADC,aAAa,EAAE;uCACD;AAEf;IADC,aAAa,EAAE;2CACG;AAEnB;IADC,aAAa,EAAE;0CACE;AAElB;IADC,aAAa,EAAE;4CACI;AAEpB;IADC,aAAa,EAAE;2CACG;AAEnB;IADC,aAAa,EAAE;8CACM;AAG1B,MAAM,OAAO,cAAc;IAGvB,IAAI,CAAmB;IAEvB,IAAI,QAAQ;QACR,IAAG,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAChD,CAAC;IAED,QAAQ,CAAC,IAAY;QACjB,IAAG,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;QACjD,IAAI,YAAY,GAAqB,IAAI,CAAC;QAC1C,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE;YACxB,IAAI,YAAY,IAAI,EAAE,CAAC,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,YAAa,CAAC,IAAI,EAAE;gBAC7D,OAAO,KAAK,CAAC,IAAI,CAAC,YAAa,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,IAAI,GAAG,YAAa,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,GAAG,YAAa,CAAC,IAAI,CAAC,CAAC,CAAC;aAClH;YACD,YAAY,GAAG,EAAE,CAAC;SACrB;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC/C,CAAC;CACJ;AAlBG;IADC,aAAa,CAAC,QAAQ,CAAC;4CACD"}

package/lib/engine-components/Animator.d.ts

@@ -0,0 +1,48 @@
+import { Behaviour } from "./Component";
+import * as THREE from 'three';
+import { AnimationActionLoopStyles } from "three";
+import { AnimatorControllerModel } from "../engine/extensions/NEEDLE_animator_controller_model";
+import { AnimatorController } from "./AnimatorController";
+export declare class MixerEvent {
+    type: string;
+    action: THREE.AnimationAction;
+    loopDelta: number;
+    target: THREE.AnimationMixer;
+}
+export declare class PlayOptions {
+    loop?: boolean | AnimationActionLoopStyles;
+    clampWhenFinished?: boolean;
+}
+export declare class Animator extends Behaviour {
+    applyRootMotion: boolean;
+    hasRootMotion: boolean;
+    keepAnimatorControllerStateOnDisable: boolean;
+    set runtimeAnimatorController(val: AnimatorControllerModel | AnimatorController | undefined | null);
+    get runtimeAnimatorController(): AnimatorController | undefined | null;
+    Play(name: string | number, layer?: number, normalizedTime?: number, transitionDurationInSec?: number): void;
+    Reset(): void;
+    SetBool(name: string | number, value: boolean): void;
+    GetBool(name: string | number): boolean;
+    SetFloat(name: string | number, val: number): void;
+    GetFloat(name: string | number): number;
+    SetInteger(name: string | number, val: number): void;
+    GetInteger(name: string | number): number;
+    SetTrigger(name: string | number): void;
+    ResetTrigger(name: string | number): void;
+    IsInTransition(): boolean;
+    SetSpeed(speed: number): void;
+    set minMaxSpeed(minMax: {
+        x: number;
+        y: number;
+    });
+    set minMaxOffsetNormalized(minMax: {
+        x: number;
+        y: number;
+    });
+    private speed;
+    private normalizedStartOffset;
+    private _animatorController?;
+    awake(): void;
+    onDisable(): void;
+    onBeforeRender(): void;
+}

package/lib/engine-components/Animator.js

@@ -0,0 +1,126 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Behaviour } from "./Component";
+import { getParam } from "../engine/engine_utils";
+import { AnimatorController } from "./AnimatorController";
+import { serializeable } from "../engine/engine_serialization_decorator";
+import { Mathf } from "../engine/engine_math";
+const debug = getParam("debuganimator");
+export class Animator extends Behaviour {
+    applyRootMotion = false;
+    hasRootMotion = false;
+    keepAnimatorControllerStateOnDisable = false;
+    // set from needle animator extension
+    set runtimeAnimatorController(val) {
+        if (this._animatorController && this._animatorController.model === val) {
+            return;
+        }
+        if (val) {
+            if (!(val instanceof AnimatorController)) {
+                this._animatorController = new AnimatorController(val);
+            }
+            else
+                this._animatorController = val;
+        }
+        else
+            this._animatorController = null;
+    }
+    get runtimeAnimatorController() {
+        return this._animatorController;
+    }
+    Play(name, layer = -1, normalizedTime = Number.NEGATIVE_INFINITY, transitionDurationInSec = 0) {
+        this.runtimeAnimatorController?.Play(name, layer, normalizedTime, transitionDurationInSec);
+    }
+    Reset() {
+        this._animatorController?.Reset();
+    }
+    SetBool(name, value) {
+        this.runtimeAnimatorController?.SetBool(name, value);
+    }
+    GetBool(name) {
+        return this.runtimeAnimatorController?.GetBool(name) ?? false;
+    }
+    SetFloat(name, val) {
+        this.runtimeAnimatorController?.SetFloat(name, val);
+    }
+    GetFloat(name) {
+        return this.runtimeAnimatorController?.GetFloat(name) ?? -1;
+    }
+    SetInteger(name, val) {
+        this.runtimeAnimatorController?.SetInteger(name, val);
+    }
+    GetInteger(name) {
+        return this.runtimeAnimatorController?.GetInteger(name) ?? -1;
+    }
+    SetTrigger(name) {
+        this.runtimeAnimatorController?.SetTrigger(name);
+    }
+    ResetTrigger(name) {
+        this.runtimeAnimatorController?.ResetTrigger(name);
+    }
+    IsInTransition() {
+        return this.runtimeAnimatorController?.IsInTransition() ?? false;
+    }
+    SetSpeed(speed) {
+        if (speed === this.speed)
+            return;
+        this.speed = speed;
+        this._animatorController?.SetSpeed(speed);
+    }
+    set minMaxSpeed(minMax) {
+        this.speed = Mathf.lerp(minMax.x, minMax.y, Math.random());
+    }
+    set minMaxOffsetNormalized(minMax) {
+        this.normalizedStartOffset = Mathf.lerp(minMax.x, minMax.y, Math.random());
+        if (this.runtimeAnimatorController)
+            this.runtimeAnimatorController.normalizedStartOffset = this.normalizedStartOffset;
+    }
+    // set speed(val: number) {
+    //     // console.trace(val);
+    //     this.SetSpeed(val)
+    // }
+    speed = 1;
+    normalizedStartOffset = 0;
+    _animatorController = null;
+    awake() {
+        if (!this.gameObject)
+            return;
+        if (this.runtimeAnimatorController) {
+            const clone = this.runtimeAnimatorController.clone();
+            console.assert(this.runtimeAnimatorController !== clone);
+            this.runtimeAnimatorController = clone;
+            console.assert(this.runtimeAnimatorController === clone);
+            this.runtimeAnimatorController.bind(this);
+            this.runtimeAnimatorController.SetSpeed(this.speed);
+            this.runtimeAnimatorController.normalizedStartOffset = this.normalizedStartOffset;
+        }
+        if (debug)
+            console.log("ANIMATOR", this.name, this);
+    }
+    onDisable() {
+        if (!this.keepAnimatorControllerStateOnDisable)
+            this._animatorController?.Reset();
+    }
+    onBeforeRender() {
+        if (this._animatorController) {
+            this._animatorController.update();
+        }
+    }
+}
+__decorate([
+    serializeable()
+], Animator.prototype, "applyRootMotion", void 0);
+__decorate([
+    serializeable()
+], Animator.prototype, "hasRootMotion", void 0);
+__decorate([
+    serializeable()
+], Animator.prototype, "keepAnimatorControllerStateOnDisable", void 0);
+__decorate([
+    serializeable()
+], Animator.prototype, "runtimeAnimatorController", null);
+//# sourceMappingURL=Animator.js.map

package/lib/engine-components/Animator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Animator.js","sourceRoot":"","sources":["../../../engine-components/Animator.ts"],"names":[],"mappings":"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"}

package/lib/engine-components/AnimatorController.d.ts

@@ -0,0 +1,39 @@
+import { Animator } from "./Animator";
+import { AnimatorControllerModel, State } from "../engine/extensions/NEEDLE_animator_controller_model";
+import { Context } from "../engine/engine_setup";
+export declare class AnimatorController {
+    Play(name: string | number, layerIndex?: number, normalizedTime?: number, durationInSec?: number): void;
+    Reset(): void;
+    SetBool(name: string | number, value: boolean): void;
+    GetBool(name: string | number): boolean;
+    SetFloat(name: string | number, val: number): void;
+    GetFloat(name: string | number): number;
+    SetInteger(name: string | number, val: number): void;
+    GetInteger(name: string | number): number;
+    SetTrigger(name: string | number): void;
+    ResetTrigger(name: string | number): void;
+    IsInTransition(): boolean;
+    SetSpeed(speed: number): void;
+    FindState(name: string | undefined | null): State | null;
+    normalizedStartOffset: number;
+    private _speed;
+    animator?: Animator;
+    model: AnimatorControllerModel;
+    get context(): Context | undefined | null;
+    bind(animator: Animator): void;
+    clone(): AnimatorController;
+    update(): void;
+    private _mixer;
+    private _activeState?;
+    constructor(model: AnimatorControllerModel);
+    private _activeStates;
+    private updateActiveStates;
+    private setStartTransition;
+    private evaluateTransitions;
+    private transitionTo;
+    private createAction;
+    private evaluateCondition;
+    private createActions;
+    private enumerateActions;
+    private rootMotionHandler?;
+}