Receive Zones - FunkybotsEvilTwin/CSIWiki GitHub Wiki
What are Receives?
Track Receives are like inverse sends. Lets say you're sending multiple mix elements to a "Room Reverb" bus. If you wanted to adjust the amount of reverb on multiple channels using Sends, you'd have to go track by track and adjust the send levels one at a time. A more efficient way would be to map the receives going into the Room Reverb bus, and adjusting the various levels from that one track.
It's ultimately a much more efficient way of controlling multiple send levels feeding the same [receive] bus. Track Receives are useful for reverb adjustments across multiple tracks, cue/headphone mixes, and even adjusting monitor mixes in a live setup.
Two types of Receive zones
There are two types of Receive Zones in CSI:
- SelectedTrackReceive
- TrackReceive
SelectedTrackReceive is best used when you have a surface with multiple channels and you want to map out the Receives on the selected track, across those various channels. Example: you have an 8 channel MCU type device. If you have more than 8 Receives on the selected track, you would use the SelectedTrackReceiveBank action to bank to the additional Receives.
TrackReceive is best used when you have a multiple channel surface, but you only want to see Receives for the channel that corresponds that specific track. Example: you have an 8-channel MCU type device. Using the TrackReceive will show you Receive Slot #1 for channels 1-8. If you want to see the Receive loaded in Receive Slot #2, you will use TrackReceiveBank action to navigate to the next slot, at which point, you'll be looking at Receive Slot #2 for channels 1-8. You setup the number of tracks in the CSI device preferences.
Receive Mapping and Unmapping Actions
Depending on the type of Receive zone you are creating, you will need to create a CSI action to map the Receives.
SelectedTrackReceive uses the CSI action GoAssociatedZone SelectedTrackReceive for mapping.
TrackReceive uses the CSI action GoAssociatedZone TrackReceive for mapping.
Unmapping is a simple as triggering the action a second time or using the GoHome action (which is more of a brute force approach).
Activating a Receive Map
You can activate the Receive map one of three ways. First, you can assign the mapping action above to a button like this...
Zone "Buttons"
Instrument GoAssociatedZone SelectedTrackReceive
Global+Instrument GoAssociatedZone TrackReceive
ZoneEnd
Or, if you can dedicate a portion of your surface to Receives and always want them to appear as part of your Home zone, you can simply add the Receive zone to the IncludedZones like this...
Zone Home
IncludedZones
"Buttons"
"Channel"
"SelectedTrackReceive"
IncludedZoneReceive
ZoneEnd
SelectedTrackReceive Zone Example
Note: SelectedTrackReceive zones are a special type of zone so your Receive zone must be named "SelectedTrackReceive" (exactly).
Here's an example of a typical MCU Receive zone.
Zone "SelectedTrackReceive"
DisplayUpper| TrackReceiveNameDisplay
DisplayLower| TrackReceivePanDisplay
Control+DisplayLower| TrackReceivePrePostDisplay
Control+RotaryPush| TrackReceivePrePost
Touch+DisplayLower| TrackReceiveVolumeDisplay
Mute| TrackReceiveMute
Rotary| TrackReceivePan
Fader| TrackReceiveVolume
Left SelectedTrackReceiveBank -8
Right SelectedTrackReceiveBank 8
ZoneEnd
TrackReceive Zone Example
Note: TrackReceive zones are a special type of zone so your Receive zone must be named "TrackReceive" (exactly).
Here's an example of a typical TrackReceive zone.
Zone "TrackReceive"
DisplayUpper| TrackNameDisplay
DisplayLower| TrackReceiveNameDisplay
FaderTouch+DisplayLower| TrackReceiveVolumeDisplay
Shift+DisplayLower| TrackReceivePrePostDisplay
Shift+RotaryPush| TrackReceivePrePost
Mute| TrackReceiveMute
Rotary| TrackReceivePan
Fader| TrackReceiveVolume
Up TrackReceiveBank -1
Down TrackReceiveBank 1
ZoneEnd
Receive Actions
The available Receive zone actions are shown below.
- TrackReceiveNameDisplay
- TrackReceiveVolume
- TrackReceiveVolumeDisplay
- TrackReceivePan
- TrackReceivePanDisplay
- TrackReceivePrePost
- TrackReceivePrePostDisplay
- TrackReceiveMute
- TrackReceiveStereoMonoToggle
- TrackReceiveInvertPolarity
- TrackReceiveVolumeDB
- TrackReceivePanPercent
TrackReceiveNameDisplay
Use the TrackReceiveNameDisplay action in a "TrackReceive" or "SelectedTrackReceive" zone to display the name of the Receive channel.
Zone "TrackReceive"
DisplayLower| TrackReceiveNameDisplay
ZoneEnd
TrackReceiveVolume, TrackReceiveVolumeDisplay
Use the TrackReceiveVolume action in a "TrackReceive" or "SelectedTrackReceive" zone to control the Receive level. TrackReceiveVolumeDisplay can be used in a display widget to show the volume level.
Zone "TrackReceive"
Touch+DisplayLower| TrackReceiveVolumeDisplay
Fader| TrackReceiveVolume
ZoneEnd
TrackReceivePan, TrackReceivePanDisplay
Use the TrackReceivePan action in a "TrackReceive" or "SelectedTrackReceive" zone to control the Receive panning. TrackReceivePanDisplay can be used in a display widget to show the pan position.
Zone "TrackReceive"
DisplayLower| TrackReceivePanDisplay
Rotary| TrackReceivePan
ZoneEnd
TrackReceivePrePost, TrackReceivePrePostDisplay
Use the TrackReceivePrePost action in a "TrackReceive" or "SelectedTrackReceive" zone to cycle through whether the Receive is 1) Post-Fader (Post-Pan), 2) Pre-Fader (Post-FX), or 3) Pre-FX. TrackReceivePrePostDisplay can be used in a display widget to show the current value.
Zone "TrackReceive"
Shift+DisplayLower| TrackReceivePrePostDisplay
Shift+RotaryPush| TrackReceivePrePost
ZoneEnd
TrackReceiveMute
Use the TrackReceiveMute action in a "TrackReceive" or "SelectedTrackReceive" zone to toggle muting the Receive.
Zone "TrackReceive"
Mute| TrackReceiveMute
ZoneEnd
TrackReceiveStereoMonoToggle
Use the TrackReceiveStereoMonoToggle action in a "TrackReceive" or "SelectedTrackReceive" zone to toggle between a stereo (default) and mono Receive.
Zone "TrackReceive"
Shift+Mute| TrackReceiveStereoMonoToggle
ZoneEnd
TrackReceiveInvertPolarity
Use the TrackReceiveInvertPolarity action in a "TrackReceive" or "SelectedTrackReceive" zone to invert the polarity of the Receive.
Zone "TrackReceive"
Alt+Mute| TrackReceiveInvertPolarity
ZoneEnd
TrackReceiveVolumeDB, TrackReceivePanPercent
TrackReceiveVolumeDB exists in case someone wanted to develop an OSC surface that used literal DB values for the fader postion. TrackReceivePanPercent works similarly, only expecting literal percentage values.
Zone "SelectedTrackReceive"
Fader| TrackReceiveVolumeDB
PanEncoder| TrackReceivePanPercent
ZoneEnd