Switch Modules
Function:
These modules provide a way to switch the connection of a GUI pin of any type to one of several destinations (many to 1), or to to one of several sources (1 to many).
Although we are used to thinking of these relationships in terms of left to right, the bi-directional nature of SynthEdit GUI connections provides additional possibilities:
-
Every 1 to Many switch can also be used as a Many to 1 switch in the opposite (right to left) direction
-
Every Many to 1 switch can also be used as a 1 to Many switch in the right to left direction.
Left-hand side pins:
Choice - Connects to a Dropdown List, DH_PopupMenu, DH_ListBox, or
other GUI selection control, which is used to select one of the
inputs (if many to1) or outputs (if 1 to many).Right to Left - When set to TRUE, makes a switch behave as its opposite, in
the right-to left direction. Please note that this only affects what
happens when the Choice is changed. The flow through the
switches is always bi-directional. See the Notes section below
for further explanation.Value or Text In - The input value or text. In the case of many to 1 switches, this
pin self-replicates each time a connection is made.
Right-hand side pins:
Value or Text Out - The output value or text. In the case of 1 to many switches,
this pin self-replicates each time a connection is made.
Notes:
The bi-directional nature of SynthEdit GUI connections requires that when a switch connects 2 points, it allows 2-way flow between them. Otherwise, they wouldn't be properly connected. These switches meet that requirement. So, if data always flows both ways, what does this Right to Left option do? It controls which side is brought into sync with the other when 2 points that have different values become connected. Normally, the left side keeps the same value, and the right side is changed to match that value. When Right to Left is set to TRUE, the right side keeps its value, and the left side is changed to match the right side. This makes a many to 1 switch behave as a right-to-left 1 to many switch, and a 1 to many switch behave as a right-to-left many to 1 switch. If this is still unclear, experiment with the 1toMany and ManyTo1 demo .se1 files. Set the knobs on both sides to various positions, and watch what changes when you switch connections with Right to Left on and off.