Node Variation - anticto/Mutable-Documentation GitHub Wiki

Function

Changes the output value (of any type) depending on what tags are active to the current instance or the state is active. The selection by state is only available for variation nodes of some types of data, like Mesh Sections. The first matching variation is returned, or the default value if none matches.

Use Cases

Allow to change certain parts of a customizable object depending on some external condition, like hiding half the hair and changing its textures around the border when a helmet is on.

Node Properties

Type: Select what properties are used to chose the variation. It can be active tags, or the state of the current instance. This option is only available for variation nodes of some types of data, like Mesh Sections.

Variations (array): Number of options defined.

Tag (array item): Name of the state or tag that activates the corresponding variation.

Input Pins

Variation (index) [(name)]: The value that are given if the current state name is the same as the variation name when the source are states. If the sources are tags, and any of the currently active customizable objects defines a tag identical to this variation name, these are the materials given. If the sources are tags and multiple variation names have active tags, this is the chosen variation only if it's the one with the lowest index among the active ones.

Default: The value that is returned if there is no matching variation.

Output Pins

(pin type name): The selected value according to the variation conditions (tags or states).