Find Sub-Material

Finds and returns the submaterial with the specified name and submaterial ID.

Lumberyard has two types of material assets:

Materials – A basic single item that represents one material.
Multimaterials – A material that contains multiple submaterials inside it.

You can use the Find Sub-Material node to access a submaterial that is inside a multimaterial. To access the submaterial, specify the name of the multimaterial and the ID of one of its submaterials. Material IDs range from the number of available submaterials. For example, if a multimaterial has five submaterials, you can specify a value from 1 to5.

To access a single material, you can use the Find by Name node.

Contents

Inputs
Outputs

Inputs

Pin	Type	Description
In	Event	Triggers the node.
Material Name	String	The path name of the material to find. The material must be a multimaterial. For more information, see Finding the Material Name.
Material ID	Number	ID of the submaterial in the multimaterial. IDs start at 1.
Should Load	Boolean	If true, the submaterial is loaded if it is not already available.

Outputs

Pin	Type	Description
Out	Event	Sends when the node is finished.
Material	Material	The submaterial that is found. Returns Invalid if the submaterial is not found.