How to reset the state of affected object upon tween ending?

[octia]

Hi, I've had this issue like 6 separate times already in my project.
I want to play the animation, and in OnComplete set the current state of the object to be the same as startValue. As an instant change, not using rewind or yoyo.
Is this possible using something built-in, or do I have to continue using workarounds?

[KyryloKuzyk]

Hi, OnComplete() seems like a perfect match for your use case. Doesn't it work for you? Something like this:

const float startValue = 5;
Tween.PositionX(transform, startValue, 10, 1f).OnComplete(() => transform.position = new Vector3(startValue, 0));

[octia]

Yeah, but sometimes it's rather annoying, especially when you have a lot to reset. Would it be a lot of work to make SetRemainingCycles(false) work with CycleMode.Reset? Even when there's a single cycle

[KyryloKuzyk]

Ah, I see. Let me think what can be done about it.
However, reusing the SetRemainingCycles() method doesn't seem like a correct place to add this feature because it was designed with multiple cycles in mind:

/// <summary>Stops the sequence when it reaches the 'end' or returns to the 'start' for the next time.<br/>
/// For example, if you have an infinite sequence (cycles == -1) with CycleMode.Yoyo/Rewind, and you wish to stop it when it reaches the 'end', then set <see cref="stopAtEndValue"/> to true.
/// To stop the animation at the 'beginning', set <see cref="stopAtEndValue"/> to false.</summary>
public void SetRemainingCycles(bool stopAtEndValue) { }

[KyryloKuzyk]

@octia I added an experimental Tween/Sequence.ResetBeforeComplete() method in version 1.3.1. Please update and tell me this works for you.

To enable experimental features, please add the PRIME_TWEEN_EXPERIMENTAL define to the 'Project Settings / Player / Other Settings / Scripting Define Symbols'.

[octia]

That's perfect, exactly what I wanted! Thanks!

[jollypunch]

It seems this very useful addition is now called ResetBeforeComplete.

It'd be worth it to add a list of experimental features in the docs, now they're quite hidden.