Differences

This shows you the differences between two versions of the page.

--- tools:multiswitcher [2019/04/21 15:34] – lightwolf
+++ tools:multiswitcher [2019/04/30 11:31] (current) – lightwolf
@@ Line 1: / Line 1: @@
-====== Scalar/Vector/Material Multi-Switcher (WiP) ======
+====== 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 =====
@@ Line 7: / Line 17: @@
 ==== Index ====
-This defines which of the images in the list is being used to compute the output colour. Usually the index is driven by a value connected to the nodal index input.
+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 images will not pick the first respective image, but interpolate between this and the next image.
+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 ====
@@ Line 17: / Line 27: @@
 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 image list. This is irrespective of the amount of images in the list.
+  * **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 image in the list will be used (this is because the index is 0 based. I.e. is the index is 0, the first image is used).
+  * **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 ====
@@ Line 25: / Line 35: @@
   * **Blank** The output will be blank.
-  * **Repeat** The list of images will be repeated
+  * **Repeat** The input index will be repeated
-  * **Mirror** The list of images will be mirrored
+  * **Mirror** The input index will be mirrored
-  * **Hold** The first image in the list will be used
+  * **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 images in the list (Depending on the **Relative**/**Absolute** switch).
+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 list of images will be repeated
+  * **Repeat** The input index will be repeated
-  * **Mirror** The list of images will be mirrored
+  * **Mirror** The input index will be mirrored
-  * **Hold** The last image in the list will be used
+  * **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]].