all_docs
Snapshot
Snapshots are an important part of a live show. It can be used to capture an audio scene into SPAT Revolution. Sources, rooms and masters properties will be stored in a snapshot. It allows a complete transformation of the soundscape, with interpolation.
!> To use snapshots, timecode needs to run in SPAT Revolution.
Two ways to run the Timecode:
- if working with Hardware IO, an audio device must be selected into SPAT preferences.
- if working with Local Audio Path, the DAW needs to play back and the SPAT session needs at least one send and one return connected together.
The timecode activity is apparent in the bottom left of the screen. If timecode isn’t running, the recall will fail.
Snapshots could be controlled of the dedicated menu, and with OSC messages.
Create a snapshot
We can create a snapshot:
-
by using the “Create” action into the “Snapshots” menu. In this case, the snapshot will be added at the end of the list. The shortcut
Alt + Spacecould also be used to capture a snapshot. -
by using the “Insert Before” action. This option is available only if another snapshot exists. The snapshot will be insert before the selected snapshot, and all the snapshots will be re-number.
-
by using the “Insert After” action. This option is available only if another snapshot exists. The snapshot will be insert after the selected snapshot, and all the snapshots will be re-number.
Recall a snapshot
Recalling a snapshot will interpolate all the current properties with the stored values of the snapshot. Different options could alter the snapshot running:
- Recall time
This option is available in the menu “Snapshots/Options recall”. The values are range between 0 and 3600 seconds.
- Recall Sources / Room / Master
As all the properties are stored into snapshots, this options give us the possibility to enable or disable the recall of some properties. The recall of each section could be separately activated.
!> Be careful with the Room properties recall: changing some properties like Reverberation Density or Size causes reverb reconstruction (and audio drops).
Snapshots handling
Different actions could be executed with snapshots:
-
updating a snapshot
-
renaming a snapshot
-
removing a snapshot
-
remove all snapshots
Handle snapshots with OSC
Different actions are available for handling snapshot with OSC messages:
- Create a snapshot:
/snapshot/create
The snapshot name could be added in argument.
- Recall a snapshot:
/snapshot/recall [index, *time, *Recall Effective Selection, *Recall Actual Selection]
Index: the snapshot index to recall. It can be replaced by the snapshot name.
Time: optional, it will define the recall time. If not given, the default value is 0s.
Recall Effective Selection: optional, if the value is True, the sources’ selection on the snapshot creation will be recalled. It’s the default value. If False, selection will not be recalled.
Recall Actual Selection: optional, if the value is True, only the parameters of selected sources’ will be recalled. Else, all the sources will recalled (default behavior).
- Update a snapshot:
/snapshot/update [index]
Index: the snapshot index to update. It can be replaced by the snapshot name.
- List all the snapshots:
/snapshot/list
This will return the list of the snapshot, index and name.
- Len the number of snapshots:
/snapshot/len
This will return the total number of snapshots.
- Rename the snapshot:
/snapshot/rename [index, name]
Index: the snapshot index to rename. Name: the new name of the snapshot.
- Remove a snapshot:
/snapshot/remove [index]
Index: the snapshot index to remove. It can be replaced by the snapshot name.
!> Be careful using it: there isn’t any confirmation.
- Change the recall options:
/snapshot/options/recall/sources [State],/snapshot/options/recall/rooms [State],/snapshot/options/recall/masters [State].
State: 0 will disable the recall of related objects, 1 will enable it.
/snapshot/options/recall [State] [State] [State] takes the three options (sources, rooms and masters)