RNBO Objects & Operators matrix~
Open Help

matrix~

Signal routing and mixing matrix

Description

matrix~ is an array of signal connectors and mixers (adders). It can have any number of inlets and outlets. Signals entering at each inlet can be routed to one or more of the outlets, with a variable amount of gain. If an outlet is connected to more than one inlet, its output signal is the sum of the signals from the inlets.

Arguments

incount [number]

Optional

Specify the number of inputs to be routed

outcount [number]

Optional

Specify the number of outputs to route to

ramp [number]

Optional

Ramp Time (ms)

Inlets

connect [list, signal]

The left inlet is used for the first signal to be routed and for the matrix routing. A list of three ints may be used to connect inlets and outlets when the to route the matrix~ object. The first int specifies the inlet, the second int specifies the outlet, and a third int is used to specify connection or disconnection. If the third int is nonzero value, the inlet of the first int will be connected to the outlet specified by the second int. A zero value for the third int in the list disconnects the inlet-outlet pair.

inlet [signal]

The signals to be routed

Outlets

out [signal]

The routed signals

Fixed Attributes

These attributes must be set in the object box and determine the behavior of the object at runtime.

incount [number] (default: 1)

Specify the number of inputs to be routed

outcount [number] (default: 1)

Specify the number of outputs to route to

Dynamic Attributes

These attributes can be modified in the code during execution using the set object

connect [list, signal]

The left inlet is used for the first signal to be routed and for the matrix routing. A list of three ints may be used to connect inlets and outlets when the to route the matrix~ object. The first int specifies the inlet, the second int specifies the outlet, and a third int is used to specify connection or disconnection. If the third int is nonzero value, the inlet of the first int will be connected to the outlet specified by the second int. A zero value for the third int in the list disconnects the inlet-outlet pair.

inlet [signal]

The signals to be routed

ramp [number] (default: 0)

Ramp Time (ms)

See Also

Name Description
gate~ Pass a signal to one of several outlets.
send~ Send signals without patch cords
receive~ Receive signals without patch cords
router
selector~ Assign one of several inputs to an outlet