NetworkMaterialEdit

The NetworkMaterialEdit nodes allow artists to edit network materials that have been created using NetworkMaterialCreate nodes or brought in through lookfiles, by adding or removing shading nodes from an existing network, or by modifying any of the parameters of shading nodes in an existing Network. NetworkMaterialEdit nodes hold the functionality of the existing NetworkMaterialParameterEdit and NetworkMaterialSplice node types, but in a UI that is visually representative of how the material was originally authored.

Node Parameters

Control (UI)

Default Value

Function

sceneGraphLocation

N/A

Type or drag the NetworkMaterial location from the Scene Graph to this field to specify which Network Material to make edits to.

Note:  The NetworkMaterialEdit node is designed to complement the NetworkMaterialCreate node. Only NetworkMaterial locations in your Scene Graph which have been created using a NetworkMaterialCreate, or lookfiles baked from a NetworkMaterialCreate node, can be edited using the NetworkMaterialEdit node.

makeInteractive

No

When set to Yes, you can drag objects in the Viewer and Katana retains the information from the Viewer.

parameters

N/A

This is where promoted parameters from with the NetworkMaterialCreate node appear. This section remains empty if no parameters have been promoted.

Note:  For more information on how to promote parameters, see Node Parameters and Interface Controls documentation.

Interface Controls

Control (UI)

Default Value

Function

Add Node button

N/A

Click to add a new Interface Control and open its parameters.

Filter

N/A

Filter the list of Interface Controls by name or type. Type in the text field to start filtering. A list of matching controls are displayed.

Click the Select All Matching button to display the parameters for all matching Interface Controls.

 

Disable Parameter Display

Disabled

Toggles the display of the parameters.

Fit to Width

Disabled

Adjusts the width of the Interface Control list so the full length of the control names are visible.

Fit to Height

Disabled

Adjusts the height of the Interface Control list so all controls are visible.

Note:  The following parameters are only visible once an Interface Control has been created and is selected.

state

visibility

The state of the parameter or page for the control to affect.

  • 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

Select whether to apply the condition on either:

  • parameter - The operation affects a single parameter.
  • page - The operation affects a page containing one or more parameters.

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

Select 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

N/A

Select an op:

  • contains - Evaluates if the condition is true by testing if the parameter or page values contain the values set in the expression.
  • doesNotContain - Evaluates if the condition is true by testing if the parameter or page values do not contain the values set in the expression.
  • endsWith - Evaluates if the condition is true by testing if the parameter or page values end with the values set in the expression.
  • equalTo - Evaluates if the condition is true by testing if the parameter or page values are equal to the values set in the expression.
  • greaterThan - Evaluates if the condition is true by testing if the parameter or page values are greater than the values set in the expression.
  • greaterThanOrEqualTo - 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 - 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 - Evaluates if the condition is true by testing if the parameter or page values are less than the values set in the expression.
  • lessThanOrEqualTo - 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 - 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 - 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 - 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.
  • numChildrenGreaterThanOrEqualTo - Evaluates if the condition is true by testing if the number of children in the target group parameter is greater than or equal to the number of children specified in the parameter or page.
  • regex - Evaluates if the condition is true by testing if the parameter or page values match the values set in the regular expression.
  • and - 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 - 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.

Note:  The following parameters are only visible once an operator has been selected from the Add menu.

op

N/A

The chosen op from the Add menu.

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.

Material Interface

Control (UI)

Default Value

Function

Name

N/A

A list displaying all promoted parameters, organized in the same way as they were grouped when promoted.

Source

N/A

The path to each different parameter.

Note:  For more information on the uses of the Material Interface, see Node Parameters and Interface Controls documentation.