NetworkMaterialInterfaceControls

The NetworkMaterialInterfaceControls node allows you to apply a visibility or a lock condition on one or several parameters exposed by a NetworkMaterial node. This node works on a network material location, which can come from a NetworkMaterial node or a Look File.

Connection Type

Connection Name

Function

Input

input

The place in the node graph where you want to apply a visibility or lock condition on the parameters exposed by a NetworkMaterial node.

 

Control (UI)

Default Value

Function

materialLocation

N/A

Specifies the scene graph location path of the network material to be modified. The materialLocation parameter options are available by clicking the dropdown menu.

For more information, refer to the Scene Graph Location Widget Type in Common Parameter Widgets.

state

visibility

Selects a condition state to apply:

visibility - depending on the condition, displays or hides the parameter or page specified in the targetName parameter.

lock - depending on the condition, locks or unlocks the parameter or page specified in the targetName parameter, making any edits impossible if locked.

targetType

parameter

Selects whether to apply the condition on either:

parameter - applies on a single parameter.

page - applies on a set of parameters grouped into a page.

targetName

N/A

Specifies the name of the chosen parameter or page.

Note:  The name must be identical to the one that displays in the NetworkMaterial node's Material Interface.

definitionStyle

operator tree

Selects how to set up the condition:

operator tree - allows you to set up conditions using an operator tree.

conditional state expression - allows you to set up conditions using one or several expressions.

When definitionStyle: operator tree

operators

op

and

Selects which expression operator to use in the operator tree:

and - the resulting expression is satisfied only if all of the child expressions are satisfied.

or - the resulting expression is satisfied if at least one of the child expressions is satisfied.

ops > Add

or

once an op has been added, [Op]

contains

N/A

Evaluates if the condition is true by testing if the parameter or page values contain the values set in the expression.

doesNotContain

N/A

Evaluates if the condition is true by testing if the parameter or page values do not contain the values set in the expression.

endsWith

N/A

Evaluates if the condition is true by testing if the parameter or page values end with the values set in the expression.

equalTo

N/A

Evaluates if the condition is true by testing if the parameter or page values are equal to the values set in the expression.

greaterThan

N/A

Evaluates if the condition is true by testing if the parameter or page values are greater than the values set in the expression.

greaterThanOrEqualTo

N/A

Evaluates if the condition is true by testing if the parameter or page values are greater than or equal to the values set in the expression.

in

N/A

Evaluates if the condition is true by testing if the parameter or page values are in the values (separated by a pipe with no spaces) set in the expression.

lessThan

N/A

Evaluates if the condition is true by testing if the parameter or page values are less than the values set in the expression.

lessThanOrEqualTo

N/A

Evaluates if the condition is true by testing if the parameter or page values are less than or equal to the values set in the expression.

notEqualTo

N/A

Evaluates if the condition is true by testing if the parameter or page values are not equal to the values set in the expression.

notIn

N/A

Evaluates if the condition is true by testing if the parameter or page values are not in the values (separated by a pipe with no spaces) set in the expression.

numChildrenEqualTo

N/A

Evaluates if the condition is true by testing if the number of children in the target group parameter is equal to the number of children specified in the parameter or page.

numChildrenGreaterThan
OrEqualTo

N/A

Evaluates if the condition is true by testing if the number of children in the target group parameter is greater than or equals to the number of children specified in the parameter or page.

regex

N/A

Evaluates if the condition is true by testing if the parameter or page values match the values set in the regular expression.

and

N/A

Specifies if you want to compare the parameter or page values to another set of values.

It uses all the expressions to evaluate the condition.

or

N/A

Specifies if you want to compare the parameter or page values to another set of values.

It uses only one of the expressions to evaluate the condition.

Once an Op has been added:

path

N/A

Specifies the path of the parameter or page to evaluate.

value

N/A

Specifies the values to compare the parameter or page values with, in order to evaluate if the condition is true.

When definitionStyle: conditional state expression

expression

N/A

Specifies the expression to use to apply a visibility or a lock condition on the exposed parameter(s).