====== Scalar/Vector/Material Multi-Switcher ======

The Multi-Switcher nodes allow for switching between multiple inputs depending on an index value.

You can add as many inputs as you'd like to by connecting outputs to the **new** input. The name of the created input is the same as the input it's been connected to.

While there are only three nodes for different connection types, they are compatible with other connection types as well.

The Scalar node can also be used for integer connections.

The Vector node can also be used for colour connections.

{{:tools:multi-switcher_gui.png|}}

===== Controls =====

==== Index ====

This defines which of the inputs is being used to compute the output. Usually the index is driven by a value connected to the nodal index input.

==== Interpolate ====

If enabled, indices that result in a value between two inputs will not pick the first respective input, but interpolate between this and the next input value.

==== Relative / Absolute ====

This defines how the Index is interpreted.

  * **Relative** The index should be between 0.0 and 1.0 which will correspond to the start and the end of the inputs. This is irrespective of the amount of inputs.
  * **Absolute** The index number will be taken as is. I.e. if the index number is 5, the 6th input will be used (this is because the index is 0 based. I.e. is the index is 0, the first input is used).

==== Pre Behaviour ====

This defines how the index is interpreted if it's below zero.

  * **Blank** The output will be blank.
  * **Repeat** The input index will be repeated 
  * **Mirror** The input index will be mirrored
  * **Hold** The first or last input will be used
==== Post Behaviour ====

This defines how the index is interpreted if it's above 1 or above the number of inputs (Depending on the **Relative**/**Absolute** switch).

  * **Blank** The output will be blank.
  * **Repeat** The input index will be repeated 
  * **Mirror** The input index will be mirrored
  * **Hold** The first or last input will be used

===== Known Issues =====

Renaming an input will not show the change in the node editor until you click in the node editor to force a refresh. This is an issue with LW that's also present in native nodes, such as the Compound Node.

----
We'd like to thank Antti Järvelä from the LightWave 3D development team for helping with the code to mix materials.


[[https://www.patreon.com/dbw|{{  ::become_a_patron_button.png?nolink|}}]]
This is the plugin of the month for April 2019, made possible by the finest patrons on [[https://www.patreon.com/dbw|Patreon]].