Chain stage nodes together to execute multiple Python scripts in sequence according to a set of rules. These are useful for creating interactive experiences such as tutorials or tours. For more information on using stage nodes, see Building Python state machines.
Attribute reference
- AutoPlay
- Turn this on to force playback of the current playback range when the stage is activated.
- Condition
- Turn this on to deactivate the current stage and activate the next stage (determined by Next State).
- End Of Animation
- Turn this on to deactivate the current stage and activate the next stage (determined by Next State) when the Time Slider reaches the end of the current playback range.
- On Activate Script
- The Python script to execute when this stage is activated.
- On Deactivate Script
- The Python script to execute when this stage is deactivated.
- Previous State
- The stage node preceding the current stage.
- Next State
- The stage node succeeding the current stage.
- Time Delay
- A delay (in seconds) before the current stage automatically deactivates and moves on to the next stage.
- Time Slider Bookmark
- The Time Slider Bookmark to frame when this stage is activated.
Command reference
The following is a list of the most useful commands when using stage nodes. You can call these in the Python scripts that are part of your state machine, or externally via the Command Line or Script Editor.
| Effect | Python | MEL |
|---|---|---|
| Activate a stage | stage ("<stage node name>", e=True, a=True) | stage -e -a "<stage node name>" |
| Deactivate a stage (without moving on to the next stage) | stage ("<stage node name>", e=True, d=True) | stage -e -d "<stage node name>" |
| Deactivate all stages (in case you're unsure which ones are currently active) | stage (da=True) | stage -da |
| Deactivate the current stage and activate the next stage | stage("<stage node name>", e=True, n=True) | stage -e -n "<stage node name>" |
| Deactivate the current stage and activate the previous stage | stage("<stage node name>", e=True, p=True) | stage -e -p "<stage node name>" |