MSCTrack
Extension
ExtensionDescription
MSCTrack represents one of MugicSpatCon's input tracks. MugicSpatCon is primarily intended to be interfaced with through its GUI (MugicSpatConGUI) and hardware controllers, but programmatic control is possible.
MugicSpatCon handles initialization of tracks and updating them with movement data from Mugic and control data from nanoKontrol. The track must be told how to handle the movement data via the below methods (usually called by the GUI).
Most of MSCTrack's internal methods are not described in this help file.
Instance Methods
App control
.reset
Resets the track state.
.stop
Resets the track state and frees its server resources.
.vst
The VSTPluginController wrapping the IEM StereoEncoder for this track.
Mixing
.amp
Number. The amplitude of the track.
.mute
Boolean. Whether the track is muted.
.solo
Boolean. Whether the track is soloed. Overrides mute.
.stereo_input
Boolean. Whether the track uses stereo input. Two input channels are always allocated to the track, but if this value is true, only the first (left) channel is used.
Manual positioning
.manual_pos_armed
Boolean. Whether manual positioning is armed. When active, incoming Mugic movement data immediately repositions the audio.
.invert
A list of three booleans that determines whether a given axis of Mugic's movement is inverted for this track.
Discussion:
This list is in the order X, Y, Z, where X refers to horizontal movement, Y refers to vertical, and Z to roll (not currently used). Therefore, to invert horizontal movement, set invert to [ true, false, false ].
.ignore
A list of three booleans that determines whether a given axis of Mugic's movement is ignored for this track.
Discussion:
This list is in the order X, Y, Z, where X refers to horizontal movement, Y refers to vertical, and Z to roll (not currently used). Therefore, to ignore horizontal movement, set ignore to [ true, false, false ].
Chaos-driven positioning
.chaos_algo
Number. The index of an algorithm in MugicSpatCon: *chaos_algos to use for algorithmic repositioning, see that documentation for more information. Setting this value starts or stops onset detection as needed.
.chaos_range
Number (0-1). The range over which -chaos_algo will move the audio. 0 is no movement, 1 is the entire range.
.chaos_rate
Number (0-1). The speed of the -chaos_algo movement. This is a relative number, 0 is pretty slow, 1 is very fast.
Gesture recording
.gesture_rec_armed
Boolean. Whether to arm gesture recording. When active, incoming Mugic movement data are recorded as a gesture which can be played back with gesture_playback_armed.
.gesture_playback_armed
Boolean. Whether playback of the recorded gesture is active. Gesture playback always loops; loop behaviour is determined by gesture_pingpong_mode.
.gesture_pingpong_mode
Boolean. Whether the playback should use pingpong mode (repeat in reverse direction when reaching the end). If false, gesture playback loops from the beginning.
.gesture_playback_rate
Number. The gesture playback rate. 1 is the original speed, 2 is twice as fast, 0.5 is half speed.