connect

connect — Connects the named outlet ports of source instruments to the named inlet ports of sink instruments.

Description

The connect opcode, valid only in orchestra headers, sends the signals from the indicated outlet in all instances of the indicated source instrument to the indicated inlet in all instances of the indicated sink instrument. Each inlet instance receives the sum of the signals in all outlet instances. Thus multiple instances of an outlet may fan in to one instance of an inlet, or one instance of an outlet may fan out to multiple instances of an inlet.

Syntax

connect Tsource1, Soutlet1, Tsink1, Sinlet1

Initialization

Tsource1 -- String name, or number, of the source instrument.

Soutlet1 -- String name of an outlet port in the source instrument.

Tsink1 -- String name, or number, of the sink instrument.

Sinlet1 -- String name of an inlet port in the sink instrument.

Performance

During performance, the signals in all named outlets are summed in the named inlets to which they have been connected using the connect opcode. When new instances of instruments are allocated during performance, their inlets, outlets, and connections also are copied.

[Note] Order is important

The order of definition of instruments is important. A source instrument must be defined in the orchestra before any of the sink instruments to which its outlets are connected.

See Also

outleta outletk outletf inleta inletk inletf alwayson ftgenonce

Credits

By: Michael Gogins 2009