Declaring your patch node to be variadic allows its user to add or remove similar input pins dynamically. For you, it is a way to avoid creating a list of mechanical variations to support the various number of inputs like:
Make sure you’re familiar with the variadic nodes concept and understand how the expansion process works.
To make your patch node variadic, you should place a special marker node on it. Find the marker node under the
xod/patch-nodes library. You need
variadic-3. The number defines the arity step, that is the group size by which the rightmost input pins replicate.
variadic-* node itself does nothing and is stripped out during compilation. It exists solely to define indefinite arity support.
Whenever you place a variadic node marker, the input pins get roles depending on their position relative to each other. Consider a patch node draft with a
To make the expansion XOD split pins of a variadic patch node into three groups.
Variadic pins (aka value pins). The rightmost pins get this role. Their number equals to the arity step. In the example above they are
V2. Values for the inputs on each level are provided by a node user.
Accumulator pins. Pins in the middle get this role. Their number equals the output number. In the example they are
A4. The user provides values only for the top level of the cascade; all other levels get accumulator values straightly from output pins of the respective upstream node.
Shared pins. The leftmost pins which are not variadic nor accumulator get this role. In the example they are
S2. The values are provided by the user, and they are delivered to each level in the cascade as is. In many cases there will be no shared pins.
Finally, consider a string join node example. We want a node which takes an arbitrary number (two or more) of input strings and joins them together inserting a delimiter between each. For example, it joins
"baz" with delimiter
"; " into
"foo; bar; baz". The delimiter is shared between all levels of expansion, so its input terminal goes left. We want the arity to increment one by one, so we use the
variadic-1 marker. Finally, a possible patch node implementation may look like this:
To let XOD properly expand your variadic node when transpiling you must satisfy several natural restrictions:
On the patch board, the variadic marker nodes either render usually or in red color. The later case tells you’re breaking some rules.
Hover the node to see the error. You have to resolve all issues or remove the marker node to make the program compile successfully.
The rules for pin placement and types are necessary for properly expanding your variadic node, but you may not want to show all the pins to the end user. With
variadic-pass nodes, you can sweep all the implementation details under the rug.