Method setCurrentAnimation

packages/melonjs/src/level/gltf/GLTFModel.js:256–302

* play the given animation clip. The second argument mirrors Sprite * and accepts the same forms: omit to loop forever, a `string` to chain to * another clip when this one ends, a `function` legacy completion callback * (return `false` to hold the final pose), or an options object. *

(name, options, preserveTime = false)

	 * model.setCurrentAnimation("emote-yes", () => spawnFx()); // legacy callback
	 */
	setCurrentAnimation(name, options, preserveTime = false) {
		if (this.anim[name] === undefined) {
			throw new Error("animation id '" + name + "' not defined");
		}
		if (this.isCurrentAnimation(name)) {
			return this;
		}
		this.current.name = name;
		this.current.length = this.anim[name].duration;
		const opts = parseAnimationOptions(options);
		this.animationspeed = opts.speed;
		this._animDone = false;
		const onComplete = opts.onComplete;
		if (opts.legacyFn) {
			// legacy bare-function callback (return false → hold the last pose)
			this.resetAnim = onComplete;
		} else if (typeof opts.next === "string") {
			const next = opts.next;
			this.resetAnim = () => {
				if (typeof onComplete === "function") {
					onComplete();
				}
				this.setCurrentAnimation(next);
			};
		} else if (opts.loop === false) {
			// play once: fire onComplete, hold the final pose
			this.resetAnim = () => {
				if (typeof onComplete === "function") {
					onComplete();
				}
				this._animDone = true;
				return false;
			};
		} else if (typeof onComplete === "function") {
			this.resetAnim = () => {
				onComplete();
			};
		} else {
			this.resetAnim = undefined;
		}
		if (!preserveTime) {
			this.current.time = 0;
		}
		this._pose();
		this.isDirty = true;
		return this;
	}

	/**
	 * Play an animation clip, or resume the current one. A shorthand for