Switch Surface Icon

asSwitchSurface

A node that switches the output material from a list of 8 inputs, based on object or instance IDs, names, or string patterns, facilitating the creation of automatic variation in large scenes, specially when coupled with other variation nodes such as asSwitchTexture, asVaryColor or asIdManifold.


Parameters


Color Parameters

Input Color 0
The first material in the list of materials evaluate.

(…)

Note

The subsequent inputs follow exactly the same structure and parameterization.

Input Color 7
The last material in the list of materials to evaluate.
Cycle Mode
When cycling through the list of materials, if the index goes outside the list bounds, then one has the choice to cycle back to the beginning of the list, or if to clamp to the list size.
Connected Slots Only
When enabled (the default behaviour), it will look up and cycle through t he inputs which are connected to upstream material nodes. When disabled it will cycle through all available inputs, even those that aren’t connected to anything at all.

Manifold Parameters

Manifold Type

The type of manifold to use in order to determine which lookup to do in the list of materials. It can be one of the following

  • Object Name
  • Object Instance Name
  • Assembly Name
  • Assembly Instance Name
  • Face ID
  • String Prefix
  • String Suffix
  • Find String

String

Expression
The expression [1] to search in the expression domain.
Domain
The domain used to search an expression for.
Seed
The seed [2] to use for the manifold.

Outputs

Output Color
The resulting material color.

Footnotes

[1]Regular expressions, or regex. If you’re unfamiliar with it, it allows the creation of complex patterns for string and substring matching. You can validate your expressions here at regex101.
[2]A number used to initialize a pseudo random number generator, to allow some degree of determinism in a system. See random seed for more information.