A newer version of Max is available. Click here to access the latest version of this document.

spray

Distribute a value to a numbered outlet

Description

spray takes a list as input. The first number is taken as the outlet number, and one or more numbers that follow are sent out that outlet and those to its right, in right-to-left order. The argument sets the number of outlets (there is no set limit). The default number of outlets is 2.

Arguments

Name Type Opt Description
number-of-outlets and numbering-offset int opt The first argument sets the number of outlets. If there is no argument present, the object has two outlets. The second argument sets an offset for the numbering of the outlets. If the second argument is not present, the outlets are numbered beginning with 0.

Messages

int input [int]
Posts an error-message in the Max window stating that spray requires a list.
list input [list]
The first number in the list is a number that specifies the outlet number; the second is an int or float value to send out that outlet. If there are additional elements in the list, they are sent out the subsequent outlets to the right of the one specified by the first number in the list. The list may contain only ints or floats; symbols will be ignored.
offset outlet-offset [int]
The word offset followed by a number will offset the output of the object by the number of outlets given shifted to the left (a negative number will specify the number of outlets offset to the right).

Information for box attributes common to all objects

Output

int: When a list of is received by spray, the first number is used to specify an outlet, and the second int or float is sent out that outlet. Any additional numbers in the list are sent out subsequent outlets to the right.

Examples

Used to break up a list and send the items out specific outlets

See Also

Name Description
cycle Send a stream of data to individual outlets
funnel Tag data with a number that identifies its inlet
gate Pass the input out a specific outlet
listfunnel Index elements of a list and output them individually
route Selectively pass the output out a specific outlet
unpack Break a list into individual messages