Documentation Wiki rss-feed

Making and changing connections

Connecting agents

Connections between agents are made using the wiring tool.

image:toolbar_wiring.jpg

Connections are made from the red pins to green pins on the agent boxes. With the wiring tool selected, move the mouse over a red pin (the agent box for that pin will be highlighted). Press the left hand mouse button and drag the mouse to create a new wire. Drag the wire to the desired green pin(or desired port) and release the mouse button. A grey wire will be drawn between the pins.

image:connection.jpg

(Tip: if the wire is still blue after you released the mouse button, the mouse wasn't over a pin when you released it and the connection has not been made. You can use the move tool to drag the unconnected end of the blue wire over the pin and the connection will be made when the mouse button is released.)

Connections can be made while the agent boxes are contracted or expanded. In the contracted case the plumber agent (which actually makes the connections behind the scenes) will, in most cases, make a number of connections between various ports of the two agents. In the example shown here, expanding the two agents reveals that the plumber has made connections from drummer 1 left audio output to audio 1 left input and from drummer 1 right audio output to audio 1 right input.

image:connection_expanded.jpg

If you first expand the agent boxes, you can explicitly make connections between 2 agent ports of your choice.

When two connected agents are contracted, a single wire on the workbench diagram may represent many connections between the two agents. If one or other or both of the agents are expanded, the individual wires will be shown.

You can create connections on the diagram in either direction (ie from red pins to green pins or green pins to red pins) but the signal flow in the system is always from red (output) pins to green (input) pins.

Circular signals

Please note that EigenD does not in general support circular signal connections. This means that you should not connect the output of an Agent back to its input in any way. Please be aware that this principle also holds in a wider sense - if you have a signal path that goes from an Agent output back to it's input in a roundabout way, perhaps through another Agent, then this will not work and may in fact cause EigenD to become unstable and crash. Workbench will prevent you from connecting the output of an Agent directy back to itself but is unable to tell if you make a longer, more complicated loop so please be careful with this.

There are some exceptions to this rule when Agents have been specially written to allow for it. In particular the Console Mixer FX Returns, Sampler Activation, Pressure and Detune, all lighting inputs, the headphone input on the Alpha Agent and the Audio ins and outs on the Audio Agent are able to tolerate back connections. This set of circular connection tolerant inputs allows for the necessary back connections in any normal setup.

Disconnecting agents

Agents can be disconnected in 2 ways. The first way is to select the delete tool and move the mouse until the connection you want to remove is highlighted in red. Click the mouse and the connection will be removed. The second method is useful if you want to move a connection to another agent or port. In this case, select the wiring tool and move the mouse so that the cursor is over the pin from which you want to disconnect the wire. (Tip: if there are several wires on the pin and the wrong one is highlighted, click the mouse repeatedly to cycle through the wires until the one you want to disconnect is red.) Hold down the cmd key (ctrl key on windows) and press the mouse button and drag the wire away from the pin. The wire will be coloured blue when it is disconnected. You can leave the wire anywhere on the diagram if you want to leave it unconnected for a while and connect it later, or you can drag it to a different pin and release the mouse button, in which case a new connection will be made.

Back to Workbench

Next: Rigs