Repository navigation
From and To
Most steps travel to a value. They can optionally start from one too.
The button at the start of a step's first value row switches between two setups:
-
TO(the default): one row. The step travels from wherever the value already is to the value you type. -
FROM: that row becomes the starting value, and a To row appears underneath. The step jumps to From, then travels to To.
Use TO for things like hover effects that should carry on smoothly from wherever they are. Use FROM when the animation should always look the same, like a panel always fading in from invisible.
- [PUT GIF OF
01 TO vs FROM(scene03 From and To) HERE]
Each value has a mode dropdown beside it, which says what the number you typed means:
| Mode | Means | Example |
|---|---|---|
Absolute |
Exactly this value | Alpha Absolute 0 = fully transparent |
Baseline |
The resting value, plus this | Scale Baseline 0 = its normal size. Position Baseline (0, -50) = 50 below where it normally sits |
Current |
Wherever it is when the step starts, plus this | Position Current (100, 0) = 100 to the right of wherever it is now. Only on To, and only when From is off |
The resting value is how the object was set up in the scene, captured when the game starts (before anything animates).
Tip
Use To: Baseline 0 for anything that should land back on its normal state. It lands in exactly the same place every time, however many times you Show and Hide, and if you later rearrange the scene, the animation follows automatically. Hard-coded Absolute positions don't.
Hover a mode dropdown for a reminder of what its options mean.
- [PUT GIF OF
02 Absolute, Baseline, Current(scene03 From and To) HERE]
Under the hood
- The resting value is captured at
Awake. If you deliberately move an element while the game runs and wantBaselineto follow it, callCaptureBaseline()(not while one of its animations is running). -
Currenton To is DOTween's relative mode (SetRelative). - The From dropdown doesn't offer
Current. Older data could still have it there, where it never meant "an offset from the start": it makes the step ignore its From value entirely, exactly like the button readingTO. A step that already has it keeps showing it, with a tooltip saying so, and nothing is rewritten. - In code the FROM / TO button is the
UseFrombool.
This setting is on each animation, on by default. Leave it on unless you know why you want it off.
When it's on, every step with a From jumps to its From value the moment the animation starts, even steps that have a delay. When it's off, a delayed step keeps its current value until its turn comes.
Why it matters: picture a title that fades in from invisible after a 0.5 second delay. With this off, the title sits fully visible for half a second, then snaps to invisible and fades in. That flash is almost never what you want.
- [PUT GIF OF
03 Apply From Values Immediately(scene03 From and To) HERE]
Rather than typing a value, you can pose the object in the Scene view and record it: pop the animation out into its own window, click the red dot at the end of a From or To row, drag the object where it should be, and press Finish. The row keeps its mode, and stores whatever that mode needs for the step to land exactly there. See Recording Values.
Punch and shake steps have no From or To. They show a strength instead, and always settle back where they started. Set Active and Play Sound have their own fields.
Installation
Code API
Basic usage
Advanced usage
- Punch and Shake
- Sizing a RectTransform
- Movement Paths
- Sound
- Custom Property
- Material and Shader Properties
- Stylised Motion
- Interrupting and Chaining
- Mirroring
- Copy and Paste
- Animation Sets
- Scene Gizmos
Nitty-gritties
Warnings and Troubleshooting